機械翻訳について

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操作を使用します。

関連トピック
  • 標準のCRUD操作
  • create操作
  • delete操作
  • get操作
  • find操作
  • find by additional predefined search criteria操作
  • merge操作
  • process操作