update操作
update
操作は、最上位サービス・データ・オブジェクトと、子エンティティおよび子孫エンティティの、既存の行を更新します。 行が存在しない場合、この操作は例外をスローします。
-
主キーまたは代替キー: 主キーが不明な場合は、
find
操作を使用して、関連する行の主キーを取得します。 -
更新する値: 要求ペイロードでは、サービス・データ・オブジェクトのすべての属性値を渡す必要はありません。
操作のシグネチャ
営業リード・サービスの場合、更新されるオブジェクトを受け取るupdateSalesLead
操作は次のとおりです。
<element name="updateSalesLead">
<complexType>
<sequence>
<element name="salesLead" type="ns1:MklLead"/>
</sequence>
</complexType>
</element>
操作が正常に完了すると、更新されたオブジェクトが応答ペイロードによって返されます。
<element name="updateSalesLeadResponse">
<complexType>
<sequence>
<element name="location" type="ns1:MklLead"/>
</sequence>
</complexType>
</element>
例
この例では、内部識別子が300100041938883の営業リード・ビジネス・オブジェクトのステータスがQUALIFIEDに設定されます。
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:updateSalesLead
xmlns:ns1="http://xmlns.oracle.com/apps/marketing/leadMgmt/leads/leadService/types/">
<ns1:salesLead
xmlns:ns2="http://xmlns.oracle.com/oracle/apps/marketing/leadMgmt/leads/leadService/">
<ns2:StatusCode>QUALIFIED</ns2:StatusCode>
<ns2:LeadId>300100041938883</ns2:LeadId>
</ns1:salesLead>
</ns1:updateSalesLead>
</soap:Body>
</soap:Envelope>
応答ペイロードでは、更新された属性が営業リード・ビジネス・オブジェクトに反映されます。
関連する操作
大きいビジネス・オブジェクトを更新する場合や、応答ペイロードが必要ないオブジェクトを更新する場合は、process
操作を使用します。 この操作を使用すると、応答ペイロードが空であるか、主キーのみを含むか、またはペイロード全体を含むかを指定できます。
次の場合は、merge
操作を使用します。
-
既存のオブジェクトを更新します。
-
新しいオブジェクトを作成します。
-
既存のオブジェクトに新しい子孫オブジェクトを作成します。
適切なサービス・データ・オブジェクト・レベルの行を削除するには、delete
操作を使用します。