更新23A

改訂履歴

本書は、既存の項の変更と、新規情報の追加に伴って、今後も引き続き更新されます。 これまでの更新内容は次の表のとおりです。

日付	モジュール	機能	ノート
2023年3月31日	プラグイン・フレームワーク	デブリーフィング・プラグインのRedwoodデザイン	OTNにリンクを追加しました。
2023年2月17日	統合	OFS-HCMアクセラレータを使用したリソースに対するリソース稼働可用性、Absence ManagementおよびパーティIDの更新	いくつかのイメージを更新し、'recipe'を'accelerator'に変更しました。
2023年1月23日			初版作成。

概要

アイデアはありますか。

私たちはここにいて、聞いています。 クラウド・サービスを改善する方法に関する提案がございましたら、一歩先を行き、オラクルに伝えてください。 Oracle Customer ConnectのIdeas Labなど、アイデアを送信するにはいくつかの方法があります。 機能名の後にこのアイコンが表示される場合は、アイデアの1つが提供されたことを意味します。

フィードバックをお寄せください

本書の内容改善のため、ご意見やご提案をお待ちしております。 フィードバックは、oracle_fusion_applications_help_ww_grp@oracle.comまでお送りください。

免責事項

この文書に記載された情報には、オラクルの製品開発プランに関する説明文が含まれていることがあります。 オラクルの製品開発プランと、今後の製品リリースの本質および時期に対し、様々な要因が大きく影響を及ぼします。 したがって、この情報はあくまで情報として提供されるものであり、マテリアルやコード、機能を提供することのコミットメント(確約)ではないため、購買決定を行う際の判断材料になさらないでください。 記載されている機能の開発、リリースおよび時期については、オラクルの単独の裁量により決定されます。

この情報は、オラクルおよびその子会社や関連会社との契約を構成するものではありません。 特にこの情報についてオラクルは一切の責任を負いかねます。 詳細は、法律上の注意点および使用条件を参照してください。

機能のサマリー

フィールド・サービス

管理

統計構成のRedwoodスタイル

概要

「統計構成」画面は、Redwoodスタイルに基づいて再設計されました。 変更は、すべての入力フィールドの表示方法に影響し、アプリケーションの残りの部分と一貫性を持たせます。

画面の再設計に加えて、次の変更が行われました:

デリバリ時間枠の最大サイズおよびデリバリ時間枠の開始制限のチェック・ボックスは削除されました。 以前にチェックマークを外した場合は、更新23Aへのアップグレード後、両方のフィールドを300分に設定できます。 次のスクリーンショットは、Redwoodスタイルの統計ページを示しています:

   

入力ボックスを選択すると、次のスクリーンショットに示すように、必要な値を説明するテキストがそのすぐ下に表示されます:

エントリが正しくない場合、次のスクリーンショットに示すように、エラー・メッセージが表示されます:

次のスクリーンショットに示すように、ほとんどのパラメータの影響を説明するために、ヘルプ・テキストが含まれています:

他のページとの一貫性を保つために、変更の適用ボタンがページの下部に移動されました。

Redwoodスタイルに対応する統計構成ページのルック・アンド・フィールを更新すると、他のOracle製品との一貫したユーザー・エクスペリエンスが提供されます。

有効化のステップ

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

主なリソース

Oracle Field Serviceの管理 : https://docs.oracle.com/en/cloud/saas/field-service/faadu/index.html

このリンクは、更新23A GAリリース後に使用可能になります。

生産能力

目標再計算のパフォーマンス向上

概要

割当ての再計算では、構成の複雑さによっては、かなりの時間がかかる場合があります。 これは、システムで発生する変更から割当て値への影響を確認するまでの遅延によって確認されます。

観察対象

• ほとんどの場合、アクティビティの変更後(追加、移動など)、および構成の変更後(作業スキル、作業ゾーン、リソース・カレンダなど)の再計算時間が短縮されます。

• 一時的に割り当てられたリソースを使用する構成では、すべての変更が関連するすべてのキャパシティ・エリアに反映されるようにするために、以前に2サイクルの再計算が必要だった変更があります。 再設計により、2回目の再計算は必要ありません。影響を受けるすべてのキャパシティ・エリアは、1サイクルで更新されます。 たとえば、リソース作業ゾーンが変更されると、「最大使用可能」および「使用済割当」パラメータが直近の再計算期間より後に更新され、以前は少なくとも2つ必要でした。

• 以前に再計算サイクルが必要だった変更の一部は、すぐに反映されます。 たとえば、目標値に影響するアクティビティの属性を変更すると、次の再計算サイクルを待機する必要がなくなります。

更新23Aでは、目標の再計算プロセスが大幅に再設計され、その結果、一部の構成(特に、一時的に割り当てられたリソース機能を使用する構成)のパフォーマンスが向上する可能性があります。

有効化のステップ

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

主なリソース

• キャパシティ・サービスの使用 : https://docs.oracle.com/en/cloud/saas/field-service/faccu/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

コア・アプリケーション

Dispatch Consoleのアド・ホック・フィルタ

概要

Oracle Field Serviceには、様々な基準に基づいてアクティビティをフィルタする機能があります。 ただし、これらのフィルタは、構成を担当するユーザーが事前構成する必要があり、(権限が適用された)システムのすべてのユーザーによって共有されます。

アド・ホック・フィルタリングを使用するには、ディスパッチ・コンソールを開き、「表示」ボタンをクリックします。 次に、「フィルタ」ドロップダウン・リストから「アド・ホック・フィルタ」を選択します。 新しいフィールドをフィルタに追加するには、フィールドを追加ボタンをクリックし、リストから目的のフィールドを選択します。 フィールドを選択した後、その値を指定できます。 フィールドに列挙プロパティが含まれている場合は、ドロップダウン・リストが表示されます。 値が指定されていない場合、フィールドはフィルタリングに参加しません。 フィールドが不要になった場合は、フィールドの横にある「-」ボタンをクリックして削除できます。

アクティビティを表示するには、フィルタに指定されたすべての値が一致する必要があります。 技術的には、AND条件を使用します。 列挙プロパティの場合、正確な値が使用されます。 文字列プロパティの場合、部分文字列が使用されます。 すべてのフィルタで大文字と小文字が区別されます。

同じフィールドに複数の値を指定できます。 列挙プロパティの場合、ドロップダウン・リストから複数の値を選択するだけです。 文字列プロパティの場合は、カンマで区切られた複数の値を指定します。 複数の値を指定した場合、フィルタは、アクティビティに少なくとも1つの値が含まれている場合に一致します。 このような場合、技術的にはOR条件が使用されます。

アド・ホック・フィルタに追加されたすべてのフィールドは、セッション間で保持されます。 ログアウト後にディスパッチ・コンソールを開くと、最初のフィルタは「*」になります。 「アド・ホック・フィルタ」を選択すると、前に構成したすべてのフィールドが表示されます。

アド・ホック・フィルタの例を次に示します:

制限事項

• 「ディスパッチ・コンソール」で使用できるフィールドのみ? 「リスト・ビュー」をフィルタに追加できます。
• アド・ホック・フィルタに追加できるフィールドは一度に10個のみです。

この機能により、エンド・ユーザーがアクセスできるものを完全に制御できます。 また、ディスパッチャがフィルタを保存したり他のユーザーと共有する必要なく、2つまたは3つのフィールドでフィルタする必要がある場合にも役立ちます。

有効化のステップ

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

主なリソース

• コア・アプリケーションの使用 : https://docs.oracle.com/en/cloud/saas/field-service/faaca/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

夜間終了時間後の開始済アクティビティの終了

概要

現在、夜間終了時に完了しなかったアクティビティを処理する際に問題が発生する可能性があります。 技術者が最終的にこのようなアクティビティを終了しても、このファクトはOracle Field Serviceに反映されなかったため、これらのアクティビティに関連するすべてのデータはアプリケーション内にありませんでした。

以前のバージョンとの比較

更新前23A:アクティビティおよび在庫に対するアクションは、夜間終了時間を超えて延長されたアクティビティでは実行できませんでした。 アクティビティ・プロパティおよびフィールド値に対する変更は制限されました。

更新23Aの新機能:夜間終了時間を超えて開始済ステータスのアクティビティでは、次のことができるようになりました:

• アクティビティ・ステータスをCompleted/Suspended/Not完了に変更
• インストール、取外しなどのインベントリでアクションを実行します。

動作

構成

夜間の終了時間後にアクティビティを完了する機能は、「ビジネス・ルール」ページにある夜間の更新アクティビティおよびオフライン同期の許可設定によって制御されます。 この設定に対して構成された期間中に、UIに適切なリンクおよびボタンが表示されます。

Oracle Field Serviceユーザー・インタフェース内での動作

アクティビティおよび在庫関連のリンクおよびボタンは、夜間終了時間を超えて開始済ステータスのアクティビティに対してのみ表示されます。 自分のルートおよびアクティビティ詳細ページを使用して処理を実行したり、管理および「ディスパッチ・コンソール'」ページ内で使用可能なアクティビティ・ヒントから処理を実行できます。 データはアプリケーションによって収集され、サーバーに同期されます。

「単一アクティビティおよびセグメント化可能アクティビティとそのセグメント」の新機能が導入されました。

ノート: 一度夜間の作業が終了した後で新しいアクティビティを開始したり、他のステータスのアクティビティの在庫を管理することはできません。

アクティビティ・ステータスの変更

夜間の終了時には、開始済アクティビティに対して次のステータス変更アクションを使用できます:

• 'End activity'   
• '未完了アクティビティ'
• 'Suspend activity'

アクティビティの一時停止のロジックは、次に説明するように新しい作業条件に調整されます:

1. 1つのアクティビティに対してアクティビティの一時停止処理を実行する場合、アプリケーション

• 元のアクティビティのルートに一時停止アクティビティを作成
• 元のアクティビティを未スケジュール・プールに移動し、そのステータスを保留中に変更し、ルート内の位置を未オーダーとして定義

2. 複数日アクティビティのセグメントを一時停止すると、アプリケーション

• 元のセグメントのルートに一時停止セグメントを作成
• それぞれ、マスター・セグメント化可能アクティビティの完了までの時間を一時停止セグメントの時間だけ増やします

ノート: 前述のように、アクティビティの一時停止操作が機能するように、適切なユーザー・タイプの未スケジュール・プールへのアクセスの許可設定を有効にする必要があります。

アクティビティ期間の調整

アクティビティ期間を調整する機能は、単一アクティビティとセグメント化可能アクティビティのセグメントの両方に保持されます。

次のアクティビティの選択および処理時間の変更

次のアクティビティを選択するか、アクティビティ処理時間を設定する権限は、特定の日の最後のアクティビティのUIでは使用できません。

在庫アクション

次の在庫処理は、夜間終了時間後の開始済アクティビティに関連する在庫に使用できます:

• 顧客に追加
• 必須に追加
• 在庫を削除
• 在庫のインストール
• 在庫の取外
• 導入済在庫の作成
• 取外済在庫の作成
• インストールを元に戻す
• アンインストールを元に戻す
• 在庫の交換
• 必要な在庫の取付
• 必須在庫の削除
• 必要な在庫の編集
• インストール済必須在庫の作成

これとは別に、ユーザーは在庫詳細ページおよびこのページに接続されているフォームを使用して、フィールド/プロパティの値を更新できます。 '「必要な在庫'」ページのフィールド値の変更もサポートされています。

重要: チーム・ワークでの作業中に、チーム・ホルダーのアクティビティからのi在庫アクションはアシスタントには使用できません。

APIサポート

夜間終了時間後に開始済ステータスのアクティビティの更新およびこれらのアクティビティに関連する在庫品目は、次のAPIコールを使用して受け入れることができます:

• イベント
• アクティビティの取得   
• アクティビティの取得   
• 在庫の取得

特定の日の日次抽出には、夜間終了時間後に実行されたアクションは含まれません。 次の日の日次抽出の自動生成を待機するか、すべてのアクティビティが完了したら日次抽出を手動で実行する必要があります。 その後、完全なデータ・セットを取得するために、2つの日次抽出ファイルの結果をマージする必要があります。

ノート: アウトバウンドAPIからのメッセージは、構成された夜間、ブロックされたままになります。

新機能により、夜間の終了時間後に作業中のアクティビティを完了できます。 この改善により、開始済アクティビティを最終ステータスに切り替え、これらのアクティビティに属する在庫を操作できます。 これにより、いくつかの目標が達成されます:

• 技術者は夜間の開始済アクティビティのレポートを継続できます
• アプリケーションは、ユーザー・インタフェースとAPIの両方を通じて一貫性のあるデータを提供
• 夜間の期間後に継続するアクティビティのデータを収集するために、Oracle Field Service以外のプロセスを作成する必要はありません

有効化のステップ

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

主なリソース

• コア・アプリケーションの使用 : https://docs.oracle.com/en/cloud/saas/field-service/faaca/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

付近のアクティビティ・ワークフローの改善

概要

ルート・マップから付近のアクティビティ・ツールを使用すると、ユーザーは付近の必要なアクティビティをすばやく識別して割り当てることができます。 ユーザーは次のことができます:

• マップ・ビューの割当可能アクティビティと、リスト内のアクティビティの詳細を確認
• 優先順位が高いアクティビティに注目します。これらはリストの上部に表示されます:
  • ビジネスの優先順位
  • SLAコンプライアンス
  • アクティビティ期間
• マップをフォーカスして、必須領域のアクティビティをフィルタで除外
• アクティビティのヒント内の詳細の確認
• マップ・ビュー内から顧客に電話
• 割当アシスタント・ツールの力を利用して、ルート内の他のアクティビティがどのように影響を受けるかを理解

機能の使用方法

ユーザーは、マップ・レイヤー・スイッチャからニアビー・アクティビティ・チェック・ボックスを選択することで、付近のアクティビティ・ワークフローを有効にできます。 このオプションを有効にすると、次のことが可能になります:

1. 周辺アクティビティはルート・マップにプロットされています。 これには、現在のリソースに割り当てられたバケットおよび未スケジュール・アクティビティと、現在のユーザーに表示されるバケットが含まれます。     
2. ルート・アクティビティのあるパネルは、「近郊のアクティビティ」パネルに置換されます。     
3. マップ・ビューの付近のアクティビティがパネルに反映されます。 マップをある領域にドラッグするか、ズーム・インすると、それに応じてパネル内のアクティビティが更新されます。

次の基準を満たす活動は、マップ・ビューとリスト・ビューの両方に表示されます:

• アクティビティまたは解決済住所からのX/Y座標があります
• 作業ゾーンと作業スキルは、リソースの作業ゾーンと一致する必要があります(または、アクティビティ移動での作業ゾーンの無視 / 作業スキルの不一致権限がユーザーに対して構成されている必要があります)
• 次のいずれかです:
  • 現在のリソースの未スケジュール・プール内
  • 現在のユーザーに表示されるバケットの未スケジュール・プール内
  • ルート・マップ・ページで選択した日に、現在のユーザーに表示されるバケットにスケジュールされます

「近郊のアクティビティ」パネルから少なくとも1つのアクティビティを選択すると、パネルの上部にある割当ボタンが使用可能になります。 割当ボタンをクリックすると、選択したアクティビティを移動するための割当アシスタント・ツールが開きます。 このスクリーンショットは、マップの「近郊のアクティビティ」パネルと付近のアクティビティ・チェック・ボックスを示しています:

付近のアクティビティ・パネル

パネルのアクティビティには、次のものが含まれます:

• チェックボックス。 パネルからアクティビティを選択すると、それがバブル・マーカーでマップ上で強調表示されます。 少なくとも1つのアクティビティが選択されると、選択したアクティビティの数とそれらが結合された期間がパネルの上部に表示されます。     
• 「ビジネス・ルール」で構成されているアクティビティ・マップ・マーカー 未スケジュールの未割当アクティビティ・マップ・マーカー。     
• 現在のユーザー・タイプに構成されているアクティビティ識別子。    
• 期日ラベルには、アクティビティSLA終了までの日数、またはSLA終了が経過した日数が表示されます。 ラベルは、アクティビティ・プロパティSLA終了が移入されたときに表示されます。    
• 詳細アイコン>は、アクティビティのヒントを開きます。

一度に最大100個のアクティビティをパネルに表示できます。

付近のアクティビティ・パネルでのソート

ソート・ボタンは、「近郊のアクティビティ」パネルで使用できます。 マップ・ビューのアクティビティは選択した方法で順序付けされ、その上位100がパネルに表示されます。

次のいずれかを選択できます:

• デフォルト - 「ビジネス・ルール」のビジネス要件で定義された優先度 未スケジュールおよび未割当のアクティビティ・マップ・マーカー
• 期日 - アクティビティ・プロパティSLA終了の値が小さいアクティビティが上部に表示されます。 SLA終了アクティビティ・プロパティが空の場合は、リストの下部に表示されます。    
• 期間、低から高 - アクティビティ期間に基づく
• 期間(高から低) - アクティビティ期間に基づく

このスクリーンショットは、「近郊のアクティビティ」パネルでアクティビティをソートするオプションを示しています:

アクティビティのヒント

ユーザーは、>アイコンをクリックして、ヒント内のアクティビティの詳細を表示できます。 ルート・アクティビティと付近アクティビティの両方で使用できます。 アクティビティのヒント用に構成されたボタンも使用できます。

ユーザーは、アクティビティ・ヒントから電話フィールドをタップして、顧客へのクイック・コールを実行できます。 この目的のために電話フィールドを構成する必要があります。 このスクリーンショットは、「近郊のアクティビティ」パネルのアクティビティのヒントを示しています:

付近のアクティビティ・ページとの組合せ

付近のアクティビティ・ボタンは、現在のユーザー・タイプのアクティビティ・リスト・コンテキスト・レイアウトに対して構成されると、「自分のルート」ページに表示されます。 このボタンを使用すると、次の項目が適用された状態でユーザーがルート・マップに移動します:

• レイヤー・スイッチャの付近のアクティビティ・チェックボックスは使用可能です
• 期日によるソートは使用可能です

新規セクションとは

近くのアクティビティ・ページは、ルート・マップと結合されています。 これで、ルート・マップ内から改善された付近のアクティビティ・ワークフローを使用できます。 ルート・マップのマップ・レイヤー・スイッチャの'「スケジューリング'」オプションは、'Nearby activities'に変更されました。

「ビジネス・ルール」ページのパラメータ'Nearby Radius'および'Nearby SLA'は削除され、付近のアクティビティ・ワークフローには含まれません。

期日バッジは、パネルに付近のアクティビティに対して表示されます。 アクティビティの「SLA終了」フィールドに関連しています。

ルート・マップのヒントは、他のページと統合され、処理ボタンが含まれています。

構成すると、付近のアクティビティ・ボタンが「自分のルート」ページに表示されます。

古い付近のアクティビティ・マップを使用している場合は、ルート・マップへの遷移が簡略化されます。 事前構成済の付近アクティビティ・ボタンにより、付近アクティビティ・オプションおよび期日でソートが適用されたルート・マップにユーザーがナビゲートされます。 ユーザーには、以前と同じような経験があります:

エクスペリエンスの前後

23Aより前	23A
旧付近のアクティビティ画面で使用可能な機能	ルート・マップの付近アクティビティ・フロー内に提供される機能。
マップ上のポイントを設定し、定義された半径からのアクティビティを表示	マップを必須領域にフォーカスし、この領域からのアクティビティがリストにのみ表示されます。
SLA終了でソートされたアクティビティを含む個別のパネルを参照	パネルで期日でソートを使用します。 期日バッジを含むアクティビティは、SLA終了プロパティに基づいています。

近接アクティビティをすばやく識別し、目的のリソースに割り当てることができます。

有効化のステップ

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

主なリソース

• コア・アプリケーションの使用 : https://docs.oracle.com/en/cloud/saas/field-service/faaca/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

フィルタ、キャパシティ・カテゴリおよびリンク・テンプレート構成ページのRedwoodスタイル

概要

この機能により、フィルタ、キャパシティ・カテゴリおよびリンク・テンプレートの構成ページの視覚的なルック・アンド・フィールが統合され、最新のRedwood UIエクスペリエンスに更新されます。 アプリケーションを構成するユーザーは、他のFusionページと同じユーザー・エクスペリエンスを持ちます。 見込み客および既存の顧客のデモ・セッションを実施するセールス・エンジニアは、Oracle Field Serviceの様々な機能を示すデモ・シナリオにこれらのページを含めることができます。

フィルタ、キャパシティ・カテゴリおよびリンク・テンプレートのメイン・ページ

フィルタ、キャパシティ・カテゴリおよびリンク・テンプレートのメイン構成ページがRedwood表として表示され、コンテンツの可視性が向上しました。 Redwood表では、プログレッシブ・ロードが使用されます。これにより、最初に項目の一部のリストを表示してから、リストをスクロール・ダウンしながら追加の項目をロードすることで、ページ・ロード時間が短縮されます。

リスト内の項目の合計数量を示すカウンタが、テーブルの右上隅に表示されます。 これは、フィルタ、キャパシティ・カテゴリ、リンク・テンプレート、プロパティ、カレンダおよび作業ゾーンを含むすべての表のようなページで機能します。 次に、キャパシティ・カテゴリ、リンク・テンプレートおよびフィルタ・ページのスクリーンショットを示します:

ページの追加/編集の変更

フィルタ、キャパシティ・カテゴリおよびリンク・テンプレートを作成および変更するページは、テキスト入力、ドロップダウン・メニュー、チェック・ボックスなど、Redwoodスタイル・コンポーネントを含む標準フォームとして表示されるようになりました。 次のスクリーンショットは、フィルタの追加、キャパシティ・カテゴリの編集および「リンク・テンプレートの追加」ページを示しています:

フィルタ条件の変更

フィルタ条件ページのレイアウトは、フィルタ条件行から直接データを編集できる表ビューとして表示されます。 クリック数を最小限に抑えることで、フィルタ条件を変更するプロセスがより効率的になりました。 このスクリーンショットは、「フィルタ条件」ページを示しています:

ダイアログ・ボックスの変更

キャパシティ・カテゴリおよびフィルタ構成ページのすべてのダイアログ・ボックスで、キャパシティ・カテゴリの作業スキルおよびタイム・スロットを構成するためのダイアログ・ボックス、グループ処理を確認するダイアログ・ボックスなど、Redwoodスタイルが使用されるようになりました。 次のスクリーンショットは、作業スキルの編集、タイム・スロットの編集および「フィルタの削除」ダイアログ・ボックスを示しています:

Redwoodスタイルに対応するフィルタ、キャパシティ・カテゴリおよびリンク・テンプレートのルック・アンド・フィールを更新すると、他のOracle製品との一貫したユーザー・エクスペリエンスが提供されます。

有効化のステップ

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

主なリソース

• コア・アプリケーションの使用 : https://docs.oracle.com/en/cloud/saas/field-service/faaca/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

生産資源事業所の統合ページ

更新23A以降、「リソースのロケーション」ページの住所は、アクティビティ・レコード内の「アクティビティ事業所の更新」オプションと同様に変更できます。

統合された「リソースのロケーション」ページは、リソースごとに個別のページとして開き、次の変更を加えます:

• ページは2つの側面に分かれています: 左側のフィールドと右側のマップ
• フィールド・ラベルおよび住所フィールド(住所、市区町村、郵便番号、都道府県および国)は変更されません。 統計ページで構成されたアクティビティ移動統計フィールドは、ラベル・フィールドの後に表示されます。

• 解決というタイトルの新しいボタンが追加されました。 このボタンをクリックすると、住所はアクティビティのロケーションの更新と同じ方法でジオコーディングされます。

• ユーザーがページの住所コンポーネントを変更すると、解決ボタンが有効になります。 クリックすると、無効になります。

• マップには、住所が解決された場合にアクティビティのロケーションが表示されます。 アドレスが解決されない場合は、対応する「アドレスが解決されていません」というメッセージが表示されます。

• 座標は、使用可能なときに左側のマップの下に表示されます。

• 終了ボタンは、アクションを実行せずにページを閉じます。

• 追加および更新ボタンは、解決ボタンをクリックした後に取得されたロケーションの住所フィールドおよび座標を更新します。

• 推奨住所セクション(Googleマップを使用している顧客にのみ使用可能)には、住所、市区町村、郵便番号、都道府県および国フィールドの値に基づいてGoogleジオコーディング・サービスによって提供される提案が含まれています。 可能な場合は、元の住所、市区町村、郵便番号、都道府県および国フィールドの値とは異なる住所の一部が太字で強調表示されます。 ユーザーは、このセクションから代替住所の一部をコピーし、編集可能なフィールドのいずれかに貼り付けることができます: 'Address', 'City', 'Postal Code', 'State'. 住所セクションは、ページが開いた後、および解決ボタンをクリックした後に更新されます。 別の住所がプロバイダから指定されていない場合、提示住所セクションは表示されません。

• 再配置ピンというタイトルのボタンがマップの下にあります。 次の場合に使用できます:
  • アドレスが高精度で解決される場合
  • アドレスが解決されたが精度が高くない場合
  • 住所を解決できなかったがおおよその事業所が使用可能な場合

• ピン・ロケーションを適切なロケーションに調整した後は、追加/更新ボタンを使用してリソース・ロケーションを座標で更新できます。 活動は次のように更新されます:
  • ユーザーが住所フィールドのみを変更し、解決ボタンをクリックすると、住所フィールドおよび座標が更新されます。        
  • ユーザーがアドレスを変更せずにピンを再配置した場合、座標のみが更新されます。

• 住所の解決後に高いロケーション精度を達成できない場合、ユーザーはマップ上のピン・ロケーションを変更してリソースのロケーションを更新する必要があります。 マップ上でロケーションを手動で更新すると、座標精度は高と見なされます。

リソースのロケーションの追加のスクリーンショット:

リソース・ロケーションの編集のスクリーンショット。 アドレスが解決されました:

再配置ピンを使用して手動で位置を調整するスクリーンショット:

この機能の利点は次のとおりです。

• Googleが提供する代替アドレスを参照してください。
• 住所のコンポーネントを変更し、住所が解決されるときにオプションを確認します。
• マップ上のリソース・ロケーションを確認してください。
• 選択したロケーションの更新された住所と座標を設定します。
• 高精度で解決される場合は、手動でロケーションを調整します。

有効化のステップ

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

主なリソース

• コア・アプリケーションの使用 : https://docs.oracle.com/en/cloud/saas/field-service/faaca/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

統合

Siebel CRMおよびOracle Field Serviceを使用したポイントの予約および活動の割当

概要

この機能では、Oracle Integration (OIC)アクセラレータを作成して、Siebel CRMをOracle Field Serviceと統合します。 このアクセラレータは、次の主要な機能をサポートしています:

• Siebel CRMを使用してフィールド・サービスのポイントを予約し、Oracle Field Serviceのフィールド技術者にアクティビティを割り当てます。        
  • Siebel CRMはプライマリ・サービス・アプリケーションとして残りますが、タイム・スロットの予約や、必要なスキルおよび可用性を持つ一致するリソースの検索などのスケジュール情報は、Oracle Field Serviceから取得されます。 この情報に基づいて、フィールド・サービス・アクティビティがSiebelで作成され、Oracle Field Serviceのフィールド技術者に直接割り当てられます。 ディスパッチャまたはフィールド技術者は、Oracle Field Serviceアプリケーションを使用してアクティビティの詳細を表示できます。

• 従業員(フィールド技術者)情報をSiebel CRMからOracle Field Serviceに転送します。        
  • Siebelから基本的な従業員連絡先情報をフェッチして、Oracle Field Serviceでフィールド・リソースを作成/更新します。        
  • フィールド・リソースのスキル、ロケーション、作業ゾーンおよび勤務スケジュールを作成/更新します。

統合でサポートされる主要なシナリオ

• 予約の予約と確認
• アクティビティの更新、再スケジュールおよび取消
• Siebel CRMからOracle Field Serviceへのサービス・リージョン情報の転送
• Siebel CRMからOracle Field Serviceへの従業員データ転送

1. ブックおよび確認Appointment

通常の予約シナリオでは、顧客が会社に連絡してサービスをリクエストします。 顧客コンタクトはリクエストをレビューし、サービス・リクエストを作成します。 このリクエストでフィールド・サービス技術者によるサイト訪問が必要な場合は、Siebelでアクティビティが作成され、対応するアクティビティがOracle Field Serviceの技術者に割り当てられます。 顧客サービス担当者は、Siebelで顧客の予約ウィンドウを検索します。 Oracle Field Serviceでは、アクティビティに必要なスキルと、そのアクティビティに関連付けられたサービス・リージョン(zipコード)を考慮してポイント・スロットが提供されます。 顧客サービス担当は、顧客とのポイントを確認して、Oracle Field Serviceで技術者の新規アクティビティを作成します。

この統合では、ポイントの予約および確認の一部として次の主要なシナリオがサポートされます:

• より広い時間ウィンドウでポイントを予約して確認
• アポイントメントを優先リソースで予約および確認(割当をロック)
• 優先時間ウィンドウでポイントを予約する(スケジュールをロック)
• アポイントメントを優先リソースおよび優先タイム・スロットで予約および確認(割当のロック+スケジュールのロック)
• アクティビティの挿入: SLAに基づいた最早の使用可能なタイム・スロットに基づく優先度の高い予約

より広い時間ウィンドウでのポイントの予約と確認

サービス・エージェントは、技術者がサイトにアクセスしてジョブを実行できる特定の日付(たとえば、月曜日の午前9時から火曜日の午後5時まで)の時間ウィンドウについて顧客に確認します。 この入力に基づいて、サービス・エージェントは最良の使用可能な日時スロットにアクティビティを割り当てます。

サービス・エージェントは、最初のステップとして、次の詳細を含む活動をSiebel内に作成します:

• 最早開始時間と最遅開始時間。 これは、より広い時間ウィンドウです(たとえば、月曜日の午前9時から火曜日の午後5時まで)。    
• アクティビティ期間(例: 30分)
• サービス・リージョン・タイムゾーン
• サービス郵便番号
• スキル    
• 割当のロックおよびスケジュールのロック・オプションはSiebelからオフになります

活動が作成されると、エージェントはこの活動をスケジュールするための適切なタイム・スロットを検索し、Siebel内のポイントの予約オプションをクリックします。 Oracle Field Serviceは、Siebelから受信したすべての入力を考慮して、リクエストされた時間ウィンドウで使用可能なすべてのタイム・スロットおよびリソースを提供します。 リクエストされたタイム・スロットで使用可能な一致するリソースがない場合は、警告メッセージ「リクエストされたタイム・スロットにリソースが見つかりません」がSiebelに表示されます。

予約の確認

CSRは、「予約ポイント」ポップアップ・ウィンドウからタイム・スロットおよび従業員(Oracle Field Service内のリソース)を選択し、「確認」ボタンをクリックします。 次の詳細とともに、Oracle Field Serviceで選択したリソースに新しいアクティビティが割り当てられます:

• SiebelのポイントIDとしての作業指示
• Siebelから選択した従業員IDとしての外部ID
• Siebelから選択された計画開始時間と計画終了時間としてサービス・ウィンドウ開始およびサービス・ウィンドウ終了
• 住所はSiebelの住所として更新されます
• 市区町村、都道府県およびZip/郵便番号は、Siebelからの対応するデータで更新されます
• アクティビティ期間は、ポイントの予約中にサービス・エージェントによって提供される期間として更新されます

Siebelポイントで次の詳細が更新されます:

• ステータスは「未開始」に設定されます
• 「計画開始/計画終了」フィールドは、選択したタイム・スロットで更新されます
• 選択したリソースは、スケジューリング詳細の「従業員」フィールドで更新されます

優先リソース (Lock assignment)でポイントを予約

サービス・エージェントは、特定の時間ウィンドウ中に特定のリソースの使用可能なタイム・スロットをチェックし、その時間ウィンドウでそのリソースにアクティビティを割り当てます。

Siebelからの入力には次のものが含まれます:

• Employee ID   
• 最早開始時間と最遅開始時間(たとえば、月曜日の午前9時から火曜日の夕方午後5時まで)
• アクティビティ期間(例: 30分)
• サービス・リージョン・タイムゾーン
• サービス郵便番号
• スキル    
• 割当のロックが選択されており、スケジュールのロックが選択されていません

Oracle Field Serviceからの出力が必要です:

• 時間ウィンドウ内の特定のリソースで使用可能なすべてのスロット。 スロットが存在しない場合は、エラーが返されます。    
• 指定した時間内にアクティビティがOracle Field Serviceに作成されます。 リクエストされたタイム・スロットで使用可能な一致するリソースがない場合は、警告メッセージ「リクエストされたタイム・スロットにリソースが見つかりません」がSiebelに表示されます。

優先時間ウィンドウでポイントを予約する(スケジュールをロック)

この場合、サービス・エージェントは特定のタイム・スロットで使用可能なリソースをチェックし、そのタイム・スロットのアクティビティを一致するリソースに割り当てます。

Siebelで活動を作成する際に入力される内容は次のとおりです:

• 最早開始時間と最遅開始時間(たとえば、月曜日の午前9時から火曜日の夕方午後5時まで)
• アクティビティ期間(例: 30分)
• サービス・リージョン・タイムゾーン
• サービス郵便番号
• スキル
• 計画開始
• 計画終了
• 割当のロックが選択解除され、スケジュールのロックが選択されています。

Oracle Field Serviceからの出力が必要です:

• Oracle Field Serviceは、サービス・エージェントによって提供される計画開始時間と計画完了時間に基づいて、使用可能なリソースおよび時間を提供します。    
• アクティビティは、計画開始時間と計画完了時間に指定されたタイム・スロットでOracle Field Serviceに作成されます。 リクエストされたタイム・スロットで使用可能な一致するリソースがない場合は、警告メッセージ「リクエストされたタイム・スロットにリソースが見つかりません」がSiebelに表示されます。

アポイントメントを優先リソースおよび優先タイム・スロットで予約および確認(割当のロック+スケジュールのロック)

サービス・エージェントは、特定のタイム・スロット内の特定のリソースの可用性を確認し、その時間ウィンドウでそのリソースにアクティビティを割り当てます。

Siebelからの入力:

• リソース
• 最早開始時間と最遅開始時間(たとえば、月曜日の午前9時から火曜日の夕方午後5時まで)
• アクティビティ期間(例: 30分)
• サービス・リージョン・タイムゾーン
• サービス郵便番号
• スキル
• 計画開始
• 計画終了
• 割当のロックがチェックされ、スケジュールのロックがチェックされます。

Oracle Field Serviceからの出力が必要です:

• アクティビティは、計画開始時間と計画完了時間で指定された時間にOracle Field Serviceで作成されます。 リクエストされたタイム・スロットで使用可能な一致するリソースがない場合は、警告メッセージ「リクエストされたタイム・スロットにリソースが見つかりません」がSiebelに表示されます。

アクティビティの挿入: SLAに基づく最早の使用可能なタイム・スロットに基づく優先度ベースの予約

サービス・エージェントは、顧客が共有するスケジュールに基づいて、最早の使用可能なタイム・スロットのポイントを作成する必要があります。 統合により、正確なスロットにアクティビティが直接作成されます(一致するリソースの場合)。

Siebelからの入力:

• リソース
• 最早開始時間と最遅開始時間(たとえば、月曜日の午前9時から火曜日の夕方午後5時まで)
• アクティビティ期間(例: 30分)
• サービス・リージョン・タイムゾーン
• サービス郵便番号
• スキル

Oracle Field Serviceからの出力が必要です:

• 使用可能なリソースで指定された時間について、アクティビティがOracle Field Serviceに作成されます。 リクエストされたタイム・スロットで使用可能な一致するリソースがない場合は、警告メッセージ「リクエストされたタイム・スロットにリソースが見つかりません」がSiebelに表示されます。

2. アクティビティの更新、再スケジュールおよびCancel

アクティビティの更新

サービス・エージェントは、Siebelで活動を作成した後で活動スキル要件を更新できます。 これにより、必要なスキルを持つ別のリソースにアクティビティが再割当されます。

Siebelからの入力が必要です:

• リソース
• 最早開始時間と最遅開始時間(たとえば、月曜日の午前9時から火曜日の夕方午後5時まで)
• アクティビティ期間(例: 30分)
• サービス・リージョン・タイムゾーン
• サービス郵便番号
• スキル

Oracle Field Serviceからの出力が必要です:

• リクエストで更新されたスキルを持つ新規リソースにアクティビティを再割当します。

Oracle Field Serviceのフィールド技術者またはディスパッチャによる次のアクションによって、Siebelのアクティビティ詳細が更新されます:

• アクティビティ完了:Oracle Field Serviceの活動状況"完了"は、Siebelの活動状況を"完了"に更新
• アクティビティは未完了として更新されます:Oracle Field Serviceの活動状況が「未完了」の場合、Siebelの活動状況は「未完了」として更新されます
• アクティビティはフィールド技術者間で移動されます:新しいリソースの外部IDがSiebelでアクティビティの「従業員プライマリ所有者ID」として更新されます
• アクティビティは同じフィールド技術者の別の日付に移動されました:Siebelで新規活動開始日が「計画開始」および「計画完了」として更新されます
• アクティビティが取り消された場合:Oracle Field Serviceの活動状況"取消済み"は、Siebelの活動状況を"取消済み"に更新

アクティビティの取消

CSRは、Siebel内の「アクティビティの取消」ボタンをクリックして、すでにスケジュールされているアクティビティを取り消すことができます。 これにより、Oracle Field Serviceの対応するアクティビティが取り消されます。

活動の再スケジュール

CSRは、現在の日付からSiebel内の別の日付に活動を再スケジュールできます。 アクティビティは、指定された新しい日付に基づいてOracle Field Serviceで更新されます。

3. Siebelサービス・リージョンのOracle Field Serviceへの転送

サービス・リージョンは、製品に関連する特定のアクティビティ・セットのサポートなど、地理的領域におけるフィールド・サービス技術者のグループです。 サービス・リージョンは、サービス・マネージャが多数の従業員に対して一貫したスケジュール、制約およびコストを設定できるようにすることで、管理上の負担を軽減します。 Siebel CRMのサービス・リージョンは、Oracle Field Serviceバケットにマップされます。

Siebel CRMからOracle Field Serviceへのサービス・リージョン情報の転送は、Siebelのサービス・リージョン管理者によって開始されます。 これにより、サービス・リージョンおよび従業員(そのサービス・リージョンで受信)情報がOracle Field Serviceに初期移行されます。

この統合の前提条件

• 管理者は、最初にSiebelのEngine=iLogのサービス・リージョンと、サービス・リージョンのスケジュール、サービス・リージョンの例外スケジュール、従業員、およびサービス・リージョンの郵便番号を設定する必要があります。

• 同じ名前のスケジュールもOracle Field Serviceに作成する必要があります。

• 準備ができたら、サービス・リージョンのリスト・ビューから「OFSに転送」ボタンをクリックして、サービス・リージョンをOracle Field Serviceに移行できます。 サービス・リージョンの'Engine'フィールドは"Oracle Field Service"に設定されます。

• これにより、Siebelサービス・リージョンと同じ名前の新規バケットがOracle Field Serviceに作成され、そのバケットのすべての関連データが更新されます。

サービス・リージョンとバケット間のフィールド・レベルのマッピング

Siebel - サービス・リージョン	Oracle Field Service - リソース(タイプ): バケット)
サービス・リージョンID	外部ID
名前	バケット名
該当なし	リソース・タイプ(デフォルトは"BK")
言語コード	Language
サービス・リージョン・タイムゾーン名	タイムゾーン(Oracle Integrationでの参照)
該当なし	親外部ID(「SUNRISE」にデフォルト設定)
該当なし	ステータス(フィールド・リソースの「アクティブ」にデフォルト設定)

• リソース・タイプ - リソース・タイプは、Oracle Field Service 'bucket'リソース・タイプを参照する"BK"のデフォルト値で構成されていますが、これはOracle Integration Cloudの参照値として構成されているため、ビジネス要件に基づいて同じものを更新できます。

• タイム・ゾーン - タイム・ゾーンはデフォルト値の「Eastern」で構成されていますが、これはOracle Integration Cloudの参照値として構成されているため、ビジネス要件に基づいて同じものを更新できます。

• 親外部ID - 親外部IDのデフォルト値は"SUNRISE"ですが、これはOracle Integration Cloudの参照値として構成されているため、ビジネス要件に基づいて同じものを更新できます。

• https://docs.oracle.com/en/cloud/paas/integration-cloud/integrations-user/managing-lookups.html

サービス・リージョン転送とともに、次のイベントも発生します:

• 現場技術者として従業員情報(このサービス・リージョン内の従業員)をOracle Field Serviceに転送します。    
• 従業員の勤務スキル、勤務スケジュール、勤務スケジュールの例外および事業所情報をOracle Field Serviceに転送します。

例外時間

例外は、特別な非稼働日または勤務日を表します。 例外レコードごとに異なるサイトの例外を定義できます。たとえば、サイトの米国祝日や別のサイトのカナダ祝日などです。 スケジュールの例外として、日単位または連続する日単位のブロックを定義できます。 場合によっては、例外時間数は非稼働期間を定義できます。たとえば、7x12スケジュールでは、日曜日の午前6時から午前12時までの作業はありません。 また、例外時間は、通常の勤務日ではない日(たとえば、5x8スケジュールの土曜日の朝)に作業期間を定義できます。

例外をスケジュールに関連付けるには、例外を定義し、この例外をスケジュールの定義に含めます。

例外時間を使用してアクティビティの所有者のスケジュール済タイム・スロットをブロックし、同じタイム・スロットのアクティビティに別の従業員割当を許可することもできます。 アクティビティの所有者に対してアクティビティがスケジュールされているときに定義済の例外時間がタイム・スロットをブロックした場合、サービス・リージョンを再ロードするとアクティビティが再スケジュールされます。

Siebelで例外時間を設定する方法については、https://docs.oracle.com/cd/E14004_01/books/FieldServ/FieldServScheduling29.htmlを参照してください。

Siebelからのサービス・リージョン郵便番号は、Oracle Field Serviceで作業ゾーンとしてマップされます。 そのため、統合が機能するには、Oracle Field Serviceの作業ゾーン・キーを'zip/postal code'に設定する必要があります。

統合エラーのトラブルシューティング

Sr.番号	シナリオ	エラー・メッセージ	トラブルシューティング方法
1	サービス・リージョンAPIの取得に失敗しました	Siebel: サービス・リージョン詳細の取得中にエラーが発生しました	Siebelチームと確認し、Siebelインスタンスが動作しているかどうかを確認
2	Workzone APIの作成/更新に失敗しました	OFS: 郵便番号の複数サービス・リージョンへのマッピングまたはワーク・ゾーンの更新中にエラーが発生しました	いずれかの郵便番号がすでに別のサービス・リージョンに関連付けられているかどうかを確認してください
3	Workzone APIの作成/更新に失敗しました	Siebel: サービス・リージョンの郵便番号がありません。 OFS: ワーク・ゾーンの更新中にエラーが発生しました	郵便番号をサービス・リージョンに追加して再度同期
4	サービス・リージョン取得レスポンスにスケジュールIDがない場合	Siebel: エラー - サービス・リージョンに関連付けられたシフトがありません	サービス・リージョンへのスケジュールの関連付け
5	例外時間数の取得API失敗	Siebel: エラー - 例外時間が関連付けられていないか、例外時間を取得中にエラーが発生しました	祝日例外がサービス・リージョンのスケジュールに正しく関連付けられているかどうかを確認
6	スケジュール名がOFSで作成された勤務スケジュールと一致しない場合	OFS: 勤務スケジュールが定義されていません。スペルが誤っているか、勤務スケジュールの設定中にエラーが発生しました	Siebelスケジュール名を使用してOFSで勤務スケジュールを作成
7	従業員APIの取得に失敗しました	Siebel: 従業員の取得中にエラーが発生しました	Siebel APIが動作しているかどうかSiebelチームに確認してください

Siebel CRMからOracle Field Serviceへのフィールド・サービス従業員の転送

• Oracle Integrationのこのワークフローでは、サービス・リージョン内の従業員がサービス・リージョン転送プロセスとともにOracle Field Serviceに転送されます。 Siebelでは、'engine'属性値が"Oracle Field Service"の従業員はフィールド・サービス・リソースとして扱われます。統合では、これらの従業員のみがOracle Field Serviceに転送されます。    
• 従業員レコードとともに、その住所(自宅またはデポ)、スキル、例外時間(休暇、ミーティングなど)も、リソースのロケーション、リソースのスキルおよびスケジュールとしてOracle Field Serviceに転送されます。

リソース・ロケーションへのSiebel従業員アドレスの転送

• Oracle Field Serviceリソースの作業開始ロケーションおよび作業終了ロケーションは、開始および終了ホーム・アドレスまたはデポ・アドレスに基づいて更新されます。

• 従業員シフト開始がデポとして構成されている場合、または空白の場合、統合によってリソース開始事業所が開始デポ住所として更新されます。 その他のすべての条件では、開始ロケーションは開始自宅住所に関連付けられた事業所になります。

• 同様に、従業員のシフト終了がデポとして構成されている場合、または空白の場合、終了ロケーションは終了デポ住所になります。 その他のすべての条件では、終了ロケーションは終了自宅住所に関連付けられた事業所になります。

Siebel従業員スキルをリソース・スキルに転送

• 従業員スキルは、従業員スキル統合の一部としてOracle Field Serviceのリソース・スキルとして更新されます。

Siebel従業員のスケジュールをリソース・スケジュールに転送

• この統合の前提条件として、Oracle Field Service管理者ユーザーは、Siebelスケジュール名と同じ名前のOracle Field Serviceカレンダ構成としてスケジュールを作成する必要があります。 従業員データ転送ワークフローの一環として、Siebelは従業員に関連付けられたスケジュール名を共有し、Oracle Field Serviceリソース・カレンダのスケジュールとして更新されます。 Siebelスケジュールに対応する一致するスケジュールがOracle Field Serviceにない場合、リソースはスケジュールなしでOracle Field Serviceに作成され、Siebelでエラー・メッセージが更新されます。

Siebel従業員例外時間の転送

• この統合では、祝日、作業例外(ミーティング、トレーニングなど)が一部のシナリオで処理されます。たとえば、フィールド技術者は、7x12スケジュールで日曜日の午前6時から午前12時までの作業がなく、Siebelでは通常の勤務スケジュールの例外として構成できます。

• 例外時間(祝日) - Siebelのスケジュールに祝日例外が含まれている場合、統合によって、Oracle Field Serviceリソース・カレンダに非稼働日としてこの祝日が適用されます。

• 勤務例外時間 - Siebelの従業員に作業例外時間(ミーティング、トレーニングなど)が含まれている場合、フィールド技術者の空き状況を適宜更新できるように、この期間中に内部アクティビティが作成されます。

• 非稼働日の超過勤務 - Siebelの従業員に超過勤務例外が含まれている場合、統合によってその非稼働日のOracle Field Serviceリソース・カレンダにスケジュールとして適用されます。

統合エラーのトラブルシューティング

Sr.番号	シナリオ	エラー・メッセージ	トラブルシューティング方法
1	サービス・リージョン・リソースAPIの作成に失敗しました	OFS: サービス・リージョン・バケットの作成中にエラーが発生しました	OFSリソースAPIが停止しているかどうかを確認するか、サービス・リージョンの欠落情報を更新してください
2	従業員リソースの作成API失敗	OFS: 従業員の作成中にエラーが発生しました	OFSリソースAPIが停止しているかどうかを確認するか、従業員の欠落情報を更新してください
3	従業員事業所の取得API失敗	Siebel - 従業員のロケーションの取得中にエラーが発生しました	OFSリソース・ロケーションAPIが停止しているかどうかを確認
4	従業員シフトの取得API失敗	Siebel: エラー - シフトが関連付けられていないか、シフトの取得中にエラーが発生しました	Siebel Shifts APIがダウンしているかどうかを確認するか、Siebelのシフト・データを修正してください
5	祝日例外の設定API失敗	OFS: 従業員に例外を設定中にエラーが発生しました	OFSリソース勤務スケジュールAPIが停止しているかどうかを確認するか、Siebelで例外データを修正してください
6	従業員スキルの取得API失敗	Siebel: 従業員スキルが関連付けられていないか、従業員スキルの取得でエラーが発生しました	SiebelスキルAPIが停止しているか確認するか、Siebelのスキル・データを修正してください
7	従業員スキル項目の取得API失敗	Siebel: 従業員スキル項目の取得中にエラーが発生しました	Siebelスキル項目APIが停止しているか確認するか、Siebelのスキル項目データを修正してください
8	作業スキルAPIの作成に失敗しました	OFS: 作業スキルの作成中にエラーが発生しました	OFSスキル作成APIが停止しているかどうかを確認するか、Siebelのスキル・データを修正してください
9	従業員例外の取得API失敗	OFS: 例外の取得中にエラーが発生しました	Siebel従業員例外APIが停止しているかどうかを確認するか、Siebelの従業員例外データを修正してください

サービス・リージョン郵便番号

バケットの基本情報が更新されると、統合によって、Siebelサービス・リージョンからOracle Field Serviceに郵便番号が移行されます。 新しいサービス・リージョンの移行中、統合では、Oracle Field Serviceに同じ名前の作業ゾーンがすでにあるかどうかを確認します。 使用可能な作業ゾーンがある場合は、その作業ゾーンがバケットに対して更新されます。 これが新しい作業ゾーンである場合、統合によってOracle Field Serviceに新しい作業ゾーンが作成されます。 郵便番号は、Oracle Field Serviceの作業ゾーン・キーとしてマップされます。

サービス・リージョンおよび従業員の増分更新

• サービス・リージョンの初期移行とは別に、ビジネス管理者がサービス・リージョンに関連付けられた郵便番号または祝日の例外を更新すると、Oracle Field Serviceでも更新されます。    
• 同様に、ビジネス管理者が従業員に関連付けられた次の情報を更新すると、Oracle Field Serviceで段階的に更新されます:
  • 従業員の基本情報
  • 従業員事業所
  • その従業員に関連付けられたサービス・リージョン
  • その従業員に関連付けられた作業スキル
  • その従業員に関連付けられた勤務例外時間数および非勤務例外時間数

3. Siebel CRM間のフィールド・レベル・マッピング & Oracle Field Service

フィールド・レベル・マッピング: SiebelおよびOracle Field Service

Siebel	Oracle Field Service
サービス・リージョン	リソース(タイプ・バケット)
サービス・リージョンID	リソース外部ID
名前	リソース名
	リソース・タイプ(デフォルトは"BK")
言語コード	Language
サービス・リージョン・タイムゾーン名	タイム・ゾーン(Oracle Integrationで参照)
	親リソースID (デフォルトは「SUNRISE」)
	ステータス(フィールド・リソースの「アクティブ」にデフォルト設定)
サービス・リージョン郵便番号	WorkZone
サービス・リージョン名	WorkZone名
サービス・リージョン名	WorkZoneラベル
	ステータス(「アクティブ」にデフォルト設定)
	移動エリア(「sunrise_enterprise」にデフォルト設定)
郵便番号	キー(配列)
郵便番号	シェイプ(配列)
	開始日(デフォルトは現在の日付)
サービス・リージョン・シフト	勤務スケジュール
シフト名	scheduleLabel
	開始日(デフォルトは現在の日付)
	作業中(デフォルトは'true')
サービス・リージョン例外時間	勤務スケジュール
例外時間名	コメント
例外時間開始日	開始日
	作業中(デフォルトはfalse)
例外時間終了日	終了日
	nonWorkingReason (デフォルトは"HOLIDAY")
	recurEvery (デフォルトは"1")
	recurrenceType (デフォルトは"daily")
	recordType (デフォルトで「非稼働」に設定)
	shiftType(defaulted to "regular")
従業員	リソース
従業員行ID	リソースID
パーティ名	リソース名
	リソース・タイプ(「PR」にデフォルト設定)
言語コード	Language
サービス・リージョン・タイムゾーン名/タイムゾーン名	タイム・ゾーン(OICで検索)
サービス・リージョンID	親ResourceId
	ステータス(フィールド・リソースの「アクティブ」にデフォルト設定)
勤務先電話番号	電話
従業員事業所	リソース・ロケーション
従業員行ID	ResourceId
Label(default to "Work Location")
開始デポ住所	住所
開始デポ国	国
開始デポ市区町村	市区町村
開始デポ状態	State
開始デポ郵便番号	postalCode
Label(default to "Home Address")
プライマリ開始自宅住所	住所
プライマリ開始自宅国	国
プライマリ開始自宅市区町村	市区町村
プライマリ開始ホームの状態	State
プライマリ開始自宅郵便番号	郵便番号
Label(default to "Work Location")
終了デポ・アドレス	住所
最終デポ国	国
最終デポ市区町村	市区町村
デポ終了状態	State
最終デポ郵便番号	郵便番号
Label(default to "Home Address")
プライマリ・エンド自宅住所	住所
プライマリ終了自宅国	国
プライマリ終了ホーム市区町村	市区町村
プライマリ終了ホームの状態	State
プライマリ終了自宅郵便番号	郵便番号
プライマリ開始自宅郵便番号	postalCode
Label(default to "Work Location")
終了デポ・アドレス	住所
最終デポ国	国
最終デポ市区町村	市区町村
デポ終了状態	State
最終デポ郵便番号	郵便番号
Label(default to "Home Address")
プライマリ・エンド自宅住所	住所
プライマリ終了自宅国	国
プライマリ終了ホーム市区町村	市区町村
プライマリ終了ホームの状態	State
プライマリ終了自宅郵便番号	郵便番号
従業員例外時間(続き)	勤務スケジュール(続き)
例外時間終了日	終了日
	nonWorkingReason (デフォルトは"HOLIDAY")
	recurEvery (デフォルトは1)
	recurrenceType (デフォルトは"daily")
	recordType (デフォルトで「非稼働」に設定)
	shiftType (デフォルトは"regular")
従業員スキル	作業スキル
従業員行ID	リソースId
従業員スキル項目	作業スキル名
熟達度	比率
従業員例外時間(続き)	勤務スケジュール(続き)
例外時間終了日	終了日
	nonWorkingReason (デフォルトは"HOLIDAY")
	recurEvery (デフォルトは1)
	recurrenceType (デフォルトは"daily")
	recordType (デフォルトで「非稼働」に設定)
	shiftType (デフォルトは"regular")
従業員スキル	作業スキル
従業員行ID	ResourceId
従業員スキル項目	作業スキル名
熟達度	比率

Oracle Integration構成:

次に、様々なエンティティのOracle Integration構成を示します:

参照

参照構成は、顧客がOracle Field Serviceの類似エンティティと異なる値を持つSiebelをマップするのに役立ちます。たとえば、サービス・リージョンIDはOracle Field ServiceでリソースIDとして処理できます。

顧客ビジネスの性質に基づいて、値が異なる場合があります。 顧客は、ビジネス要件に従ってこれらの参照表を構成し、Oracle Integrationで同じ統合を実行できます。

このレシピで使用される参照はホームの下にリストされますか? 統合? Oracle Integrationの参照。 構成する参照の名前をクリックし、「+」アイコンをクリックしてさらに値を追加します。

Oracle Integrationの参照

Oracle Integration参照	Siebel値の例	Oracle Field Service値の例	説明
ORCL-BRT-SBL_OFS_ACTIVITY_STATUS	未開始	待ち状態	OFSアクティビティ・ステータスをSiebelアポイントメント・ステータスにマップ
ORCL-BRT-SBL_OFS_TIMEZONE	(GMT-08:00) Baja California Norte、Tijuana	東部	Siebel時間値をOFSタイムゾーン値にマップします。
ORCL-BRT-SBL_OFS_LANGUAGE_CODE	ENU	en	Siebel言語コード値をOFS言語コード値にマップします。
ORCL-BRT-SBL_OFS_WEEKDAY	日曜日	太陽	Siebelの曜日の値をOFSの曜日値にマップします。
ORCL-BRT-SBL_OFS_GLOBAL_CONFIG	BK	BK	Siebelグローバル構成値をOFSグローバル構成値にマップします。
ORCL-BRT-SBL_OFS_NONWORKING_REASON	病欠時間	ILLNESS	Siebelグローバル構成値をOFSグローバル構成値にマップします。
ORCL-BRT-SBL_OFS_ACTIVITY_TYPE	アポイントメント	siebelActivityType	Siebel活動タイプ値をOFS活動タイプ値にマップします。
ORCL-BRT-SBL_OFS_FMR_LIMIT	Ofs_FMR_Limit	25	一致するリソースの検索の限度フィールドのデフォルト値
ORCL-BRT-SBL_OFS_SKILL	エキスパート	100	Siebelスキル値をOFSスキル値にマップします。
ORCL-BRT-SBL_OFS_EMPLOYEE_TYPE	従業員	技術者	Siebel従業員タイプ値をOFSユーザー・タイプ値にマップ
ORCL-BRT-SBL_COUNTRY_CODE	米国	US	Siebel国コードをOFS国コード値にマップします。

接続構成

• 統合にナビゲートして接続ページに移動しますか。ホーム・ページからナビゲーション・サイドバーまでのパッケージ。 インストール済パッケージのリストが表示されます。 「orcl.ba.sbl _ofs_sync」という名前のパッケージを検索し、「Connections」セクションまで下にスクロールします。    
• 接続名をクリック - Oracle SBL-OFS REST OFS接続。次の図のステップ1-5に従って接続を構成します。

• 接続名をクリック - Oracle SBL-OFS REST Siebel Connectionは、次の図のステップ1-5に従って接続を構成します:

• 接続名をクリック - 次の図のステップ1-6に従って、Oracle SBL-OFS OFSCアダプタ接続を構成し、接続を構成します:

Oracle Integrationフローのトラブルシューティング・ステップ

1)予約の失敗

症状: 予約ポイントは空白のスロットを返します

理由: アクティビティをスケジュールするためのスロットは返されません。 指定した時間枠内に使用可能なリソースがない可能性があります。

解決策: アカウント住所詳細が指定されていることを確認してください。

前の開始日と最遅開始日を他の日時範囲に変更します。

2)予約の失敗

症状: Oracle Integrationフローは401エラーをスロー

理由: アクティビティをスケジュールするためのスロットは返されません。 指定した時間枠内に使用可能なリソースがない可能性があります。

解決策: 'ORCLROFSSBLBOOKAPPOINTMENT'のビジネス・サービス・ユーザー・プロパティで指定されたユーザー名とパスワード資格証明が正しいことを確認してください。

3)予約の失敗

症状: ポイントの取消でエラー「OFS」が返されました : ポイントが見つからないか、取消基準を満たしていません"

理由: アポイントメントを取り消すために選択されたアクティビティはスケジュールされていません。

解決策: スケジュール済ステータスのアクティビティのみ取り消すことができます。

この機能には、次の利点があります。

• Siebel CRMを使用してフィールド・サービス予約を予約し、Oracle Field Serviceでフィールド技術者にアクティビティを割り当てることができます。
• 従業員(フィールド技術者)情報をSiebel CRMからOracle Field Serviceに転送できます。

有効化のステップ

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

ヒントと考慮事項

デフォルトではこの機能を使用できますが、使用する前に統合を構成する必要があります。

主なリソース

• アプリケーションの構成 : https://docs.oracle.com/en/cloud/saas/field-service/faded/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

OFS-HCMアクセラレータを使用したリソースに対するリソース稼働可用性、Absence ManagementおよびパーティIDの更新

概要

更新23Aで、新しいOracle Field Service - HCMアクセラレータは、Oracle HCMの既存のすべての機能を提供するOracle Integrationストアで使用できます - Oracle Field Service | OFSリソース・アクセラレータを作成および管理し、次の改善によって拡張されました:

• アクセラレータは、従業員データをOracle HCM CloudからOracle Field Serviceに転送するために'partyID'の使用を開始します。      
• アクセラレータは、リソースの作業スケジュール、休暇欠勤、作業例外および祝日を考慮して、リソースの作業可用性をOracle HCM CloudからOracle Field Serviceに更新します。

'partyID'を使用した従業員の異動

Fusion ServiceやService LogisticsなどのFusionアプリケーションでは、アプリケーション全体で従業員情報を同期するための一意の識別子として'partyID'を使用します。 このアクセラレータでは、Oracle Field Serviceリソースの外部識別子として'partyID'が更新されるため、このIDに基づいて従業員情報のすべての同期を実行できます。

Pre-requisites

• このアクセラレータは、TCA 'partyID'が生成されている場合にのみ従業員データを同期します。 partyIDは、Oracle HCM Cloud新規採用画面で現在および過去の採用日を持つ従業員に対して瞬時に生成されます。 先日付の従業員の場合、ESSジョブ「パーティおよび事業所の現在のレコード情報の保守」の実行後にpartyIDが生成されます。 そのため、特定のジョブをスケジュールすることが非常に重要です。

• partyIDは、Oracle Field Serviceリソースの外部IDとして使用されます。

• Oracle Field Serviceでは、リソース・エンティティのカスタム・プロパティを作成する必要があります。 プロパティ名は"HCM_Person_Id"である必要があります。 Oracle HCM CloudのPerson IdはOracle Field Serviceに保持され、Oracle HCM CloudとOracle Field Serviceの間のデータをマップします。

• OFSでは、Oracle HCM Cloudからリソースを追加する予定のバケットを作成する必要があります。 また、Oracle Integration参照表で同じバケットIDを更新する必要があります - "Oracle_HCM_OFS_Resource_Bucket_Lookup". 前述の参照構成で使用可能なデータがない場合、統合の一部として構成されたビジネス・ユニットの下にすべての従業員が作成されます。

「従業員勤務可能状況:自」 Oracle HCM Cloud 「Oracle Field Serviceへ」

統合では、リソース勤務スケジュール、休暇欠勤、祝日および例外を含む1日当たりのリソース空き状況が抽出されます。 この統合では、一定期間リソースの使用可能性を取得し、レコードをOracle Field Serviceに同期します。 これはスケジュールされた統合で、1日に1回実行することをお薦めします。 リソースの可用性は、休暇欠勤、例外、祝日および勤務スケジュールを考慮して計算されます。

リソースの可用性を使用する統合でサポートされる主なユースケースには、次のものがあります:

• リソース作業スケジュールの処理 - 勤務スケジュールは、勤務パターン、シフトなどを含む、従業員の勤務可能状況を定義します。Oracle HCM Cloudの勤務スケジュール構成の詳細は、このリンクを参照してOracle HCM Cloudで構成できます。 統合では、すべての作業スケジュール構成が検索され、OFSリソース・カレンダのカスタム作業スケジュールとしてリソースの可用性が更新されます。

• 勤務スケジュール間のリソース例外の処理 - リソース例外は、勤務スケジュールまたはスケジュール割当からの可用性における偏差です。 生産資源例外では、生産資源が使用できない時期を定義します。 たとえば、ある従業員が研修または昼休みに出席しているため、1日の特定の時間間隔内では使用できません。        
  • リソース例外の例#1 - 特定の時間間隔(トレーニング/休憩など)内のアクティビティでは従業員を使用できません。 顧客は、このような例外をOracle HCM Cloudの勤務スケジュールに対して構成できます。 統合により、これらの例外がOracle Field Serviceの内部アクティビティとして更新されます。

内部アクティビティ・タイプ"ResourceExceptions"は、すべての内部アクティビティのデフォルト・アクティビティ・タイプとして使用されます。 このアクティビティ・タイプは、Oracle HCM CloudからOFSへのスケジュール済データ転送の一部として自動的に作成されます。 デフォルトのアクティビティ・タイプは、参照表Oracle_HCM_OFS_IntegrationVariablesLookupでOFS_DefaultActivityTypeとして構成されます。

• リソース例外例#2 - 従業員が非稼働日に勤務している場合。 顧客は、Oracle HCM Cloudの勤務スケジュールで非稼働日に勤務している従業員の例外を構成できます。 統合により、Oracle Field Serviceで選択した日時について選択したリソースに対して、これらの例外がカスタム作業スケジュールとして更新されます。

• 祝日の処理 - 祝日がカレンダ・イベントとしてOracle HCM Cloudに作成されます。 統合では、Oracle Field Serviceに転送されるOracle HCM Cloudに定義されているすべてのカレンダ・イベントが検索されます。 これらは、リソース・レベルで非稼働日として作成されます。

• 休暇欠勤の処理 - 統合により、Oracle Field Serviceの従業員の半日/全日の休暇欠勤がサポートされます。 統合では、Oracle HCM Cloudで構成されたすべての休暇欠勤が検索されます。 すべての半日の休暇欠勤は、Oracle Field Serviceの内部アクティビティとして定義されます。 1日の休暇欠勤は、リソース・レベルで非稼働日として処理されます。

Oracle Integrationフロー

Oracle Integrationフロー

Sl. 番号	ユースケース	入力	スケジュール済統合	推奨計画頻度
1	Oracle HCM CloudからOracle Field Serviceへの従業員詳細のアップロード - 一括抽出	HCM抽出	Oracle HCM OFS従業員抽出 子統合: Oracle HCM OFS抽出ヘルパー Oracle HCM OFS従業員同期ヘルパー	1回のみ実行* 一致するすべての技術者が初めてOracle Field Serviceに同期されます
2	新入社員のデータ転送	公開就業者Rest API	Oracle HCM OFSパーティ同期 子統合: Oracle HCM OFSパーティ同期ヘルパー Oracle HCM OFS従業員同期ヘルパー	毎時* 新規採用者をOracle Field Serviceに同期するために、より頻繁にスケジュールされます
3	従業員詳細がOracle HCM Cloudで更新された場合のOracle Field Serviceのリソース詳細の更新	ATOMフィード	Oracle HCM OFS従業員の更新 子統合: Oracle HCM OFS AtomFeedヘルパー Oracle HCM OFS従業員同期ヘルパー	1日2回* 1日に2回スケジュールできます
4	従業員がHCMで退職した場合のOracle Field Serviceでのリソースの中断	ATOMフィード	Oracle HCM OFS従業員退職 子統合: Oracle HCM OFS AtomFeedヘルパー	毎時* Oracle Field Serviceで終了を同期するために、より頻繁にスケジュールされます
5	就業者の勤務可能性の同期 - フル・モード	パブリック就業者REST API、就業者勤務可能状況REST API	Oracle HCM OFS就業者勤務可能状況 子統合: Oracle HCM OFS就業者勤務可能状況アクティビティ・タイプ Oracle HCM OFS就業者勤務可能状況ヘルパー Oracle HCM OFS就業者勤務可能状況アクティビティ削除 Oracle HCM OFS就業者勤務可能状況WS削除 Oracle HCM OFS就業者勤務可能状況同期ヘルパー Oracle HCM OFS就業者勤務可能状況WS作成者 Oracle HCM OFS就業者勤務可能状況アクティビティ作成	1日1回* 1日に1回スケジュールできます

ノート: スケジュール頻度は単なる推奨であり、要件に基づいて変更できます。

"Oracle HCM OFS従業員抽出" - HCM抽出を使用した従業員詳細のHCMからOFSへのアップロード

アクセラレータは、Oracle HCM Cloud抽出を使用して、従業員詳細をOracle HCM CloudからOracle Field Serviceにアップロードします。 ここでは、従業員抽出および設定構成の詳細を説明します。

アクセラレータは、統合フロー「Oracle HCM OFS従業員抽出」の一部として次の従業員情報を抽出します:

• 従業員の基本詳細 - これらは、個人番号、名、姓、個人Eメール・アドレス、電話番号、自宅住所などの従業員の基本的な詳細です。      
• 従業員アサイメント詳細 - これらは、割当済ビジネス・ユニット、ジョブ・コード、部門、ユーザー詳細および事業所などの従業員アサイメント詳細です。

抽出フロー

• 抽出プロセスでは、フィールド技術者、ビジネス・ユニットおよびアサイメント・ステータスに対応するジョブ・コードを持つすべての従業員が「アクティブ」としてフィルタされます。

• 抽出された従業員詳細は、対応するリソースがOracle Field Serviceで使用できない場合、OFSに作成されます。 そうしないと、Oracle Integrationのマッピングおよびルックアップ構成に基づいて、Oracle Field Serviceのリソース詳細が更新されます。

• 「Oracle HCM OFS従業員抽出」スケジュール済統合では、抽出ファイルが読み取られ、特定のビジネス・ユニット(ジョブ・コードおよびステータスが「アクティブ」)の従業員が除外されます。 次に、各個人の子統合「Oracle HCM OFS抽出ヘルパー」がトリガーされます。

• Oracle HCM OFS抽出ヘルパーは、partyIDが生成されているかどうかを確認します。 partyIDが使用できない場合、統合は終了します。 それ以外の場合は、Oracle Field Serviceリソースの作成に必要なデータが準備され、ヘルパー統合"Oracle HCM OFS Employee Sync Helper"がトリガーされます。

• Oracle HCM OFS Employee Sync Helperは、リソースの作成、ユーザーの作成、リソースのロケーションおよび割当ロケーションの作成を処理する共通のヘルパー統合です。

• リソースとユーザーはバケットにマップされます(バケットは参照で定義されます。使用可能なマッピングがない場合、リソースはビジネス・ユニットと同じ名前の組織ユニットの下に配置されます)。 リソースには、従業員の自宅住所および従業員アサイメント事業所に対応するリソース事業所も移入されます。

HCM個人番号と同じ外部IDを持つOracle Field Serviceリソースが使用可能な場合、外部IDは'partyID'で更新されます。

"Oracle HCM OFSパーティ同期" - 新入社員のデータ転送

新しい従業員がHCMに追加されると、対応するリソースをOracle Field Serviceに作成できます。 新しい従業員が採用され、partyIDが作成された場合、それらのリソースはOracle Field Serviceに同期されます。

新規従業員が現在または過去の採用日で採用されると、TCA partyIDが作成されます。 また、将来の採用については、ESSジョブ「パーティおよび事業所の現在のレコード情報の保守」が実行された後にpartyIDが作成されます。 最新バージョンのOracle HCM Cloud統合では、従業員に対してpartyIDが生成されている場合にのみ、Oracle Field Serviceに従業員が作成されます。

• 「Oracle HCM OFSパーティ同期」は、指定されたジョブ・コードで有効日が>=現在日 - 2日['days'パラメータは変更可能な統合プロパティです]である特定のビジネス・ユニットのすべてのACTIVE従業員を取得するために、公開就業者APIを呼び出します。 サブ統合では、Oracle HCM OFSパーティ同期ヘルパーが個人ごとにトリガーされます。

• Oracle HCM OFSパーティ同期ヘルパーは、従業員に対してpartyIDが使用可能かどうかを確認します。 partyIDを使用できない場合、統合は終了します。 partyIDが使用可能な場合は、リソース・バケットを検証し、OFSでリソースを作成するためのデータを準備し、統合Oracle HCM OFS従業員同期ヘルパーをトリガーします。

• Oracle HCM OFS Employee Sync Helperは、リソースの作成、ユーザーの作成、リソースのロケーションおよび割当ロケーションの作成を処理する共通のヘルパー統合です。

• リソースとユーザーはバケットにマッピングされます(バケットは参照で定義されます。使用可能なマッピングがない場合、リソースはビジネス・ユニット名として組織ユニットの下に配置されます)。 リソースには、従業員の自宅住所およびアサイメント事業所に対応する事業所も移入されます。

"Oracle HCM OFS従業員の更新" - HCMで従業員詳細が更新されたときOracle Field Serviceのリソースの更新

従業員更新フロー

「Oracle HCM OFS Employee Update」統合により、従業員の更新がほぼリアルタイムでHCMからOracle Field Serviceに渡されます。 このアクセラレータはHCM Atomフィードを使用 - Oracle HCM Cloudから従業員の更新を取得するには、「従業員の更新」をクリックしてください。 HCM Atomフィードをサブスクライブする方法の詳細は、ここにあります。

• 「Oracle HCM OFS従業員更新」スケジュール済統合では、ジョブ・コード、ビジネス・ユニット名およびアサイメント・ステータス「ACTIVE」に従って、必要な従業員アサイメントが除外されます。 従業員ごとに、「Oracle HCM OFS AtomFeed Helper」子統合がトリガーされます。

• 「Oracle HCM OFS AtomFeed Helper」は、パブリック就業者APIをコールして、リソースの作成に必要な詳細を取得し、「Oracle HCM OFS従業員同期ヘルパー」ヘルパー統合をコールします。    

• 「Oracle HCM OFS Employee Sync Helper」統合は、マッピング表に示されているように、Oracle HCM CloudからOracle Field Serviceに渡されるデータをマップします。 したがって、対応するリソース詳細はOFSで更新されます。

"Oracle HCM OFS従業員退職" - 従業員がHCMで退職したとき、Oracle Field Serviceでのリソースの一時停止

• Oracle HCM OFS Employee Terminate統合は、退職した従業員の詳細をスケジュールされた方法でOracle HCM CloudからOracle Field Serviceに渡します。    
• 次のステップとして、サブ統合「Oracle HCM OFS AtomFeed Helper」が起動され、Oracle Field Serviceユーザーが更新され、リソース・ステータスが「非アクティブ」に設定されます。

この統合では、Atomフィードにより更新がサブスクライブされます - " 「従業員退職」 ". HCM Atomフィードをサブスクライブする方法の詳細は、「こちら」を参照してください。

"Oracle HCM OFS就業者勤務可能状況"- リソースの可用性をOracle HCM Cloudから Oracle Field Serviceへの更新

「Oracle HCM OFS就業者勤務可能状況」統合では、リソースのカレンダ可用性がOracle HCM CloudからOracle Field Serviceに更新されます。 リソースの可用性は、祝日、割り当てられた勤務スケジュールと休暇欠勤の間のリソース例外に基づいて計算されます。

統合フロー

• Oracle HCM OFS Worker Availabilityにより、HCM Public Worker APIが起動され、指定されたビジネス・ユニットおよび特定のジョブ・コードのすべてのACTIVE従業員がフェッチされます。

• Oracle HCM OFS就業者勤務可能状況アクティビティ・タイプ(サブ統合)は、参照Oracle_HCM_OFS_IntegrationVariablesLookupで構成されたアクティビティ・タイプがOracle Field Serviceにすでに存在するかどうかをチェックします。 存在しない場合は、参照表で構成されている名前とラベルの新しいアクティビティ・タイプが作成されます。

• Oracle HCM OFS Worker Availability Helperは、有効なジョブ・コードを持つすべての適格従業員のpartyIDをフェッチするAPIを呼び出します。 partyIDが存在する場合、この統合によって就業者可用性APIが起動され、リソース・カレンダの可用性がOracle HCM Cloudから取得されます。 就業者勤務可能状況APIがスケジュールを返す場合、Oracle HCM OFS就業者勤務可能状況アクティビティ削除およびOracle HCM OFS就業者勤務可能状況WS削除が起動され、Oracle Field Serviceのアクティビティおよびスケジュールが消去されます。

• Oracle HCM OFS就業者勤務可能状況アクティビティ削除(サブ統合)が起動され、apptNumberがPerson ID、開始日と同じである既存のすべての内部アクティビティが消去されますアクティビティの現在の日付および終了日以降のアクティビティは、現在の日付+ 'noOfDays' [Oracle HCM OFS就業者勤務可能状況ヘルパーの整数プロパティ]と等しくなります。

• Oracle HCM OFS就業者勤務可能状況WS削除サブ統合が起動され、就業者勤務可能状況APIが起動される日付範囲について、Oracle Field Serviceのリソースに対する既存のすべてのスケジュールが消去されます。

• Oracle HCM OFS就業者勤務可能状況同期ヘルパーは、就業者勤務可能状況APIから各レコードを反復して処理します。

• Oracle HCM OFS就業者勤務可能状況WS作成者サブ統合が起動され、Oracle Field Serviceにカスタム勤務スケジュールが作成されます。

• Oracle HCM OFS就業者勤務可能状況アクティビティ作成サブ統合が起動され、リソース例外(勤務スケジュール間の分岐)およびOracle HCM Cloudからの半日の休暇について内部アクティビティがOracle Field Serviceに作成されます。

Oracle Integrationの設定構成

参照

参照構成は、Oracle Field ServiceとOracle HCM Cloudの類似したエンティティを異なる値でマップするのに役立ちます。たとえば、「Field tech」のジョブ・コードをOracle Field Serviceの「技術者」として処理できます。

Oracle HCM CloudからOracle Field Serviceへの統合の一部として、6つの参照があります。 顧客ビジネスの性質に基づいて、値は異なる場合があります。 顧客はビジネス・ニーズに応じてこれらの参照表を構成し、Oracle Integrationで同じ統合を実行できます。

このアクセラレータで使用される参照は、Oracle Integrationの「ホーム」>「統合」>「参照」にリストされます。 構成する参照の名前をクリックし、'+'アイコンをクリックしてさらに値を追加します。

参照

Oracle Integration参照	HCM値の例	Oracle Field Service値の例	説明
Oracle_HCM_OFS_UserTypeLookup	Technician (技術者)	Technician (技術者)	Oracle HCM Cloudジョブ・コードをOracle Field Serviceユーザー・タイプにマップ
Oracle_HCM_OFS_ResourceTypeLookup	フィールド・テクノロジ	PR	Oracle HCM Cloudジョブ・コードをOracle Field Serviceリソース・タイプにマップ
Oracle_HCM_OFS_Nonworking_Reason	病気	疾病	疾病休暇、期限内休暇、臨時休職などのOracle HCM Cloud休暇欠勤タイプを、Oracle Field Service非勤務理由にマッピングします。 Oracle HCM Cloudからのカレンダ・イベント/祝日の場合は、参照で構成するOracle HCM Cloud値は'CAL'で、対応するOracle Field Service非稼働事由をマップできます。
Oracle_HCM_OFS_ResourceRoleLookup	フィールド・テクノロジ	フィールド・リソース	ジョブ・コードをOracle Field Serviceリソース・ロールにマップします。 現在の統合では、フィールド・リソース・リソース・タイプ・ロールのみが処理されます。
Oracle_HCM_OFS_Resource_Bucket_Lookup	書式: BusinessUnit#DepartmentName サンプル: Supremo USビジネス・ユニット#JOB001	ServiceBucket [Oracle Field ServiceバケットID]	Oracle HCM Cloud BusinessUnit#DepartmentName [ビジネス・ユニット名と、デリミタ#を連結した部門名をOracle Field ServiceバケットのリソースIDにマップします。 この参照の前提条件は、参照で指定されたOFSバケットが、指定されたリソースIDを持つOracle Field Serviceで使用可能であることです。 参照に使用可能な一致がない場合は、リソースIDがOracle HCM Cloudビジネス・ユニットIDで、名前がOracle HCM Cloudビジネス・ユニット名である組織ユニットが作成されます。 すべてのリソースがその組織単位の下に配置されます。 たとえば、Oracle HCM Cloudビジネス・ユニット名はSupremo Business Unitで、技術者のジョブ・コードはJOB0001です。 これらの技術者をリソースID "ServiceBucket"のOracle Field Serviceバケットと同期する必要がある場合、構成は次のようになります: HCM値> Supremo US Business Unit#JOB0001 Oracle Field Service > ServiceBucket
Oracle_HCM_OFS_IntegrationVariablesLookup			この参照には、Oracle HCM CloudからOracle Field Serviceへの統合で使用される基準およびデフォルト値が含まれます。

マッピング表

次の表に、アクセラレータで構成された対応するOracle Field Serviceに対応するOracle HCM Cloudエンティティ/プロパティとのマッピングを示します。

たとえば、Oracle HCM Cloudのビジネス・ユニットは、リソース・レポート構造を管理するように機能的に設計されているため、Oracle Field Serviceで組織単位として処理できます。

マッピング表

HCMプロパティ	Oracle Field Serviceプロパティ	コメント
ビジネス・ユニット	組織単位	組織単位は、Oracle Field Serviceのリソース・タイプです
部門	バケット	バケットはOFSOracle Field Serviceのリソース・タイプです
Person ID	HCM_Person_Id	リソースのPerson IDを保持するカスタム・プロパティ。
ユーザー名	ログイン
個人住所	リソースのロケーション
個人アサイメント住所	リソースのロケーション
partyID	外部ID	リソースの外部IDです。
休暇欠勤タイプ	非稼働事由	疾病休暇や前受休暇などの休暇欠勤タイプは、Oracle Field Serviceの非稼働理由(疾病、休暇など)にマップされます。 祝日の場合、参照に構成されるOracle HCM Cloud休暇欠勤タイプはCALで、対応するOracle Field Service非稼働事由(祝日など)をマップできます。

ノート: アクセラレータでは、Oracle HCM Cloudのビジネス・ユニットがOracle Field Serviceの組織単位としてマップされます。 顧客は、技術者リソースを作成する必要があるバケットを定義するOracle_HCM_OFS_Resource_Bucket_Lookupを構成できます。 参照には、ソース値が'Business Unit#Department'の書式で必要です。 参照に一致するものが見つからない場合、技術者はビジネス・ユニットの下に作成されます。

統合プロパティ

統合プロパティ

統合	プロパティ名	デフォルト値	使途
Oracle HCM OFSパーティ同期	noOfPastDays	2	開始日が現在の日付以降の新しい採用 - 'noOfPastDays'はOFSと同期されます。
Oracle HCM OFS就業者勤務可能状況ヘルパー	noOfDays	10	現在日から現在日まで+ 'noOfDays'のリソース可用性がOFSに同期されます。

統合プロパティの変更方法

統合プロパティを変更するには、次のスクリーンショットに示すナビゲーションに従います:

OFSでのカスタム・プロパティの作成 - HCM_Person_Id

アクセラレータは、前提条件としてOracle Field Serviceの次の管理者定義プロパティを使用します。

カスタム・プロパティの作成の前提条件

プロパティ名	プロパティ・ラベル	プロパティ・タイプ	エンティティ	GUI
HCM Person Id	HCM_Person_Id	文字列	リソース	テキスト要素

プロパティの作成方法の詳細は、ここで説明されています: ファイル・プロパティの作成。

ノート: プロパティのラベルとタイプは正確である必要があります。そうしないと、存在しないプロパティへのマッピングのために統合フローがアクティブ化しようとしたときにエラーが発生します。

接続構成

ナビゲーション・サイドバーを介してホーム・ページから「統合」>「接続」にナビゲートして、「接続」ページに移動します。 アクセラレータで使用される接続のリストと、Oracle Integrationインスタンス内の他の既存の統合が表示されます。      

接続名をクリック - イメージのステップ1-5に従って、Oracle RESTトリガーして接続を構成します。

接続名をクリック - Oracle HCM Cloudイメージのステップ1-5に従って、アダプタ接続を構成し、接続を構成します。

接続名をクリック - Oracle Field Serviceイメージのステップ1-6に従って接続を接続して構成します。    

接続名をクリック - イメージのステップ1-5に従って、Oracle Rest HCM接続を構成し、接続を構成します。

接続名をクリック - Oracle Rest OFS接続を使用し、イメージのステップ1-5に従って接続を構成します。

統合変数の構成

インスタンス構成に基づいて統合変数の参照を編集する必要があります。 "Oracle_HCM_OFS_IntegrationVariablesLookup"には次の変数が含まれます:

統合変数

統合変数	サンプル値	使途
HCM_BusinessUnitName	Supremo USビジネス・ユニット	従業員を除外するために使用するビジネス・ユニット。 カンマで区切られた複数のビジネス・ユニットをサポートします。
HCM_JobCode	JOB0001	技術者の除外に使用するジョブ・コード。 複数の職務コードをカンマ区切りでサポートします。
OFS_Timezone	東部	リソースに関連付ける必要があるOFSのTimeZone値("America/New_York"など)。
OFS_OrganisationTypeLabel	OU	組織タイプ。
OFS_OrganisationID	SUNRISE	OFSの法的エンティティのリソースID。
OFS_DefaultLanguage	エン	リソースのデフォルト言語。
OFS_DefaultActivityType	ResourceExceptions	構成された値がOFSに存在しない場合は、新しいアクティビティ・タイプが作成されます。 Oracle HCM Cloudからのリソース例外および半日休暇は、OFS_DefaultActivityTypeにマップされたタイプの内部アクティビティとして作成されます。

HCM抽出の構成の設定

詳細は、「HCM抽出の構成」および「抽出の送信」を参照してください。

アクセラレータでのFusion APIと使用

Fusion側からデータを取得するには、次のAPIを使用します:

データの取得に使用されるAPI

Sl. 番号	API名	セキュリティ・ロール	APIで使用されるフィールド	このAPIを使用している統合
1	hubSourceSystemReferences	HZ_VIEW_TRADING_COMMUNITY_PERSON_PRIV HZ_VIEW_TRADING_COMMUNITY_ORGANIZATION_PRIV	OwnerEntityId	Oracle HCM OFSパーティ同期 Oracle HCM OFS抽出ヘルパー Oracle HCM OFS AtomFeedヘルパー Oracle HCM OFS就業者勤務可能状況ヘルパー
2	publicWorker	ORA_PER_REST_SERVICE_ACCESS_PUBLIC_WORKERS_RO	BusinessUnitName    BusinessUnitId    DepartmentName    JobCode    DisplayName    ユーザー名 WorkEmail    CountryCodeNumber    AreaCode    PhoneNumber    LocationName    LocationAddressLine1  LocationAddressLine2  LocationRegion2    LocationTownOrCity    LocationPostalCode    LocationCountry	Oracle HCM OFSパーティ同期 Oracle HCM OFS抽出ヘルパー Oracle HCM OFS AtomFeedヘルパー Oracle HCM OFS就業者勤務可能状況
3	作業員	PER_REST_SERVICE_ACCESS_WORKERS_RO_PRIV	AddressId AddressLine1 AddressLine2 TownOrCity Region2 PostalCode 国	Oracle HCM OFSパーティ同期 Oracle HCM OFS AtomFeedヘルパー
4	workerAvailability	機能権限 - RESTサービスの使用 - 就業者勤務可能状況読取り専用 - ANC_REST_SERVICE_ACCESS_WORKER_AVAILABILITY_RO データ権限 - 就業者勤務可能状況データの表示 - ANC_VIEW_WORKER_AVAILABILITY_DATA 新規ロールRESTサービスの使用 - 就業者勤務可能状況読取り専用' - これにより、新しいDSPおよび権限付与が取得されます - ASSIGNMENTレベル このロールは、Human Capital Management Integration Specialistに付与されます。	ShiftName  ShiftType  AvailabilityCode  StartDateTime  EndDateTime	Oracle HCM OFS 就業者勤務可能状況ヘルパー

「Oracle Integrationのトラブルシューティング・ステップ」 「フロー」

次の項では、Oracle Integration内の様々なフローをアクティブ化またはスケジュール(あるいはその両方)する方法について説明します。

Oracle HCM OFS従業員抽出

1. 次の統合がアクティブ化されていることを確認してください - Oracle HCM OFS従業員抽出、Oracle HCM OFS抽出ヘルパーおよびOracle HCM OFS従業員同期ヘルパー。    
2. Oracle HCM Cloudから抽出を送信します。 抽出 - HCM_EmployeeExtractに使用できる送信済抽出結果が少なくとも1つあることを確認してください。
3. Oracle Integrationから統合を送信します。 「送信」ボタン>「送信」をクリックします。

この統合フローの検証方法

抽出から一致するフィルタ基準を持つ従業員は、対応する組織単位および部門の下のOracle Field Serviceに作成されます。    

フィルタ基準を使用したHCMデータ: (「自分のクライアント・グループ」>「個人管理」)

Oracle Field Serviceインスタンス - ディスパッチ・コンソール - リソース詳細が更新されました

Oracle HCM OFSパーティ同期

1. 次の統合がアクティブ化されていることを確認 - Oracle HCM OFS従業員同期ヘルパー、Oracle HCM OFSパーティ同期ヘルパーおよびOracle HCM OFSパーティ同期
2. 統合をスケジュールします。 統合の横にある「統合」>「処理」ボタンをクリック - 「Oracle HCM OFSパーティ同期」>「スケジュールの追加」メニュー > 頻度、開始日、終了日、タイムゾーンなどのスケジュール詳細を入力します。

この統合フローの検証方法

1. Oracle HCM Cloudに新規採用を作成します。 「ログイン」>「自分のクライアント・グループ」>「新規個人」>「従業員の採用」に移動します。

2. 各画面ですべての必須フィールドに入力し、追加された詳細を発行します。 新しく作成した従業員が「個人管理」画面に表示されていることを確認します。    
3. スケジュールに従って次の発行を待機します。 対応するリソースが、新規採用基本情報および事業所情報とともにOracle Field Serviceに作成されます。

Oracle HCM-OFS従業員の更新

1. 次の統合がアクティブ化されていることを確認 - Oracle HCM OFS Employee Sync Helper、Oracle HCM OFS Extract HelperおよびOracle HCM OFS Employee Update
2. インテグレーションをスケジュールします。 統合の横にある「統合」>「処理」ボタンをクリック - 「Oracle HCM OFS従業員更新」>「スケジュールの追加」メニュー > 頻度、開始日、終了日、タイムゾーンなどのスケジュール詳細を入力します。

各画面のすべての必須フィールドに入力し、追加された詳細を送信します。 新しく作成した従業員が「個人管理」画面に表示されていることを確認します。

この統合フローの検証方法

1. Oracle HCM Cloudで従業員/就業者を更新します。
2. スケジュールに従って次の発行を待機します。 Oracle Field Service内の対応するリソースが、対応する情報で更新されます。

Oracle HCM OFS退職従業員

1. 次の統合がアクティブ化されていることを確認 - Oracle HCM OFS抽出ヘルパーおよびOracle HCM OFS退職従業員
2. インテグレーションをスケジュールします。 統合の隣にある「統合」>「処理」ボタン - 「Oracle HCM OFS従業員終了」>「スケジュールの追加」メニュー > 頻度、開始日、終了日、タイムゾーンなどのスケジュール詳細を入力します。

各画面のすべての必須フィールドに入力し、追加された詳細を発行します。 新しく作成した従業員が「個人管理」画面に表示されていることを確認します。

統合フローの検証方法

1. Oracle HCM Cloudで従業員を終了します。    
2. スケジュールに従って次の発行を待機します。 Oracle Field Service内の対応するリソースおよびユーザー・レコードは非アクティブになります。

Oracle HCM-OFS就業者勤務可能状況

1. 次の統合がアクティブ化されていることを確認 - Oracle HCM OFS Worker Availability, Oracle HCM OFS Worker Availability Activity Type, Oracle HCM OFS Worker Availability Helper, Oracle HCM OFS Worker Availability Activity Delete, Oracle HCM OFS Worker Availability WS Delete, Oracle HCM OFS Worker Availability Sync Helper, Oracle HCM OFS Worker Availability WS Creator, Oracle HCM OFS Worker Availability Activity Create.
2. インテグレーションをスケジュールします。 統合の横にある「統合」>「処理」ボタンをクリック - 「Oracle HCM OFS就業者可用性」>「スケジュールの追加」メニュー > 頻度、開始日、終了およびタイムゾーンなどのスケジュール詳細を入力します。

各画面のすべての必須フィールドに入力し、追加された詳細を発行します。

統合フローの検証方法

1. Oracle HCM Cloudで個人の勤務スケジュール詳細を更新します。
2. 次の統合を待機し、スケジュールに従って送信します。 Oracle Field Service内の対応するリソースは、対応する作業スケジュールの更新で更新されます。

統合からのエラーまたは警告メッセージ

エラーおよび警告のメッセージ

統合エラー・メッセージ	説明	改善
個人リソースが見つからないか、リソースIDの更新に失敗しました。	これは、以前のバージョンの統合によってすでに作成されているOracle Field Serviceリソースの外部IDの更新が失敗したことを意味します。 または、リソースIDとして個人番号を持つリソースがOracle Field Serviceにありません。
個人のパーティが作成されていません : <Person id>	技術者の個人パーティがOracle HCM Cloudに生成されていません。 そのため、技術者はOracle Field Serviceに同期されません。	ESSジョブがOracle HCM Cloudで実行されるようにスケジュールされていることを確認します。
ユーザーがすでにパーティ<OFS resource Id>に存在するか、デフォルトのユーザー・アカウントを作成できません[OFS UIに移動して手動でユーザー・アカウントを作成してください]	このメッセージは、次のいずれかのシナリオで出力されます: 技術者詳細の同期中に、技術者に使用可能なユーザー・アカウントがOracle Field Serviceにすでにある場合は、再度作成されません。 または Oracle HCM Cloudには技術者に使用可能なユーザー・アカウントがなく、firstName.lastNameを使用してデフォルトのユーザー・アカウントを作成しようとすると、技術者はOracle HCM Cloudで名を使用できません。	ユーザー・アカウントは、Oracle Field Serviceユーザー・インタフェースを使用して作成または更新する必要があります。

Oracle HCM Cloud統合の制限事項

Oracle HCM-OFS就業者勤務可能状況

このリリースのこの統合では、次のシナリオは処理されません:

シナリオ 1

勤務スケジュール内の同じ日に複数の部分リーフがサポートされていません。 このリリースでは、半日休暇のみがサポートされています。

例:

ある日の従業員の勤務スケジュールは、午前8時から午後5時までです。 従業員はOracle HCM Cloudに進み、午前10時から午前11時までと、同じ日の午後3時から午後4時まで部分休暇に適用されます。

インテグレーションが実行されると、その日に適用された最後の部分休暇のみが同期されます。 この例では、OFSで午後3時から午後4時までの内部アクティビティが作成されます。

このシナリオを処理するための回避策は、休暇欠勤のかわりにリソース例外を使用して、同じ日に複数の使用不可タイム・スロットを指定することです。

シナリオ 2

従業員の勤務スケジュールが午前8時から午後5時であるとします。 同日の午後7時から午後10時までの超過勤務の実行を決定しました。 このシナリオは、現在の就業者勤務可能状況統合では処理されません。 この設定では、Oracle Field Serviceに午前8時から午後10時までの単一の勤務スケジュールが作成されます。 実際のシナリオでは、リソースは午後5時から午後7時まで作業できません。 この情報はOracle Field Serviceでは追跡されません。

シナリオ 3

1日の間に時間ギャップがある複数のシフトがあるスケジュールは、Oracle Field Serviceの単一のシフトとして表されます。

例:

HCMで、1日のシフトが2つある勤務スケジュールを作成します:

シフト1 - 午前7時から午前11時

シフト2 - 午後12時から午後3時

統合が実行されると、これはOracle Field Serviceの午前7時から午後3時への単一のシフトとして表されます。

実際の場合、リソースは午前11時から午後12時まで作業できません。

シナリオ 4

従業員が翌日の午後7時から午前3時までの勤務スケジュールを持ち、2023年1月1日から2023年12月31日までの勤務スケジュールに従っているとします。 2023年1月10日から2023年1月20日までの10日間スケジュールされた統合を実行する場合、Oracle Field Serviceで各日のスケジュールが午後7時から午前3時に更新されます。 最終日、1月20日は午後7時から午後11時55分にスケジュールが更新されます。 次の日のスケジュールである1月21日の午前12時から午前3時までは、Oracle Field Serviceでは更新されません。この例では、1月10日から1月20日の間にのみOracle HCM Cloudからデータをプルするように統合がスケジュールされているためです。

この機能には、次の利点があります。

• 技術者の重複同期を解決し、PartyIdを使用してOracle HCMとOracle Field Service間で同じレコードを管理
• 休暇欠勤レコード、従業員のスケジュール、祝日などの就業者の勤務可能性を同期します。

有効化のステップ

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

ヒントと考慮事項

このレシピはOracle Integrationで使用できますが、使用する前に統合を構成する必要があります。

主なリソース

• アプリケーションの構成 : https://docs.oracle.com/en/cloud/saas/field-service/faded/index.html。このリンクは、更新23A GAリリース後に使用可能になります。

「アプリケーション」ページからの日次抽出の実行

概要

この新機能では、顧客が前日の日次抽出ファイルを再生成する場合に対処します。 これで、顧客は「構成」>「アプリケーション」画面から自分でファイルを再生成できるようになりました。

さらに、この画面では、自動および手動の両方の日次抽出実行の履歴を表示できるようになりました。

機能を使用できるユーザー

この機能はすべての顧客が使用できます。

動作

手動日次抽出実行

更新23Aに更新した後、「構成」>「アプリケーション」ページに移動し、「日次抽出」アプリケーションの右下にある「:」を押します。 次のスクリーンショットに示すように、新しい手動実行メニュー・オプションがリストに追加されました:

手動実行をクリックすると、日次抽出手動実行抽出日を選択できるページが表示されます:

次の日付範囲から日付が選択されています: 今日から(今日 - 90日)。 デフォルト値は昨日です。 日付の下のヒントは、手動実行日付範囲を示しています。

抽出日を選択してデータの抽出を押すことができます。 このページでは、手動実行を開始できるかどうかが検証されます。 このスクリーンショットは、検証エラーを示しています:

手動日次抽出には1日のみ選択できます。 数日間または日付範囲のデータを抽出する必要がある場合は、複数の手動日次抽出の実行を1つずつ開始できます。

インスタンスごとに1つの同時日次抽出プロセス(自動または手動)のみをトリガーできます。 したがって、インスタンスが日次抽出タスクをすでに実行している場合、手動実行ボタンは表示されません。

このページに表示される可能性のあるエラー

日次抽出ページで考えられるエラー

エラー	説明
手動実行を開始できません。 30分後にプロセスを再実行してください。	日次抽出モジュールはリクエストを受け入れませんでした。
パラレル日次抽出ジョブ。 30分後にプロセスを再実行してください。	自動日次抽出ジョブが進行中です。

複数の日間にわたって日次抽出エクスポートを実行する必要がある場合は、前の手動実行が終了してから各日に対して手動実行を実行する必要があります。

日次抽出手動実行では、自動日次抽出と同じフォーマットおよびロケーションにファイルが生成されます。 したがって、自動日次抽出のファイルは上書きされます。

日次抽出アプリケーションの下部には、次の2つの新しいステータスが表示されます:

日次抽出のステータス

ステータス	説明
'YYYY-DD-MM'の実行がリクエストされました	手動実行はユーザーによってリクエストされ、処理待ちです。
'YYYY-DD-MM'の実行が進行中です: 残り%	手動実行または自動実行が進行中です。

日次抽出実行履歴の表示

更新23Aに更新した後、「構成」>「アプリケーション」ページに移動し、「日次抽出」アプリケーション・タイルの右下にある「:」を押します。 新しい履歴ボタンがリストに追加されました:

履歴ボタンを押すと、次のページが表示され、このインスタンスの過去20回の日次抽出実行(自動と手動の両方)の履歴を確認できます:

この機能により、顧客は過去の日付の日次抽出ファイルを自分で生成できます。 日次抽出の自動実行と手動実行の両方の履歴を表示することもできます。

有効化のステップ

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

主なリソース

• アプリケーションの構成 : https://docs.oracle.com/en/cloud/saas/field-service/faded/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

プラグイン・フレームワーク

デブリーフィング・プラグインのRedwoodデザイン

デブリーフィングおよびプロフォーマ・プラグインの概要

報告は、活動の実行中に使用される時間と資材をレポートするプロセスです。 フィールド・リソースは、このプラグイン・サンプルを使用して、作業中のアクティビティのコンテキストで次の情報をレポートします:

• 労務: 移動時間と作業時間を含む(時間単位で測定)
• 部品: アクティビティの実行中に使用される部品および資材
• 手数料: 料金や駐車料金などの追加料金(支出金額で測定)

すべての部品と労務、費用項目が在庫エンティティに格納されます。 また、PDF請求書が生成され、活動のファイル・プロパティに保存されます。

ノート: このサンプル・プラグインには、Oracle Field Service 19B更新以降のリリースが必要です。

プラグイン構成

更新23Aでは、DebriefプラグインをOracle Field Service内の即時利用可能なStandardプラグインとして使用できます。 特別な技術スキルを必要とせずに、数回のクリックで標準プラグインを簡単に選択してインストールできます。 OTNストアからプラグインを手動でダウンロードする場合は、次に説明するステップに従います。 これらの手動ステップを回避するために、標準プラグインをOracle Field Serviceアプリケーションからダウンロードすることをお薦めします。

プラグインを構成するプロセスは次のとおりです:

1. OTNからサンプル・コード・コレクションをダウンロードします。 サンプル・コレクションには、次に説明するコンテンツに記載されているファイルが含まれます: (つまり、plugindebriefing_properties_v 1.x ml、plugin-debriefing-plugins_v 1.x ml、およびplugin-debriefing-source-v1.zip)。
2. properties.xml (例: plugin-debriefing_properties_v 1.x ml)をインポートします。
3. 3つの在庫タイプを追加します。
4. plugins.xml (plugin-debriefing-plugins_v1.xmlなど)をインポートします。
5. ユーザー・タイプを構成します。
6. 部品カタログをアップロードします。

報告プラグインのプロパティをインポート

異なるアプリケーション画面およびエンティティを構成するには、プラグイン・プロパティが必要です。 そのため、プラグイン・プロパティがエンティティに自動的に関連付けられるように、OTN webサイトからproperties.xmlファイルをダウンロードする必要があります。

デフォルト・プロパティを保持することも、properties.xmlファイル内のプロパティの名前と値を変更することもできます。

1. コレクションからproperties.xmlファイルを抽出します(例: plugin-debriefing-properties_v 1.x ml)。
2. 管理者としてアプリケーションにログインします。
3. 「構成」>「プロパティ」にナビゲートし、「インポート」をクリックします。
4. 参照をクリックし、インポートをクリックします。

次の表に、properties.xmlファイルからインポートされたプラグイン・プロパティを示します:

リソース・エンティティ・プロパティ

名前	ラベル	タイプ	GUI	説明
ID	pid			リソースの内部ID
名前	pname			リソースの名前

アクティビティ・エンティティ・プロパティ

名前	ラベル	タイプ	GUI	説明
請求書	invoice	ファイル	ファイル	生成された請求書のPDFファイル。 例: mime_types="application/pdf"
会社名	ccompany	文字列	テキスト	請求書のタイトルとして表示される顧客の会社名。
アクティビティID	aid			アクティビティの内部ID。
名前	cname			PDF請求書で参照されるアクティビティ顧客の名前。
Address	caddress			請求書で使用されるアクティビティ住所。
市区町村	ccity			請求書で使用されるアクティビティ市区町村。
State	cstate			請求書で使用されるアクティビティ状態。
郵便番号	czip			請求書で使用される郵便番号。
作業オーダー	appt_number			請求書で使用される作業オーダーです。
シグネチャ	csign			請求書をPDFとして保存する前に顧客シグネチャが必要です。

在庫エンティティ・プロパティ

名前	ラベル	タイプ	GUI	説明
費用	expense_amount	文字列	テキスト	経費金額
経費通貨	expense_currency_code	列挙	コンボ・ボックス	各列挙項目の値は「|」文字で区切られます。 索引値 USD          $|USドル EUR          €|ユーロ
部品処分	part_disposition_code	列挙	コンボ・ボックス	在庫が顧客によって消費可能で、追跡する必要がなくなったかどうか、または在庫が返品可能かどうかを識別する値です。 在庫が返品可能な場合、Oracle SCM CloudのInventory Managementシステムは、顧客が返品するまで部品を追跡する必要があります。 索引値 N               返品なし S                遅延返品 M              高速返品
部品単位	part_uom_code	列挙	コンボ・ボックス	部品(在庫)の単位(UOM)。 たとえば: 索引値 ea              ea m               m in                in
部品品目摘要	part_item_desc	文字列	テキスト	部品の摘要。 たとえば、磁気ハード・ドライブです。 カタログ内の在庫の検索に使用されます。
部品品目番号	part_item_number	文字列	テキスト	お客様から設置または取得された部品の番号。 コードとして指定されます。 たとえば、FS908765です。
部品品目改訂	part_item_revision	文字列	テキスト	単一文字のコード。たとえば、「A」や「B」です。 また、「1」や「2」のような1桁の数字を使用することもできます。 通常、在庫は部品品目と部品品目の改訂で識別されますが、品目改訂はオプションです。
部品品目番号+改訂	part_item_number_rev	文字列	テキスト	部品品目番号は、部品品目改訂と連結されます。 たとえば、FS908765Aのように、"FS908765"は部品項目番号、"A"は部品項目改訂です。 カタログ内の在庫の検索に使用されます。
経費アクティビティ	expense_service_activity	列挙	コンボ・ボックス	経費のタイプ。 たとえば: 索引値 trv              トラベル mscその他
費用項目	expense_item_number	列挙	コンボ・ボックス	経費のサブタイプ。 たとえば: 索引値 tol               通行料金 prk             駐車
経費項目摘要	expense_item_desc	列挙	コンボ・ボックス	経費サブタイプの摘要。 索引は、expense_item_numberプロパティと同じである必要があります。 値は、対応するexpense_item_number要素を説明する必要があります。 たとえば: 索引値 tol:             サービスの料金 prk:            サービスの駐車料金
労務終了時間	labor_end_time	文字列	テキスト	フィールド・リソースが特定のサービス・アクティビティの処理を停止した時間。 作業オーダーの終了時間(Oracle Field Service Cloudアクティビティ)より後にしないでください。 また、労務リストの項目間に重複はありません。 形式はT24:59:59です。
労務開始時間	labor_start_time	文字列	テキスト	フィールド・リソースが特定のサービス・アクティビティでの作業を開始する時間。 作業オーダーの開始時間(Oracle Field Service Cloudアクティビティ)より前にはできません。 また、労務リストの項目間に重複はありません。 形式はT24:59:59です。
労働アクティビティ	labor_service_activity	列挙	コンボ・ボックス	労働のタイプ。 たとえば: 索引値 com:          通勤 drp:            診断および修復
労務項目	labor_item_number	列挙	コンボ・ボックス	労務のサブタイプ。 たとえば: 索引値 trv              移動時間 reg             FFS通常労務 ovr             FFS超過勤務労務
労務品目摘要	labor_item_desc	列挙	コンボ・ボックス	労務サブタイプの摘要。 索引は、labor_item_numberプロパティと同じである必要があります。 値は、対応するlabor_item_number要素を説明する必要があります。 たとえば: 索引値 trv              FS技術実績出張 reg             通常労務時間 ovr             超過勤務労務時間
在庫ID	invid			インベントリの内部ID。
アクティビティID	inv_aid			在庫が割り当てられているアクティビティの内部ID。
リソースID	inv_pid			在庫が割り当てられているリソースの内部ID。
在庫プール	invpool			在庫プール(リソース、顧客、インストール済、アンインストール済)
在庫タイプ	invtype			在庫のタイプ。 プラグインのインベントリ・タイプの追加を参照してください。
数量	quantity			取り付けられた部品または顧客から取られた部品。 インチ、フィートなどでカウントまたは指定できます。 数量は整数として定義されます。
シリアル番号	invsn	フィールド	テキスト	在庫のシリアル番号

オプションの構成

追加のプロパティを構成するには、『Oracle Field Service Cloudの管理』ガイドのプロパティの項を参照してください。

プラグインのインベントリ・タイプの追加

アクティビティ中に使用される時間と資材に関する情報を取得するには、在庫タイプ(費用、労務、部品およびpart_sn)を追加する必要があります。 プラグインは、時間および経費に関するレポート済情報をアクティビティのインストール済プールに格納します。 ただし、材料 - 使用された部品と返された部品は、それぞれリソース・プールと顧客プールに格納されます。

1. 管理者としてアプリケーションにログインします。     
2. 「構成」>「在庫タイプ」にナビゲートし、「追加」をクリックします。
3. 費用在庫タイプを次のように追加します:
   1. ラベルとして'expense'と入力します。         
   2. 名前に'Expense'と入力します。         
   3. モデル・プロパティ・ドロップ・ダウン・リストからExpense_item (「費用項目」フィールドの一意の識別子)を選択します。        
   4. 「保存」をクリックします。 
4. 労務在庫タイプを次のように追加します:
   1. ラベルに'labor'と入力します。         
   2. 名前に'Labor'と入力します。         
   3. モデル・プロパティ・ドロップ・ダウン・リストからLabor_Item (「労務項目」フィールドの一意の識別子)を選択します。         
   4. 「保存」をクリックします。 
5. 部品在庫タイプを次のように追加します:
   1. ラベルに'part'と入力します。        
   2. 名前に'Part'と入力します。        
   3. モデル・プロパティ・ドロップ・ダウン・リストからPart_Item+Revision (「部品品目」フィールドの一意の識別子)を選択します。        
   4. 「保存」をクリックします。 
6. 部品SN在庫タイプを次のように追加します:
   1. 「ラベル」フィールドに'part_sn'と入力します。        
   2. 名前フィールドに'Serialized Part'と入力します。        
   3. モデル・プロパティ・ドロップ・ダウン・リストからPart_Item+Revision (「部品SN品目」フィールドの一意の識別子)を選択します。        
   4. 「保存」をクリックします。

plugin.xmlをOracle Field Serviceにインポート

OTN webサイトからplugin.xmlファイルをダウンロードし、Oracle Field Service Cloudアプリケーションにインポートして使用する必要があります。 モバイル・プラグイン・フレームワーク・ガイドの「Plug-Ins」の構成および使用に関する項を参照してください。

1. 管理者としてアプリケーションにログインします。    
2. 「構成」>「フォーム&プラグイン」に移動します。    
3. プラグインのインポートをクリックします。    
4. 「保存」をクリックします。    
5. plugins.xml (plugin-debriefing-plugins_v1.xmlなど)を見つけ、追加をクリックします。    
6. 「保存」をクリックします。

プラグインがインポートされ、デブリーフィング・プラグインをクリックして詳細を表示できるようになりました。 デフォルトでは、次の設定が有効です:

• 「ラベル」フィールドに'debriefing_plugin'が表示されます。     
• タイプ・フィールドでHTML5アプリケーションが選択されています。     
• プラグインAPIの使用チェック・ボックスが選択されています。

プラグインのユーザー・タイプの構成

プラグインを複数のユーザー・タイプに対してアクセス可能にするには、それらのユーザー・タイプのアプリケーション画面に関連付けます。 報告は開始済アクティビティに対してのみ行われるため、開始済アクティビティにのみ表示される報告ボタンを「アクティビティの編集/表示」ページに追加します。

1. 管理者としてアプリケーションにログインします。    
2. 「構成」>「ユーザー・タイプ」にナビゲートします。    
3. 画面構成をクリックします。    
4. アプリケーション画面で、アクティビティの編集/表示をクリックします。    
5. ボタン要素をビジュアル・フォーム・エディタの上部にドラッグ・アンド・ドロップします。    
6. 鉛筆アイコンをクリックし、ドロップダウン・リストからプラグインを選択し、画面リストから「デブリーフ」を選択して、OKをクリックします。    
7. 「追加」をクリックします。    
8. プラス(+)アイコンをクリックし、それぞれのドロップダウンからアクティビティ・ステータスおよび次と等しいを選択します。
9. 値の選択をクリックし、開始チェック・ボックスを選択してから、保存をクリックしてウィンドウを閉じます。    
10. 「保存」をクリックします。

部品カタログをOracle Field Serviceにアップロード

カタログで使用または返品された部品を検索し、それらの部品を請求書に追加できます。 カタログ内の部品を表示するには、SOAP APIのcreate_catalogメソッドを使用してカタログを作成し、次の構成でカタログをアップロードする必要があります:

• type_schemaのInventory_typeフィールドは"part"である必要があります
• フィールド・スキーマには、次のfield_schema要素が含まれている必要があります:

field_schema要素

カタログ・ラベル	プロパティ・ラベル	検索可能
part_uom_code	part_uom_code	0
part_item_revision	part_item_revision	0
part_item_number	part_item_number	0
part_item_desc	part_item_desc	1
part_disposition_code	part_disposition_code	0

• upload_catalogリクエストの各項目要素のラベル・フィールドには、セパレータなしで部品項目のリビジョンと連結された部品項目番号が含まれている必要があります。 たとえば、"FS54888A"です。"FS54888"は部品項目番号、"A"は部品項目改訂です。 部品品目改訂が空の場合、ラベルには部品品目のみが含まれている必要があります。

プラグインの使用方法

開始済アクティビティに対して表示される報告ボタンを使用すると、時間、経費または資材情報を請求書レポートに追加し、この情報を保存して、顧客のシグネチャを取得できます。

技術者が追加した料金がない場合の初期ランディング・ページ:

メニュー・ボタン手数料の追加をクリックすると、次のオプションが表示され、技術者はアクティビティの実行中に使用された時間と資材をレポートできます:

労務の追加

これには、移動時間および作業時間が含まれます(時間単位で測定)。 開始時間や終了時間などの必須フィールドを追加すると、送信ボタンが有効になり、データを保存できます。

経費の追加

これにはすべての経費が含まれます - 移動およびその他 - 駐車場や通行料などで発生。

部品の追加

これは、アクティビティ中に使用された(リソース・プール内に格納された)資材をレポートするために使用されます。        

シリアル化されていない部品

シリアル番号なし項目の場合は、部品を選択し、数量を指定して追加をクリックします。

シリアル化されていない部品を選択すると、設置に関連する情報(新規 / 保証など)と数量を追加できます。

シリアル管理部品

シリアル管理品目の場合、すべての部品とそのシリアル番号は別々の明細品目として表示されます。 適切な部品を選択できます。

部品を選択すると、設置に関連する情報(つまり、新規 / 保証)と数量を追加できます。

返品部品

検索フィールドを使用して、返される部品を参照します。

詳細ボタンを使用すると、すべての部品をスクロールできます。

シリアル管理部品の場合は、シリアル番号を入力できます。 シリアル管理部品の数量は1である必要があります。

シリアル番号なしの部品の場合、シリアル番号は空白のままにする必要があり、それに応じて数量を調整できます。

すべての料金が追加されると、次のように要約がページに表示されます:

報告情報の取得が完了したら、顧客のシグネチャを取得し、PDF請求書を生成できます。        

1. 署名して保存をクリックします。        
2. シグネチャ・ペインを使用して請求書にシグネチャします。        
3. 「送信」をクリックします。

ノート: 請求書が発行されると、請求書はダウンロードおよびレビューのためにアクティビティ・プロパティにPDFファイルとして格納されます。 請求書を変更する場合は、アクティビティを再オープンし、報告を再度実行して、新しいPDFファイルが古いPDFファイルを上書きするようにする必要があります。

会社ロゴ

お客様は、名前「logoUrl」および値が「会社のロゴのURL」の新しいセキュア・パラメータを追加して、Time and Labourレポートに会社のロゴを提供できます。

ロゴ・イメージは.jpegのみをサポートし、イメージの推奨サイズは"150X60"未満です。

カスタマイズ

デブリーフィング・プラグインをカスタマイズするには:

1. コレクション内のプラグイン・ソース・アーカイブを見つけます(例: plugin-debriefing-source-zip)。     
2. アーカイブを抽出し、詳細はREADME.mdファイルを表示します。

標準プラグインのデブリーフィングは、Oracle Field Serviceにデフォルトで用意されています。 特別な技術スキルを必要とせずに、数回のクリックで簡単に選択してインストールできます。

有効化のステップ

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

ヒントと考慮事項

デブリーフィング・プラグインをダウンロードしたら、使用を開始する前に構成する必要があります。 手順については、「プラグイン構成」のセクションを参照してください。

主なリソース

• モバイル・プラグイン・フレームワーク : https://docs.oracle.com/en/cloud/saas/field-service/falid/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

Standardプラグインとプラグインのユーザー・エクスペリエンスの向上

はじめに

更新23Aでは、フィールド・サービス内ですぐに使用できるStandardプラグインのリストへの新しいアクセシビリティが提供されます。 特別な技術スキルを必要とせずに、数回のクリックで標準プラグインを簡単に選択してインストールできます。 新しいリリースでは、2つのStandardプラグインが提供されています - サンプルとデブリーフィング。 また、Standardプラグインのソース・コードをダウンロードして、特別なビジネス・シナリオをカバーするために必要に応じて変更し、システムに簡単にアップロードすることもできます。

また、Oracle Field Serviceのプラグイン・ページは、ユーザー・エクスペリエンスが向上したRedwoodスタイルに再設計されました。

新機能

• プラグインのタイプを選択できる新しいプラグインの追加ダイアログ・ウィンドウ。 このウィンドウには、各プラグイン・タイプの説明が含まれています。
• 使用可能なプラグイン、その説明およびバージョンのリストを提供する新しいStandardプラグイン・ページ(更新23Aにはサンプルおよびデブリーフィング・プラグインが含まれています)。
• システムにすでに存在する場合、または確認後に自動的に作成されるプロパティについて、ユーザーがプラグインによって使用される必須プロパティを確認できる新規インストール・プラグイン・ページ。
• インストール済Standardプラグインは、対応するRedwoodアイコンがある「フォーム&プラグイン」ページで使用できます。
• すべてのプラグイン・ページがRedwoodスタイルに再設計され、UXが向上します。

ユース・ケース

• Standardプラグインをインストールします。コンフィギュレータは、Standardプラグイン(更新23Aのサンプルまたはデブリーフィング・プラグイン)を選択し、数回のクリックでインストールできます。
• コンフィギュレータは、ユーザーがOracle Field Serviceページを使用してこれらのプラグインにアクセスするためのボタンを追加できます。
• コンフィグレータまたはインテグレータは、ソース・コードをダウンロードして、特別なビジネス・シナリオをカバーするために必要な変更を加え、プラグインをOracle Field Serviceにアップロードできます。
• コンフィギュレータは、追加のセキュア・パラメータの追加など、Standardプラグインに追加の構成を追加できます。

Standardプラグインの概要

更新23Aより前は、特別なビジネス・ロジックでOracle Field Service機能を拡張するために、独自のカスタム・コード(カスタム・プラグインを使用)を実装し、Oracle Field Service(ホスト・プラグイン)でホストするか、プラグインが外部(外部プラグイン)でホストされている場合はリンクを追加しました。

カスタム・プラグインとは異なり、StandardプラグインはOracleによって導入およびサポートされ、更新23Aからシステム内の即時利用可能になります。 これらのプラグインは変更できません。 これには、特定のビジネス・シナリオ(報告など)をカバーするロジックが含まれ、他のOracle CX製品(サービス・ロジスティクスなど)との統合をサポートできる可能性があります。

つまり、Standardプラグインのソース・コードをダウンロードして変更し、ホストされたプラグインとしてOracle Field Serviceに再アップロードできます。 変更されたコードはOracleでサポートされなくなります。

Standardプラグインの構成

Standardプラグインのインストール

1. 「構成」>「フォーム&プラグイン」を開きます。
2. プラグインの追加をクリックします。 このスクリーンショットは、「フォーム&プラグイン」ページを示しています:

1. Standard plug-inオプションを選択し、次へをクリックします。 このスクリーンショットは、「プラグイン・タイプ」ダイアログ・ボックスを示しています:

ノート: Standardプラグインは、ホストされる25のプラグイン制限に含まれません。

3. リストから必要なプラグインを選択します。 各プラグインには、名前、説明および現在のバージョンがあります。 更新23Aでは、2つのプラグインを使用できます:- サンプル・プラグイン- デブリーフィング・プラグイン

NOTE : プラグインは英語でのみサポートされています。

このスクリーンショットは、Oracle Field Serviceで使用可能な標準プラグインを示しています:

プラグイン・ページには、次の情報が表示されます:

• プロパティがインストールされます。 プラグインで自動的にインストールされ、その後構成で使用できるようになるプロパティのリストが表示されますか。 プロパティ・ページ。 プラグインが将来アンインストールされる可能性がある場合、これらのプロパティはプロパティ・ページに残ります。
• 既存のプロパティが使用されます。 プラグインに必要なプロパティのリストが表示され、システムにすでに存在しています。

このスクリーンショットは、インストールされるプロパティを示しています:

ノート: 一部のプロパティの構成(プロパティ・タイプ、エンティティなど)が正しくない場合は、対応するメッセージがユーザーに通知されます。 プラグインのドキュメントを開き、プロパティ要件を見つけて、それに応じてプロパティ設定を変更する必要があります。

このスクリーンショットは、正しく構成されていないプロパティを示しています:

4. Installボタンをクリックし、インストールを確認します。

4. 確認後、インストールに時間がかかり、完了すると、ユーザーはプラグインが正常にインストールされましたという通知とともに「フォーム&プラグイン」ページにリダイレクトされます。

「フォーム&プラグイン」ページでのStandardプラグインの検索

「フォーム&プラグイン」のリストからプラグインを検索するには、ヘッダーをスクロールまたはフィルタします。

このスクリーンショットは、「フォーム&プラグイン」ページのプラグインのみを示しています:

このスクリーンショットは、「フォーム&プラグイン」ページのフィルタを示しています:

インストール済のプラグインは2回インストールできません。 このスクリーンショットは、デブリーフィング・プラグインのインストール済ラベルを示しています:

インストールされているプラグインを開くと、インストール・ボタンが無効になります。 このスクリーンショットは、デブリーフィング・プラグインに対して無効なインストール済ボタンを示しています:

プラグインの削除

プラグインをアンインストールするには、リストからプラグインを選択し、プラグイン・アクション・メニューから削除オプションをクリックします:

このスクリーンショットは、削除ダイアログ・ボックスを示しています:

Standardプラグイン設定の変更

一部の例外を除き、インストール後にStandardプラグインに変更を加えることができます。 プラグイン機能を保持するために必須フィールドは変更できません。 プラグインのラベルは常に読取り専用モードで表示されます。 特定のプロパティやパラメータを操作するために使用されたプラグインも構成できません。 このスクリーンショットは、「外部プラグインの編集」ページを示しています:

コードのダウンロードによるStandardプラグインの変更

1. Standardプラグイン・ページに移動し、必要なプラグインを選択します。
2. ソースのダウンロード・ボタンをクリックします。
3. コードを変更します。
   1. README.mdの手順に従ってアーカイブを作成し、テスト目的でホスト・プラグインとしてシステムにアップロードします。
   2. 構成に移動しますか? プラグインを追加しますか。 プラグイン・アーカイブをアップロードするか、REST APIを使用します。
   3. ページにボタンを追加します。
   4. 変更を含むプラグインを開き、シナリオをテストします。

重要: これを行うと、プラグインはカスタム・プラグインになり、Oracleではサポートされなくなります。

このスクリーンショットは、ソースのダウンロード・ボタンがあるデブリーフィング・プラグインを示しています:

-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

サンプル・プラグイン

概要

以前は、サンプル・プラグインのコードをパブリック・ドキュメントからコピーし、アーカイブを作成してOracle Field Serviceにアップロードしてから操作するのに非常に時間がかかりました。 更新23Aでは、サンプル・プラグインが使用可能で、Oracle Field Service内のボックスからアクセスできるため、数回のクリックでインストールし、テスト目的、チェック・リクエスト、バーコード・スキャナ、印刷ファイル、サービス・ワーカーなどのチェック機能に使用できます。

• サンプル・プラグインは、モバイル・プラグイン・フレームワーク内で使用可能な機能を示しています。    
• ユースケース・フローのテストを可能にし、受信メッセージおよび送信済メッセージをテストするためのサンドボックスを提供します。    
• これは、独自のカスタム・プラグインを実装する例として使用できます。

サンプル・プラグインのインストール

プラグインを構成して操作するプロセスは次のとおりです:

1. サンプル・プラグインをインストールします(Standardプラグインのインストール方法の手順に従います)。     
2. モバイル・プラグイン・フレームワーク・ドキュメントの使用可能な機能を確認します。     
3. 必要な設定をプラグインに追加します(プロパティ、セキュアなパラメータなど)。     
4. 必要なOracle Field Serviceページにプラグインのボタンを追加します。    
5. プラグインを開き、シナリオをテストします。    
6. テストのためにプラグインが不要になった場合は、システムからプラグインをアンインストールします。

サンプル・プラグインのソース・コードの学習

1. 「フォーム&プラグイン」をクリックします。プラグインを追加します。 Standard Pluginsをクリックします。
2. 「Standardプラグイン」ページで、サンプル・プラグインをクリックします。    
3. ソースのダウンロード・ボタンをクリックします。    
4. 実装を確認します(たとえば、オフライン・モードをサポートするためにService Workerを実装する方法)。    
5. コードの変更を続行できます
6. コードを変更します。         
7. README.mdの指示に従ってアーカイブを作成し、それをテスト目的でホスト・プラグインとしてシステムにアップロードします。        
8. 構成に移動しますか? プラグインを追加しますか? プラグイン・アーカイブをアップロードするか、REST APIを使用してアップロードします。         
9. ページにボタンを追加します。        
10. 変更を含むプラグインを開き、シナリオをテストします。

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

デブリーフ・プラグイン

概要

報告は、活動の実行中に使用される時間と資材をレポートするプロセスです。

フィールド技術者は、報告プロセスを使用して次の情報を報告します:

• 労務: 移動時間および作業時間が含まれます(時間単位で測定)。
• 部品: アクティビティの実行中に使用される部品および資材。
• 手数料: 料金や駐車場などの追加料金(支出金額で測定)。

すべての部品、労務および経費項目は、特定の顧客活動の導入済在庫プールに格納されます。 また、請求書はPDFファイルとしてアクティビティのファイル・プロパティに保存されます。

使用方法

開始済アクティビティに対して表示される報告ボタンを使用すると、ユーザーは、時間、経費または資材情報を請求書レポートに追加し、この情報を保存し、顧客のシグネチャを取得できます。

プラグインを開く

1. フィールド・リソースとしてアプリケーションにログインします。
2. Start Activityをクリックします。
3. プラグインを開くには、「アクティビティの詳細」ページの報告をクリックします。

アクティビティに対して部品をすでに取り付けまたはアンインストールしている場合、これらの部品はリストに応じて追加部品および返却部品として事前に移入されます。 それ以外の場合は、項目なしで報告プラグインが開き、課金を追加ドロップダウン・リストをクリックして報告プロセスを開始できます。

勤務管理の追加

料金の追加ドロップダウン・リストをクリックし、労務を選択して、次のフィールドに入力します:

• 請求タイプ: 技術者が実行するビジネス・プロセス。 このようなサービス・アクティビティのリストは、契約で定義されます。 たとえば、通勤、診断および修理などです。
• 請求項目: 技術者が実行する処理。 原価および価格は、選択した品目によって異なります。
• 摘要: 項目の摘要。 選択した品目の摘要が自動的に移入されます。
• 開始時間: 技術者がアクティビティを開始する時間。
• 終了時間: 技術者がアクティビティを終了する時間
• 期間は開始時間と終了時間の差を反映し、レートをサポートするために小数時間に小数点以下の2桁を表示します。これは1時間当たりの金額として定義されます。

経費の追加

レポートに駐車料金などの経費を追加するには、料金の追加ドロップダウン・リストをクリックして経費を選択します。 「経費の追加」ページが表示されます:

• 請求タイプ: 技術者が実行するビジネス・プロセス。 このようなサービス・アクティビティのリストは、契約で定義されます。 たとえば、通勤、診断および修理などです。
• 請求項目: 技術者に請求される処理。 道路など。
• 摘要: 項目の摘要。 選択した品目の摘要が自動的に移入されます。
• 金額: アクティビティに費やされた金額。 たとえば、25.15。
• 通貨: 支払に使用される通貨。 これは、プラグイン構成から自動的に移入されます。

部品の追加

レポート内でアクティビティに使用される部品を追加するには、料金の追加ドロップダウン・リストをクリックし、部品の追加を選択します。 検索フィールドを使用して、必要な部品を問い合せます。

• シリアル番号なし項目の場合は、部品を選択し、数量を指定して送信をクリックします。
• シリアル管理品目の場合は、部品を選択し、シリアル番号を指定して発行をクリックします。

返品部品の追加

料金の追加ドロップダウン・リストをクリックし、部品の返品を選択します。 検索フィールドを使用して、必要な部品を問い合せます。

• シリアル番号なし項目の場合は、部品を選択し、数量を指定して送信をクリックします。
• シリアル管理品目の場合は、部品を選択し、シリアル番号を入力して発行をクリックします。

報告項目の削除

一部の項目を誤って追加した場合は、削除アイコンをクリックして削除できます。

すべての報告項目が追加されたときに請求書を生成

報告情報の取得が完了したら、顧客のシグネチャを取得し、PDF請求書を生成できます。

署名して保存ボタンをクリックします。 シグネチャ・ペインを使用して請求書にシグネチャし、発行をクリックします。 プラグインはクローズされ、請求書はダウンロードおよびレビューのためにアクティビティ・プロパティにPDFファイルとして格納されます。 請求書を更新する場合は、新しいPDFファイルが古いPDFファイルを上書きするように、活動を再オープンして報告を再度実行する必要があります。

会社ロゴ

お客様は、logoUrlという名前の新しいセキュア・パラメータと「会社のロゴのURL」の値を追加することで、時間&労働レポートに会社のロゴを指定できます。

ロゴ・イメージでは.jpeg形式のみがサポートされ、イメージの推奨サイズは"150X60"未満です。

構成方法

プラグインを構成するプロセスは次のとおりです:

ノート: これらのステップの順序は重要です。

1. デブリーフィング・プラグインをインストールします(Standardプラグインのインストール方法の手順に従います)。      
2. 必要なインベントリ・タイプおよびユーザー・タイプを作成/構成します。
3. 顧客の請求書に表示される会社ロゴのURLを追加します。      
4. システムで部品カタログがまだ使用されていない場合は、部品カタログをアップロードします。

トラブルシューティングのためのプロパティ要件

インストール・プロセス中に、必要なプロパティが自動的に作成されるか、既存のプロパティがすでにconfigured.Noteの場合にプラグインによって使用されることが通知されます: システムに、対応する名前とラベルのプロパティがすでにあるが、構成が不適切である場合、顧客はプロパティ設定を変更し、インストールを再度繰り返す必要があります。

リソース・エンティティ・プロパティ

リソース・エンティティ・プロパティ

名前	ラベル	タイプ	GUI	説明
ID	pid			リソースの内部ID。
名前	pname			リソースの名前。

アクティビティ・エンティティ・プロパティ

名前	ラベル	タイプ	GUI	説明
請求書	invoice	ファイル	ファイル	生成された請求書のPDFファイル。 例: mime_types ="application/pdf"
会社名	ccompany	文字列	テキスト	請求書のタイトルとして表示される顧客の会社名。
アクティビティID	aid			アクティビティの内部ID。
名前	cname			PDF請求書で使用されるアクティビティの名前。
Address	caddress			請求書で使用されるアクティビティ住所。
市区町村	ccity			請求書で使用されるアクティビティ市区町村。
State	cstate			請求書で使用されるアクティビティ状態。
郵便番号	czip			請求書で使用される郵便番号。
作業オーダー	appt_number			請求書で使用される作業オーダーです。
シグネチャ	csign			請求書をPDFとして保存する前に必要な顧客シグネチャ。

在庫エンティティ・プロパティ

名前	ラベル	タイプ	GUI	説明
費用	expense_amount	文字列	テキスト	経費の金額。
経費通貨	expense_currency_code	列挙	コンボ・ボックス	各列挙項目の値は「|」文字で区切られます。
部品処分	part_disposition_code	列挙	コンボ・ボックス	在庫が顧客によって消費可能で、追跡する必要がなくなったかどうか、または在庫が返品可能かどうかを識別する値です。 在庫が返品可能な場合、Oracle SCM CloudのInventory Managementシステムは、顧客が返品するまで部品を追跡する必要があります。
部品単位	part_uom_code	列挙	コンボ・ボックス	部品(在庫)の単位(UOM)
部品品目摘要	part_item_desc	文字列	テキスト	部品の摘要。 たとえば、磁気ハード・ドライブです。 カタログ内の在庫の検索に使用されます。
部品品目番号	part_item_number	文字列	テキスト	お客様から設置または取得された部品の番号。 コードとして指定されます。 たとえば、FS908765です。
部品品目改訂	part_item_revision	文字列	テキスト	単一文字のコード。たとえば、「A」や「B」です。 また、「1」や「2」のような1桁の数字を使用することもできます。 通常、在庫は部品品目と部品品目の改訂で識別されますが、品目改訂はオプションです。
部品品目番号+改訂	part_item_number_rev	文字列	テキスト	部品品目番号は、部品品目改訂と連結されます。 たとえば、FS908765Aのように、"FS908765"は部品項目番号、"A"は部品項目改訂です。 カタログ内の在庫の検索に使用されます。
経費アクティビティ	expense_service_activity	列挙	コンボ・ボックス	経費のタイプ。
費用項目	expense_item_番号	列挙	コンボ・ボックス	経費のサブタイプ。
経費項目摘要	expense_item_の説明	列挙	コンボ・ボックス	経費サブタイプの摘要。 インデックスは、expense_item_numb erプロパティと同じである必要があります。 値は、対応するexpense_item_numb er要素を説明する必要があります。
労務終了時間	labor_end_time	文字列	テキスト	技術者が特定のサービス・アクティビティに対する作業を停止した時間。 作業オーダーの終了時間(Oracle Field Serviceアクティビティ)より後にすることはできません。 また、労務リストの項目間に重複がない必要があります。 形式はT24:59:59です。
労務開始時間	labor_start_time	文字列	テキスト	技術者が特定のサービス・アクティビティに対する作業を開始する時間。 作業オーダーの開始時間(Oracle Field Serviceアクティビティ)より前にはできません。 また、労務リストの項目間に重複がない必要があります。 形式はT24:59:59です。
労働アクティビティ	labor_service_activity	列挙	コンボ・ボックス	労務のタイプ
労務項目	labor_item_number	列挙	コンボ・ボックス	労務のサブタイプ
労務品目摘要	labor_item_desc	列挙	コンボ・ボックス	労務サブタイプの摘要。 索引は、labor_item_numberプロパティと同じである必要があります。 値は、対応するlabor_item_number要素を説明する必要があります。
在庫ID	invid			インベントリの内部ID。
アクティビティID	inv_aid			在庫が割り当てられているアクティビティの内部ID。
リソースID	inv_pid			在庫が割り当てられているリソースの内部ID。
在庫プール	invpool			在庫プール(リソース、顧客、インストール済、未インストール)
在庫タイプ	invtype			在庫のタイプ。 プラグインのインベントリ・タイプの追加を参照してください。
数量	quantity			取り付けられた部品または顧客から取られた部品。 インチ、フィートなどでカウントまたは指定できます。 数量は整数として定義されます。
シリアル番号	invsn	フィールド	テキスト	在庫のシリアル番号。

プラグインのインベントリ・タイプの追加

アクティビティ中に使用される時間と資材に関する情報を取得するには、在庫タイプ(費用、労務、部品、part_sn)を追加する必要があります。 プラグインは、時間および経費に関するレポート済情報をアクティビティのインストール済プールに格納します。 ただし、使用される部品と返された部品である資材は、それぞれリソース・プールと顧客プールに格納されます。

1. 管理者としてOracle Field Serviceにログインします。
2. 構成、在庫タイプにナビゲートし、新規追加をクリックします。
3. 次のように費用在庫タイプを追加します:
   1. ラベル・フィールドに'expense'と入力します。
   2. 名前フィールドに'Expense'と入力します。
   3. モデル・プロパティ・ドロップ・ダウン・リストからExpense_itemを選択します。
   4. 「保存」をクリックします。
4. 次のように労務在庫タイプを追加します:
   1. ラベル・フィールドに'labor'と入力します。
   2. 名前フィールドに'Labor'と入力します。
   3. モデル・プロパティ・ドロップ・ダウン・リストからLabor_Itemを選択します。
   4. 「保存」をクリックします。
5. 次のように部品在庫タイプを追加します:
   1. 「ラベル」フィールドに'part'と入力します。
   2. 名前フィールドに'Part'と入力します。
   3. モデル・プロパティ・ドロップ・ダウン・リストからPart_Item+Revisionを選択します。
   4. 「保存」をクリックします。
6. 部品SN在庫タイプを次のように追加します:
   1. 「ラベル」フィールドに'part_sn'と入力します。
   2. 名前フィールドに'Serialized Part'と入力します。
   3. モデル・プロパティ・ドロップ・ダウン・リストからPart_Item+Revision (「部品SN品目」フィールドの一意の識別子)を選択します。
   4. 「保存」をクリックします。

ユーザー・ページへのデブリーフィング・プラグインの追加

プラグインを複数のユーザー・タイプで使用できるようにするには、対応するOracle Field Serviceページにユーザー・タイプに関連付けます。 報告は開始済アクティビティに対してのみ行われるため、「アクティビティの編集/表示」ページに報告ボタンを追加して、アクティビティがそのステータスの場合にのみ表示されるようにします。

1. ここに示す手順を使用して、該当するユーザー・タイプのページにプラグインのボタンを追加: プラグインを画面に追加する方法
2. 表示ボタン・セクション内からのみ開始済アクティビティに対してプラグインを使用可能にします。 新規追加オプションをクリックし、条件内のプラス・ボタンをクリックし、それぞれのドロップダウンからアクティビティ・ステータスおよび次と等しいを選択します。 次に値の選択をクリックし、開始チェック・ボックスを選択し、保存をクリックしてウィンドウを閉じます。 次に、ビジュアル・フォーム・エディタ内の全体的な変更を保存します。

部品カタログの構成

部品カタログのアップロード方法

カタログで使用または返品された部品を検索し、それらの部品を請求書に追加できます。 カタログから部品を表示するには、SOAP APIまたはREST APIのcreate_catalogメソッドを使用してカタログを作成する必要があります

次に、レポート用のカタログを作成する例を示します:

{           

"name": "my_catalog",           

"fieldSchemas": [               

{                   

"label": "part_disposition_code", 

"name": "Part Disposition Code", 

"searchable": true, 

"preview": false 

},               

{                   

"label": "part_item_number",                   

"name": "Item Number",                   

"searchable": true,                   

"preview": true               

},  

{  

"label": "part_item_revision",   

"name": "Item Revision", 

"searchable": true  

},               

{                   

"label": "part_item_desc",  

"name": "Item Description", 

"preview": true 

},               

{                   

"label": "part_uom_code",  

"name": "UOM", 

"preview": true, 

"searchable": true 

}         

],           

"typeSchemas": [               

{                   

"itemType": "part",  

"inventoryType": "part_general"   

},               

{                   

"itemType": "cartridge", 

"inventoryType": "part_cartridge"  

}           

]              

}

次の例は、デブリーフ・シナリオの部品カタログ品目を作成または更新する方法を示しています:

"type": "part",           

"fields": [               

{     

"label": "part_disposition_code", 

"value": "ECM100001A"  

}, 

{    

"label": "part_item_number",   

"value": "ECM100000"  

},  

{   

"label": "part_item_revision", 

"value": "ECM100000A" 

},  

{  

"label": "part_item_desc",    

"value": "2" x 5" Robotically Welded Steel Frame" 

},  

{   

"label": "part_uom_code",  

"value": "ea" 

}             ],  

"tags": [  

"Printer", 

"Cartridge"  

], 

"linkedItems": [   

{  

"itemLabel": "RG5-7691-250CN", 

"data": "1"  

},  

{  

"itemLabel": "RG5-7691-250CF",  

"data": "2" 

},  

{  

"itemLabel": "RG5-7691-250CZ", 

"data": "3"  

}            ], 

"images": [   

{   

"imageURL": "https://www.storage-service.com/rg5_7691_250cz.png"  

}, 

{  

"imageURL": "https://www.storage-service.com/rg5_7691_250cf.png" 

} 

]

}

次の点を確認してください:

「作成」または「更新」の部品カタログ・コール内の「タイプ」フィールドは、シリアル管理在庫の場合は「パート」である必要があります。 部品カタログ・コールの作成または更新内の「タイプ」フィールドは、非シリアル管理在庫の場合は「part_sn」と同じである必要があります。 各項目の'Fields'スキーマには、次の要素が含まれている必要があります:

品目フィールド・スキーマに含める必要がある要素

ラベル	プロパティ・ラベル	検索可能
part_uom_code	part_uom_code	0
part_item_revision	part_item_revision	0
part_item_number	part_item_number	0
part_item_desc	part_item_desc	1
part_disposition_code	part_disposition_code	0

プラグイン構成の変更

プラグインにセキュリティ保護されたパラメータを追加することはできますが、ラベルや使用可能なプロパティを変更することはできません。

この機能を使用すると、特別な技術スキルを必要とせずに、標準プラグインを簡単に選択してインストールできます。 また、Standardプラグインのソース・コードをダウンロードし、ビジネス・シナリオにあわせて変更してから、Oracle Field Serviceにアップロードすることもできます。

有効化のステップ

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

主なリソース

• モバイル・プラグイン・フレームワーク : https://docs.oracle.com/en/cloud/saas/field-service/falid/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

レポーティング

ダッシュボードでの重要なフィルタ基準の表示

概要

ここに示すように、グラフィカル・レポートには、結果のフィルタに使用する基準(日付、リソース、キャパシティ・カテゴリなど)が表示されます。

日付およびリソースに加えて、次のフィルタ基準が各レポートに表示されます。

フィルタ基準表示

レポート	表示フィルタ基準
カテゴリ別生産能力	キャパシティ・カテゴリ、予約間隔/タイム・スロット
自動ルーティング結果	アクティビティ・タイプ・グループ
ステータス別アクティビティ	アクティビティ・タイプ・グループ
ボリューム別完了進捗	アクティビティ・タイプ・グループ 測定単位はグラフの容積の横に表示されます
リソース当たりの平均移動時間	アクティビティ・タイプ・グループ
活動タイプ別平均生産性	アクティビティ・タイプ・グループ
リソースの比較 - 活動の数	アクティビティ・タイプ・グループ、リソース数
リソースの生産性の比較	アクティビティ・タイプ・グループ、リソース数
完了進捗	アクティビティ・タイプ・グループ
配送までの平均時間	キャパシティ・カテゴリ、アクティビティ・タイプ・グループ、リソース数
活動達成率	アクティビティ・タイプ・グループ、リソース数
顧客期待率達成	アクティビティ・タイプ・グループ、許容遅延、リソース数
ルーティング・エラー事由	アクティビティ・タイプ・グループ

この機能では、レポート名の下にフィルタ基準が表示されます。これにより、ユーザーは各レポートに適用されたフィルタ条件を簡単に識別できます。

有効化のステップ

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

主なリソース

• レポートの構成および使用 : https://docs.oracle.com/en/cloud/saas/field-service/fasmr/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

ルーティング

ルーティング・プラン構成のエクスポートおよびインポート

概要

更新23Aには、JSON形式でルーティング・プランをエクスポートする新機能と、以前にエクスポートしたルーティング・プランをOracle Field Service UIを介してインポートする機能があります。 APIを介してルーティング・プランおよびプロファイルを作成、読取りおよび更新する機能もあります。 新しいAPIをサポートするために、すべてのルーティング・プロファイルおよびプランに、システム全体で一意のラベルが含まれるようになりました。

使用方法

インポートおよびエクスポート機能を使用して、実データでルーティング戦略をテストしてから本番に実装できます。 そのためには、まず本番インスタンスからテスト・インスタンスを作成し、ルーティング・プランに必要な変更を実装します。 その後、各計画コンテキスト・メニューからエクスポート・メニュー項目を選択し、ダウンロードしたファイルをデバイスのフォルダに保存することによって、変更したルーティング・プランをテスト・インスタンスから1つずつエクスポートします。 ルーティング・プランを本番インスタンスにインポートするには、必要なルーティング・プロファイルを選択し、ルーティング・プランのインポート・コンテキスト・メニュー項目を選択して、JSONファイルをアップロードします。 同じ名前のプランがルーティング・プロファイルにすでに存在する場合は、リライトを確認する必要があります。 インポートされた計画が依存するエンティティ(アクティビティ・フィルタやリソース・フィルタ、メッセージ・シナリオ、以前のルーティング・プラン、アクティビティ・タイプなど)がターゲット・システムにない場合、警告が表示され、欠落している各項目の置換を選択するためのダイアログ・ウィンドウが表示されます。 選択内容が保存され、次回に事前選択された値として使用されます。

CI/CD戦略の実装

更新23Aでは、ルーティング・プランのインポートおよびエクスポートを自動化するために、多数の新しい構成APIエンドポイントが追加されました。 これらに基づいて、独自のCI/CD戦略を実装できます。

ルーティング・プランおよびプロファイルへのAPIアクセスを許可するには、「構成」>「アプリケーション」に移動し、認証メソッドを選択し(または、ない場合は追加)、Metadata APIノードに読取り/書込み権限を持つルーティング・プロファイルを追加して、アプリケーションを保存します。

1. 最初のステップとして、ソース・システムからルーティング・プロファイルのリストを取得して、プロファイル・ラベルを取得できます。    
2. その後、プロファイル・ラベルを使用して、特定のプロファイルごとのルーティング・プラン・ラベルのリストを取得できます。    
3. アーカイブ可能な.jsonファイルを取得するために必要な計画をエクスポートできます。    
4. アーカイブされた計画をリストアする必要がある場合は、前のステップで取得したファイルを使用して、ソース・システムに強制的にインポートできます。

メソッドおよびパラメータの詳細は、Metadata APIのドキュメントを参照してください。

ノート: エクスポートされたルーティング実行ファイルは、承認されていない変更を防ぐために署名されます。 このような変更済ファイルをインポートしようとすると、エラー・メッセージが表示され、実行はインポートされません。

ラベルの編集

新しいルーティング・プロファイルまたはプランを名前とともに追加する場合は、プロファイルとプランを区別するためにAPIで使用されるラベルを指定します。 プロファイル・ラベルはプロファイルの変更中に編集できますが、ルーティング・プラン・ラベルはプランの追加/編集プロセス中に変更できます。

ノート: プランとプロファイル・ラベルの両方がシステム全体で一意である必要があります。

スクリーンショット

次のスクリーンショットは、エクスポートおよびインポート・メニューとインポート・ダイアログ・ボックスを示しています:

ルーティング・プランをエクスポートおよびインポートする機能は、インスタンス間でプランを簡単に移行し、手動エラーなしで事前にテストされたルーティング戦略を迅速に実装するのに役立ちます。

有効化のステップ

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

主なリソース

• ルーティングの使用 : https://docs.oracle.com/en/cloud/saas/field-service/farcu/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

一括ルーティングでの最も重要なアクティビティの早い開始の優先度付け

概要

「最も重要なアクティビティの早期開始の優先順位付け」という新しい最適化目標がルーティング・プラン設定に追加され、アクティビティを非割当のコストに従ってオーダーできるようになっています。

新機能

「最も重要なアクティビティの早期開始の優先順位付け」最適化目標により、ルーティングでは、非割当のコストでアクティビティをオーダーできます。

また、新しい非割当理由が追加されました:

新規エラー・コード

エラー・コード	エラー	説明
6077	適切な作業スキルを持つフィールド・リソースや、特定の作業ゾーンでの作業ができない	アクティビティ要件は、使用可能なリソースでは満たせません。 このエラーは必ずしもエラーを示しているとは限りませんが、次の設定を確認して、モバイル従業員の正確な設定を確認する必要があります: 作業ゾーン 作業スキル
6092	アクティビティは移動可能ではありません	アクティビティ・タイプ制約またはルーティング・プラン設定により、アクティビティが日数またはリソース(あるいはその両方)の間を移動できません。
6093	特定のアクティビティを処理するためにカレンダ単位で使用可能なフィールド・リソースがありません	アクティビティ要件は、使用可能なリソースでは満たせません。 このエラーは必ずしもエラーを示しているとは限りませんが、次の設定を確認して、モバイル従業員の正確な設定を確認する必要があります: リソース・カレンダ

使用方法

最も重要なアクティビティの以前の開始に優先順位を付けるには、新しい一括ルーティング・プランを作成するか、既存の一括ルーティング・プランを変更できます。 ルーティング・プランの「最適化戦略」セクションで、最適化目標ドロップダウン・メニューから「最も重要なアクティビティの早期開始の優先順位付け」を選択します。 次に、フィルタ・セクションを開き、アクティビティの割当外コストを選択します。割当なしのアクティビティ・コストが高いほど、アクティビティをスケジュールできる作業日の開始に近づきます。

ノート: 一括ルーティングは、各ルートではなくルートのセット全体を最適化しようとします。 このため、非割当コストが高い特定のアクティビティが、非割当コストが低いアクティビティより後にスケジュールされる可能性はありますが、そうした割当によって移動時間が考慮されるときに全体的な最適化が改善されます。

目的の結果を得るには、未スケジュール・アクティビティ、ルートにすでに存在するアクティビティ、および最適化プランを含むプロファイル内のすべてのルーティング・プランを含むすべてのフィルタ間で、非割当コストが一貫している必要があります。

「最も重要なアクティビティの早期開始の優先順位付け」が最適化目標として選択されている場合、割当外コストが最も高いアクティビティが事前にスケジュールされ、次の制約が適用されます:

• この最適化目標はバンドルされた訪問に適用されます。 特定のバンドルの最初のアクティビティのジョブ・サイトの技術者がバンドル内のすべてのアクティビティを完了すると予想されます。 ただし、バンドル内のアクティビティは非割当コストでオーダーする必要があり、割当外コストが最も高いアクティビティはルート内のバンドル全体を表す必要があります。

• アクティビティの作業スキル、作業ゾーンおよびカレンダ要件が満たされています。

• アクティビティ・デリバリ時間枠、サービス時間枠/タイム・スロットおよびアクセス時間が満たされています。

• 遅延到着ペナルティは、同じ非割当原価優先度を持つアクティビティに対して考慮されます。

• 出張はアクティビティ・オーダーに影響を与えずに最適化されます。

• アクティビティSLAは観察されますが、割当外コスト優先度が同じアクティビティに対してのみ観察されます。

「最小」からすべてのコストまでの範囲で、アクティビティ開始の優先順位付けに使用される9つの主な優先度レベルがあります。 追加レベルが必要な場合は、「遅延到着ペナルティ」を使用して、同じ非割当コスト(「最小」から「高」)のアクティビティのアクティビティ優先度をさらに区別できます。 たとえば、「非割当の原価」が「高」に設定され、「遅延到着ペナルティ」がNormalに設定されたアクティビティは、「非割当の原価」がNormalに設定され、「遅延到着ペナルティ」がNormalに設定されたアクティビティよりも優先度が高くなります。 ただし、最初のアクティビティの優先度は、「非割当の原価」が「高」に設定され、「遅延到着ペナルティ」が「高」に設定されたアクティビティより低くなります。

例 - 機械修理の練習

会社には、次のアクティビティ・タイプのサイズ・マシン用のライン・オブ・ビジネスがあります:

• 重要な修理 - マシンが動作せず、非稼働時間ごとに高額な料金が支払われます。    
• 修復 - マシンは部分的に動作しています。たとえば、ディスプレイは機能しません。 非勤務時間ごとに小額の料金が支払われます。    
• 予防メンテナンス - これはSLAベースの作業です。 料金は支払われませんが、技術者が現場にいる場合、より重要な作業とともに作業を行うことが期待されます。

すべての技術者は同じスキルを持っています。

このようなスキームを実装するには、それぞれ独自のアクティビティ・タイプを持つ3つのアクティビティ・フィルタを作成する必要があります。

フィルタ機能を視覚的に制御できるようにするには、ルーティングとディスパッチ・コンソールの両方でフィルタを使用する必要があります。

このライン・オブ・ビジネスに対するバケット内のすべての既存の一括ルーティング・プランについて、これらの3つの新規アクティビティ・フィルタを「フィルタ : スケジュールして割り当てる必要があるルーティング・バケット内の未スケジュール・アクティビティ、割り当てる必要があるルーティング・バケット内のアクティビティ、スケジュールする必要がある事前割当済の未スケジュール・アクティビティ」および「既存ルート内のアクティビティ」のすべてのグループに追加し、次の設定を行う必要があります:

機械修理演習の設定

アクティビティ・フィルタ	アクティビティの未割当コスト	リソース・フィルタ	割当コスト
重要な修理	最高	その他	Normal
修復	Normal	Other	Normal
予防メンテナンス	最小	その他	Normal

最適化目標として「最も重要なアクティビティの早期開始の優先順位付け」を選択します。 ルーティング・パフォーマンスを向上させるには、「事前割当済アクティビティの処理」メニューで「ルート間でのアクティビティの移動および同じルート内での順序変更」を選択します。

「構成」-> 「ビジネス・ルール」ページで「訪問の有効化」機能がチェックされ、バンドル・キーが同じ顧客およびロケーションのアクティビティをバンドルするように設定されていることを確認します。

ルーティング・プランが実行されると、重要な修復アクティビティはルートの最初に、その後に修復アクティビティが続きます。 プリエンプティブ・メンテナンス・アクティビティは、より重要なアクティビティとともにバンドルされています。

既知の制約

特に、最適化目標が「最も重要なアクティビティの早期開始の優先順位付け」に設定されている計画が他の最適化目標を持つ計画と組み合されている場合、ルーティング・プランを同じバケットで異なる最適化目標と混在させることはお薦めしません。 このような組合せが避けられない場合は、最適化目標が「最も重要なアクティビティの早期開始の優先順位付け」に設定されている計画を除くすべての計画について、ルート間でアクティビティを移動し、同じルート内のアクティビティを並べ替える機能を禁止することをお薦めします。

ノート: 割当ては異なる方法で処理される可能性があるため、最適化目標が最も重要なアクティビティの早期開始の優先順位付けに設定されている計画で使用される同じアクティビティ・セットに対してフィルタに一致するアクティビティの即時ルーティングを使用することはお薦めしません。 ただし、最適化目標が「最も重要なアクティビティの早期開始の優先順位付け」に設定されたプランとともに「緊急アクティビティの即時ルーティング」プランを組み合せることができ、優先度レベルが「緊急」のアクティビティに、プラン設定の割当外コストの最大値を設定できます。

この機能を使用すると、一括ルーティング・プランで最も重要なアクティビティの早い開始時間を優先できます。

有効化のステップ

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

主なリソース

• ルーティングの使用 : https://docs.oracle.com/en/cloud/saas/field-service/farcu/index.html。 このリンクは、更新23A GAリリース後に使用可能になります。

重要な処理および考慮事項

置き換えられた機能または削除された機能

クラウド・サービスのセキュリティ、パフォーマンスおよび品質全体を向上させるために、ソリューションの機能および技術コンポーネントを削除または置換できます。 これが発生すると、機能またはコンポーネントの非推奨が事前に発表されるため、変更の予測および拡張された交換機能/コンポーネントへの移行に十分な時間がかかります。 非推奨が発表された後、非推奨の機能またはコンポーネントは、計画された削除日までソリューション内に残り、拡張や他の新機能との互換性はなくなります。

次に、このクラウド・サービスの新規および以前に発表された非推奨のリストを示します。

以前に発表された減価償却

アプリケーション領域	削除される機能	非推奨の発表	削除予定	置換後の機能	追加情報
ユーザー・ログイン・ドメイン	https://login.etadirect.com URLスキームを使用した認証リクエスト	22A (February 2022)	23D (November 2023)	URLスキームhttps:// <instance_name>.fs.ocs.oraclecloud.comの使用	この変更により、ターゲットのOracle Field Service環境が実行されている適切なデータ・センターにリクエストが転送されるようにすることで、認証時間が短縮され、データ・レジデンシに関連する政府および企業ポリシー規制に準拠します。 Oracle Field Serviceのすべてのバージョンで実行されているすべての環境では、更新23Dの一般提供日以降からログイン・ドメインはサポートされません。 詳細は、Oracle Field ServiceログインおよびAPIドメイン非推奨のトピックhttps://support.oracle.com/epmos/faces/DocumentDisplay?id= 2922270.1を参照してください。
APIドメイン	https://api.etadirect.com URLスキームを使用したAPIアクセス	22A (February 2022)	23D (November 2023)	URLスキームhttps:// <instance_name>.fs.ocs.oraclecloud.comの使用	この変更により、ターゲットのOracle Field Service環境が実行されている適切なデータ・センターにリクエストが転送されるようにすることで、認証時間が短縮され、データ・レジデンシに関連する政府および企業ポリシー規制に準拠します。 APIドメインは、すべてのバージョンのOracle Field Serviceで実行されているすべての環境について、更新23D一般提供日以降ではサポートされません。 詳細は、Oracle Field ServiceログインおよびAPIドメイン非推奨のトピックhttps://support.oracle.com/epmos/faces/DocumentDisplay?id= 2922270.1を参照してください。