ワークフロースタジオ のアクションとサブフロー RPA ハブ

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:9分
  • ロボットをシームレスに実行するためのワークフロースタジオRPA ハブ でのアクションとサブフローの双方向統合。

    フローとアクションの概要

    フローとアクションは ServiceNow ワークフロースタジオを使用してビルドされているため、ワークフロースタジオでのアクションの構築およびワークフロースタジオでのサブフローの構築の基本を十分に理解しておいてください。

    フローまたはサブフローの呼び出し

    RPA デスクトップデザインスタジオ無人ロボット、または アテンド型ロボット を介してフローまたはサブフローを呼び出します。詳細については、「フローデザイナーコンポーネント」に記載されているトピックを参照して ください。

    フローまたはサブフローのクライアント呼び出し可能オプションの有効化

    RPA ハブ フローまたはサブフローをトリガーするためのクライアントスクリプトを有効にします。詳細については、「のフローまたはサブフローでクライアント呼び出し可能オプションを有効にする RPA ハブ」を参照してください。

    RPA ハブ アクション

    次の表は、 RPA ハブ アクションの詳細な説明、アクション入力、およびアクション出力を示しています。

    表 : 1. RPA アクション
    アクション 説明 アクションの入力 アクションの出力
    キューに作業アイテムを追加アクション RPA ハブ アプリケーションの指定されたキューに作業アイテムを追加し、作業アイテム ID を返します。
    • キュー名:レコード
    • 名前:文字列
    • コンテンツ:文字列
    • タイプ:文字列
    • 優先度:String.Choice
    • ステージ:文字列
    • SLA:日付/時刻

    [コンテンツ] フィールド (要求コンテンツと応答コンテンツ) の上限は 8000 文字です。

    関連付けられた作業キューフォームの [作業アイテム名が機密かどうか (Is Work Item Name Sensitive)] チェックボックスがオンになっている場合、[要求コンテンツ] フィールドのデータは暗号化されます。暗号化された機密データは作業アイテムに保存されるため、RPA デスクトップデザインスタジオまたはロボットに渡すことができます。

    • アクションステータス:オブジェクト
    • WorkItemID:GUID
    • IsNameExists:ブール
    • ステータス:文字列
    • メッセージ:文字列
    有人自動化プロセスにユーザーをアサインするアクション 有人自動化プロセスにユーザーをアサインします。
    • プロセス名:レコード
    • ユーザー名:レコード
    • アクションステータス:オブジェクト
    • ステータス:文字列
    • メッセージ:文字列
    アテンド型ロボット にユーザーをアサインするアクション アテンド型ロボットにユーザーをアサインします。 ユーザー名:レコード
    • アクションステータス:オブジェクト
    • ステータス:文字列
    • メッセージ:文字列
    ボットプロセスアクションのライフサイクルステージステータスを変更 廃棄されていないボットプロセスのライフサイクルステージステータスを変更します。

    ボットプロセスが [ビルド] ライフサイクルステージステータスの場合、必要なロールがあれば [公開済み] ステータスに更新できますが、[メンテナンス中] に更新することはできません。

    ボットプロセスが [公開済み] ライフサイクルステージステータスの場合、必要なロールがあれば [メンテナンス中] ステータスに更新することもその逆に更新することもできます。

    • プロセス名:レコード
    • ライフサイクルステージステータス:選択肢
    • 結果:文字列
    • メッセージ:文字列
    • アクションステータス:オブジェクト
    作成されたジョブをフェッチするアクション RPA ハブ でプロセスジョブをフェッチします。
    • プロセス番号:文字列
    • ロボット:アレイ[文字列]
    • アクションステータス:オブジェクト
    • 結果:文字列
    • ジョブ:アレイ[文字列]
    • startedRobots:アレイ[文字列]
    • pendingRobots:アレイ[文字列]
    実行状況をフェッチするアクション RPA ハブ で特定のプロセスジョブの実行状況をフェッチします。 プロセスジョブ番号:文字列
    • アクションステータス:オブジェクト
    • ProcessJob:オブジェクト
      • プロセス名:文字列
      • ロボット名:文字列
      • ステータス:文字列
      • 開始日時:日付/時刻
      • 完了日時:日付/時刻
      • メッセージ:文字列
    • ステータス:文字列
    • メッセージ:文字列
    作業アイテムのステータスをフェッチするアクション 特定の作業キューアイテムのステータスを非同期でフェッチします。 作業キューアイテム ID:GUID
    • アクションステータス:オブジェクト
      • コード:整数
      • メッセージ:文字列
    • 作業アイテム:オブジェクト
      • sysId:文字列
      • 名前:文字列
      • タイプ:文字列
      • 優先度:文字列
      • ステータス:文字列
      • lockedBy:文字列
      • additionalComments:文字列
      • requestContent:文字列
      • responseContent:文字列
      • deferredTill:日付/時刻
      • sla:日付/時刻
      • created:日付/時刻
      • startedOn:日付/時刻
      • completedOn:日付/時刻
      • lastStartedTime:日付/時刻
    • ステータス:文字列
    • メッセージ:文字列
    プロセスの開始アクション RPA ハブで特定のボットプロセス をトリガーし、ステータスを返します。
    • プロセス名:レコード
    • ロボット:アレイ[文字列]

      ロボットプールがボットプロセスにアサインされている場合、このフィールドのエントリを無視します。

      [処理の開始] ワークフロースタジオ アクションを呼び出すと、ライフサイクルステージステータスが [メンテナンス中] のロボットは、失敗したロボットとして扱われます。

    • アクションステータス:オブジェクト
    • 結果:文字列
    • ロボット:アレイ[文字列]
    • プロセス:文字列
    • 失敗したロボット:アレイ[オブジェクト]
    プロセスの停止アクション ボットプロセスを停止します。グレースフルストップが有効になっている場合、このアクションはボットプロセスを緩やかに停止します。
    • 結果:文字列
    • アクションステータス:オブジェクト
    • ロボット:アレイ[文字列]
    • プロセス:文字列
    • 失敗したロボット:アレイ[オブジェクト]
    有人自動化プロセスからユーザーのアサインを解除するアクション 有人自動化プロセスからユーザーのアサインを解除します。
    • プロセス名:レコード
    • ユーザー名:レコード
    • ステータス:文字列
    • メッセージ:文字列
    • アクションステータス:オブジェクト
    アテンド型ロボット からユーザーのアサインを解除するアクション アテンド型ロボットからユーザーのアサインを解除し、アテンド型ロボットを廃止します。 ユーザー名:レコード
    • アクションステータス:オブジェクト
    • ステータス:文字列
    • メッセージ:文字列
    プロセスパラメーターの更新アクション プロセスパラメーターの [値] フィールドを更新します。
    • プロセス:レコード
    • パラメーター名:文字列
    • :文字列
    • ステータス:文字列
    • アクションステータス:オブジェクト
    • メッセージ:文字列
    作業アイテムアクションの更新 作業キューアイテムを更新します。
    • キュー名:レコード
    • WorkItemID:文字列
    • ステージ:文字列
    • DefferedTill:日付/時刻
    • 名前:文字列
    • 優先度:選択肢
    • ステータス:選択肢
    • 要求コンテンツ:文字列
    • タイプ:文字列
    • 注釈:文字列
    • SLA:日付/時刻
    • 応答コンテンツ:文字列

    [要求コンテンツ][応答コンテンツ] フィールドの上限は 8000 文字です。

    関連付けられた作業キューフォームの [作業アイテム名が機密かどうか (Is Work Item Name Sensitive)] チェックボックスがオンになっている場合、[要求コンテンツ] フィールドのデータは暗号化されます。暗号化された機密データは作業アイテムに保存されるため、RPA デスクトップデザインスタジオまたはロボットに渡すことができます。

    • IsNameExist:True/False
    • ステータス:文字列
    • メッセージ:文字列
    • アクションステータス:オブジェクト
    パッケージバージョン のハッシュコードの検証 RPA ハブ でパッケージバージョンのハッシュコードを検証し、手動でアップロードされた自動化 zip ファイルのハッシュコードを関連するパッケージバージョンレコードで検証します。

    ハッシュコードの検証の詳細については、「でのパッケージバージョンのハッシュコードの確認 RPA ハブ」を参照してください。

    パッケージバージョン:レコード
    • アクションステータス:オブジェクト
    • メッセージ:文字列
    • isAttachmentValid:True/False

    RPA ハブ サブフロー

    次の表は、 RPA ハブ サブフローの詳細な説明、アクション入力、およびアクション出力を示しています。

    表 : 2. RPA サブフロー
    サブフロー 説明 サブフローの入力 サブフローの出力
    パッケージバージョンの添付ファイルのインポートサブフロー パッケージバージョン用にパッケージバージョンの添付ファイルを自動的にインポートします。パッケージの添付ファイル (自動化 zip ファイル) を下位 (非本番) 環境から上位 (本番) 環境に自動で移行するためにインポートします。

    RPA ハブ でのパッケージバージョンの添付ファイルのインポートの詳細については、「RPA ハブ でのパッケージバージョンの添付ファイルのインポート」を参照してください。

    • メール:メール
    • パッケージバージョン:レコード

    添付ファイルが正常にアップロードされた後、または添付ファイルのアップロード中にエラーが発生した場合は、この添付ファイルのインポートアクションを実行したユーザーにメール通知が送信されます (入力として電子メールが提供されている場合)。

    プロセスサブフローを開始 RPA ハブで特定のボットプロセス をトリガーします。プロセスジョブの詳細を返します。
    • プロセス名:レコード
    • ロボット:アレイ[文字列]

      ロボットプールがボットプロセスにアサインされている場合、このフィールドのエントリを無視します。

      プロセスジョブが [実行中] ステータスでない場合、プロセスジョブに関連付けられているロボットは、[プロセスの開始] サブフロー出力で [失敗] として扱われます。

    • 失敗したロボット:アレイ[オブジェクト]
    • 停止したロボット:アレイ[文字列]
    • 処理待ちのロボット:アレイ[文字列]
    • プロセスジョブ:アレイ[文字列]
    • 結果:文字列
    • メッセージ:文字列
    プロセスサブフローを停止 RPA ハブ で特定のボットプロセスをトリガーして停止します 。ロボットの詳細とプロセスジョブのステータスを返します。グレースフルストップが有効になっている場合、このサブフローはボットプロセスを適切に停止します。
    • グレースフルストップ (Graceful Stop):True / False
    • プロセス名:レコード
    • ロボット:アレイ[文字列]
    • 失敗したロボット:アレイ[オブジェクト]
    • 停止したロボット:アレイ[文字列]
    • 処理待ちのロボット:アレイ[文字列]
    • プロセスジョブ:アレイ[文字列]
    • メッセージ:文字列
    • 結果:文字列