フローの構築とテスト

ワークフロー コンソールではドラッグアンドドロップ インターフェースを使って独自のフローを構築します。フローの各イベントとアクションは標準搭載のコネクターに対応しているため、コードやAPIを使用しなくても他のアプリケーションと情報をやりとりできます。アプリケーションを接続し、イベントとアクションを指定して情報を入力するだけです。

はじめに

フローを構築する前に次の作業を行います。

  1. Okta Workflowsの要素についてを確認します。
  2. を必ず行ってください。
  3. (オプション)フローにアプリケーションの接続を作成します。

フローの構築

この手順では、フローの構築に必要な一連の基本コマンドについて説明します。仕組みを理解したら、実際のユースケースで使えるフローをいくつか構築してみてください。「Okta Workflowsのユースケース」を参照してください。

  1. 管理コンソールで[Workflow(ワークフロー)]> [Workflows console(ワークフロー コンソール)]に移動します。
  2. ワークフロー コンソールで [New Flow(新規フロー)]をクリックします。
  3. 最初のカードで[Add(追加)] [Event(イベント)]をクリックします。
  4. イベントが発生するアプリを選択し、利用可能なイベントからイベントを選択します。
    • アプリをまだ接続していない場合は、[New Connection(新規接続)]をクリックし、必要な情報を入力します。[Need Help?(ヘルプが必要ですか?)]をクリックすると、このウィンドウにアプリ固有のヘルプが表示されます。
    • アプリを接続していて、複数のアカウントがある場合は、使用するアカウントを1つ選択します。
  5. 2番目のカードで[App Action(アプリアクション)][Function(機能)]をクリックします。
    • [App Action(アプリアクション)]カードはアプリケーションにコマンドを送信します。アクションが発生するアプリを選択し、利用可能なアクションからアクションを選択します(まだアプリを接続していない場合は、接続するよう促すメッセージが表示されます)。 []をクリックすると、アクション固有のヘルプがコンソールに表示されます。
    • [Function(関数)]カードは、カードか分岐からデータを別の論理フローに移動します。分岐やエラー処理などのロジック関数を選択したり、作成カード、リスト、テーブルなど、データを操作する関数を選択したりできます。HTTP リクエストを行ったり、JSON 文字列を解析する高度な関数を選択することもできます。ただし、関数カードにアプリを選択しないよう注意してください。 []をクリックすると、関数固有のヘルプがコンソールに表示されます。
  6. フローにアクションや関数、メモをさらに追加するには、[Add Another(さらに追加)]メニューを使用します。
  7. カード間でデータをマッピングします。あるカードから出力をドラッグして、別のカードの入力にドロップします。この際、フィールド タイプが一致していることを確認してください。
  8. メモ: フローの構築中は[]をクリックして任意のカードをテストできます。マッピングに問題がないか確認するには、カードを個別にテストすることをおすすめします。

  9. []をクリックします。まだフローに名前を付けていない場合は、ここで名前を付けることができます。
  10. フローを手動でテストする場合は、[Add Another(さらに追加)]メニューから[Save and Test(保存してテスト)]オプションをクリックします。


フローのテスト

イベント カードへのデータの手動入力と、アプリ自体でのイベントのトリガーという2つの方法でフローをテストできます。さきほどの[Save and Test(保存してテスト)]メニュー オプションを選択した場合、手動による方法のステップ2に進みます。

メモ: フローが有効になるまで約60秒かかります。フローを保存して有効にしたら、1分間待機してからそれをトリガーします。

データの手動入力

  1. ワークフロー コンソールで[]をクリックします。
  2. [Check for new data(新しいデータの確認)]ウィンドウで、カード フィールドにテスト データを手動で入力します。
  3. [Test(テスト)]をクリックします。コンソール ビューにフローの進捗が表示されます。実行に成功したカードの名前フィールドにはチェック マークが表示されます。
  4. フローでエラーが発生した場合、詳細を確認し、[Back to Flow(フローに戻る)]をクリックして修正します。

アプリでのフローのトリガー

  1. ワークフロー コンソールで[Flow is OFF(フローがオフ)][ON(オン)]に切り替えます。
  2. Oktaインスタンスで、イベント カードに記載されているアクションを実行します。
    • Oktaでイベントが発生する場合、フローをトリガーするアクションを管理コンソールから実行します。 たとえば、ユーザーがSalesforceに割り当てられるたびにフローを実行する場合、[Applications(アプリケーション)]> [Applications(アプリケーション)]に移動し、Salesforceにテスト ユーザーを割り当てます。
    • 別のアプリケーションでイベントが発生する場合、ホーム ページに移動してアプリを起動し、そこでイベントをトリガーします。
  3. フローの進捗を確認するにはワークフロー コンソールに戻ります。実行に成功したカードの名前フィールドにはチェック マークが表示されます。
  4. フローでエラーが発生した場合、詳細を確認し、[Back to Flow(フローに戻る)]をクリックして修正します。

フロー履歴の確認

過去30日間で実行したすべてのフローのログを[Flow History(フロー履歴)]で確認します。完了したフローと進行中のフローで[Flow History(フロー履歴)]ウィンドウを並べ替えることができます。

[Flow History(フロー履歴)]からレコードを選択すると、フローのすべての実行がワークフロー コンソールに表示されます。

  • フローの結果、期間、時間が[Execution Details(実行の詳細)]ウィンドウに表示されます。
  • 入力フィールドと出力フィールドにはあらかじめ情報が入力されており、各カードの正常な実行にかかった時間が緑のチェック マークの下に表示されます。
  • フローが停止した場合、無効なデータを含むカードがエラーとしてマークされます。
  • 他のアプリケーションから未加工のエラー情報が提供された場合、デバッグのためにその情報が含まれます。
  • フローを有効にした直後にフローをトリガーした場合、そのフローは[Flow History(フロー履歴)]に表示されません。 60秒待ってから再試行してください。

関連項目

フローの構築について

アプリケーションの接続

ユース ケース チュートリアル