この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

サービスレポートテンプレート

フィールドサービスの 1 つ以上のサービスレポートテンプレートに対応する情報を返します。このリソースは REST API バージョン 40.0 以降で使用できます。

このリソースでは、1 つ以上のサービスレポートテンプレート ID を入力することができ、テンプレートに関する情報を返します。作業指示、作業指示品目、サービス予定のサービスレポートを生成できます。

ServiceReportTemplate は Field Service が有効になっている組織の API ユーザーが利用できます。またエクスペリエンスビルダーサイトでも有効になっています。

URI
/services/data/vXX.X/support/fieldservice/ServiceReportTemplate
形式
JSON
HTTP メソッド
GET
認証
Authorization: Bearer token
パラメーター
パラメーター 説明
templateIds サービスレポートテンプレート ID のリスト (カンマ区切りの文字列値)。テンプレート ID が無効の場合、API の応答には失敗が表示されます。
showDefault デフォルトのサービスレポートテンプレートが応答で返されるかどうかを示す boolean パラメーター。true の場合、デフォルトのテンプレートが含まれます。false (デフォルト) の場合、デフォルトのテンプレートは含まれません。たとえば、要求にデフォルト以外の 2 つのテンプレートの ID が含まれていて、showDefault=true である場合、応答には 3 つのテンプレートの情報が含まれます。
templateTypes レポートテンプレートが使用できるレコードタイプは、ServiceAppointment、WorkOrder、WorkOrderLineItem です。サービスレポートには、次の 4 つのサブテンプレートがあります。
  • WO — 作業指示
  • WOLI — 作業指示品目
  • WO_SA — 作業指示のサービス予定
  • WOLI_SA — 作業指示品目のサービス予定

レスポンスボディ

サービスレポートには、ヘッダー本文フッターという削除できない 3 つの主要領域があります。各領域には、セクション関連リスト、または署名コンポーネントのうち少なくとも 1 つが含まれている必要がありますが、コンポーネントは空でもかまいません。ヘッダーとフッターには定義済みのセクションが含まれていて、他のコンポーネントを追加することはできません。本文には、各コンポーネントを 1 つ以上含めることができます。

セクションコンポーネントには次のプロパティがあります。
  • title: String
  • hideTitle: Boolean
  • hideFieldLabels: Boolean
  • columns: Enum {1, 2}
  • rightAlignment: Enum {true,false}
  • fields: {Field} の配列
項目は、セクション、関連リスト、署名に追加できます。関連リストの列は、API で項目に変換されます。項目コンポーネントには次のプロパティがあります。
  • fieldType: Enum {rta, entityField, blank}
  • 属性:
    • データ型が rta の場合、項目には {“richTextValue” : “<html value>”} も含まれます。
    • データ型が entityField の場合、項目には {“entityName” : “<WorkOrder>”, “fieldName” : “Account”} も含まれます。
    • データ型が blank の場合、それ以外に情報は必要ありません。
  • 位置:
    • row
    • column
関連リストコンポーネントには次のプロパティがあります。
  • title: String
  • hideTitle: Boolean
  • entityName: String
  • relatedListName: String
  • relatedEntityName: String
  • fields: {Field Name (String), Column Position (Integer)} の配列
署名コンポーネントには次のプロパティがあります。
  • title: String
  • hideTitle: Boolean
  • hideFieldLabels: Boolean
  • columns: Enum {1, 2}
  • rightAlignment: Enum {true,false}
  • signatureType: Dynamic Enum {<technician 1>, <dispatcher 1>}
  • fields: {Field Name (String), Position (Row,Column)} の配列

この要求例では、2 つのサービスレポートテンプレート ID を使用しています。

要求

GET

/services/data/v42.0/support/fieldservice/ServiceReportTemplate?templateIds=0SLxx0000000ABC, 0SLR000000001QtOAI&showDefault=false&templateTypes=ServiceAppointment

応答