Workday - Call operationアクション
このアクションはWorkday Web Services(WWS)を使用して、接続済みのWorkdayインスタンスでSOAPベースの操作を実行します。
操作の完全なセットは、Workday Web Services Directoryで確認できます。
入力(シンプル)
Workdayインスタンスで実行する操作を定義します。
操作とともに送信されるデータを指定します。 入力フィールドのセットは、選択した操作のタイプによって異なります:
- 操作
- 実行する予定のWorkday Web Services操作の名前。
Workatoが残りの入力フィールドを判別できるように、操作を選択する必要があります。 - 属性付きフィールド
- 属性を割り当てる必要があるフィールドを選択します。
これらの属性は、選択したフィールドのXMLタグの一部です。
属性を持つフィールドが少なくとも1つある操作の場合のみ。 - 複数値フィールド
- 操作データで繰り返されるフィールドを選択します。
繰り返しフィールドが少なくとも1つある操作の場合のみ。
操作
Maintain Contact Informationを選択
Workday Web Servicesのすべての操作の完全なリスト。 必要な操作を見つけるには、キーワードを使用して絞り込み、一致する可能性のある項目のリストを減らします。
この例では、Maintain Contact Information操作を探します。 ここでは、従業員のメールアドレスが変更されたときにWorkdayレコードのメールアドレスを更新するレシピを作成します。
属性を持つフィールド
属性値を含めるためにEmail Address Dataを選択
既存のメールアドレスを置き換えずに特定の連絡先へ新しいメールアドレスを追加する場合は、Email address dataフィールドのDo_Not_Replace_All属性をfalseに設定できます。
Maintain Contact Information Data/Worker.../Email Address Dataを選択します。 これにより、Do_Not_Replace_Allを含む、Email address dataフィールドで使用可能なすべての属性が生成されます。
複数の値を持つフィールド
繰り返し対象のEmail Address Dataフィールドを選択
ユースケースに複数のメールアドレスが含まれる場合は、1回の操作で複数のメールアドレスを送信する必要があります。
Maintain Contact Information Data/Worker.../Email Address Dataを選択します。 これにより、Email address dataがリスト型の入力フィールドに変更されます。 以降の操作では、このリストを使用して1つ以上のメールアドレスをマッピングできます。
参照フィールドのカスタマイズ
各参照フィールド値は、customization:value構文を使用してカスタマイズできます。 これを使用してフィールドタイプをカスタマイズできます。 たとえば、Worker_Referenceは通常WIDを使用して参照されます。 従業員IDで参照する場合は、Employee_ID:21012と入力できます。 これにより、フィールドタイプがWIDから従業員IDに変換され、使用される値は21012になります。
カンマ、スペース、またはコロンを含む値は、区切り文字として使用されないように<!--no_split-->構文で囲む必要があることに注意してください。 例: <!--no_split-->value1,value2<!--no_split-->。
入力(ユーザー定義ペイロード)
ユーザー定義ペイロードへの切り替え
Workdayに送信されるXMLペイロードをカスタマイズする場合は、Workdayコネクターのユーザー定義ペイロードのサポートを使用できます。
ガイド付き入力からユーザー定義XMLペイロードに切り替えるには、次の手順に従います:
実行する操作を選択します。
ユーザー定義ペイロードモードを有効にするには、Switch to user-defined payload入力フィールドをYesに設定します。 複数行テキスト入力フィールドを使用して、リクエストの未加工XMLペイロードを直接編集します。
Workatoは、ユーザー定義ペイロードに切り替える前に設定されたすべてのガイド付き入力フィールドを、未加工XMLペイロードに自動入力します。
ユーザー定義XMLペイロードモードを使用する場合は、次の考慮事項に注意してください:
- Workatoは、選択したコネクションに基づく値を使用して、
HeaderフィールドのSecurity部分を挿入または置換します。 - Workatoは、ユーザー定義ペイロードモードで行ったカスタマイズをガイド付き入力モードに同期しません。 ユーザー定義ペイロードに戻す場合、これらのカスタマイズは取得できません。
- XMLペイロードが適切に生成されるように、Formulaモードを使用して設定されたガイド付き入力フィールドを確認し、修正する必要があります。
有効なカスタムXMLペイロードの例を次に示します:
<env:Envelope
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:wsdl="urn:com.workday/bsvc"
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Body>
<wsdl:Get_Workers_Request>
<wsdl:Request_References>
<wsdl:Worker_Reference>
<ID wsdl:type="Employee_ID">12345</ID>
</wsdl:Worker_Reference>
</wsdl:Request_References>
</wsdl:Get_Workers_Request>
</env:Body>
</env:Envelope>出力
選択した操作のフィールドと属性の完全なセットは、出力データツリーで利用できます。
制限事項
Workdayドキュメントに基づく内容:
- Webサービスレスポンス内のインスタンスの最大数は100万です。
- 添付ファイル/画像を含むレスポンスでは、各添付ファイル/画像の最大サイズは30MBです。
- リッチテキスト文字列レスポンスには、1,048,576文字または1MBのサイズ制限があります。
Last updated: