デザイナー
Last updated
Last updated
デザイナーは、ビジュアルインターフェースを使用してワークフローを作成するためのツールを提供します。 ワークフローは、特定の目標を達成するために必要な順序、タイミング、意思決定を含む指示とアクションのセットです。 ロジックツリーダイアグラムを構築することで、ビジュアルプログラミングのアプローチを使用してワークフローを作成します。
既存のアクティブなワークフローデザインに変更を加える前に、必ずワークフローを無効化してください。 これは、変更によりワークフローデザインが無効になる場合に変更が失われるのを防ぎます。
デザイナーインターフェースにアクセスするには:
メインメニューからワークフローを選択し、ナビゲーションパネルからワークフロー管理を選択します。
関連するワークフロー名を選択し、バージョンタブをクリックします。
既存のワークフローバージョンにカーソルを合わせると、テーブルの右側にアクションメニューが表示されます。
アクションメニューをクリックし、ワークフローロジックを編集するを選択します。
インターフェースには5つの主要な要素が含まれています。
タブ: デザイナーとNEALのタブ間を切り替えてワークフローを微調整します。 システムは、他のタブに切り替えるたびに変更を保存するよう促します。 NEALのスクリプト機能についての詳細は、NEALのドキュメントを参照してください。
キャンバス: キャンバス領域を使用して、Thinkletとフローコントロールをロジックツリーダイアグラムに接続します。 ツールバーから既存のコードブロックに要素をドラッグアンドドロップします。 各ワークフローは開始ブロックから始まり、終了状態で終わります。 ワークフローに複数の分岐がある場合、複数の終了状態が生じることがあります。
ツールバー: ツールバーを使用して、Thinkletとフローコントロールを用いたワークフローの構築ブロックを追加および定義し、ワークフローパラメータを設定します。 詳細については、Thinkletの追加と削除セクションを参照してください。
ワークフローマップ: ワークフローマップコントロールを使用して、ズームインおよびズームアウトし、ワークフロー全体をフレーム表示します。
ワークフローの保存または閉じる: ワークフローの保存ボタンをクリックして変更を確定するか、変更を保存せずにデザイナースペースを閉じることができます。
ツールバーのツールボックスタブをクリックして、キャンバスにThinkletとフローコントロールを追加します。
ワークフローを作成するには、要素をドラッグしてキャンバス上にドロップします。 キャンバス上に要素を移動すると、駐車スペースが表示されます。 Thinkletを駐車スペースに触れてドロップして確認します。
キャンバスから要素を削除するには、ごみ箱アイコンをクリックします。
デザイン外の場所にThinkletをドロップすると、そのアクションはキャンセルされ、デザインには変更が加えられません。
Thinkletを追加するには、ツールボックスから既存の接続パスにThinkletをドラッグします。 Thinkletが正しい位置にある場合、水平線が表示され、Thinkletを追加できることを示します。
接続パスにThinkletをドロップします。
条件がデバイスにインストールされているソフトウェアを確認する必要がある場合など、ワークフローの特定のステップをスキップし、後でフローに再結合する必要があることがあります。 この場合、ソフトウェアのインストール手順をスキップし、残りの設定を続行したい場合があります。
接続のないパスの最後のThinkletまたはフローコントロールにカーソルを合わせます。 Thinkletの下にパルスするドットが表示されます。\
ドットをクリックしてドラッグし、線を描きます。 すべてのThinkletとフローコントロールの上部にドットが表示され、接続対象として有効です。
ドット線を該当するThinkletまたはフローコントロールに接続し、Thinkletのパルスするドットにドット線を付けます。
Thinkletやフローコントロールに複数の経路がつながる場合、接続経路の1つを削除することができます。 パスを削除するには:
該当する接続経路をクリックすると、線が太字で表示されます。
Backspace/削除ボタンを押します。
 
枝を接続して不要な経路を削除する方法は、ワークフローの大きな部分を条件分岐の間で切り替えるためにも使用できます。
ワークフローデザインに問題があり、有効化とアクティベーションを妨げる場合、ワークフローの保存ボタンがクリックされたときにツールバーのエラーセクションに表示されます。
リストをレビューし、特定された問題を修正して、ワークフローデザインが有効であることを確認してください。
既存の問題が解決された後に、検証の問題リストにさらに問題が含まれることがあります。 これは、いくつかの問題がデザインの他の要素のさらなる検証をブロックしているためです。
NEALエディタでは検証メッセージは使用できません。 リストをレビューするには、保存してデザイナーに戻る必要があります。
ツールバーから要素を追加したら、クリックしてそのプロパティを表示します。
リモートアクションThinkletは、ワークフローでターゲットにされたデバイスにリモートアクションを送信します。
名前: リモートアクションThinklet用にユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: Thinkletの目的とその動作を説明します。 この情報は、ワークフローを知らない他のユーザーに役立ちます。
タイムアウト: タイムアウトを分または時間で設定します。 リモートアクションからの応答を待つ時間を決定します。タイムアウトになると、ワークフローは失敗状態になり、処理が停止します。 タイムアウト制限に達すると、ワークフローが失敗状態に入り、処理が停止します。
リモートアクションを選択: Thinkletが実行するリモートアクションを特定します。 リモートアクションは、リストに表示されるためにワークフロートリガーが設定されていなければなりません。
デバイスを選択: リモートアクションを実行するデバイスを選択します。 実行されたワークフローに対してデバイスを適用するには、デバイスを選択入力フィールドがターゲットデバイスに設定されていることを確認してください。
パラメータ: リモートアクションに必要なパラメータを設定します。
リモートアクションにパラメータが定義されている場合、リモートアクションページのスクリプトタブでカスタム値を入力可能にする設定をします。
出力: リモートアクションの出力を確認します。
リモートアクションの状態を条件で評価するときには、以下の値を使用します:
0は失敗
1は成功
ターゲットデバイス以外のデバイスを選択して、サービスとして実行するように設定されたリモートアクションを使用する場合、そのデバイスで適切にCollectorを設定してください。 設定の詳細については、リモートアクションをサーバーデバイスでサービスとして実行するドキュメントを参照してください。
出力: リモートアクションの出力を確認します。
キャンペーンThinkletは、ワークフローによりターゲットにされたデバイスの従業員にキャンペーンを送信します。
ワークフローは、キャンペーン中の単一回答の質問の回答を条件で定義された意思決定に使用したり、ワークフロー内の他のThinkletへの入力として利用したりします。
名前: キャンペーンThinklet用にユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: Thinkletの目的とその動作を説明します。 この情報は、ワークフローを知らない他のユーザーに役立ちます。
タイムアウト: タイムアウトを分または時間で設定します。 キャンペーンからの応答を待つ時間を決定します。タイムアウトになると、ワークフローは失敗状態になり、処理が停止します。 キャンペーンを選択: Thinkletが送信するキャンペーンを特定します。
キャンペーンを選択: Thinkletが送信するキャンペーンを識別します。 このリストにキャンペーンが表示されるために必要な条件は次の通りです:
キャンペーントリガーがワークフローに設定されていること。
キャンペーン内に単一回答の質問のみが含まれていること。
キャンペーンが公開されていること。
パラメータ: キャンペーンのパラメータを設定します。 このオプションは、選択したキャンペーンがパラメータを受け入れるように設定されている場合にのみ表示されます。
キャンペーンを延期して従業員が再び見ることを望む場合、キャンペーンThinkletのタイムアウト値を6時間以上に設定します。
サービス/API Thinkletは以下のコネクタ認証タイプをサポートしています:
基本
ベアラー
OAuth 2.0 - クライアントクレデンシャル
OAuth 2.0 - 認証コード
サービス/API Thinkletは、外部のパブリックAPIに対してRESTコールを行います。 追加情報の取得やアクションの実行リクエストにこれを使用します。
サービス/API Thinkletは以下のコール方法をサポートしています:
GET
POST
PATCH
PUT
DELETE
サービス/API ThinkletのサポートされているペイロードとレスポンスはJSON形式です。
名前: サービス/API Thinklet用にユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: Thinkletの目的とその動作を説明します。 この情報は、ワークフローを知らない他のユーザーに役立ちます。
証明書: 統合のための接続証明書を選択します。 最初にAdministrationモジュールのConnector証明書ページで設定する必要があります。 詳しくは、コネクタ証明書ドキュメントを参照してください。
リクエストメソッド: リクエスト接続方法を選択します。
リソース: 接続のエンドポイントを入力します。
ペイロード: 外部システムに送信されるJSONペイロードを入力します。
サービス/API Thinkletは、外部システムへのコールから受け取ったレスポンスからデータを読み取ることができます。
最大5つの出力をサポートしています。
レスポンスを待っているとき、サービス/API Thinkletは、外部システムからのレスポンスを最大10秒間待ち、その後、コールは失敗したと見なされます。
レスポンスが受信されたとき、外部システムから受信するレスポンスの合計サイズは、出力が設定されているかどうかにかかわらず2MBを超えてはなりません。
これらの出力を設定するには:
出力を追加をクリックします。
名前: 条件やThinklet入力のリファレンスとして使用する名前を入力します。
JSONパス: システムが受信することを期待するデータのJSONパスを追加します。 このパスは常に**$.**で始まり、その後にドットで区切られたデータへのパスが続きます。 ServiceNowからのインシデント番号をキャプチャする例:
JSON Path出力に許容される最大サイズは30 KBまたは3840文字です。
ワークフローの実行中に収集されたユーザーとデバイスのデータを、リソースおよびペイロードフィールドに参照します。
データへの参照を二重中括弧で含めます:
Nexthinkデータベース属性を使用してServiceNowへのペイロードの例:
システム値は、現在のワークフロー実行の参照を提供するために使用できます。 これは、ワークフローがサードパーティシステムのアクションを待つ必要があり、その後ワークフローを進行させるためにコールバックを行うケースで有効です。
システム値は常にsys.workflowで始まります。
これらの値のリストは以下に示されています。
sys.workflow.executionId: 現在実行されているワークフロー実行のIDへの参照です。
sys.workflow.workflowId: 実行中の特定のワークフローデザインへの参照です。
次に、これらの値がワークフローを後で進めるためにチャットボットによって使用されるMoveworksチャットボットとの統合のコンテキストでの使用例を示します。
ワークフローの他のThinkletからの出力を参照するときは、次のフォーマットを使用します:
以前のService/API Thinkletからのデータを含むServiceNowインシデント更新リソースの例:
データ属性を取得する際には、デバイスおよびユーザーオブジェクトからデータを収集することができます。 オブジェクトのデータは、ワークフロー実行中のデバイスまたはユーザーに基づいています。
このデータにアクセスするフォーマットは次の通りです:
デバイス属性の参照例:
ユーザー属性の参照例:
サポートされている属性のリストについては、デバイスおよびユーザーのセクションを参照し、フィールド列に含まれる値を属性名として使用してください。 詳細はNQLデータモデルをご確認ください。
条件ベースのフロー制御ブロックは、ワークフローやNexthinkデータによって収集された値に基づいてワークフローの分岐を可能にします。 システムは条件を1回だけ評価し、ワークフロー実行がその段階に到達した時点で評価されます。
条件は1つの出口ポイントしか受け付けません。ワークフローは並列処理をサポートしていません。
条件に有効な出口ポイントがない場合、ワークフローの実行は停止します。
条件が評価できる値は以下の通りです：
シンクレットの出力
リモートアクションの出力。
キャンペーンの応答。
サービス/APIの出力。
ワークフローパラメーター
databaseオブジェクト
device
ユーザー
カスタム値
条件は以下の演算子を使用して値を比較します：
である
でない
より大きい
より小さい
以上
以下
含む
含まない
空である
空でない
使用可能な演算子のリストは、指定されたデータ型で使用できるものに基づいてフィルタリングされていません。 比較しているデータの種類で指定された演算子を使用できることを確認してください。
名前: 条件ベースのフロー制御にユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: 条件の目的とその役割を説明します。 この情報は、ワークフローに不慣れな他のユーザーにとって有益です。
条件を追加: 条件ベースのフロー制御に条件を追加します。
ユニークな名前を入力します。 この名前はキャンバスおよびNEALスクリプトに表示されます。
条件のソースと値を選択します。
演算子を選択します。
テスト対象のソースと値を選択します。
必要なだけ多くの条件を追加します。
完了 をクリックして変更を確定します。
キャンバス上にブランチが表示され、シンクレットや他のフロー制御ブロックをその下に追加できるようになります。
ワークフロー設計から条件を削除すると、その条件の下にある設計要素も失われます。
待機フロー制御を使用すると、ワークフローを一時停止し、一定時間または外部システムからのAPI呼び出しを待つことができます。 これは、システムが制御できない何かを待たなければならない場合に役立ちます。
待機には2つのタイプがあります：
時間遅延
APIリスナー
時間遅延が選択され設定されると、ワークフローは指定された時間を待機し、その時間が経過すると自動的に続行されます。
名前: 待機フロー制御にユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: 待機の目的とその役割を説明します。 この情報は、ワークフローに不慣れな他のユーザーにとって有益です。
タイプ: 必要な待機のタイプを選択します。
値: 遅延時間を分または時間で設定します。 ワークフローは次のステップに進む前に、この時間だけ一時停止します。
APIリスナーが選択されると、ワークフローは一時停止し、Trigger WaitFor Eventワークフローエンドポイントに対して行われるAPI呼び出しを監視します。 詳細については、ワークフローAPIドキュメントを参照してください
Nexthinkへの呼び出しを行う外部システムからのデータをキャプチャするために、最大5つの出力を設定することができます。 これらの出力を使用して、ワークフロー内で条件による分岐判断を下したり、後続のシンクレットに入力情報を提供することができます。
名前: 待機フロー制御にユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: 待機の目的とその役割を説明します。 この情報は、ワークフローに不慣れな他のユーザーにとって有益です。
タイプ: 必要な待機のタイプを選択します。
タイムアウト: タイムアウトを分または時間で設定します。 これは、望ましいAPI呼び出しをワークフローが待機する長さを決定します。 タイムアウトの制限に達すると、ワークフローは失敗状態に入り、処理が停止します。
出力: 監視しているAPI呼び出しから収集された最大5つの出力を設定します。 出力IDは、Trigger WaitFor Eventワークフローエンドポイントへの呼び出しのボディにパラメーターとして使用されます。
待機フロー - APIリスナーを使用するには、外部システムが対話するワークフローの実行とワークフローを認識していることを確認してください。
この情報を{{sys.workflow.executionId}}および{{sys.workflow.workflowId}}変数を通じてサービス/APIシンクレットを使用して送信します。 サードパーティシステムはこの情報を記録してワークフローとインタラクトします。 これらの値の使い方の例については、システム値の形式 を参照してください。
エンドブロックフロー制御は、ワークフローの終了を指定します。 各ブランチの末尾にエンドブロックを配置します。
エンドブロックは、ワークフローの結果を定義できる場所でもあります。 システムがワークフローのロジックを実行しエンドブロックに到達すると、結果とその詳細が記録され、NQLでクエリすることができます。
結果と結果の詳細フィールドを使用してワークフローの実行に関する詳細情報を取得し、ダッシュボードでKPIとして表示します。
名前: エンドブロックにユニークな名前を入力します。
ID: システムは名前に基づいて自動的にIDを生成します。
説明（オプション）: この時点のロジックツリーで予想されるワークフローの結果を説明します。 この情報は、ワークフローに不慣れな他のユーザーにとって有益です。
結果: この時点での状況を最もよく説明している結果の一覧から選択します：
アクション実行済み
アクション未実行
失敗
その他
結果の詳細（オプション）: ワークフローがエンドブロックに到達すると何が起こるかを説明します。 このフィールドの文字数制限は64文字です。 情報がダッシュボードで使用される場合に備えて、この説明は簡潔に保つことをNexthinkは推奨します。
コネクタは、一連の設定を使用して、サードパーティAPIへのインテグレーションイベントを迅速にセットアップします。 Nexthinkは次のサードパーティアプリケーションとのコネクタの設定をサポートしています：Microsoft Entra ID、Microsoft Outlook、ChatGPT、およびServiceNow。
コネクタシンクレットの設定方法について詳しくは、コネクタシンクレットの設定を参照してください。
ワークフローは以下を行うためにグローバル変数を使用します：
実行時に入力を受け付けます。
システムが以下を行うために静的パラメーターを定義します：
入力としてシンクレットに渡します。
条件の一部として評価します。
DNSアドレス上で、
ワークフローパラメータの名前を入力します。
ワークフローパラメータの値を入力します。
さまざまなトリガーに対する入力を許可するにはカスタム値を許可を選択します。
ツールバーのワークフロー詳細セクションを使用して、ワークフローに説明を追加します。 ワークフロー設計の目的や、他のユーザーがレビューや編集時に知っておくべき追加情報を記述します。
ワークフロー設計に関連して、有効でないものやアクティブにできない問題がある場合、これらの問題は「ワークフロー保存」ボタンがクリックされたときにツールバーのエラーレビューセクションに表示されます。
リストを確認し、有効なワークフロー設計を確保するために特定された問題を修正してください。
検証問題のリストには、既存の問題が解決された後にさらに多くの問題が含まれていた可能性があります。 これは、いくつかの問題が他の要素のさらなる検証をブロックしているためです。
NEALエディターでは検証メッセージは利用できません。 リストを確認するには、保存してデザイナに戻る必要があります。
関連トピック
