デザイナー

デザイナーは視覚的なインターフェースを使用してワークフローを作成するためのツールを提供します。 ワークフローとは、特定の目標を達成するために必要な順序、タイミング、決定を含む一連の指示とアクションのことです。 論理木の図を構築してビジュアルプログラミングアプローチを使用してワークフローを作成します。

既存のアクティブなワークフローデザインに変更を加える前には、必ず最初にワークフローを無効にしてください。 これにより、変更がワークフローデザインを無効にした場合の変更の損失を防ぎます。

デザイナーページにアクセスする

デザイナーインターフェースにアクセスするために:

  1. メインメニューからワークフローを選択し、ナビゲーションパネルからワークフローを管理を選択します。

  2. 関連するワークフロー名を選択し、バージョン タブをクリックします。

  3. 既存のワークフローバージョンにカーソルを合わせると、表の右側にアクションメニューが表示されます。

  4. アクションメニューをクリックして、編集 を選択し、ワークフローロジックを編集します。

デザイナーインターフェースの理解

インターフェースには5つの主要要素が含まれています。

Workflow designer
  1. タブ:デザイナーとNEALタブを切り替えてワークフローを調整します。 システムは、他のタブに切り替えるたびに変更を保存するように促します。 NEALのスクリプトの機能に関する詳細はNEAL ドキュメントを参照してください。

  2. キャンバス:キャンバススペースを使用して、シンクレットとフローコントロールを論理木の図に接続します。 ツールバーから要素を既存のコードブロックにドラッグアンドドロップする。 各ワークフローは開始ブロックで始まり、終了状態で終わります。 ワークフローには複数のブランチを持てるため、複数の終了状態が生じる可能性があります。

  3. ツールバー:ツールバーを使用して、シンクレットとフローコントロールによりワークフローの構成ブロックを追加および定義し、ワークフルーパラメータを設定する。 詳細については、シンクレットの追加と削除セクションを参照してください。

  4. ワークフローマップ:ワークフローマップコントロールを使用して、ワークフロー全体を拡大・縮小し、フレームに収める。

  5. ワークフローを保存 または 閉じる: 変更を確定するには ワークフローを保存 ボタンをクリックし、変更を保存せずにデザイナースペースを 閉じる こともできます。

シンクレットの追加と削除

キャンバスにシンクレットとフローコントロールを追加するには、ツールバーのツールボックスタブをクリックします。

  • ワークフローを作成するには、要素をドラッグしてキャンバスにドロップします。 キャンバスの上に要素を移動すると、駐車スペースが表示されます。 駐車スペースにシンクレットを接触させてドロップし、確認します。

  • キャンバスから要素を削除するには、ゴミ箱アイコンをクリックします。

デザイン外の任意の場所にシンクレットをドロップすると、操作がキャンセルされ、デザインは変更されません。

image-20240205-151644.png

既存のパスへのシンクレットの追加

  • シンクレットを追加するには、ツールボックスから既存の接続パスにシンクレットをドラッグします。 シンクレットが正しい位置にある場合は、水平線が表示され、シンクレットを追加できることを示します。

  • シンクレットを接続パス上にドロップします。

AddThinkletsToExistingPath.png

Thinkletを他のワークフローブランチに接続する

ワークフローの特定のステップをスキップし、その後でフローに再参加する必要がある場合があります。たとえば、デバイスにインストールされたソフトウェアがすでにワークフロー内にあるかどうかを確認する条件がある場合など。 この場合、ソフトウェアのインストールステップをスキップし、残りの構成を続行したい可能性があります。

  • 接続のないパスの最後のThinkletまたはフローコントロールにカーソルを合わせます。 Thinkletの下部に点滅する点が表示されます。

    SkippingWorflowConfiguration.png
  • ドットからクリックして線を引く。 すべての有効な接続ターゲットであるThinkletとフローコントロールの上に点が表示されます。

  • 点線を関連するシンクレットまたはフローコントロールに接続するには、シンクレットの脈動する点に点線を接続します。

ConnectingThinklets.png

シンクレットまたはフローコントロールに複数のパスが存在する場合、接続パスの1つを削除することができます。 パスを削除するには:

  1. 関連する接続パスをクリックすると、線が太字で表示されます。

  2. Backspace/Deleteキーを押します。

RemoveThinklets.png

ブランチの接続と不要なパスの削除方法は、条件ブランチ間でワークフローの大きなセクションを切り替えるためにも使用できます。

ワークフローデザインの問題をレビューする

システムは、ワークフローデザインの有効化を妨げる問題を ワークフローを保存 をクリックしたときに、ツールバーのエラーセクションに表示します。

リストを確認し、問題を特定して修正することで、有効なワークフローデザインを確保してください。

既存の問題が解決された後、さらなる問題を含む可能性のあるバリデーション問題のリスト。 これは、他のデザイン要素のさらなるバリデーションを妨げるいくつかの問題によるものです。

NEALエディターではバリデーションメッセージは利用できません。 その代わりに、保存してリストを確認するためにデザイナーに戻ってください。

ツールバーから要素を追加したら、クリックしてプロパティを表示します。

シンクレットの設定

Thinkletを設定して、リモートアクションを実行したり、キャンペーンを開始したり、サービス/APIと統合したり、Microsoft TeamsのNexthinkチャネルを介して従業員と直接通信したりできます。

Thinkletの設定に関する詳細情報については、Thinkletの設定 ドキュメントを参照してください。

フローコントロールの設定

条件フローコントロール

条件フローコントロールブロックは、Nexthinkデータまたはワークフローによって収集された値に基づいてワークフローを分岐させます。 システムは、ワークフローの実行がそこに達した時点でのみ条件を評価します。

条件は1つの出口ポイントしか受け付けず、ワークフローによる並列処理はサポートされていません。

条件に有効な出口がない場合、ワークフローは実行を停止します。

条件が評価できる値は以下の通りです:

  • シンクレット出力

    • リモートアクションの出力

    • キャンペーン応答

    • サービス/API出力

  • ワークフローパラメータ

  • データベースオブジェクト

    • device

    • user

  • カスタム値

条件は以下の演算子を使用して値を比較します:

  • である

  • でない

  • より大きい

  • より小さい

  • 以上

  • 以下

  • 含む

  • 含まない

  • 空である

  • 空でない

システムは、使用可能な演算子のリストを、特定のデータ型で使用できるものに基づいてフィルタリングしません。 比較しているデータのタイプで特定の演算子を使用できることを確認してください。

Condition flow control
  • 名前:条件フローコントロールのために一意の名前を入力します。

  • ID:システムは名前に基づいてIDを自動的に生成します。

  • Description (optional): Describe the purpose of the condition and what it does. この情報は、ワークフローに詳しくない可能性がある他のユーザーにとって役立ちます。

  • 条件を追加:条件フローコントロールに条件を追加します。

    • 一意の名前を入力します。 この名前は、キャンバスおよびNEALスクリプトに表示されます。

    • 条件のソースと値を選択します。

    • 演算子を選択します。

    • テストされるソースと値を選択します。

    • 必要な条件を追加します。

  • 完了をクリックして変更を確定します。

キャンバスにブランチが表示されたら、その下にThinkletや他のフロー制御ブロックを追加できます。

ワークフローデザインから条件を削除すると、その下のデザイン要素も失われます。

待機フローコントロール

待機フローコントロールを使用すると、ワークフローを一時停止して、一定期間または外部システムからのAPIコールを待つことができます。 これは、システムが制御できない何かを待たなければならない場合に便利です。

待機には2つのタイプがあります:

  • 時間遅延

  • APIリスナー

時間遅延

時間遅延が選択され設定されると、指定された時間待機し、その後時間が経過すると自動的に続行します。

  • 名前:待機フローコントロールのために一意の名前を入力します。

  • ID: システムは名前に基づいてIDを自動的に生成します。

  • Description (optional): Describe the purpose of the Wait and what it does. この情報は、ワークフローに詳しくない可能性がある他のユーザーにとって役立ちます。

  • タイプ: 必要な待機タイプを選択します。

  • 値: 遅延時間を分または時間で設定します。 この時間だけワークフローが停止し、その後次のステップに進みます。

APIリスナー

APIリスナーを選択すると、ワークフローは一時停止し、APIコールがトリガーWaitFor Eventワークフローのエンドポイントに届くのを待ちます。 詳しくは、Workflows API ドキュメントを参照してください。

Nexthinkへのコールを行う外部システムからデータをキャプチャするために、最大5つの出力を設定します。 これらの出力を使用して、ワークフロー内で条件を用いて分岐判断を行ったり、後続のシンクレットに入力情報を提供したりします。

  • 名前:待機フローコントロールのために一意の名前を入力します。

  • ID: システムは名前に基づいてIDを自動的に生成します。

  • Description (optional): Describe the purpose of the Wait and what it does. この情報は、ワークフローに詳しくない可能性がある他のユーザーにとって役立ちます。

  • タイプ: 必要な待機タイプを選択します。

  • タイムアウト: タイムアウトを分または時間で設定します。 これにより、望ましいAPIコールを待機する時間が決まります。 タイムアウト制限に達すると、ワークフローは失敗状態に入り処理が停止します。

  • Outputs: Configure up to 5 outputs which are collected from the API call being listened for. 出力のIDはTrigger WaitFor Eventワークフローエンドポイントに対して行われるコールのボディのパラメータとして使用されます。

Wait-APIリスナーを使用するには、外部システムが連携する実行およびワークフローを把握していることを確認してください。;

{{sys.workflow.executionId}}および{{sys.workflow.workflowId}}変数をService\APIシンクレット経由で送信してこの情報を伝達します。 その後、サードパーティシステムはこの情報を記録し、ワークフローと連携します。 これらの値の使用例については、システム値のフォーマット例をご覧ください。

終了ブロックフローコントロール

エンドブロックは、ワークフローの結果を定義できる場所です。 システムがワークフローロジックを実行して終了ブロックに達すると、その結果と結果の詳細が保存され、NQLでクエリすることが可能です。 いくつかのブランチを1つのエンドブロックにリンクすることは可能ですが、同じエンドの結果が報告される場合にこのオプションを使用してください。

結果および結果の詳細フィールドを使用して、ワークフロー実行の詳細情報を取得し、ダッシュボードにKPIとして表示します。

End block
  • 名前: Endブロック用にユニークな名前を入力してください。

  • ID: システムはその名前に基づいてIDを自動的に生成します。

  • 説明 (任意): このロジックツリーのポイントで予想されるワークフローの結果を説明してください。 この情報は、そのワークフローに精通していない他のユーザーにとって有用です。

  • 結果: このポイントで何が起こるかを最もよく説明する結果を固定リストから選択してください:

    • 操作が行われた

    • 操作が行われていない

    • 失敗

    • その他

  • 結果の詳細 (任意): ワークフローがEndブロックに達したときに何が起こるかを説明してください。 このフィールドの文字数制限は64文字です。 この説明はダッシュボードで使用される可能性があるため、Nexthinkはこれを簡潔に保つことを推奨しています。

Connectorsの設定

コネクタは構成セットを使用して、サードパーティAPIへのインテグレーションイベントをすばやく設定します。 Nexthink は、以下のサードパーティアプリケーションとのコネクタ構成をサポートしています: Microsoft Entra ID、Microsoft Outlook、ChatGPT、および ServiceNow。

image-20240612-094700.png

コネクタThinkletの設定方法についての詳細は、コネクタThinkletの設定ドキュメントを参照してください。

ワークフローパラメーターの定義

ワークフローの実行開始時に値を設定するために、ワークフローのパラメーターを定義して、実行される操作をパラメーター化します。

パラメーターと動的値に関するドキュメントを参照して、パラメーターの使用法と設定方法についての詳しい情報を得てください。

ワークフローの詳細を定義する

ツールバーのワークフロー詳細セクションを使用して、ワークフローに説明を追加します。 ワークフロー設計の目的と、他のユーザーがレビューおよび編集する際に知っておくべき追加の情報を説明してください。

ワークフロー設計の問題をレビューする

システムは、ワークフローデザインに有効性や有効化を妨げる問題がある場合、それをツールバーのエラーセクションに表示します。ワークフローを保存をクリックすると表示されます。

リストを確認し、特定された問題を修正して、有効なワークフロー設計ができているか確認してください。

検証のリストは、既存の問題が解決された後、さらなる問題を含む場合があります。 設計の他の要素のさらなる検証を妨げるいくつかの問題があるためです。

バリデーションメッセージはNEALエディターで利用できません。 その代わりに、保存してリストを確認するためにデザイナーに戻ってください。

関連トピック

Last updated

Was this helpful?