Oracle Web Services On Demand Guide > Web Services On Demand API Calls > Service API Calls >

HistoryInsertOrUpdate

Inserts or updates entries in the Recently Viewed records section in the Action bar.

Usage

You use the HistoryInsertOrUpdate method to insert or update records in the Recently Viewed records section in the Action bar in the Oracle CRM On Demand application.

For upsert operations, the user keys are either of:

• <Id>
• <ObjectName> + <ObjectId>

The only field that can be updated is the <Order> field.

Arguments

Table 54 describes the arguments taken by the HistoryInsertOrUpdate method.

Return Value of the Call

The inserted or updated records with their status key fields are returned.

Sample SOAP Request - HistoryInsertOrUpdate

The following SOAP request updates an account record with the <objectId> value of 1QA2-VKKBZ record in the Recently Viewed list. The order of the record within the list is changed.

<?xml version="1.0" encoding="utf-8" standalone="no"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:his="urn:crmondemand/ws/history/" xmlns:data="urn:/crmondemand/xml/historyitem/Data">

   <soapenv:Header>

      <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">

         <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

            <wsse:Username>%%%USERNAME%%%</wsse:Username>

            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">%%%PASSWORD%%%</wsse:Password>

         </wsse:UsernameToken>

      </wsse:Security>

   </soapenv:Header>

   <soapenv:Body>

      <his:HistoryInsertOrUpdate_Input>

         <data:ListOfHistoryItem>

            <data:HistoryItem>

               <data:ObjectName>Account</ObjectName>

               <data:ObjectId>1QA2-VKKBZ</ObjectId>

               <data:Order>12</Order>

            </data:HistoryItem>

         </data:ListOfHistoryItem>

      </his:HistoryQueryPage_Input>

   </soapenv:Body>

</soapenv:Envelope>

Sample SOAP Response - HistoryInsertOrUpdate

The following SOAP response contains the updated record with its status key fields:

<?xml version="1.0" encoding="utf-8" standalone="no"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

   <SOAP-ENV:Body>

      <ns:HistoryInsertOrUpdate_Output xmlns:ns="urn:crmondemand/ws/history/">

         <ListOfHistoryItem xmlns="urn:/crmondemand/xml/historyitem/Data">

            <HistoryItem>

               <Id>1QA2-34ISOM</Id>

               <CreatedById>1-CZ010</CreatedById>

               <CreatedDate>2018-05-18T09:59:42Z</CreatedDate>

               <CreatedBy>Tara Treadlightly, 05/18/2018 05:59:42</CreatedBy>

               <ModifiedById>1-CZ010</ModifiedById>

               <ModifiedDate>2018-05-18T10:15:30Z</ModifiedDate>

               <ModifiedBy>Tara Treadlightly, 05/18/2018 06:15:30</ModifiedBy>

               <ModId>1</ModId>

            </HistoryItem>

         </ListOfHistoryItem>

      </ns:HistoryInsertOrUpdate_Output>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>