予約に必要なフィールドの取得

25D更新では、Oracle Fusion Field Service用にbookingFieldsDependenciesという新しいREST操作が導入されました。このサービスは、showBookingGrid API操作で有効な予約オプションを計算して表示する前に指定する必要があるアクティビティ・フィールドおよび構成済プロパティの完全なリストを提供します。これにより、必要なデータ・ポイントが常に統合で認識されるため、予約リクエストによって正確で正常な結果が戻されます。

この機能には、構成の変更に自動的に適応する機能があります。以前は、管理者が期間、移動時間または作業ゾーンの見積に使用されたフィールドまたはプロパティを更新したとき、新しく必要なデータを送信するために統合を手動で更新する必要がありました。これを見逃した場合、予約が失敗したり、誤った結果が生成される可能性があります。 bookingFieldsDependenciesでは、統合に手動で調整する必要がなくなりました。サービスは、構成の変更を動的に検出し、検証に必要なフィールドおよびプロパティの現在のセットを返します。このレスポンスを利用することで、統合は常に正しいデータを送信し、追加のメンテナンスなしで予約応答を成功させることができます。

たとえば、「アクティビティ・タイプ」および「サービス・レベル」が当初期間を見積もる必要があった場合に、後で「アセット・タイプ」という名前の新しいプロパティが追加されると、APIによって自動的にレスポンスに含められます。統合により、予約リクエストの資産の種類が提供され、コードを変更することなく正確な結果が保証されます。

APIリクエストおよびレスポンス

要求情報

メソッド: GET
エンドポイント: /rest/ofscCapacity/v1/bookingFieldsDependencies
パラメータ:なし
本文:なし

レスポンス構造
レスポンスは5つの配列を含むJSONオブジェクトで、それぞれが予約計算の1つの側面に必要なフィールドまたはプロパティをリストします:

commonDependencies:必須アクティビティ・フィールドは、常にshowBookingGridで必須です。
durationDependencies:アクティビティ所要時間の計算に使用されるフィールド/プロパティ(期間キーに基づく)。
travelTimeDependencies:移動時間推定に使用されるフィールド/プロパティ(移動キーに基づく)。
workZoneDependencies:正しい容量領域を識別するフィールド/プロパティ(市区町村や郵便番号など、作業ゾーン・キーに基づく)。
workSkillDependencies:作業に必要なスキルまたは資格を確認するフィールド/プロパティ(作業スキル条件構成に基づく)。

各依存性には次のものが含まれます。

label:フィールドまたはプロパティの説明的な名前。
apiParameterName: showBookingGridに必要なパラメータ名。

リクエスト・レスポンスの例

GET https://frontend.ofss.com/rest/ofscCapacity/v1/bookingFieldsDependencies HTTP/1.1
Accept: application/json
Content-Type: application/json
HTTP/2 200
server: nginx/1.20.1
date: Tue, 23 Sep 2025 17:37:13 GMT
content-type: application/json; charset=utf-8
cache-control: no-store, no-cache
strict-transport-security: max-age=31536000
{
  "commonDependencies": [
    {
      "label": "aworktype",
      "apiParameterName": "activityType"
    }
  ],
  "durationDependencies": [
    {
      "label": "aworktype",
      "apiParameterName": "activityType"
    },
    {
      "label": "BookingStatisticProperty_1",
      "apiParameterName": "BookingStatisticProperty_1"
    },
    {
      "label": "BookingStatisticProperty_2",
      "apiParameterName": "BookingStatisticProperty_2"
    }
  ],
  "travelTimeDependencies": [
    {
      "label": "BookingStatisticProperty_3",
      "apiParameterName": "BookingStatisticProperty_3"
    },
    {
      "label": "BookingStatisticProperty_4",
      "apiParameterName": "BookingStatisticProperty_4"
    }
  ],
  "workZoneDependencies": [
    {
      "label": "WorkOrder.City",
      "apiParameterName": "city"
    },
    {
      "label": "WorkOrder.PostalCode",
      "apiParameterName": "postalCode"
    }
  ],
  "workSkillDependencies": [
    {
      "label": "aworktype",
      "apiParameterName": "activityType"
    },
    {
      "label": "XA_PROPERTY_1",
      "apiParameterName": "XA_PROPERTY_1"
    },
    {
      "label": "XA_PROPERTY_2",
      "apiParameterName": "XA_PROPERTY_2"
    },
    {
      "label": "XA_PROPERTY_3",
      "apiParameterName": "XA_PROPERTY_3"
    },
    {
      "label": "XA_PROPERTY_4",
      "apiParameterName": "XA_PROPERTY_4"
    },
    {
      "label": "XA_PROPERTY_5",
      "apiParameterName": "XA_PROPERTY_5"
    }
  ]
}

ビジネス上の利点

正常に予約コールを行うために、統合によって常に正しいデータが送信されるようにします。
統合の手動更新を回避して、構成の変更に自動的に適応します。
メンテナンス作業を最小限に抑え、見落とされた変更によるエラーを防止します。
進化するビジネス・ルール全体で一貫性のある正確な予約結果を提供します。

有効化のステップ

この機能を有効化するうえで必要な操作はありません。

ヒントと考慮事項

commonDependenciesの下のフィールドは常に必須です。
フィールドまたはプロパティは、複数のカテゴリに表示される場合があります。
レスポンスは常に動的に消費されます(ハード・コード・フィールド名は使用しないでください)。
予約の前に、このサービスを検証チェックポイントとして扱います。