Oracle Fusion Cloud - アクション

レコードの作成アクション

Oracle Fusion Cloudコネクターの「レコードの作成」アクションは、特定のオブジェクトタイプの新しいレコードを作成するために使用されます。例えば、特定の顧客アカウントの新しい売掛金請求書を作成する場合です。

接続の設定と特定のオブジェクトの選択後、特定のオブジェクトのすべての属性と子オブジェクトが入力フィールドとして表示されます。必要なフィールドをすべて入力し、必要な子オブジェクトにリストや手動のエントリを追加すると、レシピを実行することで特定のレコードを簡単に作成することができます。

売掛金請求書のメイン属性の追加

売掛金請求書の子オブジェクトである請求書行のリストの追加

レコードの取得アクション

レコードの取得アクションを使用すると、レコードの一意の内部IDに基づいて特定のレコードを取得することができます。例えば、製品を取得するには、特定の製品の在庫アイテムIDをレシピに渡す必要があります。オブジェクトを選択すると、必要なフィールドが自動的に表示されます。

Oracle Fusion Cloudでの製品の取得

「展開」フィールドを使用すると、関連する子オブジェクトと孫オブジェクトの特定の深さを選択して取得することができます。デフォルトでは、レスポンスにはレコードとその子オブジェクトが含まれますが、孫オブジェクトは含まれません。特定の孫オブジェクトを有効にするには、「展開」フィールドを使用して特定のオブジェクトを選択します。例えば、「売掛金クレジットメモ」オブジェクトの場合、ユーザーは「クレジットメモ行」（子オブジェクト）の「添付ファイル」（孫オブジェクト）を含めることができます。

売掛金クレジットメモの展開フィールド

レコードの検索アクション

Oracle Fusion Cloudコネクターには、2つの検索アクションがあります - レコードの検索と高度なクエリを使用したレコードの検索。 レコードの検索アクションを使用すると、入力フィールドに直接属性の値を指定して検索することができます。ユーザーは提供された属性を組み合わせるために「And」または「Or」を使用することができます。And操作は、すべての属性が一致する場合にのみ一致するレコードを返し、Or操作は少なくとも1つの属性が一致するレコードを返します。

例えば、ここでは「And」検索操作を使用して通貨が「USD」で請求書金額が「30000」の請求書を検索しています。

レコードの検索アクションを使用した請求書の検索

ユーザーは、大量のレコードが返される場合に効果的にページネーションするために、制限とオフセットを定義することもできます。 Get recordアクションと同様に、ここでは展開するオブジェクトをExpand入力で定義することができます。

高度なクエリを使用したレコードの検索アクション

高度なクエリを使用したレコードの検索アクションを使用すると、クエリ、フィールド、およびFinder入力を直接定義して特定のレコードをクエリして取得することができます。

• クエリ：SQLステートメントと同様に、検索のwhere句を定義します。詳細については、こちら (opens new window)を参照してください。
• Finder：特定の基準に基づいて検索およびレコードを取得するための事前定義されたクエリです。Finderはリソースに関連付けられた事前定義のクエリであり、使用することができます。詳細については、こちら (opens new window)を参照してください。

クエリの設定に加えて、このアクションには次のような追加機能も提供されています。

• フィールド：出力の一部として表示するフィールドを明示的に指定することができます。これにより、大量のレコードを取得する際にペイロードサイズを最小限に抑えるため、必要な特定のフィールドのみがレコードごとに取得されます。
• 制限とオフセット - 大量のレコードセットをページネーションするための制限とオフセットを設定できます。
• Order by - 特定の属性でフェッチされたレコードを昇順または降順の形式で並べ替えることができます。フィールド：順序形式に従い、カンマで複数のフィールドで並べ替えることができます。

高度なクエリを使用した売掛金顧客アカウントのアクティビティの検索アクション

高度なクエリを使用した売掛金顧客アカウントのアクティビティの検索アクション - 出力

レコードの更新アクション

レコードの更新アクションを使用すると、ユーザーはレコードを更新することができます。 オブジェクトに関連付けられた既存のレコードを更新するには、まず特定のオブジェクトを選択し、更新できるすべての入力フィールドが表示されるようにします。オブジェクトに関連付けられた主キーのレコードが強調表示され、更新する特定のレコードを識別します。

たとえば、既存の売掛金請求書を更新するには、オブジェクトの下に「売掛金請求書」を選択し、「顧客取引ID」を入力します。これにより、更新する必要がある請求書を一意に識別することができます。トランザクションIDを調べるには、ユーザーはレコードを検索し、クエリフィルターを使用して必要なレコードを取得し、そのアクションからこの入力にデータピルとしてトランザクションIDを渡すことができます。

売掛金請求書の更新アクション

更新アクションでは、メインオブジェクトおよびその子オブジェクトを更新することができます。特定の子オブジェクトを更新するには、メインオブジェクトのIDと子オブジェクトのIDの両方を提供して、両方を同時に更新する必要があります。たとえば、請求書の下の特定の請求行の子オブジェクトを更新するには、行番号IDを提供する必要があります。

請求書の子オブジェクトの更新

レコードのアップサートアクション

アップサートレコードを使用すると、オブジェクトに関連付けられた既存のレコードを追加または更新することができます。これは、特定のアクションにレコードの配列が渡され、レコードが既に存在するか新しく作成する必要がある場合に便利です。ここでの基本的なルールは、特定の主キー（例：請求書の場合は請求書ID）が存在する場合、レコードが更新され、主キーのフィールドが存在しない場合、レコードが新しいレコードとして挿入されるということです。

売掛金請求書オブジェクトのアップサート

同じアプローチは子オブジェクトにも適用され、特定の子オブジェクトの主キー属性が存在する場合、子オブジェクトが更新され、存在しない場合は親オブジェクトの設定に応じて既存のレコードまたは新しいレコードに挿入されます。 したがって、このアクションを介して任意のオブジェクトレベルで挿入または更新を実現することができます。

アップサートレコードアクションが非常に便利ないくつかのサンプルシナリオ：

• 既存の請求書に1つ以上の新しい請求行を追加する
• 既存の請求書の特定の請求行を更新する
• 新しい通貨レートで既存の請求書を更新する
• 在庫アイテムIDの有無に基づいてGoogleシートから抽出された製品を挿入または更新する

レコードの削除アクション

レコードの削除アクションを使用すると、既存のレコードを削除することができます。取得、更新、アップサートアクションと同様に、オブジェクトが選択されると、特定のレコードに関連付けられた主キーを提供する必要があります。

売掛金請求書オブジェクトの削除