Creating/Updating a MACConfig

Request: http://<PPM_Server_IP>:<Port>/itg/rest/integration/MACConfigurations

HTTP Method: POST/PUT

Description: Create a request if you do not specify a configuration key; update a request if you specify a configuration key.

Response entity body:

  • on success: Return an XML object of the created or updated MACConfig with the following format:

    <mACConfig>
       <configurationKey>43824eeb-26de-4ad9-b0fd-4b6974373c11</configurationKey>
          <serverURL>http://ppmvm48:8080/qcbin/</serverURL>
          <userName>admin</userName>
          <password>admin</password>
          <timeZone>28800000</timeZone>
          <domain>LBC</domain>
          <project>LBC_PRJ1</project>
          <enabled>false</enabled>
          <qcMajorVersion>11</qcMajorVersion>
          <qcMinorVersion>2</qcMinorVersion>
          <requestTypeId>31420</requestTypeId>
          <entityType>Requirement</entityType>
          <dominateCenter>PPM</dominateCenter>
          <syncHierarchy>false</syncHierarchy>
          <defaultFolder>a</defaultFolder>
          <normalNotificationEnabled>false</normalNotificationEnabled>
          <errorNotificationEnabled>false</errorNotificationEnabled>
          <consolidateNormalNotification>false</consolidateNormalNotification>
          <consolidateErrorNotification>false</consolidateErrorNotification>
          <fieldMappings>
             <fieldMapping>
                <qcFieldName>name</qcFieldName>
                <qcFieldLabel>Name</qcFieldLabel>
                <ppmfieldToken>REQ.DESCRIPTION</ppmfieldToken>
                <ppmfieldPrompt>RFC Summary:</ppmfieldPrompt>
                <fieldControl>Bidirectional</fieldControl>
                <allowValueMap>false</allowValueMap>
                <ppmToQCValueMaps/>
                <qcToPPMValueMaps/>
             </fieldMapping>
             <fieldMapping>
                <qcFieldName>req-comment</qcFieldName>
                <qcFieldLabel>Description</qcFieldLabel>
                <ppmfieldToken>REQD.RFC_DESCRIPTION</ppmfieldToken>
                <ppmfieldPrompt>RFC Description:</ppmfieldPrompt>
                <fieldControl>Bidirectional</fieldControl>
                <allowValueMap>false</allowValueMap>
                <ppmToQCValueMaps/>
                <qcToPPMValueMaps/>
             </fieldMapping>
             <fieldMapping>
                <qcFieldName>dev-comments</qcFieldName>
                <qcFieldLabel>Comments</qcFieldLabel>
                <ppmfieldToken>REQD.RFC_EFFECT_NO_CHANGE</ppmfieldToken>
                <ppmfieldPrompt>Effect of no change:</ppmfieldPrompt>
                <fieldControl>Bidirectional</fieldControl>
                <allowValueMap>false</allowValueMap>
                <ppmToQCValueMaps/>
                <qcToPPMValueMaps/>
             </fieldMapping>
          </fieldMappings>
    </mACConfig>
  • on failure: The following message codes are returned if the operation fails:

    Message Code

    Message

    Cause

    Possible Corrective Action

    PPMC_WSE401

    ALM MAC configuration validation error

    Invalid parameter

    Check parameters

    PPMC_WSE402

    The MAC configuration does not exist

    The mac config you try to update does not exist

    Check configuration key

    PPMC_WSE400 Internal error Unknown Error N/A