タスクの更新

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

オプション

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

タスクタイプ(Task Type)

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

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

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

ドロップダウン

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

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

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

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

ドロップダウン

入力

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

タスク(Task)

システムID(System 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

優先度(Priority)

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

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

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

数値 FALSE

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

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

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

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

テキスト FALSE

割り当て先(Assigned to)

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

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

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

テキスト FALSE

アクティブ(Active)

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

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

たとえば、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ステータスコードを参照してください。

数値