タスクの更新

ServiceNowのタスクまたはカタログタスクを更新します。

オプション

フィールド 定義 タイプ 必須

タスクタイプ(Task Type)

更新するいずれかのタスクタイプを選択します。

  • Task:ServiceNowのベースタスクタイプ。taskレコードを更新します。

  • Catalog Task:サービスカタログに固有のタスクのサブタイプ。sc_taskレコードを更新します。

ドロップダウン 正

空の値の受け渡し?(Pass Empty Values? )

ServiceNow APIに空の入力値(nullまたは空の文字列)を渡すかどうかを選択します。

  • Yes:空の値を渡します。選択した入力フィールドのデータは消去され、指定されたタスクに対してnullまたは空の文字列値を渡します。

  • No:空の値を渡しません。nullまたは空の文字列値の入力はAPIに送信されず、更新または変更されません。

ドロップダウン 正

入力

フィールド 定義 タイプ 必須

タスク(Task)

System ID(システムID)

タスクの一意のレコード識別子(sys_id)。

テキスト 正

数値(Number)

各タスクレコードの識別番号。

このフィールドはタスクテーブルの表示値です。

システムはタスクの作成時にこの番号を生成します。

テキスト FALSE

説明(Description)

行われる作業の詳しい説明。

テキスト FALSE

簡潔な説明(Short description)

タスクの簡潔な説明。この説明はレコードのタイトルとして使用されます。

テキスト FALSE

追加コメント(Additional comments)

タスクレコードに関するコメント。

各コメントはアクティビティ(Activity)フィールドに挿入されます。

テキスト FALSE

オープン(Opened)

タスクレコードを初めて人的に開いた日時。

日時 FALSE

承認履歴(Approval history)

レコードの承認の履歴。

テキスト FALSE

ウォッチリスト(Watch list)

レコードの更新時にメールおよびSMS通知を受け取るユーザーを指定します。

このフィールドにリストされたユーザーに通知するのは、デフォルトではインシデント(Incident)、変更(Change)、サービスカタログ(Service Catalog)アプリケーションのみです。

タスクベースのその他のアプリケーションでは、カスタムメール通知を作成してこれらのユーザーに送信する必要があります。

テキスト FALSE

優先度

割り当て先にとってタスクがどの程度優先されるかを指定します。

デフォルトでは、この値は影響(Impact)と緊急度(Urgency)の値に基づいてcalculatePrioritybusinessルールによって計算されます。

その上で、レコードリストは優先度に応じて各タスクを色分けします。

数値 FALSE

作業注記リスト(Work notes list)

レコードに作業注記が追加されたときにメールおよびSMS通知を受け取るユーザーを指定します。

このフィールドにリストされたユーザーに通知するのは、デフォルトでは変更(Change)、問題(Problem)、サービスカタログ(Service Catalog)アプリケーションのみです。

タスクベースのその他のアプリケーションでは、カスタムメール通知を作成してこれらのユーザーに送信する必要があります。

テキスト FALSE

割り当て先(Assigned to)

タスクの完了を割り当てられるユーザーを指定します。

デフォルトでは、このフィールドは参照修飾子を使ってitilロールが割り当てられたユーザーのみを表示します。一部のアプリケーションは、親参照修飾子をオーバーライドして関連ユーザーを表示します。

たとえば、サービス命令(Service Order)テーブルとプロジェクトタスク(Project Task)テーブルはスキルに基づいてユーザーをフィルタリングします。

テキスト FALSE

アクティブ

タスクの作業がまだ行われているかどうか、またはタスクの作業が完了しているかどうかを指定します。

このフィールドの値を設定するのは、デフォルトではアプリケーションに固有のビジネスルールのみです。

たとえば、incident autocloseビジネスルールは、解決され、1日更新されなかったインシデントをクローズします。

True/False FALSE

都道府県(State)

タスクのステータス。次の値があります。

  • Pending

  • Open

  • Work in Progress

  • Closed Complete

  • Closed Incomplete

  • Closed Skipped

アプリケーションは、通常は辞書オーバーライドを使ってアプリケーションに固有の状態を表示します。

数値 FALSE

作業時間(Time worked)

レコードがフォームビューで開いている時間を測定するタイマーを表示します。

テキスト FALSE

作業注記(Work notes)

ITILユーザーのみが表示できるコメントを表示し、入力できるようにします。

各コメントはアクティビティ(Activity)フィールドに挿入されます。ジャーナルフィールドタイプを参照してください。

テキスト FALSE

出力

フィールド 定義 タイプ

レスポンス(Response )

ステータスコード(Status Code)

操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例:

  • 204ステータスコードは、成功して指定のタスクが更新されたことを示します。

  • 400または500シリーズのステーコードエラーは、HTTPリクエストに問題が生じたことを示します。タスクは正しく更新されませんでした。

発生する可能性があるステータスコードの完全なリストについては、HTTPステータスコードを参照してください。

数値