Coupa - オブジェクトアクション ​

Workatoには、請求書、経費、サプライヤーなどのCoupaとやり取りできるさまざまなオブジェクトアクションが用意されています。また、幅広いCoupaオブジェクトを使用できます。オブジェクトを参照するコネクターアクションを使用する際に、操作する予定のオブジェクトを指定できます。詳細については、オブジェクトセクションを参照してください。

Workatoには、次のオブジェクトアクションが用意されています:

• オブジェクトを作成
• オブジェクトを更新
• オブジェクトの検索
• IDによるオブジェクトの取得
• オブジェクトIDによる送金先住所の取得
• オブジェクトへのファイル添付の追加

作成/更新アクションの入力フィールド ​

このステップでは、選択したオブジェクトに対して選択したアクションを実行します。たとえば、オブジェクトの作成アクションを選択し、オブジェクトとしてInvoiceを選択すると、レシピでステップが実行されたときにCoupaで請求書が作成されます。

Coupaコネクターのオブジェクト作成/更新アクションでのオブジェクトの選択

オブジェクトを選択すると、そのオブジェクトに関連するすべてのフィールドが表示されます。たとえば、オブジェクトの作成アクションを選択し、オブジェクトとしてContractを選択すると、入力する必要がある契約関連のすべてのフィールドがアクションに入力されます。前のステップのデータピルを使用して、ワークフローのデータに基づいてオブジェクトを作成します。

エラーを防ぐため、必須フィールドは常にレシピ設定に表示されます。 Coupaインスタンスで定義されているカスタムフィールドは、追加フィールドタブでも確認できます。

リスト入力フィールド ​

Workatoの一部のCoupaオブジェクトアクションでは、リスト入力行を受け入れることができます。これは、請求書行または発注書行のリストを生成する場合に、請求書や発注書でよく見られます。リスト入力フィールドを使用して、レシピアクションから生成されたリスト出力をマッピングできます。リスト入力の詳細については、リストを参照してください。

オブジェクトを作成 ​

このアクションは、発注書や請求書など、指定したオブジェクトを作成します。動的に生成された入力フィールドには、このオブジェクトを正常に作成するために必要なすべての必須入力フィールドが表示されます。任意の入力フィールドは、フィールドタブで非表示になっている場合があります。

Workatoでは、データの取得元アプリケーションのレコードIDを保存するために、Coupaにカスタムフィールドを作成することを推奨しています。たとえば、NetSuiteからデータを取得するインテグレーションを通じてCoupaで作成された新しいサプライヤーには、同じサプライヤーのNetSuite IDを保存するカスタムフィールドを設定する必要があります。また、同じアクションのCoupa内部IDでNetSuiteレコードを更新する必要があります。これにより、アプリケーション内のレコード間のこの関係が明示的に定義されるため、今後のレシピやインテグレーションが容易になります。

オブジェクトの更新 ​

このアクションは、Coupa内の特定のオブジェクトを更新します。 Coupaオブジェクト内部IDを指定する必要があります。これにより、更新する予定のオブジェクトがCoupaに示されます。その他のすべてのフィールドは動的に生成されます。

レシピにCoupa内のこの請求書の内部IDがない場合は、オブジェクトの検索アクションを使用します。詳細については、オブジェクトの検索セクションを参照してください。オブジェクトの検索アクションでは、請求書の場合はInvoice number、発注書の場合はPurchase order numberなど、他のフィールドに基づいてCoupa内の特定のオブジェクトを検索できます。オブジェクトの検索の出力にあるIDデータピルを使用して、オブジェクトを更新します。

作成/更新アクションの出力フィールド ​

各オブジェクト作成/更新アクションは、Coupa内の単一のオブジェクトに対してアクションを実行します。 Workatoのこのアクションは、カスタムフィールドに含まれるすべてのオブジェクト関連情報を取得します。その後、レシピの後続ステップで出力データピルを使用できます。

検索/取得アクションの入力フィールド ​

このアクションは、ステップが実行されるとCoupaで検索を実行します。入力を受け取り、それに一致するオブジェクトをオブジェクトのリストとして返します。

オブジェクトを選択すると、そのオブジェクトに関連するすべてのフィールドが表示されます。 Workatoでは、オブジェクトの検索アクションを使用して検索できる、さまざまな関連フィールドをサポートしています。その他のすべての検索/取得アクションでは、Coupaオブジェクト内部IDを使用する必要があります。

オブジェクトの検索 ​

このアクションは、指定した特定のフィールドに基づいてCoupa内のオブジェクトを検索します。使用できる一般的なフィールドには、Coupa内部ID、オブジェクトに関連付けられた番号と名前があります。たとえば、請求書番号に基づいて請求書を検索したり、サプライヤー名に基づいてサプライヤーを検索したりできます。これは、これらのオブジェクトを更新する予定だがCoupa内部IDがない場合に便利です。

このアクションは、複数のオブジェクトレコードを返すことができます。 Workatoコネクターでは、次の方法で検索できます:

• フィールド: 事前定義された一連のフィルターを使用してレコードを検索します。オブジェクトタイプを選択すると、関連フィールドが表示されます。
• クエリ: 自由形式のクエリを使用してレコードを検索します。詳細については、Coupaドキュメントを参照してください。

IDでオブジェクトを取得 ​

このアクションは、Coupa内の特定のオブジェクトを取得します。探しているオブジェクトのタイプと内部IDを定義します。返されるオブジェクトは、オブジェクトの検索アクションの結果と似ています。

このアクションは、単一の一意のレコードのみを返します。

オブジェクトIDによる送金先住所の取得 ​

このアクションでは、オブジェクトと、そのオブジェクトに関連付けられたCoupa内部IDを選択して、送金先住所を取得できます。これは、支払いを送金する住所です。このアクションの出力は、指定されたオブジェクトの住所リストの形式です。このアクションはサプライヤーでのみサポートされています。

検索/取得アクションの出力フィールド ​

IDによるオブジェクトの取得アクションを除く各検索/取得アクションは、検索条件に一致するオブジェクトのリストを返します。このアクションを使用して、他のアプリケーションの一般的なオブジェクトに関連している可能性があるCoupa内のオブジェクトを検索します。

オブジェクトへのファイル添付の追加アクションの入力フィールド ​

オブジェクトへのファイル添付の追加アクションでは、Coupa内のさまざまなオブジェクトにファイル添付を作成できます。 Coupaで添付を作成する予定のオブジェクトを定義するには、オブジェクトタイプを手動で選択するか、データピルをマッピングする必要があります。また、オブジェクトのCoupa内部IDと添付コンテンツも指定する必要があります。ファイル添付は、Contracts、Purchase Orders、Requisitions、およびInvoicesでサポートされています。

オブジェクトへのファイル添付の追加アクションの出力フィールド ​

このアクションは、Coupaで作成された添付の場所を返します。この場所をURLとして直接使用することはできません。