活用シーン
| シーン | 詳細 |
|---|---|
| テンプレートにない組み合わせでワークフローを作成したい場合 | 用意されている既存のテンプレートでは実現できない、自社独自のステップ順や組み合わせで自動化を組みたいときに最適です。 |
| 従業員データやサービスに影響なく、安全にテスト（ドライラン）したい場合 | 本番環境へ公開する前に、実際の従業員データや連携サービスに影響しない「ドライラン機能」を使って、安全に動作を確認・試作できます。 |
利用可能なトリガー・アクション
ゼロから作成するワークフローは、トリガーを起点に、実行したいアクションを上から下へ順番に1つずつ追加していくシンプルな設計です。直感的に自動化の手順を組み立てられます。| 種別 | 名前 | 概要・発火タイミング |
|---|---|---|
| トリガー | 新規入社 | 新しい従業員が組織に加わったとき（オンボーディング）に実行されます。 |
| トリガー | 退社 | 従業員が組織を離れたとき（オフボーディング）に実行されます。 |
| トリガー | ディレクトリ定期更新 | 設定したスケジュール：毎日 / 毎週 / 毎月 / カスタム |
| トリガー | デバイス変更 | デバイスレコードのフィールドが変更されたときに実行されます。ご利用にはデバイス機能の利用・デバイス権限が必要です。 |
| トリガー | Webhook トリガー | 外部システムが当サービスにイベントをPOST配信したときに実行されます。 |
| アクション | 変換：データマッピング | ターゲットタイプと変数形式のフィールドごとのマッピング。プロビジョニング等の前に配置します。 |
| アクション | DBアクション：アイデンティティ、デバイス | アイデンティティ（作成 / 参照 / 更新 / 削除）、デバイス（割当 / 割当解除 / 削除 / 更新） |
| アクション | プロビジョニング | 「新規入社」トリガーの後に配置可能。アカウントを付与するワークスペースや連携先を指定します。 |
| アクション | デプロビジョニング | 「退社」トリガーの後に配置可能。アカウントを剥奪するワークスペースや連携先を指定します。 |
| アクション | 通知：Slack / メール | 通知を送るチャンネルや受信者アドレスを指定します。 |
| アクション | フィルター | AND / OR の条件グループと、一致しなかった場合の挙動（停止 vs. 続行）を指定します。 |
| アクション | コミュニケーション：HTTP リクエスト | 外部システムを呼び出すための設定：URL、メソッド、認証、ヘッダー、本文テンプレート、タイムアウトなど |
設定手順
-
自動化 > ［自動化を作成］をクリックし、ダイアログから［新規作成］を選択します。
-
「ビルダー」画面の「1. イベントを選択」をクリックします。
-
「ノードを追加」画面で任意のトリガーを選択すると、画面右側に詳細な設定サイドバーが表示されます。トリガーの条件やフィルターなどを設定します。
各トリガーの設定手順については、以下のリンクをご参照ください。
-
ノード（＋）を選択し、「ノードを追加」画面で任意のアクションを選択します。画面右側に詳細な設定サイドバーが表示されますので、条件を設定します。
各アクションの設定手順については、以下のリンクをご参照ください。
プロビジョニング / デプロビジョニング アクションを設定する場合、必ずその手前のステップに「データマッピング」ノードを配置する必要があります。以下の画面が表示される場合、［データマッピングを追加］をクリックして、画面右側の「データマッピング」を設定します。
- 繰り返し、任意のアクションを追加します。
-
設定完了後に「ビルダー」の全てのチェックが緑色に変わりますので、ドライランまたは［公開］をクリックします。
-
「ワークフロー自動化の設定を確認」画面が表示されますので、自動化名を入力して、［公開］をクリックします。
※自動化名にはご登録済みの名称は登録できません。
-
「ワークフローが公開されました」と表示されますので、［OK］をクリックします。
データマッピング
「ビルダー」画面の「データマッピング」を選択すると、標準IDフィールドと貴社のカスタムIDフィールドが一覧表示されます。 ［サンプルペイロードから自動入力］をクリックして、テスト受信したキーに基づき各フィールドを自動推測します（完全一致 > 前方・後方一致の優先順でマッチング）。保存前に必ず内容を見直してください。一致しなかったフィールドは空欄となり、実行時はスキップされます。上書きする場合、フィールドをクリックして［Insert Variable］から変数を選択するか、直接パス（例：
{{trigger.user_displayName}}）を入力して上書き・指定してください。各フィールドに設定できるのは、1つの {{trigger.X}} のみです。複数入力すると無効になります。
| 項目 | 説明 |
|---|---|
| ターゲット | 現在は、「identity」のみ選択できます。 |
| フィールドマッピング | データソースからターゲットフィールドへの変換ルールを定義します。カスタム項目も設定できます。 |
アイデンティティ
「ビルダー」画面の「アイデンティティ」で対象となるユーザーに対して、以下の操作をします。
| 項目 | 内容 |
|---|---|
| 操作 | アイデンティティに対する操作タイプが以下のように選択されています。・アイデンティティを更新：テンプレート「リアルタイムID同期 / 外部オフボーディング同期」を選択した場合に表示されます。・アイデンティティを作成：テンプレート「外部オンボーディング同期」を選択した場合に表示されます。 |
| パラメータ | パラメータフィールドが動的に表示されます。上記「操作」で表示される操作タイプに応じて、「アイデンティティを更新 パラメータ」「アイデンティティを作成 パラメータ」 が表示されます。{{identity.displayName}}（表示名）や {{identity.primaryEmail}}（メインメールアドレス）などの変数が正しく紐付いているか確認します。役職、部署名、従業員ID、契約終了日などの項目も必要に応じてマッピング可能です。 |
サービス選択（並列実行）
-
「並列実行」>［+別のサービスを追加］をクリックして、ワークフローに設定するサービスを追加します。
-
「プロビジョニング」または「デプロビジョニング」に表示されるサービスを選択します。
表示されるサービスは事前設定（マッピング）したサービスです。複数のサービスをワークフローに設定する場合、「複数選択」をONにします。
-
「並列実行」画面で選択したサービスをクリックすると、右側に「設定」画面が表示されます。
「サービス設定 - ワークスペース名」をプルダウンから選択します。複数のサービスを設定する場合は［+別のサービスを追加］から設定します。
デバイス
「デバイス設定」画面で操作「デバイスを削除 / デバイスの割り当て解除 / デバイスを更新」を選択します。
通知
-
「通知」>［+別の通知を追加］をクリックします。
-
「メッセージ」画面で通知方法「Slack/Email」を選択します。
複数の通知を設定する場合、「複数選択」をONにします。Slackの手順は通知方法「Slack」の設定手順をご参照ください。
-
「通知」画面で選択したメッセージをクリックすると、右側に「設定」画面が表示されます。
HTTP リクエスト
「4. HTTPリクエスト」では、外部APIへのコールバックが必要な場合、メソッド（POST等）やエンドポイントURLを設定します。 送信元では以下の形式でWebhookを送出するよう設定してください。| 項目 | 指定値・要件 |
|---|---|
| エンドポイント | 当サービス上に生成されたWebhook URL |
| メソッド | POST |
| ヘッダー：Content-Type | application/json |
| ヘッダー：X-Timestamp | Unix タイムスタンプ（ミリ秒、文字列） |
| ヘッダー：X-Webhook-Signature | sha256=HMAC-SHA256(secret, ”.”) |
| リクエストボディ | コンパクトなJSON（空白・インデントなし）。送るキーがそのまま変数になります。 |
ドライラン
ワークフロー公開前に、［ドライラン］からテストを実施します。-
［ドライラン］をクリックすると「ドライラン」画面が表示されますので、内容を確認して［ドライランを開始］をクリックします。
-
結果一覧では進行に合わせて、該当のステップがリアルタイムに点灯します。内容を確認して［再実行］または［公開］します。
- テストが完了すると、画面上部のバナーに結果が表示されます。また、ステップ毎の結果一覧が表示されます。モックユーザー（テストアカウント）が作成された場合は、［削除］［保持］を選択します。 テストに成功した場合、［公開］をクリックします。テストに失敗する場合、問題を修正後、再度テストを実行します。
トラブルシューティング
| 症状・エラー | 考えられる原因 | 対処方法 |
|---|---|---|
| Dry Run ボタンがグレーアウトしている | 無効・未設定のノードがある、またはワークフローがアーカイブ済みです。 | 全てのノードの設定を完了し（赤マークなし）、アーカイブ済みの場合は復元してください。 |
| Start dry run が無効になっている | 実在ユーザーの実行には確認チェックが必要です。または対象サービスがテストに非対応です。 | 「I understand this will really run on 」にチェックするか、別の対象SaaSに切り替えてください。 |
| can’t be tested automatically | 該当SaaSがドライランに未対応のサービスです。 | 手動でテストするか、他のSaaSで続行してください。該当SaaSは別途接続してください。 |
| プロビジョニング / デプロビジョニングの「＋」が警告バナーに変わっている | 上にデータマッピングノードが設定されていません。 | プロビジョニング / デプロビジョニングの前にデータマッピングを追加してください。 |
| レビューダイアログで Publish が無効になっている | フロー内のどこかにガードレール違反があります。 | 各違反の横のFixをクリックしてからレビューを開き直してください。 |
| Couldn’t start the test run on the server | 実際のバックエンドトリガーの起動に失敗しました。 | ローカルプレビューは引き続き表示されます。問題が解消してから再実行するか、サポートにお問い合わせください。 |
| オートメーション一覧に「Dry Run draft 」というワークフローが表示される | ドライラン実行前に、未保存のワークフローが無効な下書きとして自動保存されました。 | 本番公開するか、テストが終わったら削除してください。無効な間は本番イベントで実行されません。 |