フローの構築とテスト

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

はじめに

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

  1. フローのカードとフィールドについて学習します。「Workflowの要素」を参照してください。

  2. Oktaコネクターの接続を作成します。Oktaアカウントの認証を参照してください。

  3. （オプション）フローに他のアプリケーションの接続を作成します。

フローの構築

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

  1. Okta Admin ConsoleでWorkflow > Workflowsコンソール（Workflows console）に移動します。

  2. Workflowsコンソールで、フロー（Flows）タブを開きます。

  3. フォルダーを作成し、フォルダー名を選択してフォルダーを開きます。

  4. +新規フロー（+New Flow）をクリックします。

  5. 最初のカードでイベントの追加（Add Events）をクリックします。

  6. イベントが発生するアプリを選択し、利用可能なイベントからイベントを選択します。

    • アプリをまだ接続していない場合は、新規接続（New Connection）をクリックし、必要な情報を入力します。ヘルプが必要？（Need help?）をクリックすると、アプリに固有のヘルプがこのウィンドウに表示されます。

    • すでにアプリに接続していているが、複数のアカウントがある場合は、使用するアカウントを1つ選択します。

  7. 2番目のカードでアプリアクションを追加（Add app action）または関数を追加（Add function）をクリックします。

    • アクションカードはアプリケーションにコマンドを送信します。イベントが発生するアプリを選択し、利用可能なアクションからアクションを選択します。まだアプリを接続していないときは、接続するよう求められます。Okta疑問符アイコン（）をクリックすると、アクションカードに固有のヘルプが表示されます。

    • 関数カードは、データをカードまたは分岐から別の論理フローに移動します。分岐やエラー処理などのロジック関数や、作成カードなどのデータ操作関数を選択できます。HTTPリクエストの実行やJSON文字列の解析を行う高度な関数を選択することもできます。疑問符アイコン（）をクリックすると、関数固有のヘルプがコンソールに表示されます。

  8. フローで同じカードの別の同一インスタンスが必要な場合は、カードの下部にある複製（Duplicate）オプションを使用します。

  9. カード間でデータをマッピングします。あるカードから出力をドラッグして、別のカードの入力にドロップします。この際、フィールド タイプが一致していることを確認してください。

    フローを構築しているときに、をクリックして任意のカードの機能をテストできます。マッピングに問題がないか確認するには、カードを個別にテストすることをおすすめします。

  10. フローを保存するときは、保存（Save）をクリックするか、CTRL+S（Windows）または⌘+S（macOS）のキーボードショートカットを使用します。まだフローに名前を付けていない場合は、ここで名前を付けることができます。

フローのテスト

フローをテストするには2つの方法があります。

  1. イベントカードにデータを手動で入力できます。

  2. アプリ内でイベントをトリガーできます。

データの手動入力

  1. Workflowsコンソールで実行（Run）をクリックします。

  2. フローを実行（Run Flow）ウィンドウで、カードフィールドにテストデータを手動で入力します。

  3. 実行（Run）をクリックします。コンソールビューにフローの進捗が表示されます。実行に成功したカードの名前フィールドにはチェック マークが表示されます。

  4. フローでエラーが発生した場合、詳細を確認し、フローに戻る（Back to Flow）をクリックして修正します。

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

  1. Workflowsコンソールでフローがオフ（Flow is OFF）をオン（ON）に切り替えます。

  2. フローを実行するには、実行（Run）ボタンをクリックするか、CTRL+SHIFT+ENTER（Windows）または⌘+SHIFT+ENTER（macOS）のキーボードショートカットを使用します。

    フローがイベントカードからトリガーされるときは、フローをアクティブ化するテストイベントを作成できます。

    • Oktaでイベントが発生する場合は、フローをトリガーするアクションをAdmin Consoleから実行します。たとえば、ユーザーがSalesforceアプリに割り当てられるたびにフローが実行される場合は、アプリケーション（Applications） > アプリケーション（Applications）に移動し、Salesforceにテストユーザーを割り当てます。

    • イベントが別のアプリケーションからトリガーされる場合は、アプリに移動してアプリからテストイベントをトリガーする必要があります。

  3. フローの進捗を確認するにはWorkflowsコンソールに戻ります。実行に成功したカードの名前フィールドにはチェック マークが表示されます。

  4. フローでエラーが発生した場合は、詳細を確認し、フローに戻る（［Back to Flow）]をクリックして修正します。

実行履歴の確認

過去30日間のすべてのフロー実行のログを実行履歴（Execution History）ページで確認します。実行履歴ペインは、完了したOkta Workflowsと進行中のWorkflowsで並べ替えることができます。

実行履歴からレコードを選択すると、フローのすべての実行がWorkflowsコンソールに表示されます。

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

関連項目

Workflows要素

アプリケーションの接続

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