メインコンテンツへスキップ

はじめに

この記事では、ワークフロー管理と、 許可 やワークフロー固有の 権限 などのガバナンスのトピックについて説明します。また、ワークフローの バージョン管理リカバリ についても学習します。管理者と「ワークフローを管理する」の許可を持つユーザーは、代替トリガーを管理してワークフローを開始できます。トリガーの詳細については、 こちら を参照してください。
用語集 :この記事の 二重引用符で囲まれている用語には、ワークフロー内の特定の定義があります。 用語集 では、定義を示します。
ワークフローの有効化、設定、または操作のサポートについては、Domoアカウントチームまたは Domoサポート にお問い合わせください。

必要な許可

次の許可によって、ワークフロー機能の権限が付与されます。
  • ワークフローを作成する — この許可を使用すると、 テンプレートライブラリー からの作成も含め、 新しいワークフローを作成できます 。新しいワークフローを作成する必要があるインスタンス内のすべてのユーザーが、この許可を持っている必要があります。
  • ワークフローを管理する — この許可を使用すると、Domoインスタンス内の任意のワークフローに対して任意のアクションを実行できます。スーパーユーザー、管理者、インスタンスのワークフローの管理を支援するユーザーには、この許可が付与されている必要があります。 “実行済み”ワークフローインスタンスにアクセスする必要があり、この許可を持つユーザーは、権限モーダルで「実行リストを表示」および「実行の詳細を編集」の許可を明示的に自分に付与する必要があります。 権限 については、次のセクションを参照してください。
権限を管理する 」セクションでは、インスタンス内の管理者以外のユーザーに特定のワークフローへのアクセス権を与える方法について説明します。使用可能な権限がいくつかあります。

権限を管理する

ワークフロー内で、 “権限”はワークフローへのユーザーやグループのアクセス権をより細かく指定する方法です。 例えば、ユーザーがワークフローの任意の “バージョン”を削除するには、そのワークフローの削除権限が必要です。
重要: 権限を管理するには、ワークフローに対する共有権限または管理者権限が必要です。ワークフローの所有者は、デフォルトでこれらの権限を持ちます。ワークフローを所有していない場合は、所有者または現在の管理者からこの権限を付与されている必要があります。共有権限のみを持っている場合は、同じレベルまたは下位レベルの権限のみをほかのユーザーに付与できます。
権限 — 使用可能な権限は、次のとおりです。
  • 管理者 — ワークフローで任意のアクションを実行するためのアクセス権を付与します。この権限は、Domoインスタンス内のすべてのワークフローへのアクセス権を誰かに付与する「ワークフローを管理する」の 許可 とは別です。
デフォルトでは、ワークフローの所有者にはワークフローに対する管理者権限がありますが、このアクセス権は変更または無効にすることができます。
  • 削除 — ワークフロー( “事前展開済み”または無効化されている場合)および任意のバージョンのワークフローを削除するアクセス権を付与します。展開と無効化については、 用語集 を参照してください。
  • 読み取り — ワークフローのすべてのバージョンへの閲覧専用アクセス権を許可します。
  • 書き込み — ワークフローの “事前展開済み”バージョンの編集アクセス権を付与します。展開済みバージョンを変更するには、ワークフローの新しいバージョンを作成する必要があります。
  • 共有 — ワークフローへのアクセス権をほかのユーザーと共有する権限を許可します。ワークフローに対する共有権限を持つユーザーは、自分のレベル以下のアクセス権のみを共有できます。
  • 展開 — ワークフローの “展開”バージョンへのアクセス権を付与します。
  • 実行 — ワークフローの展開済みバージョンを実行するアクセス権を付与します。
  • 実行リストを表示 — ワークフローの 実行 への閲覧専用アクセス権を許可します( 実行の詳細 および 再生コントロール を含む)。
権限の所有者に「ワークフローを管理する」の 許可 が与えられていない場合、実行リストには、個人的に開始した実行のみが表示されます。ワークフローに対する「実行リストを表示」の許可を持ち、 かつ 「ワークフローを管理する」の許可があるユーザーは、ワークフローのすべての実行を表示できます。
  • 実行の詳細を編集 — 失敗した、または進行中の ワークフロー 実行 を編集およびリカバリするためのアクセス権を付与します。
権限の所有者に「ワークフローを管理する」の 許可 が与えられていない場合、個人的に開始した実行のみを編集またはリカバリできます。ワークフローに対して「実行の詳細を編集」の許可と「ワークフローを管理する」の許可を持つユーザーは、「進行中」または「失敗」ステータスの実行済みワークフローを編集またはリカバリできます。
ワークフローの権限を管理するには、次の手順に従います。
  1. ワークフローのデフォルトビューで、権限を管理するワークフローを探し、 詳細 (水平の三点リーダー)> [権限を管理] を選択します。
    権限モーダルが表示されます。
    workflows permissions modal.png
  2. 権限によっては、ドロップダウンを使用してインスタンス内の任意のユーザーまたはグループの権限を更新できます。
注記: ほかのユーザーには、同じレベルまたは下位レベルのアクセス権のみを付与することができます。例えば、共有アクセス権を持つユーザーが、別のユーザーに管理者アクセス権を付与することはできません。
  1. モーダルを閉じる前に変更を保存します。
このページのトップへ

ワークフロー名と説明を編集する

ワークフローの編集 権限 または管理者権限が与えられている場合、 詳細 (水平の三点リーダー)> [詳細を編集] を選択して、ワークフローのデフォルトビューから名前と説明を変更できます。
このページのトップへ

ワークフローを編集する

注記: ワークフローを “展開”した後は、ワークフローを編集できません。代わりに、新しいワークフローの “バージョン”を作成する必要があります。「 ワークフローバージョンを管理する 」を参照してください。
ワークフローバージョンが展開されていない場合は、次の手順に従って編集を続行できます。
  1. デフォルトのワークフロービューで、バージョンリストを開くワークフローを選択します。バージョンリストの詳細については、 こちら を参照してください。
  2. バージョンリストで、編集するワークフローバージョンに対して 詳細 (縦の三点リーダー)> [ワークフローを編集] を選択します。 バージョンがキャンバスに編集モードで開きます。
    ロックされたバージョンにアクセスする: “事前展開済み”バージョンは一度に1人のユーザーのみが編集できます。事前展開済みバージョンを編集しているユーザーがいる場合、そのバージョンを編集しようとするほかのユーザーには、更新が上書きされないように [バージョンはロックされています] モーダルが示されます。モーダルにはバージョンを編集しているユーザーの名前が表示され、バージョンを閲覧専用モードで表示するオプションが提供されます。ワークフローの管理者 権限 を持っている場合、ロックされたバージョンをロック解除できます。ロック解除すると、ほかのユーザーによる変更が保存されないと警告されます。例えば作業中に誰かがロック解除した場合、未保存の編集内容がすべて 失われ、ほかのユーザーがそのバージョンを開いて編集できるようになります。
    locked version.jpg
このページのトップへ

ワークフローを削除する

ワークフローを削除すると、そのすべてのバージョンが削除されます。アクティブなバージョンがあるワークフローは削除できません。そのため、ワークフローを削除するには、すべてのバージョンを “無効化”しておく必要があります。 ワークフローを削除するには、そのワークフローの削除権限または管理者権限が必要です。権限の詳細については、 こちら を参照してください。 詳細 (水平の三点リーダー)> [削除] を選択して、ワークフローのデフォルトビューからワークフローを削除します。
このページのトップへ

ワークフローバージョンを管理する

ワークフローを “展開”した後は、ワークフローを編集できません。代わりに、新しいワークフローのバージョンを作成( [名前を付けて保存] )して、新しい バージョン を編集する必要があります。1つのワークフローに複数のバージョンを設定できます。各バージョンには、 <major.minor.patch> フォーマットで独自のバージョン番号が付いています(例:1.1.2)。ワークフローのバージョンリストを表示するには、ワークフローのホームからワークフローを選択します。
[バージョン] タブでリスト表示されている 貢献者 はバージョン作成者です。これは ワークフロー作成者とは異なる場合があります。
リストからバージョンを選択すると、キャンバスが開き、権限とモデルのステータスにもとづいて、バージョンのグラフィックモデルが最も制限の少ないモードで表示されます。
  • バージョンが “展開済み”の場合、モデルは閲覧専用モードで開きます。展開済みバージョンは編集できません。編集するには、新しいバージョンを作成する必要があります。
  • バージョンが “事前展開済み”ではなく、ワークフローの読み取り 権限 のみが与えられている場合、モデルは閲覧専用モードで開きます。
  • バージョンが “事前展開済み”ではなく、ワークフローの書き込み 権限 または管理者権限を持っている場合は、バージョンが編集モードで開きます。ワークフローの設計方法については、 こちら を参照してください。
このページのトップへ

バージョンアクション

[バージョン] タブで、各バージョンの 詳細 メニュー(縦の三点リーダー)には、下の表で説明する次のオプションがあります。
注記: メニューのアクションにアクセスできない場合は、アクションを実行する 権限 がないか、バージョンの ステータス のためにアクションを利用できないかのどちらかです。バージョンステータスの確認については、「 実行の詳細を確認する 」を参照してください。

アクション

必要な権限

説明

表示のみ

表示、編集、または管理者

バージョンを閲覧専用モードで開きます。

ワークフローを編集

編集または管理者

**これは、バージョンが展開されていない場合にのみ使用できます。

バージョンを編集モードで開きます。

バージョン詳細を編集

編集または管理者

バージョンの説明を編集できるモーダルを開きます。

新しいバージョンを作成

編集または管理者

[新しいバージョンを作成] モーダルが開きます。

新しいバージョンの作成についての説明を確認してください。

展開

展開または管理者

バージョンの展開を試みます。バージョンは、展開されるまで実行できません。バージョンを展開すると、デフォルトで有効になります。

検証 の問題がある場合は、展開する前にエラーを解決する必要があります。

有効にする / 無効にする

編集または管理者

展開済みバージョンを有効または無効にします。

バージョンは、アクティブになるまで実行できません。バージョンを展開すると、デフォルトで有効になります。バージョンを無効化して実行したままにすることはできますが、展開した後は展開を「解除」できません。

無効化されたバージョンは開始できません。

開始

実行または管理者

フォームの起動を含むワークフローの実行を開始します。

実行数のリストを開く

実行リストを表示、実行の詳細を編集、または管理者

[実行数] タブを開きます。

削除

削除または管理者

バージョンを削除します。

アクティブステータスの展開済みバージョンは削除できません。

このページのトップへ

新しいバージョンを作成する

重要: 新しいバージョンを作成するには、「ワークフローを作成する」の 許可 と、ワークフローの書き込み 権限 または管理者権限が必要です。
[バージョン] タブから、 [+バージョンを追加] を選択して、次のオプションを表示します。
  • [白紙のキャンバス] — このオプションを選択すると、以前のバージョンを開始点として使用せずに、ワークフローの新しいバージョンが作成されます。
  • [既存のバージョン] — このオプションを選択すると、ワークフローの以前のすべてのバージョンのリストが表示されます。任意のバージョンの設定を変更し、新しいバージョンとして保存できます。利用可能なバージョンのいずれかを選択して新しいバージョンに番号を付け、オプションの説明を追加してキャンバスで開きます。デフォルトのバージョン番号を変更する場合は、 <major.minor.patch> フォーマットにする必要があります。ワークフローに既にバージョン番号が使用されている場合は、それを再度使用することはできません。
    Screenshot 2023-03-30 at 1.50.50 PM.png
    バージョン情報: “展開済み”とは、ワークフローが検証され、実行可能であることを意味します。アクティブ とは、ワークフローがスケジュールに従って実行されるように、またはトリガーに応答して実行されるように現在設定されていることを意味します。ワークフローを “無効化”すると、削除することなく実行を回避できます。ステータスの詳細およびその他のバージョン情報を確認するには、 [実行数] タブに進みます。
このページのトップへ

ワークフローのトリガーを管理する

トリガーを使用すると、App Studio App内など、Domoのほかの場所から、またはタイマーを使用してワークフローを開始できます。手動トリガーは、そのワークフローバージョン内の 開始形状 から設定できます。手動トリガーの設定プロセスはこれのみです。ワークフローの [トリガー] タブには、ワークフローバージョンに設定されたすべてのトリガーが表示されます。 ワークフローのトリガーを作成するには、「ワークフローを管理する」の 許可 および 管理者 権限 またはワークフローの実行権限を持っている必要があります。
注記: 手動トリガー以外のすべてのトリガー(タイマーを含む)は、ワークフローを “展開”した後にのみ設定できます。一部のトリガーは、App Studioなどのトリガーの実行元となる機能で設定する必要があります。トリガーを追加するには、次の手順に従います。
  1. ワークフローのホームからワークフローを選択し、 [トリガー] タブに進みます。
  2. [トリガーを追加] > < トリガータイプ> を選択します。
    各トリガータイプには、独自の設定要件があります。設定後、トリガーは [トリガー] タブにリスト表示されます。
    • App Studio — トリガーを開始するApp Studio Appに進み、ワークフローウィジェットを追加します。ワークフローの正しいバージョンを見つけて選択します。 次の画像は、3つのバージョンのスクリーニング再開ワークフローです。App内からバージョン2.0.0をトリガーする場合は、そのバージョンを選択します。
    • プロコードApp — ワークフローが設定されているAsset Libraryから既存のAppを選択してカードにマップするか、プロコードエディターを使用して新しいAppを構築します。ワークフローを使用するようにAppデザインをプログラムすることができ、そのワークフローはカード設定パネルで選択してマップできます。
    • アラート — DataSetの詳細ページに進み、 [アラート] タブに移動します。新しいアラートを作成するとき、または既存のアラートを編集するときに、アラートトリガー時に実行するワークフローバージョンとしてアクションを設定します。アラートを作成する方法については、 こちら を参照してください。
    • ワークフロー — ワークフローを別のワークフローでトリガーするために、ワークフローのトリガーを作成する方法については、 こちら を参照してください。
    • タイマー — ワークフローバージョンを選択し、更新頻度と開始時間を指定してタイマーを設定します。更新頻度のオプションは次のとおりです。
      • [毎分] — [毎分]、[5分毎]、[15分毎] のオプションがある [期間(分)] ドロップダウンが表示されます。 オプションを選択した後、必要に応じて [開始期間] ボックスにチェックを入れると、ワークフローを特定の時間帯のみに実行したい場合に、ワークフローを実行する間隔の開始時刻と終了時刻を選択できます。
      • [毎時] ワークフローを1時間ごとに展開します。 必要に応じて、 [開始期間] ボックスにチェックを入れ、ワークフローを1時間ごとに実行する開始時刻と終了時刻を選択できます。 [開始期間] ボックスのチェックを外すと、ワークフローは1時間ごとに 1回、 1日当たり24回実行されます。
      • [毎日] ワークフローを毎日1回展開します。[開始]フィールドで、ワークフローを開始する時刻を選択します。 [終了] フィールドは、選択した開始フィールドにもとづいて自動的に入力されます。
      • [毎週平日] 毎週平日(月曜日~金曜日)に1回、ワークフローを展開します。ワークフローは週末(土曜日と日曜日)には開始されません。ワークフローを開始する時刻を [開始] フィールドで選択する必要があります。 [終了] フィールドは、選択した開始フィールドにもとづいて自動的に入力されます。
      • [毎週] ワークフローを週に1回展開します。 [この日] フィールドで、ワークフローを開始する日と開始する時刻を選択します。
      • [毎月] ワークフローを月に1回、指定した日に展開します。 [この日] ドロップダウンからオプションを選択します。オプションは、[毎月1日]、[毎月15日]、[月の末日]です。オプションを選択した後、ワークフローを開始する時刻を選択します。
  • APIトリガー — ワークフローバージョンを選択します。構文がJavaScriptとPythonで生成されます。構文にはトリガーIDが含まれています。構文はコピーしてAPIコールに貼り付けることができます。このトリガーIDを使用して行われたコールは、追跡目的でのみ使用されるため、ワークフローを開始したトリガーを特定できます。
  1. 設定されたトリガーは [トリガー] タブに表示されます。また、展開済みバージョンのトリガーをキャンバスの [トリガー] タブ で表示および設定することもできます。
    注記: トリガーは現在、ワークフローバージョンから別のワークフローバージョンにコピーすることはできません。
このページのトップへ

ワークフローのトリガーを作成する

  1. トリガーとなるワークフローを編集モードで開きます。これは “事前展開済み”である必要があります。それ以外の場合は、新しいバージョンを作成します。
  2. ステップを追加して、ターゲットワークフローを開始します。
    1. アクションメニューの検索バーで「ワークフローを開始する」を検索します。
    2. [ワークフローを開始する] パッケージを選択します。
    3. 関数リストでターゲットワークフローを探し、必要なパラメーターをマップします。
    4. 変更を保存します。
  3. トリガーとなるワークフローを展開します。 そのワークフローの [トリガー] タブにワークフローのトリガーが表示されます。

トリガーを削除する

アラート、App Studio、プロコードApp、ワークフローでは、トリガーを設定した機能からトリガーを削除できます。 タイマーまたはAPIコールでは、設定モーダルの 削除 (ゴミ箱アイコン)オプションを使用して、トリガーを削除します。
このページのトップへ

ワークフローの実行を表示する

所有者と管理者 権限 を持つユーザーは、ワークフローの実行を表示できます。ほかのユーザーは、ワークフローに対して「実行リストを表示」または「実行の詳細を編集」の許可を持っている場合、ワークフローの実行を表示または編集できます。 ワークフローのホームから 詳細 (水平の三点リーダー)> [実行数のリストを開く] を選択します。 [実行数] タブが表示されます。 [実行数] タブには、バージョン、ステータス、期間により実行をソートするためのフィルターパネル、メトリクスタイル、およびメトリクスをパーセンテージで視覚的に表す円グラフがあります。
重要:
  • [期間] フィルターのデフォルト値は[今日]です。 [実行数] タブとビジュアルに期待する結果が表示されない場合は、期間の値を確認します。
time period filter.jpg
  • より長い期間でフィルターをかけることを選択すると、結果を返すのにより多くの時間が必要になる場合があります。

ワークフローを一括でキャンセルする

[実行数] タブで一度に複数の進行中または失敗したワークフローの実行をキャンセルするには、 [実行を一括でキャンセル] スイッチを切り替えます。キャンセルされたワークフローのステータスは変更できません。
キャンセルする各ワークフローのボックスにチェックを入れるか、上部のチェックボックスをオンにして「すべてを選択」します。 [実行をキャンセル] を選択します。 注記: キャンセルするワークフローが多いほど、リクエストの処理にかかる時間が長くなります。
このページのトップへ

実行の詳細を確認する

ワークフローに対して「実行リストを表示」の 許可 を持っている場合、 [実行数] タブから実行を選択して、特定の形状の実行に要した時間や実行が失敗した形状などといった詳細情報を表示できます。
実行の詳細がワークフローキャンバスに表示されます。このキャンバスには、実行の現在のステータス、 再生コントロール 、および画面下部にサイズ変更可能なデータパネルが表示されます。 実行されたワークフローには、次の4つのステータスのいずれかがあります。
  • 完了しました
  • 進行中
  • キャンセルしました
  • 失敗しました
キャンバス上では、完了した形状は緑で囲まれ、現在進行中の形状は青で囲まれて表示されます。1つまたは複数の形状が完了する前に実行が停止された場合、実行ステータスは[キャンセルしました]になります。完了する前に失敗した形状がある場合は、赤で囲まれ、実行ステータスは[失敗]になります。
反復: 1つの形状が複数回完了した場合、その形状のバッジには、実行中に完了した回数が表示されます。形状が1回だけ完了した場合、番号は表示されません。
execution details.jpg
このページのトップへ

再生コントロールを使用する

再生コントロールを使用すると、実行のイベントを開始したりもう一度再生したりできます。
playback controls.jpg
次の表では、再生コントロールについて説明します。

アイコン

コントロール

説明

切り替え

画面で実行の自動再生を開始するか、フロー内で到達した最も遠いポイントを表示するかを制御します。

もう一度再生

最初の開始形状から実行をもう一度再生します。

再生

最後に停止したポイントから実行を再生または再開します。

停止

実行の再生を停止/一時停止します。

早送り

再生速度を上げます。4つの速度があり、ボタンを繰り返し選択すると、速度が切り替わります。

再生中と再生後に、実行データを確認する形状を選択できます。形状を選択すると、形状がハイライト表示され、データパネルが開きます。このパネルには、形状で使用されている値、変数名とその型、および実際に使用されている値が表示されます。
data panel.jpg
ユーザータスクとコード関数には入力と出力が表示され、その他の形状には、形状がアクティブになったときの変数の実際の値が表示されます。
Screenshot 2024-07-09 at 11.48.22 AM.png
複数回アクティブ化された形状の場合、データパネル内で反復のページを移動すると、反復ごとのデータを表示できます。 このページのトップへ

実行をリカバリ/再試行する

ワークフローに対して「実行の詳細を編集」の 許可 がある場合は、失敗したワークフローの実行のリカバリができます。リカバリとは、 a) エラーの発生した形状でデータを更新してから、 b) 実行を再試行できることを意味します。
注記: リカバリモードを開始できるのは、エラーが発生したとき、あるいは進行中のユーザータスクまたは待機中の形状が完了するのを実行が待機しているときだけです。ほかの形状の完了が速すぎるため、進行中にリカバリオプションを適用できません。
実行のリカバリモードにアクセスするには、形状を選択します。形状のデータパネルで、右上隅の [実行を編集] を選択します。
edit execution.jpg
リカバリモードでは、画面上部のバナーに、次に示すリカバリオプションが表示されます。
recovery banner.jpg
このページのトップへ

リカバリオプション

使用可能なリカバリオプションは次のとおりです。
  • [リカバリを終了] — 閲覧専用モードに戻ります。
  • [再試行]— ワークフローが失敗した場所から、または 現在進行中の場所から実行を再度試みます。
  • [インスタンスをキャンセル]— ワークフロー実行を停止し、ステータスを[キャンセルしました]に更新します。

実行データを編集する

リカバリモードでは、再試行を試みる前に、実行の現在または最後のアクティブポイントで入力データを変更できます。これを行うには、データパネルで変更する入力を見つけて、その入力の [編集] を選択します。
edit input.jpg
変更を行った後、必ず [保持] を選択して保存してください。
keep changes.jpg
バナーの [再試行] オプションを選択する前に、形状のデータ入力を必要なだけ変更します。

ワークフローの実行をキャンセルする

[進行中]ステータスのワークフロー実行が[完了]ステータスに到達しないことが分かっている場合は、その実行をキャンセルし、実行がログに正しく表示され、誤って更新されないようにするのがベストプラクティスです。 ユーザータスクが[キャンセルしました]に更新されると、タスクは自動的に タスクセンター で無効になります。 このページのトップへ 日本語