目次

3-7.ワークフローをゼロから作成する

Yamaguchi Kaori 更新 by Yamaguchi Kaori

本ページでは、テンプレートを使わずにトリガーとアクションを自由に組み合わせてワークフローをゼロから作成する手順をを説明します。

作成したワークフローを安全に本番公開するために、「ドライラン」を使って事前に動作確認を行うまでのステップを網羅しています。

　　　

活用シーン

テンプレートにない組み合わせでワークフローを作成したい場合

用意されている既存のテンプレートでは実現できない、自社独自のステップ順や組み合わせで自動化を組みたいときに最適です。

従業員データやサービスに影響なく、安全にテスト（ドライラン）したい場合

本番環境へ公開する前に、実際の従業員データや連携サービスに影響しない「ドライラン機能」を使って、安全に動作を確認・試作できます。　　　　　

利用可能なトリガー・アクション

ゼロから作成するワークフローは、トリガーを起点に、実行したいアクションを上から下へ順番に1つずつ追加していくシンプルな設計です。直感的に自動化の手順を組み立てられます。

種別

名前

概要・発火タイミング

トリガー

新規入社

新しい従業員が組織に加わったとき（オンボーディング）に実行されます。

トリガー

退社

従業員が組織を離れたとき（オフボーディング）に実行されます。

トリガー

ディレクトリ定期更新

設定したスケジュール：毎日 / 毎週 / 毎月 / カスタム

トリガー

デバイス変更

デバイスレコードのフィールドが変更されたときに実行されます。ご利用にはデバイス機能の利用・デバイス権限が必要です。

トリガー

Webhook トリガー

外部システムが当サービスにイベントをPOST配信したときに実行されます。

アクション

変換：データマッピング

ターゲットタイプと変数形式のフィールドごとのマッピング。プロビジョニング等の前に配置します。

アクション

DBアクション：アイデンティティ、デバイス

アイデンティティ（作成 / 参照 / 更新 / 削除） 、デバイス（割当 / 割当解除 /削除 / 更新）

アクション

プロビジョニング

「新規入社」トリガーの後に配置可能。アカウントを付与するワークスペースや連携先を指定します。

アクション

デプロビジョニング

「退社」トリガーの後に配置可能。アカウントを剥奪するワークスペースや連携先を指定します。

アクション

通知：Slack / メール

通知を送るチャンネルや受信者アドレスを指定します。

アクション

フィルター

AND / OR の条件グループと、一致しなかった場合の挙動（停止 vs. 続行）を指定します。

アクション

コミュニケーション：HTTP リクエスト

外部システムを呼び出すための設定： URL、メソッド、認証、ヘッダー、本文テンプレート、タイムアウトなど

　　　　　

設定手順

  1. 自動化 > [自動化を作成]をクリックし、ダイアログから[新規作成]を選択します。
  2. 「ビルダー」画面の「1. イベントを選択」をクリックします。
  3. 「ノードを追加」画面で任意のトリガーを選択すると、画面右側に詳細な設定サイドバーが表示されます。トリガーの条件やフィルターなどを設定します。
    各トリガーの設定手順については、以下のリンクをご参照ください。

    新しい従業員が追加されました

    退職した従業員が削除されました

    スケジュールジョブWebhook

    デバイスフィールド変更

  4. ノード（＋）を選択し、「ノードを追加」画面で任意のアクションを選択します。画面右側に詳細な設定サイドバーが表示されますので、条件を設定します。
    各アクションの設定手順については、以下のリンクをご参照ください。

    データマッピング

    アイデンティティ

    デバイス

    HTTPリクエスト

    プロビジョニング / デプロビジョニング

    メッセージ（通知）

    「プロビジョニング / デプロビジョニング」アクションを設定する場合、必ずその手前のステップに「データマッピング」ノードを配置する必要があります。
    以下の画面が表示される場合、［データマッピングを追加］をクリックして、画面右側の「データマッピング」を設定します。
  5. 繰り返し、任意のアクションを追加します。
  6. 設定完了後に「ビルダー」の全てのチェックが緑色に変わりますので、[ドライラン]または[公開]をクリックします。
  7. 「ワークフロー自動化の設定を確認」画面が表示されますので、自動化名を入力して、［公開］をクリックします。
    ※自動化名にはご登録済の名称は登録できません。
  8. 「ワークフローが公開されました」と表示されますので［OK］をクリックします。

　

データマッピング

「ビルダー」画面の「データマッピング」を選択すると、標準IDフィールドと貴社のカスタムIDフィールドが一覧表示されます。

[サンプルペイロードから自動入力] をクリックして、テスト受信したキーに基づき各フィールドを自動推測します（完全一致 > 前方・後方一致の優先順でマッチング）。

保存前に必ず内容を見直してください。一致しなかったフィールドは空欄となり、実行時はスキップされます。
上書きする場合、フィールドをクリックして [Insert Variable] から変数を選択するか、直接パス（例：{{trigger.user_displayName}}）を入力して上書き・指定してください 。
各フィールドに設定できるのは、1つの {{trigger.X}} のみです。複数入力すると無効になります。

ターゲット

現在は、「identity」のみ選択できます。

フィールドマッピング

データソースからターゲットフィールドへの変換ルールを定義します。カスタム項目も設定できます。

　　　　　

アイデンティティ

「ビルダー」画面の「アイデンティティ」で対象となるユーザーに対して、以下の操作を行います。

操作

アイデンティティに対する操作タイプが以下のように選択されています。

・アイデンティティを更新：テンプレート「リアルタイムID同期 / 外部オフボーディング同期」を選択した場合に表示されます。

・アイデンティティを作成：テンプレート「外部オンボーディング同期」を選択した場合に表示されます

パラメータ

パラメータフィールドが動的に表示されます。

上記「操作」で表示される操作タイプに応じて、「アイデンティティを更新 パラメータ」「アイデンティティを作成 パラメータ」が表示されます。

{{identity.displayName}}（表示名）や {{identity.primaryEmail}}（メインメールアドレス）などの変数が正しく紐付いているか確認します。

役職、部署名、従業員ID、契約終了日などの項目も必要に応じてマッピング可能です。

　　　　

サービス選択（並列実行）
  1. 「並列実行」>［+別のサービスを追加］をクリックして、ワークフローに設定するサービスを追加します。
  2. 「プロビジョニング」または「デプロビジョニング 」に表示されるサービスを選択します。
    表示されるサービスは事前設定（マッピング）したサービスです。
    複数のサービスをワークフローに設定する場合、「複数選択」をONにします。
  3. 「並列実行」画面で選択したサービスをクリックすると、右側に「設定」画面が表示されます。
    「サービス設定 - ワークスペース名」をプルダウンから選択します。
    複数のサービスを設定する場合は［+別のサービスを追加］から設定します。

　　　　　　　

デバイス

「デバイス設定」画面で操作「デバイスを削除 / デバイスの割り当て解除 / デバイスを更新」を選択します。

　　　　　

通知
  1. 「通知」>［+別の通知を追加］をクリックします。
  2. 「メッセージ」画面で通知方法「Slack/Email」を選択します。
    複数の通知を設定する場合、「複数選択」をONにします。
    Slackの手順は通知方法「Slack」の設定手順をご参照ください。
  3. 「通知」画面で選択したメッセージをクリックすると、右側に「設定」画面が表示されます。

HTTP リクエスト

「4. HTTPリクエスト」では、外部APIへのコールバックが必要な場合、メソッド（POST等）やエンドポイントURLを設定します。

送信元では以下の形式でWebhookを送出するよう設定してください 。

項目

指定値・要件

エンドポイント

本サービス上に生成されたWebhook URL

メソッド

POST

ヘッダー：Content-Type

application/json

ヘッダー：X-Timestamp

Unix タイムスタンプ（ミリ秒、文字列）

ヘッダー：X-Webhook-Signature

sha256=HMAC-SHA256(secret, "{ts}.{body}")

リクエストボディ

コンパクトなJSON（空白・インデントなし）。送るキーがそのまま変数になります。

　　　　　　　　　　　　

ドライラン

ワークフロー公開前に、[ドライラン]からテストを実施します。

  1. [ ドライラン]をクリックすると「ドライラン」画面が表示されますので、内容を確認して[ドライランを開始]をクリックします。
  2. 結果一覧では進行に合わせて、該当のステップがリアルタイムに点灯します。内容を確認して[再実行]または[公開]します。
    「実在ユーザー」を選択した場合、実際のデータに影響します。 その場合、シミュレーションではなく、本番データでの実行になります。
    　 実際の従業員アカウントや本番データに影響を与えたくない場合は、必ず「モックユーザー」を選択してください。
  3. テストが完了すると、画面上部のバナーに結果が表示されます。また、ステップ毎の結果一覧が表示されます。モックユーザー（テストアカウント）が作成された場合は、[削除][保持]を選択します。
    テストに成功した場合、[公開]をクリックします。テストに失敗する場合、問題を修正後、再度テストを実行します。

　　　　　　　

トラブルシューティング

症状・エラー

考えられる原因

対処方法

Dry Run ボタンがグレーアウトしている

無効・未設定のノードがある、またはワークフローがアーカイブ済です。

全てのノードの設定を完了し（赤マークなし）、アーカイブ済の場合は復元してください。

Start dry run が無効になっている

実在ユーザーの実行には確認チェックが必要です。または対象サービスがテストに非対応です。

「I understand this will really run on {name}」にチェックするか、別の対象SaaSに切り替えてください。

{service} can't be tested automatically

該当SaaSがドライランに未対応のサービスです。

手動でテストするか、他のSaaSで続行してください。該当SaaSは別途接続してください。

プロビジョニング / デプロビジョニングの「＋」が警告バナーに変わっている

上にデータマッピングノードが設定されていません。

プロビジョニング / デプロビジョニングの前にデータマッピングを追加してください。

レビューダイアログで Publish が無効になっている

フロー内のどこかにガードレール違反があります。

各違反の横のFixをクリックしてからレビューを開き直してください。

Couldn't start the test run on the server

実際のバックエンドトリガーの起動に失敗した

ローカルプレビューは引き続き表示されます。問題が解消してから再実行するか、サポートにお問い合わせください。

オートメーション一覧に「Dry Run draft {timestamp}」というワークフローが表示される

ドライラン実行前に、未保存のワークフローが無効な下書きとして自動保存された

本番公開するか、テストが終わったら削除する。無効な間は本番イベントで実行されません。

　　　　

FAQ

Q. テンプレートにない組み合わせでアクションを構成できますか？

A. 可能です。任意のトリガーを起点として、「ノードを追加」でアクションを追加することで、用途に合わせて自由な順序や組み合わせでステップを設定できます。

　　

Q. アクションを並列実行できますか？

A. 現時点ではできません。 並列実行やグループ分岐はテンプレート専用の仕組みです。ゼロから作成する場合は、すべて上から下へ順番に実行される1本の直線的なチェーン構造となります。

　　

Q. ドライランは実際のデータに影響しますか？

A. 「実在ユーザー」を選択した場合、実際のデータに影響します。 その場合、シミュレーションではなく、本番データでの実行になります。

　 実際の従業員アカウントや本番データに影響を与えたくない場合は、必ず「モックユーザー」を選択してください。

　　

Q. ドライラン用に作成されたモックユーザーは、テスト後どうなりますか？

A. テスト終了後、ドライランで作成されたモックユーザーを[削除][保持]するか選択できます。デフォルトでは[削除]が選択されていまして、テスト用の仮想データは即座に削除されます。

　　　　　

Q. 新規入社のドライランで「実在ユーザー / モックユーザー」の選択肢が出ないのはなぜですか？

A. オンボーディング（入社処理）のテストには必ず新規アカウントが必要ですので、常に自動でモックユーザーを作成する仕様です。そのため、対象ユーザーの選択は不要です。

　　　

Q. ワークフローのドライランは複数回実行できますか？

A. はい、公開前であれば何度でも実行可能です。 すべてのノードが正しく設定されており、ワークフローがアーカイブされていない状態であれば、ヘッダーの[ドライラン]や「ドライラン」画面の[再実行]から、何度でも繰り返しテストを実行できます。

　　　　　　　　　　

Q. ドライランで一部のステップが失敗した状態のまま公開すると、本番でどのようになりますか？

A. エラーがある状態で[公開]をクリックすると、エラー内容を修正されるまで、本番でもエラーとなり続けますのでご注意ください。

　　　　　　　　

Q. 作成したワークフローを、後から編集したり一時停止できますか？

A. 可能です。ワークフロー一覧から対象のワークフローをクリックし、「ビルダー」タブから修正できます。

　一時停止はワークフロー一覧の「ステータス」欄のトグルスイッチをOFFにすると、[ワークフローを一時停止]できます。

この記事はお役に立ちましたでしょうか？

3-6.Webhookのワークフローを設定する

4.ワークフローを手動で即時実行する（ディレクトリ画面）

お問い合わせ