ワークフローの実行
ワークフロー全体の実行は、ワークフローの階層にある実行アイコンをクリックするか、特定のワークフロー内のアクションメニューからRun Allを選択して開始できます。
ワークフローテーブルの上部にあるToggle Start/Stopボタンをクリックすることもできます。このトグルボタンで、実行中のワークフローを停止したり、ワークフローを開始したりできます。
すでに実行中のワークフローで実行をクリックすると、PlaidCloudは2回目の実行を開始せず、その旨を通知します。
転記モードの選択
Section titled “転記モードの選択”すべての実行にはERP転記モードが設定されます。PlaidCloudでモードを選択するには、ワークフローの右クリックメニューの転記モードを指定して実行、またはワークフローキャンバス上の実行モードボタンを使用します。通常のワークフローを開始やワークフローの実行ではLiveが要求されますが、後述のプロジェクトの上限が適用されます。実行APIまたはアシスタントから実行を開始するときにも、モードを選択できます。
| モード | 動作 |
|---|---|
| Live | 転記ステップは従来どおりに転記します。これがデフォルトです。 |
| Simulate | すべてのERP転記ステップは、転記する内容を正確に作成して検証しますが、何もコミットせず、ERPにも接続しません。転記される予定のエントリは記録されるため、Liveで実行する前に確認できます。伝票を転記 ステップのエントリは転記レジスターに 転記予定 として記録され(ERPシステムに伝票を転記するを参照)、各システム専用の転記ステップのエントリは、シミュレーションとしてマークされてERP転記履歴に記録されます。 |
| Off | 転記ステップは完全にスキップされます。 |
プロジェクトにも独自の転記モード上限があります。これは、ロックされていないプロジェクトへの書き込みアクセス権を持つメンバーであれば、プロジェクトAPIまたはアシスタントから設定できます。上限は実行をより安全にする方向にのみ働き、より緩くすることはありません。実行の実効モードは、選択したモードとプロジェクトの上限のうち、より制限の厳しいほうになります。そのため、上限がSimulateに設定されたプロジェクトは、Liveで実行を開始してもシミュレーションのままです。
スケジュールされたイベントは独自の転記モードを保持するため、Simulateに設定されたスケジュールは、起動のたびにシミュレーションとして実行されます。
モードは、実行が関わるすべてのものに引き継がれます。サブワークフロー、マクロ、およびRun Model、Conditional Run Model、Loop Modelの各ステップはすべて親の実行のモードを継承します。停止後に再開した実行も同様です。そのため、シミュレーションの実行が内部のどこかで実際に転記することはありません。
プロジェクトに転記を承認する
Section titled “プロジェクトに転記を承認する”ワークフローの実行は、実行を開始した人ではなく、プロジェクトとしてERPに転記します。実行が転記できるようにするには、転記ステップが使用するERP接続と環境ごとに、プロジェクトの承認が必要です。承認がない場合、ステップは接続と環境を示して「This project isn’t authorized to post to connection …」というメッセージで失敗します。Call SAP Financial Document Attachment、Call SAP Master Data Table RFC、Call SAP RFCの各ステップには承認は不要です。
プロジェクトを承認するには、プロジェクトのホームページを開き、ERP転記の下にあるERP書き込み承認を選択します。各行は、1つの環境における1つの接続を表します。承認済みをオンにするとプロジェクトがそこに転記できるようになり、オフにすると転記できなくなります。承認者と承認日時には、最後に承認した人とその日時が表示されます。
- このボタンはプロジェクトのアーキテクトとワークスペース管理者に表示されますが、承認を変更できるのはアーキテクトだけで、しかもプロジェクトがロックされていない場合に限られます。アーキテクトではないワークスペース管理者は、先に自分自身をアーキテクトとして追加できます。
- 行を選択して承認または解除しても、一覧は再読み込みされません。スクロール位置と選択した列の並べ替えはそのまま保たれます。ウィンドウのサイズは変更でき、公開プロジェクトに関する注記は全文が折り返して表示されます。
- 接続を承認するには、自分自身もその接続への書き込みアクセス権が必要です。つまり、自分が所有しているか、名前指定またはいずれかのセキュリティグループを通じて共有されている必要があります。すべてのワークスペースメンバーに設定された接続は対象になりません。
- すべてのワークスペースメンバーに設定されたプロジェクトも、ほかのプロジェクトと同様に承認されます。すべてのメンバーがそのプロジェクトのアーキテクトであるため、接続への書き込みアクセス権を持つメンバーなら誰でも、そのプロジェクトにその接続を承認できます。承認されると、どのメンバーでも、そのプロジェクトのワークフローからその接続へ転記できるようになり、ウィンドウにはグリッドの上にその旨が表示されます。
- テーブルデータまたはディメンションのメンバーを含めて作成した、自分専用の新しいコピーには、自分で付与できるソースの承認が引き継がれ、ソースがLiveだった場合はSimulateの状態で作成されます。詳しくはコピーでのERP書き込み承認をご覧ください。それ以外のコピーや、プロジェクトアーカイブから作成したプロジェクトには、承認がない状態で作成されます。転記する前に承認してください。
ステップの状況の確認
Section titled “ステップの状況の確認”ワークフローの実行中は、各ステップに現在の状況を示すステータスアイコンと、実行にかかっている時間が表示されます。アイコンにカーソルを合わせると、その状況のメッセージが表示されます。
| ステータス | 意味 |
|---|---|
| Waiting | ステップはキューに入っており、まだ開始されていません。 |
| Running | ステップは処理中で、実行時間が増え続けます。 |
| Completed | ステップは正常に完了しました。 |
| Warning | ステップは完了しましたが、ワークフローログで確認すべき内容が検出されました。 |
| Error | ステップは失敗しました。ステップエラーの管理をご覧ください。 |
| Skipped | ステップは無効になっているか、実行条件が満たされなかったため、実行されませんでした。ワークフローのステップをスキップするをご覧ください。 |
| Continued | ステップは失敗しましたが、エラー時に続行する設定になっているため、ワークフローは続行されました。エラー時に続行をご覧ください。 |
| Stopped | ステップが終了する前に、実行が停止されました。 |
| Abandoned | ステップの実行が中断されたため、完了することはありません。実行を再開するか、ワークフローを再実行してください。 |
開いているワークフロービューは、実行の進行に合わせて自動的に更新されるため、ページを再読み込みしなくても、表示中のステータスは常に最新です。
放棄されたステップ
Section titled “放棄されたステップ”ステップを実行していたものが実行の途中で失われると、そのステップはabandoned(放棄)とマークされます。多くの場合、誰かが停止を押したか、プラットフォームのメンテナンスで実行が中断されたことが原因です。ステップの実行時間は増えなくなり、ステータスのツールチップに何が起きたかが表示されます。
放棄されたステップは完了しておらず、出力も生成されていません。処理が遅いわけではなく、データや設定の問題でもありません。
作業を再開するには、実行を再開するか(放棄されたステップが再度実行されます)、ワークフロー全体を再実行します。どちらも安全です。
中断されたステップ
Section titled “中断されたステップ”ステップを実行しているサーバーが実行の途中で失われた場合、PlaidCloudは、繰り返しても安全なときにそのステップを自動的に再実行します。出力を置き換えるステップは、1回で正常に実行した場合と同じ結果になるため、確認する必要はありません。ステップのログには、2回目の試行が始まる位置に「Restarted: the server running this step stopped before it finished (e.g. out of memory or a restart); running it again from the start.」という警告が表示されます。
安全に繰り返せないステップは再実行されません。そのステップは、interrupted(中断)メッセージとともに1回だけ失敗します。2回目を実行すると、1回目がすでに書き込んだものが重複するおそれがあるためです。名前やパスに {date} または {date_iso} を含む出力を書き込むステップは、再実行すると別の日付に書き込まれる可能性があるため、安全に繰り返せないものとして扱われます。復旧するには、ステップのターゲットで1回目に書き込まれた内容を確認し、必要に応じてクリーンアップしてから、ステップを再実行するか、実行を再開します。
開始されないステップ
Section titled “開始されないステップ”ステップがワーカーを待っている間、そのステータスメッセージには「Waiting for a worker… N min. No import worker has picked this step up yet.」と表示されます(ワーカーの種類はステップに対応し、インポートやエクスポートなどになります)。作業が始まると、このメッセージは消えます。
ステップのジョブが開始できない場合は、永遠に待ち続けるのではなく、理由を示して失敗します。
| 原因 | 失敗するまでのおおよその時間 |
|---|---|
| インポートまたはディメンションのステップのジョブをどのワーカーも取得しない | 40分 |
| ステップのPodがPendingのままになっている | 20分 |
| ステップのイメージをプルできない | 5分 |
| ステップ用のPodが作成されない | 20分 |
| コネクタ(Singer)の同期をどのランナーも取得しない | 30分 |
コネクタの同期のメッセージには、その同期の名前が示されます。ワーカーがジョブを開始した後に失われた場合も、ワーカーが停止したというメッセージとともにステップは失敗します。インポートとディメンションのメッセージには「Use Run from here to retry.」と表示されます。
応答しなくなった実行
Section titled “応答しなくなった実行”実行の背後にある処理がなくなった後も、実行が実行中のままになることはありません。ワークフローを実行しているサーバーが失われた場合、その実行は失敗として終了します。1回の実行は最大12時間です。その時点でまだ終わっていない実行は、「Run failed: still running at the 12-hour limit. Re-run the workflow.」というメッセージとともに失敗します。
一時停止、停止、再開
Section titled “一時停止、停止、再開”ワークフローの実行中は、一時停止して実行中のステップを完了させ新しいステップを待機させることも、停止してキューに入っていたステップと実行中のインポートまたはエクスポートのジョブを、エクスポートが読み取っていたウェアハウスのクエリとともにキャンセルすることもできます。キューに入っていたインポートとディメンションのステップは正常にキャンセルされるため、ワークスペース内の後続のインポートやディメンションのロードを妨げません。停止すると、ワークフローのキュー中または実行中のコネクタ(Singer)の同期も停止されるため、ワークフローの停止後も同期が実行され続けることはありません。
マクロは、他のワークフローやマクロ: 並行実行ステップから呼び出されて、複数の場所で同時に実行されることがあります。マクロを停止すると、実行中のすべてのコピーが停止します。1つのコピーを停止した場合、停止するのはそのコピーとそれが開始したものだけで、それを呼び出したワークフローは実行を続けます。Macro Concurrentステップが応答しなくなったコピーを見限った場合も同様です。他のワークフローの中でのみ実行されているマクロは、ワークフロー一覧に実行中と表示されて停止を使用でき、開くと各ステップの最新の実行におけるステータス、開始時刻、終了時刻が表示されます。
再開すると、一時停止、停止、または失敗した実行を、最初からやり直すのではなく、中断した箇所から続行します。ワークフローの最後の実行が一時停止、停止、またはエラーの状態で終了している場合は、常に利用できます。
「中断した箇所」が何を意味するかは、ワークフローの実行方法によって異なります。
| 実行方式 | 再開時の動作 |
|---|---|
| シリアル | 実行が終了したときに実行中だったステップから再開し、そこから続行します。そのステップがグループ内にある場合、再開ではそれを含む最上位のグループ全体が対象になります。グループ内ですでに正常に完了したステップはそのままで、それ以外が実行され、グループの後から実行が続行されます。 |
| パラレル | 正常に完了していないすべてのステップを再実行し、完了したステップはそのままにします。 |
| 高度(グラフ) | 失敗したノードと、それを待っているすべてのノードを再実行し、完了したノードはそのままにします。 |
別のワークフローを呼び出すステップ(Run Model、Conditional Run Model、Loop Model)は、呼び出し先のワークフローを最初からやり直すのではなく再開します。これは、ネストの階層がいくつあっても同様です。ループステップは、中断された反復を再開し、すでに完了した反復はスキップします。
別のワークフローのネストされた子として実行されたワークフロー(親のRun Modelステップが呼び出したもの)を再開するとき、PlaidCloudはチェーンの先頭から再開を提示します。子だけを再開しても親のオーケストレーションを続行できないため、このオプションでは代わりに最上位の親(チェーンのルート)を再開し、チェーン全体を停止した箇所から続行します。最上位のワークフローの再開は従来どおりです。チェーンの先頭は同じプロジェクト内で解決されます。別のプロジェクトにまたがるチェーンは、プロジェクト内の部分の先頭から再開されます。
再開は常に元の実行を続行します。その実行のうち正常に完了しなかったすべてのステップを再実行します。失敗したステップや放棄されたステップは完了扱いにならず再実行されます。また、その間に個々のステップを単独で再実行しても、次に再開で取得される内容は変わりません。これは子ワークフローにも当てはまります。子ワークフローのステップの1つを単独で再実行した場合でも、親を再開すると、そのステップだけでなく、子ワークフローに残っていたすべてが実行されます。
再開された実行は、ワークフローの実行履歴に新しい実行として記録され、再実行したステップのみが含まれます。元の実行は、それ自身の履歴エントリを保持します。1回の実行で同じ子ワークフローが複数回呼び出された場合は、呼び出しごとに子ワークフローの実行履歴にエントリが作成されます。ループステップの反復は、1回の呼び出しとして数えられます。