カタログアイテム要求アクションを送信する

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • サービスカタログ 要求 [sc_request] で要求済みアイテム [sc_req_item] を作成します。

    ロールと使用可用性

    ワークフロースタジオ ServiceNow コアアクションとして利用可能です。flow_designer または admin ロールを持つユーザーは、アクションをフローに追加し、構成の詳細を定義できます。

    入力

    入力 説明
    カタログアイテム

    要求されたカタログアイテムの名前です。

    選択したカタログアイテムに応じて、入力を動的に追加できます。たとえば、要求されたカタログアイテムが新しいメールアカウントの場合、[優先メールアドレス] フィールドが表示されます。

    注:
    次の サービスカタログ変数タイプはサポートされていません。
    • リストコレクター
    • 複数選択肢をルックアップ
    • 選択ボックスをルックアップ
    数量 要求アイテムの数です。
    特別な指示 アイテム要求に関する特別な指示を説明するテキストです。
    配送先 要求されたアイテムを配送する場所です。
    要求元 アイテムが要求されているユーザーです。
    エラーがあっても続行する (Don't fail on error) アクションによってエラーが発生した場合にフローを失敗にさせるかどうかを決定するオプションです。
    完了待ち 続行する前にアクションが完了するまでフローを強制的に待機させるオプションです。
    タイムアウト有効化
    フローが続行する前にアクションの完了を待機する時間を制限するオプション。
    注:
    [タイムアウト有効化] オプションを使用して、このアクションの実行が続行されないようにします。続行するための条件が満たされない場合、タイムアウト値は、システムが [条件待ち] アクションをスキップしてフロー内の次のアイテムに進むタイミングを指定します。タイムアウトを有効にするには、 [期間] の値を設定する必要があります。特定の作業スケジュールに基づいて期間の終了日を計算する場合は、 [スケジュール] を選択することもできます。

    このフィールドは、[完了待ち] オプションを選択した場合にのみ表示されます。

    期間

    [タイムアウト有効化] オプションが選択されている場合にフローが続行する前に待機する時間。待機時間を時、分、秒単位で入力します。このフィールドを空白のままにすると、フローは待機しません。

    このフィールドは、[完了待ち] オプションを選択した場合にのみ表示されます。

    スケジュール

    [タイムアウト有効化] オプションが選択されている場合にタイムアウト期間を計算するために使用されるスケジュール。たとえば、平日の午前 8 時~午後 5 時のスケジュールの一部として 10 時間待機すると、フローは 1 営業日以上待機することになります。このフィールドを空白のままにすると、タイムアウトはスケジュールなしで実行されます。

    このフィールドは、[完了待ち] オプションを選択した場合にのみ表示されます。

    出力

    フィールド 説明 データタイプ
    エラーメッセージ アクションでエラーが生成された場合に表示されるメッセージ 文字列
    要求済みアイテム 要求済みアイテムのドキュメント ID ドキュメント ID
    ステータス アクションの完了ステータス (数値)
    • 0 (成功)
    • 1 (エラー)
    • 2 (タイムアウト)
    選択肢

    フロー内の [カタログアイテム要求を送信] アクションの例。

    デザインの検討

    [カタログアイテム要求を送信] アクションを含むフローを作成するときは、次のデザインの検討を行ってください。

    文字列置換変換関数を使用して、文字列データピルから引用符をエスケープする
    複雑な文字列変数は、システムに格納されるときに JSON 形式に変換されます。JSON 形式のエラーを防ぐために、文字列置換変換関数を使用して、カタログ変数に使用する文字列データピルに存在する引用符をエスケープできます。「文字列変換関数」を参照してください。
    変換関数を使用してデータピルを検証する
    データピルを使用してアクション入力にデータを提供する場合はいつでも、変換関数を使用してデータを検証できます。利用可能な変換機能のリストについては、「変換関数」を参照してください。