インテグレーション ビジネス プロセス ガイドライン
概要
インテグレーション ビジネス プロセスは、 Workdayと外部エンドポイント間でデータを交換するための、インテグレーションの実行に関連するタスクを調整する、設定可能なワークフローです。
"インテグレーション プロセス イベント"
ビジネス プロセス タイプが使用されているため、単純なインテグレーションの開始よりも複雑な処理が可能です。を参照概念: インテグレーション ビジネス プロセス-このトピックには以下のセクションがあります。
- サブプロセス
- 前提条件
- プロセス開始者
- 制限事項
- 共通ビジネス プロセス ワークフロー
- ワークフロー ステップ
- インテグレーション
- 通知
- 課題と解決策
サブプロセス
そのビジネス プロセスの定義に "インテグレーション" ステップを追加することで、そのビジネス プロセスにインテグレーションを埋め込むことができます。親ビジネス プロセスがそのステップに到達すると、指定された "インテグレーション プロセス イベント" がサブビジネス プロセスとして開始されます。
前提条件
プロセス開始者
インテグレーション ビジネス プロセスは、いくつかの方法で開始できます。
- 手動適切な権限を持つユーザーは、"View Integration System"レポートから直接、または"インテグレーションの開始 / スケジュール"タスクを使用してインテグレーションを開始できます。
- スケジュール済"インテグレーションの開始 / スケジュール"タスクから、インテグレーションが特定の時間に実行されたり、定期的に実行されたりするようにスケジュールできます。
- サブビジネス プロセスインテグレーション ビジネス プロセスは、別のWorkdayビジネス プロセス内のステップから開始できます (例:"Complete Form I-9"ビジネス プロセスの後に"E-Verify " インテグレーションを実行します)。
制限事項
インテグレーション ビジネス プロセス フレームワークには柔軟性がありますが、その基盤となるインテグレーションテクノロジーには特定の制限があります。
- Webサービス開始からのインテグレーション システムの組織以下を介してインテグレーションを開始する。Launch_IntegrationまたはLaunch_EIBWebサービスオペレーションでは、ビジネス プロセスの特定の組織固有バージョンを指定できません。そのインテグレーション システムの最上位 (デフォルト) 定義が使用されます。組織とインテグレーション ビジネス プロセスの表示 -概念: インテグレーション ビジネス プロセス -
- ドキュメント取得のファイル サイズの上限インバウンド ファイルの上限は、XML では 1 GB、XLSX では 300MB です。を参照参考: インテグレーションおよび Web サービスの制限事項-
共通ビジネス プロセス ワークフロー
- パス 1: デフォルトのインテグレーション ワークフロー
- デフォルトでは、インテグレーション プロセス イベントは次の 2 つの基本的なステップで構成されています。A:開始>B:サービス (インテグレーションの起動)"サービス (起動)"ステップでは、インテグレーション システム自体が実行されます。アウトバウンドインテグレーションの場合は、出力ファイル ()が生成されます。インバウンドインテグレーションの場合は、データがWorkdayにロードされます。
- パス 2: 承認ありのアウトバウンド インテグレーション
- このワークフローは、 Workdayからデータが送信される前に、ユーザーによるレビューが必要な場合に一般的です。A:開始>B:承認>C:サービス (起動インテグレーション)>D:サービス: ドキュメント送信承認されると、"サービス (インテグレーションの実行)" ステップが実行され、 Workdayからデータが抽出され、出力ファイルが生成されます。"サービス: ドキュメント送信" ステップは、生成されたファイルを SFTP サーバーなどの外部エンドポイントに送信します。
- パス 3: インバウンド インテグレーション ワークフロー
- このワークフローは、外部ソースからWorkdayにデータを取り込むための標準的なワークフローです。A:開始>B:サービス: ドキュメント取得>C:サービス (インテグレーションの起動)"サービス: ドキュメント取得" ステップは、外部ソース (FTP サーバーなど) からファイルを取得するか、タスクをユーザーに転送して手動でファイルをアップロード。"サービス: インテグレーションの起動"ステップにより、インテグレーションが実行され、取得したファイルが取得されてWorkdayにロードされます。
- パス 4: チェーン化されたインテグレーション ワークフロー
- このパターンは、あるインテグレーションの出力が別のインテグレーションの入力である場合に役立ちます。A:開始>B:インテグレーション>C:インテグレーション最初の"インテグレーション"ステップで、最初のインテグレーション システム(例: EIBまたは Studioインテグレーション) が実行され、出力ファイルが生成されます。2 つ目のインテグレーションステップで 2 つ目のインテグレーション システムがトリガされ、最初のインテグレーションからの出力ファイルが使用されます。
ワークフロー ステップ
- 開始
- 順序
- A (第 1 ステップ)
- 実行者
- インテグレーションを開始するユーザーまたはシステム。これには、スケジュール済みイベントやシステムによりトリガされるイベントのインテグレーション システム ユーザー (ISU)、または手動開始のインタラクティブ ユーザーが該当します。
- ロール別のセキュリティ ドメイン
- インテグレーションを開始する ISU またはインテグレーション管理者:インテグレーション構築、インテグレーション設定、インテグレーション デバッグ、インテグレーション イベントに対する変更/入力権限。
- ベストプラクティス
- "開始" ステップは、すべてのビジネス プロセスで必須の最初のステップです。削除することはできません。開始プロセスの開始点および監査記録として機能。
- 例
- HR 管理者は、"インテグレーションの開始 / スケジュール"タスクに移動して "OK" をクリックして、外部福利厚生ベンダーへの新規採用のエクスポートを実行します。このアクションによって"開始" ステップが完了し、ビジネス プロセスワークフローが開始されます。
ステップ タイプ
インテグレーション ビジネス プロセスに追加できる一般的なステップ タイプは次のとおりです。
- 承認
- 順序
- "開始" ステップの後は、任意の場所に配置できます。たとえば、"インテグレーションの実行" ステップの後ではなく、"ドキュメント送信" ステップの前に配置できます。
- 実行者
- 指定されたセキュリティ グループ(例: HR パートナー、報酬管理者、マネージャ)。
- セキュリティ ドメイン
- ISU、インテグレーション管理者、またはビジネス プロセス管理者:インテグレーション イベントの"変更/入力"権限。
- 指定
- 承認を担当するセキュリティ グループを指定する必要があります。
- 条件ルール
- ユース ケース:社員の賞与データが含まれたファイルを給与計算ベンダーに送信する前に、マネージャがレビューおよび承認する必要があります。
- ベスト プラクティス:条件ルールを使用して、必要な場合にのみ承認をトリガ。たとえば、賞与額の合計が特定の閾値を下回った場合に、承認ステップをスキップするルールを作成できます。
- 例:インテグレーション出力の "合計賞与額" フィールドが 50,000 ドルより大きいかどうかをチェックする条件ルールが承認ステップに設定されます。設定されている場合、このステップは承認のために"Compensation Administrator"セキュリティ グループに転送されます。それ以外の場合、このステップはスキップされます。
- ステップ タイプの使用ケース、ベスト プラクティス、および例:
- ユース ケース: 給与計算や株式付与などの機密性の高いアウトバウンド インテグレーションで、データの正確性を確保する。
- ベスト プラクティス:社員の休暇によるプロセスの遅延を回避するために、特定の指定ユーザーではなくロール ベースのセキュリティ グループに承認を割り当てます。
- 例: エグゼクティブ報酬変更ファイルを外部システムに送信する前に、承認ステップを"Executive Compensation Admin"セキュリティ グループにルーティングし、データを検証します。
- サービス
- 順序
- 開始 ()以降の任意の場所に配置できます。この順序は重要です。インバウンドインテグレーションの場合、"ドキュメント取得" は"インテグレーションの実行"より前に配置する必要があります。アウトバウンドの場合、インテグレーションの起動はドキュメント送信 ()より前でなければなりません。
- 実行者
- インテグレーション システム ユーザー (ISU)。
- ロール別のセキュリティ ドメイン
- ISU:インテグレーション "構築"、"インテグレーション設定"への"変更/入力"権限。
- 指定
- 実行するサービス(ドキュメント取得)、ドキュメント送信(ドキュメント送信)、またはインテグレーションの起動 ()を指定する必要があります。
- 条件ルール
- ユース ケース: 毎日実行されるインテグレーションの場合、週の最初の日にファイルを取得すれば十分です。
- ベスト プラクティス:ドキュメント送信ステップの条件ルールを使用して、空のファイルが送信されないようにする。インテグレーションイベントのレコード数がゼロより大きいかどうかをチェックするルールを作成できます。
- 例:"ドキュメント送信" ステップの条件ルールでは、"起動インテグレーション" ステップで処理されたレコード数をカウントする計算フィールドがチェックされます。納品ステップは、件数が 0 より大きい場合にのみ実行され、システムがベンダーに空白のファイルを送信するのを防ぐ。
- ステップ タイプの考慮事項
- ドキュメント取得: インバウンド インテグレーションで、外部ソース (SFTP サーバーなど) からファイルを取得するために使用されます。
- インテグレーションの起動: これは、メインインテグレーション システムを実行するコア ステップであり、出力ファイルの生成 (アウトバウンド) や、 Workdayへのデータのロード (インバウンド) を処理します。
- ドキュメント送信: アウトバウンド インテグレーションで、生成されたファイルを外部の宛先 (SFTP サーバーや Webサービス エンドポイントなど) に送信するために使用されます。
- 関連手続き
- 順序
- 手動によるアクションや指示が必要なプロセス内のどこにでも配置できます。
- 実行者
- 指定されたセキュリティ グループまたはユーザー。
- セキュリティ ドメイン
- ISU、インテグレーション管理者、またはビジネス プロセス管理者:インテグレーション イベントの"変更/入力"権限。
- 条件ルール
- 必要な場合にのみ手動介入をトリガするのに役立ちます。たとえば、ルールによって、インテグレーション イベントのステータスが "完了 (警告)" になっているかどうかを確認し、管理者が警告を確認するように "関連手続き" をトリガすることができます。
- ステップ タイプのユース ケース、ベスト プラクティス、および例
- ユース ケース: Workday外で手動タスクを実行するか、プロセス ステップの後にWorkday内でデータを確認するよう管理者に通知します。
- ベスト プラクティス:"関連手続き" ステップの指示を明確で、アクション可能なものにする。可能であれば、関連するレポートやタスクへのリンクを含めます。
- 例: インバウンドEIBが新しい臨時従業員をロードする場合。"関連手続き" ステップは、"サービス - 起動インテグレーション" ステップの後にトリガように設定されています。"臨時従業員がロードされました" という指示を持つ"HRIS アナリスト"グループに割り当てられています。"新規採用の検証" レポートを実行してデータを確認し、ローカライズ設定が不足している場合は完了させてください"
インテグレーション
このステップ タイプにより、現在のビジネス プロセス内から別のインテグレーション システムを起動できます。これにより、インテグレーションをチェーン化します。
- 順序
- "開始" ステップの後は、任意の場所に配置できます。
- 実行者
- インテグレーション システム ユーザー (ISU)。
- 指定
- サブプロセスとして開始するインテグレーション システム "" を選択する必要があります。
- ユース ケース、ベスト プラクティス、例が含まれる条件ルール
- ユース ケース: メインのアウトバウンドインテグレーションが実行された後、2 つ目のインテグレーションを実行して生成ファイルを長期保管先の事業地にアーカイブする。ただし、最初のインテグレーションが成功した場合に限定されます。条件ルールを使用して、前のステップ ("インテグレーションの実行") のステータスをチェックし、その出力に応じて後続のインテグレーションを開始する前に、そのステップが正常に完了したことを確認します。例: "インテグレーションのアーカイブ" を開始するようにインテグレーションステップが設定されています。このステップの条件ルールにより、その前の"インテグレーションの実行" ステップのステータスがチェックされます。アーカイブインテグレーションは、前のステップのステータスが "完了" の場合にのみ実行されます。
- ユース ケース:インテグレーションを開始せずにファイルを取得する、またはファイルを送信せずにインテグレーションを開始する。常に偽と評価される条件ルールを使用する。例: スキップすべきステップの "1=2"。
- ステップ タイプのユース ケース
- ユース ケース (データの強化): 初期のインテグレーションで基本的な社員データが抽出されます。2 番目の"インテグレーション"ステップは、最初の出力を取得し、別のソース (カスタム レポートなど) からデータを追加して、機能を強化した最終的なファイルを作成する別のインテグレーションを呼び出します。
- ユース ケース (プロセスオーケストレーション): インバウンドEIBが新規採用者をロードした後、インテグレーションステップによってアウトバウンドインテグレーションがトリガ、外部の IT システムでその新規採用者のアカウントがプロビジョニングされる場合があります。
- ユース ケース (リダイレクトの失敗):インテグレーションステップが失敗した場合、ビジネス プロセスを自動的に終了するのではなく、失敗したインテグレーションを特定のユーザーに転送する。
- ビジネス プロセス セキュリティ ポリシーで、"リダイレクト"権限を持つようにセキュリティ グループを設定します。
- ビジネス プロセス定義 ()の"インテグレーション" ステップで、"リダイレクトの管理"関連アクションを使用します。
- 1 つ以上のリダイレクト アクションを選択し、リダイレクトされたステップを受信するセキュリティ グループを 1 つ以上選択します。
- ステップ タイプの例
- ビジネス プロセスが開始され、最初のステップである"サービス (インテグレーションの実行)"が"PayData Extract" インテグレーションを実行すると、生の給与計算データファイルが生成されます。次のステップ"インテグレーション"は、"PayData" インテグレーション""を開始するように設定されています。この 2 つ目のインテグレーションは、最初のインテグレーションからファイルをピッキングし、ベンダーに必須XML レイアウトに再フォーマットし、新しいファイルをアウトバウンド 保留領域に配置するように設計されています。最後のステップである"サービス (ドキュメント送信)" は、変換された XML ファイルを給与計算ベンダーに送信します。
通知
カスタム通知は、インテグレーションプロセスイベント全体の最終ステータスによってトリガされます。ビジネス プロセス定義自体に通知 (例: ステップの完了時またはエラー) を設定できます。
ユース ケースとベスト プラクティスおよび以下の例:
- ユース ケース (成功): 週間給与計算インターフェイス ファイルが正常に生成され、ベンダーに送信されたことを確認する E メールを給与計算チームに送信します。
- ユース ケース (エラー):インテグレーションが失敗した場合、イベントの詳細とエラーメッセージを記載した優先順位の高い通知をインテグレーション管理チームに送信し、すぐに調査できるようにします。
- ベスト プラクティス: 個々のユーザーではなく、特定のロール ベースのセキュリティ グループ (インテグレーション管理者など) を受信者として使用します。インテグレーションの名前、実行時間、詳細のためのプロセス モニタへのリンクなどの重要な情報を含む、明確でアクション可能な通知メッセージを作成します。
- 例:ビジネス プロセスのステータスが "失敗" の場合にインテグレーション通知がトリガように設定されています。"インテグレーション サポート" セキュリティ グループに E メールが送信されます。E メール本文は、以下のようにカスタマイズされます。"インテグレーションCCB - アウトバウンド Demographics"が失敗しました。詳細については、プロセス モニタを参照してください。イベント ID: [Event ID]"。
課題と解決策
このセクションには、一般的な問題と、それに対応する原因および解決策が記載されています。ここにリストされていない問題については、 Communityでナレッジ記事を検索することをお勧めします。最良の結果を得るには、以下のことを行ってください。
- 二重引用符を使用して、プロセスの正確な名称を検索します。例: "インテグレーション ビジネス プロセス"。
- 以下の検索フィルタを選択して、最初の結果を絞り込みます。
- コンテンツ グループ: 記事
- コンテンツ タイプ: ナレッジ記事
- "ソート基準" フィルタを使用して、関連性または新しい順に結果を表示します。
出庫 | 原因とソリューション |
|---|---|
外部エンドポイントが予期したインテグレーションファイルを受け取りません。 | "プロセス モニタ と"すべてのプロセス レコード " レポートを使用して、期待どおりに動作しなかった部分を特定する。インテグレーション プロセス イベントのトラブルシューティング を参照してください概念: インテグレーション ビジネス プロセス- |
アウトバウンド ファイルが外部エンドポイントに配信されませんでした。 | 原因:ビジネス プロセスが "ドキュメント送信 " ステップの前に失敗したか、送信ステップ自体が失敗した可能性があります。
ソリューション: 失敗に関連したステータスとエラーメッセージを表示するには、以下の手順に従います。
|
インバウンドインテグレーションでデータがロードされませんでした。 | 原因: ドキュメント取得 ステップでファイルが検索ないか、ファイルが空であるか、データのロード中に起動インテグレーション ステップが失敗した可能性があります。
ソリューション: ファイルが指定した外部事業地に存在すること、およびファイル名が設定 ()と一致していることを確認します。 "インテグレーション イベント" レポートを確認します。ファイルの解析またはデータ検証に関連するプロセスエラーメッセージを表示するには、インテグレーション イベント ()の " Created from Trigger" 列を選択します。 |
承認ステップが正しくルーティングされなかったか、スキップされました。 | 原因: 承認ステップの条件ルールが正しく設定されていないか、指定されたセキュリティ グループのメンバーが正しくない可能性があります。
ソリューション: "ビジネス プロセス定義の表示 " レポートを使用して、ステップの条件ルールロジックをレビューします。"セキュリティ グループの表示 " レポートを使用して、割り当てられた承認者グループのメンバーシップを確認します。 |
インテグレーションがセキュリティエラーで失敗しました。 | 原因:インテグレーションに関連付けられているインテグレーション システム ユーザー (ISU) に、必須セキュリティドメイン ()の権限がありません。
ソリューション: インテグレーション イベントの 詳細にあるエラーメッセージを確認して、保護されているデータまたはアクションを特定してください。"業務分野のドメイン セキュリティ ポリシー " レポートにアクセスして関連するドメインを検索し、ISU に割り当てられたセキュリティ グループに追加します。 |
すべてのインテグレーションが次のエラーで開始できませんでした: """インテグレーション プロセス イベント" ビジネス プロセス タイプのデフォルト定義がありません... | 原因: インテグレーション プロセス イベント のデフォルトのビジネス プロセス定義が正しく非アクティブ化、削除、または編集され、エラーが発生しました。すべてのインテグレーションがベースとしてこの定義に依存します。
ソリューション:
|
インテグレーション ビジネス プロセス通知が設定されていますが、E メールで送信されていません。 | 原因: テナント レベルの通知ルーティングルールで、インテグレーション関連の通知を E メールで送信するように設定されていません。
ソリューション:
|
チェーン化されたインテグレーション( インテグレーション ステップから開始) が失敗し、親ビジネス プロセス全体が終了します。 | 原因: これは、 Workdayで設計され、想定された動作です。 インテグレーション ステップを含むビジネス プロセスのいずれかのステップでエラーが発生した場合、デフォルトでプロセスが停止し、エラーの発生を防ぐことができます。
ソリューション: これは「修正」するエラーではなく、管理する動作です。
|
エラーのある Studioインテグレーションステップは、 "リダイレクトの管理" で設定されている場合でも、リダイレクトされません。 | 原因: 現在、 "リダイレクトの管理 " 機能は、"失敗 " ステータスで完了した Studio インテグレーションでのみ機能します。Studioインテグレーションが"完了 (エラー) " のステータスで完了した場合、これは"リダイレクトの管理" 機能では失敗とみなされません。
ソリューション: これは「修正」するエラーではなく、管理する動作です。インテグレーションに堅牢なエラー処理と独自の通知があることを確認します。を参照ビジネス プロセス ステップでのリダイレクトの設定- |