タスクを更新する

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

このカードの入力フィールドはServiceNowインスタンスに基づいて動的に生成されます。入力フィールドにはServiceNowが提供するデフォルトフィールドが含まれます。たとえば、［Active（アクティブ）］、［Approval history（承認履歴）］、［Description（説明）］、［Time worked（作業時間）］、タスクまたはカタログタスクテーブルに追加したすべてのカスタムフィールドが含まれます。ここでは、一般的な一部の入力フィールドについて説明します。

オプション

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

フィールド	定義	タイプ	必須
Task Type（タスクタイプ）	更新するいずれかのタスクタイプを選択します。 Task：ServiceNowのベースタスクタイプ。`task`レコードを更新します。 Catalog Task：サービスカタログに固有のタスクのサブタイプ。`sc_task`レコードを更新します。	ドロップダウン	TRUE
Pass Empty Values?（空の値を渡す？）	ServiceNow APIに空の入力値（nullまたは空の文字列）を渡すかどうかを選択します。 Yes：空の値を渡します。選択した入力フィールドのデータは消去され、指定されたタスクに対してnullまたは空の文字列値を渡します。 No：空の値を渡しません。nullまたは空の文字列値の入力はAPIに送信されず、更新または変更されません。	ドロップダウン	TRUE

Task Type（タスクタイプ）

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

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

ドロップダウン

TRUE

Pass Empty Values?（空の値を渡す？）

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

Yes：空の値を渡します。選択した入力フィールドのデータは消去され、指定されたタスクに対してnullまたは空の文字列値を渡します。
No：空の値を渡しません。nullまたは空の文字列値の入力はAPIに送信されず、更新または変更されません。

ドロップダウン

TRUE

入力

フィールド	定義	タイプ	必須
タスク
System ID（システムID）	タスクの一意のレコード識別子（sys_id）。	テキスト	TRUE
Number（数値）	各タスクレコードの識別番号。このフィールドはタスクテーブルの表示値です。システムはタスクの作成時にこの番号を生成します。	テキスト	FALSE
Description（説明）	行われる作業の詳しい説明。	テキスト	FALSE
Short description（簡潔な説明）	タスクの簡潔な説明。この説明はレコードのタイトルとして使用されます。	テキスト	FALSE
Additional comments（追加コメント）	タスクレコードに関するコメント。各コメントは［Activity（アクティビティ）］フィールドに挿入されます。	テキスト	FALSE
Opened（オープン）	タスクレコードを初めて人的に開いた日時。	日時	FALSE
Approval history（承認履歴）	レコードの承認の履歴。	テキスト	FALSE
Watch list（ウォッチリスト）	レコードの更新時にメールおよびSMS通知を受け取るユーザーを指定します。このフィールドにリストされたユーザーに通知するのは、デフォルトではインシデント、変更、サービスカタログアプリケーションのみです。タスクベースのその他のアプリケーションでは、カスタムメール通知を作成してこれらのユーザーに送信する必要があります。	テキスト	FALSE
Priority（優先度）	割り当て先にとってタスクがどの程度優先されるかを指定します。デフォルトでは、この値は［Impact（影響）］と［Urgency（緊急度）］の値に基づいてcalculatePrioritybusinessルールによって計算されます。その上で、レコードリストは優先度に応じて各タスクを色分けします。	数値	FALSE
Work notes list（作業注記リスト）	レコードに作業注記が追加されたときにメールおよびSMS通知を受け取るユーザーを指定します。このフィールドにリストされたユーザーに通知するのは、デフォルトでは変更、問題、サービスカタログアプリケーションのみです。タスクベースのその他のアプリケーションでは、カスタムメール通知を作成してこれらのユーザーに送信する必要があります。	テキスト	FALSE
Assigned to（割り当て先）	タスクの完了を割り当てられるユーザーを指定します。デフォルトでは、このフィールドは参照修飾子を使ってitilロールが割り当てられたユーザーのみを表示します。一部のアプリケーションは、親参照修飾子をオーバーライドして関連ユーザーを表示します。たとえば、サービス命令テーブルとプロジェクトタスクテーブルはスキルに基づいてユーザーをフィルタリングします。	テキスト	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ステータスコード」を参照してください。	数値

フィールド

定義

タイプ

Response （レスポンス）

Status Code（ステータスコード）

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

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

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

数値

タスクを更新する

オプション

入力

出力

関連項目