create操作
create操作は、要求ペイロードによって渡されるビジネス・オブジェクトを検証し、その後、作成します。 ビジネス・オブジェクトには、最上位オブジェクト・エンティティと、子孫オブジェクト・エンティティが含まれます。
操作のシグネチャ
営業リード・サービスを例として使用すると、定義されるビジネス・オブジェクトを受け取るcreate操作のシグネチャは次のとおりです。 ここでは、createSalesLeadが要求ペイロードで、定義されるビジネス・オブジェクトはMklLead型の営業リード・オブジェクトです。
<element name="createSalesLead">
<complexType>
<sequence>
<element name="salesLead" type="ns1:MklLead"/>
</sequence>
</complexType>
</element>create操作は、応答ペイロードで、新しく定義されたビジネス・オブジェクトを返します。
<element name="createSalesLeadResponse">
<complexType>
<sequence>
<element name="result" type="ns1:MklLead"/>/>
</sequence>
</complexType>
</element>例
この例では、予想される取引金額が$100,000 USDの Issaquah Imaging Innovations - Tabletsの営業リード・オブジェクトが作成されます。
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:createSalesLead
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:Name>Issaquah Imaging Innovations - Tablets</ns2:Name>
<ns2:DealAmount currencyCode="USD">100000</ns2:DealAmount>
</ns1:salesLead>
</ns1:createSalesLead>
</soap:Body>
</soap:Envelope>操作が正常に完了すると、新しく作成された営業リード・オブジェクトが応答ペイロードによって返されます。
<ns0:createSalesLeadResponse xmlns="" xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns0="http://xmlns.oracle.com/apps/marketing/leadMgmt/leads/leadService/types/"
xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsu="http://docs.oasis-open.org/
wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<ns2:result xmlns:ns0="http://xmlns.oracle.com/adf/svc/types/"
xmlns:ns1="http://xmlns.oracle.com/apps/marketing/leadMgmt/leads/leadService/"
xmlns:ns2="http://xmlns.oracle.com/apps/marketing/leadMgmt/leads/leadService/types/"
xmlns:ns3="http://xmlns.oracle.com/apps/crmCommon/notes/noteService"
xmlns:ns4="http://xmlns.oracle.com/oracle/apps/marketing/leadMgmt/leads/leadService/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns4:MklLead">
<ns4:Name>Issaquah Imaging Innovations - Tablets</ns4:Name>
<ns4:LeadNumber>CDRM_80328</ns4:LeadNumber>
<ns4:OwnerPartyName>Gabrielle Lee</ns4:OwnerPartyName>
<ns4:StatusCode>UNQUALIFIED</ns4:StatusCode>
<ns4:Rank xsi:nil="true"/>
<ns4:LeadId>300100041938883</ns4:LeadId>
...
<ns4:DealAmount currencyCode="USD"
xmlns:tns="http://xmlns.oracle.com/adf/svc/errors/">100000</ns4:DealAmount>
...
</ns2:result>
</ns0:createSalesLeadResponse>関連する操作
既存のビジネス・オブジェクトの子オブジェクトを作成する場合、create操作を使用することはできません。 かわりに、merge操作を使用します。
1つの要求で複数のビジネス・オブジェクトを作成する場合は、process操作を使用します。 この操作を使用すると、応答が値を返さないか、主キーのみを返すか、またはオブジェクト全体を返すかを制御できます。 process操作を使用して、応答ペイロードの値が必要でない大きいビジネス・オブジェクトを作成することもできます。