Process request and the acknowledge response

Process is used when the client is submitting a new business object, canceling an existing business object, or invoking processing logic against an existing business object. The Acknowledge response will include the shell of the business object that was processed, containing at a minimum the unique identifier for the new or changed business object.

On Process requests, the action 'Create' is used for submitting a new business object such as create a new catalog entry. The action 'Delete' is used for cancelling an existing business object, like delete a catalog entry. Actions can also be user-defined. The action must indicate the business operation that needs to take place on the included Noun. There is no predefined list of actions that can be associated with the Process verb, because the action is very specific on the supported business process associated with the business object.

In the example below, the Process verb is used, with an actionCode of Register.


<_mbr:DataArea>
    
<oa:Process>
      <oa:ActionCriteria>
        <oa:ActionExpression actionCode="Register"
expressionLanguage="XPath">/Person[1]</oa:ActionExpression>
      </oa:ActionCriteria>
    </oa:Process>
    <_mbr:Person>
      <_mbr:PersonIdentifier/>
      <_mbr:ParentOrganizationIdentifier/>
      <_mbr:Credential>
        <_mbr:LogonID>test121622</_mbr:LogonID>
        <_mbr:Password>web1admin</_mbr:Password>
        <_mbr:SecurityHint/>
      </_mbr:Credential>
      <_mbr:ContactInfo>
        <_wcf:ContactInfoIdentifier>
          <_wcf:ExternalIdentifier>
            <_wcf:PersonIdentifier/>
          </_wcf:ExternalIdentifier>
        </_wcf:ContactInfoIdentifier>
        <_wcf:ContactName/>
        <_wcf:Address>
          <_wcf:City>Toronto</_wcf:City>
        </_wcf:Address>
        <_wcf:Telephone1/>
        <_wcf:Telephone2/>
       
<_wcf:BestCallingTime>Evening</_wcf:BestCallingTime>
        <_wcf:EmailAddress1>
          <_wcf:Value>abc@123.com</_wcf:Value>
        </_wcf:EmailAddress1>
        <_wcf:EmailAddress2>
          <_wcf:Value>abc@456.com</_wcf:Value>
        </_wcf:EmailAddress2>
        <_wcf:Fax1/>
        <_wcf:Fax2/>
      </_mbr:ContactInfo>
    </_mbr:Person>
  </_mbr:DataArea>

The following example shows the Acknowledge response:


<_mbr:DataArea>
    
<Oagis9:Acknowledge/>
    <_mbr:Person>
      <_mbr:PersonIdentifier>
        <_wcf:UniqueID>17002</_wcf:UniqueID>
       
<_wcf:DistinguishedName>uid=test121622,cn=users,dc=ibm,dc=com</_wcf:DistinguishedName>
      </_mbr:PersonIdentifier>
      <_mbr:ContactInfo>
        <_wcf:ContactInfoIdentifier>
          <_wcf:UniqueID>34801</_wcf:UniqueID>
          <_wcf:ExternalIdentifier>
           
<_wcf:ContactInfoNickName>test121622</_wcf:ContactInfoNickName>
            <_wcf:PersonIdentifier>
              <_wcf:UniqueID>17002</_wcf:UniqueID>
             
<_wcf:DistinguishedName>uid=test121622,cn=users,dc=ibm,dc=com</_wcf:DistinguishedName>
            </_wcf:PersonIdentifier>
          </_wcf:ExternalIdentifier>
        </_wcf:ContactInfoIdentifier>
      </_mbr:ContactInfo>
    </_mbr:Person>
  </_mbr:DataArea>