本書は、既存の項の変更と、新規情報の追加に伴って、今後も引き続き更新されます。 これまでの更新内容は次の表のとおりです。
日付 | 製品 | 機能 | ノート |
---|---|---|---|
2021年4月23日 | 初版作成。 |
このガイドでは、Oracle Field Service更新21Bの新機能および改善された機能について理解しておく必要がある情報の概要を示します。 このガイドは本アップデートでの新規・改善機能の概要を理解するのに必要な情報およびアップデートに必要なタスクについて説明します。個々のセクションは機能の概略説明、その機能を実装に必要なステップ、ヒントおよび考慮点、他に必要なリソースが記述されています。 Oracle Field Serviceでサポートされているブラウザのリストについては、サポート・サイトにログインし、アンサーID 8415にアクセスしてください。
『Oracle Field Serviceベスト・プラクティス・ガイド』: Oracle Service Cloud Support PortalのアンサーID 8215 (ログインが必要)に記載されている『Oracle Field Serviceベスト・プラクティス・ガイド』をダウンロードしてください。 このマニュアルには、Oracle Field Serviceサブスクリプションの利点を十分改善して得られる、多数の役立つヒントや提案が記載されています。
フィードバックをお寄せください
本書の内容改善のため、ご意見やご提案をお待ちしております。 https://documentation.custhelp.com/ci/documents/detail/5/4/12までフィードバックをお送りください。
列の定義:
レポート = 新規または変更済の、オラクル社から提供されたすぐに実行可能なレポートです。
UIまたはプロセスベース: 小規模 = これらのUIまたはプロセスベースの機能は、通常、フィールド、検証またはプログラムの軽微な変更で構成されます。 したがって、ユーザーへの影響は最小限です。
UIまたはプロセスベース: 大規模* = これらのUIまたはプロセスベースの機能の設計は、より複雑になります。 したがって、ユーザーに及ぼす影響は大きくなります。
すぐ使用できない状態で提供される機能 = エンド・ユーザーがこれらの機能を使用するために処理が必要です。 これらの機能は無効化された状態で提供され、有効にするかどうかや有効にする時期を任意で選択します。 たとえば、a)新しいまたは拡張されたBIサブジェクト領域を最初にレポートに組み込む必要がある、b)新しいWebサービスを使用するには統合が必要である、c)機能にアクセスするには、ユーザー・ロールに機能を割り当てる必要があるなどです。
エンド・ユーザーがすぐに使用可能 レポートと小規模UIまたはプロセスベースの新機能が更新後にユーザーに与える影響は最小限です。 したがって、顧客受入テストでは、大規模UIまたはプロセスベース*の新機能に焦点を当てる必要があります。 |
エンド・ユーザーが使用するには顧客によるアクションが必要 これらの機能を使用可能にするためにアクションが必要になるため、ディスラプティブではありません。 利用することを選択する際には、テストと展開のタイミングを設定します。 |
|||||
---|---|---|---|---|---|---|
機能 |
レポート |
UIまたは |
UIまたは |
|
||
以前は、Oracle Field Serviceは、レポートされたデータが移動を見積もるのに十分でない場合に、拡張アルゴリズムを使用してアクティビティとの間の移動時間を計算していました。 このメソッドは、システムに十分な学習推定がない場合、または移動キーに大きな領域が含まれている場合には、精度が低下します。 更新21B以降、レポートされた移動が十分にないか、ロケーション・サービスからの十分なデータがないロケーション間の移動時間を計算するアルゴリズムが改善されました。 このアルゴリズムでは、移動キーの中央値のロケーションまたは座標の座標を使用して、より正確にします。
中央値ロケーションの座標は、その移動キーに対応するすべてのアクティビティ・ロケーションの座標に基づいて計算されます。 これらの座標は、アクティビティまたはリソース・ロケーションの座標がない場合に移動を見積もるために使用されます。 移動時間は、座標間の航空会社(直線)距離、構成された航空会社の距離速度、出発時間または駐車場時間に基づく航空会社の距離方式を使用して推定されます。
したがって、以前の拡張アルゴリズムを使用してこのようなキー間の移動を見積もると、移動が改善されます。 この変更により、拡張アルゴリズムは中止され、新しい移動推定メソッド「移動キー・ベースの航空会社距離」に置き換えられます。
このメソッドを使用する場合、構成、統計ページの座標計算の重みフィールドに設定された値には関連性がありません。 これは、統計と既存の座標ベースの移動の両方で航空距離方式が使用されるためです。 両方のロケーションが同じ移動キーに属している場合は、学習した統計がない場合、またはいずれかのロケーションの有効な座標がない場合に、デフォルトの移動期間が使用されます。
ノート: 移動を見積もる新しいメソッドとして、「移動キー・ベースの航空会社距離」は移動キーの中央座標に基づいており、移動キーの座標に依存しています。すべての移動キーに、有効な座標を持つアクティビティまたはリソース・ロケーションが少なくとも1つあることが重要です。
移動時間は、2つのロケーション間で十分な移動がレポートされていない場合、またはロケーション・サービスからのデータが不十分な場合に、ロケーションの座標または移動キーの中央ロケーションの座標を使用して推定されます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
SAMLおよびOpenIDのプライマリ・アクセス・ポイントとしてのインスタンスURL
以前は、新しいログイン・ポリシーを追加する際に、SAMLおよびOpenID接続認証方式のアクセス・ポイントとしてlogin.etadirect.comを使用できました。 更新21B以降、SAMLおよびOpenID Connect認証方式に基づく新しいログイン・ポリシーでは、インスタンス固有のURLのみを使用できます。 つまり、「ログイン・ポリシーの追加」ページには、SAMLおよびOpenID接続メソッドの認証にインスタンスURLを使用オプションのみが表示されます。
新規ログイン・ポリシー
このイメージは、SAML認証方式のOFSメタデータ・セクションを示しています:
インスタンス固有URLを使用する既存のログイン・ポリシー
更新21Bにアップグレードすると、インスタンス固有のURLを使用するすべての既存のSAMLおよびOpenIDログイン・ポリシーが変更されます。 その結果、login.etadirect.comをアクセス・ポイントとして使用するオプションが「ログイン・ポリシーの追加」ページから自動的に削除されます。
LOGIN.ETADIRECT.COMを使用する既存のログイン・ポリシー
login.etadirect.comを使用する既存のSAMLおよびOpenIDログイン・ポリシーを手動で変更する必要があります。 次のステップを実行します。
- 構成→ログイン・ポリシーをクリックします。
- 編集するログイン・ポリシーを見つけて、変更をクリックします。
- OFSメタデータ・セクションで、インスタンスURLを使用してメタデータを生成オプションを選択します。 このイメージは、login.etadirect.comを使用する既存のログイン・ポリシーを示しています:
- 「更新」をクリックします。
- 警告ダイアログ・ボックスでOKをクリックします。 この図は、警告を示しています:
- ログイン・ポリシーの更新された構成を表示します。
これらのステップでは、SAMLポリシーのスクリーンショットについて説明しますが、OpenID接続ポリシーにも同じステップを使用できます。
SAMLおよびOpenID Connect認証方式に基づく新しいログイン・ポリシーでは、インスタンス固有のURLのみを使用できます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
ヒントと考慮事項
「ログイン・ポリシーの追加」ページには、SAMLおよびOpenID接続メソッドの認証にインスタンスURLを使用オプションのみが表示されます。
主なリソース
以前は、ローカル・ストレージの容量を簡単に把握できませんでした。 その結果、デバイスのストレージが不足したときに、イメージおよびファイルをこれ以上アップロードできませんでした。 更新21B以降、インストール済アプリケーションのAboutページで使用可能な内部ストレージを表示できます。 さらに、ストレージが100 MBを下回ると、アプリケーション通知領域に通知が表示されます。
デバイスの使用可能な記憶域と使用済記憶域の合計は、インストール済アプリケーションのAboutページに表示されます。 バーの色付きの部分は、消費される領域の量を示します。 使用されるデータには、Oracle Field Serviceによって消費されるデータのみでなく、デバイス内のすべてのアプリケーションおよびデータによって消費されるデータが含まれます。 使用されているデータが90%を超える場合、棒は赤で表示されます。 このイメージは、バージョン情報ページを示しています:
アプリケーションでは、使用可能な容量も定期的にチェックされます。 残りの記憶域が100MB未満の場合は、アプリケーション通知センターに通知が表示されます。 この図は、通知を示しています:
使用可能な内部ストレージは、AndroidおよびiOSアプリケーションのAboutページに表示されます。 ストレージが100 MBを下回ると、アプリケーション通知領域に通知が表示されます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
AndroidおよびiOSアプリケーションのRedwoodテーマ
更新21B以降、iOSアプリケーションとAndroidアプリケーションの両方にRedwoodスタイルに基づく新しいユーザー・インタフェースが追加されました。 Redwoodテーマに次の画面が表示されます:
- スプラッシュ・ページ
「スプラッシュ」ページがRedwoodテーマで表示されます:
- サインイン・ページ
iOSおよびAndroidモバイル・アプリケーションの両方の「サインイン」画面がRedwoodテーマに表示されるようになりました:
iOSアプリケーションのサインイン画面:
Androidアプリケーションのサインイン画面:
- 情報ページ
Redwoodテーマに「バージョン情報」ページが表示されるようになりました
- 「エンド・ユーザー・ライセンス契約」ページ
「エンド・ユーザー・ライセンス」ページがRedwoodテーマに表示されます:
「サインイン」ページが再設計され、Redwoodのユーザー・エクスペリエンスが採用されました。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
更新21B以降、「アクティビティ・ステータスをenrouteに更新」 (POST /rest/ofscCore/v1/activities/{activityId}/custom-actions/enroute) REST APIメソッドを使用して、アクティビティのステータスをenrouteに更新し、リソースがアポイントメント中であることを確認できます。
アクティビティ・ステータスは、次の条件が満たされた場合にのみ正常に更新されます:
- enrouteサポート・オプションはビジネス・ルールで有効になっています。
- アクティビティ・タイプに対して移動の計算機能が選択されています。
- アクティビティはルートの最初のアクティビティです。
- アクティビティは保留中、オーダー済で、ルートがアクティブ化されています。
また、技術者の移動がなんらかの理由で中断された場合は、アクティビティ・ステータスをenrouteからpending (POST /rest/ofscCore/v1/activities/{activityId}/custom-actions/stopTravel) REST APIに変更メソッドを使用して、アクティビティ・ステータスをenrouteからpendingに変更できます。
'アクティビティ・ステータスをenrouteに更新' REST APIメソッドを使用して、アクティビティのステータスを'enroute'に更新し、リソースがアポイントメント中であることを確認できます。
有効化のステップ
REST APIガイド(Oracle Help Center > 「関心のあるアプリケーション・サービス領域」 > REST APIから入手可能な)のRESTサービス定義を確認します。 Oracle RESTサービスの新しい場合は、「クイック・スタート」セクションから開始することができます。
Oracleヘルプ・センター→関心のあるアプリケーション・サービス領域→REST APIから入手できるREST APIガイドのRESTサービス定義を確認します。 OracleのRESTサービスを初めて利用する場合は、「Quick Start」セクションから始めることができます。
主なリソース
現在、リソースがアクティビティを完了すると、リソースは次のアクティビティに移動中であるとみなされます。 これは現実には当てはまらないかもしれません。 更新21B以降、リソースはアクティビティに対する「enroute」であることを示すことができます。 enrouteを指定すると、Where is My Technician機能が透過的になり、ルーティングによってenrouteアクティビティが再スケジュールされなくなります。
リソースは、移動の計算オプションが有効になっているアクティビティに対してのみenrouteを設定できます。 このステータスは、前のアポイントメントの終了時または休憩後に設定できます。 アクティビティにenrouteが設定されている場合、アプリケーションはリソースのロケーションに従って移動時間を調整し(リアルタイム・トラフィックを使用)、ETAを更新します。 これについてエンド・ユーザーに通知され、Where is My TechnicianページにETAが更新された実際の進行中ステータスが表示されます。 ルーティングでは、「enroute」ステータスのアクティビティが再最適化から除外されます。
ノート: enrouteサポート機能を有効にすると、アクティビティ・バンドリング機能を使用できなくなります。 移動を必要としないアクティビティ(非移動アクティビティ)は、ルート内の順序に従って実行できます。 ただし、そのようなアクティビティは、リソースが別のアクティビティへのenrouteである場合は実行できません。
enroute機能を使用可能にすると、次のようになります:
- リソースは、アポイントメントに対するenrouteであることを確認します。
- リソースが進行中であることが最終顧客に通知されます。 到着時間が更新されます。
- 「最終顧客は、実際の進行中ステータスおよび更新されたETAを自分の場所で確認できます」技術者page.
- 顧客に移動する必要がない場合(アポイントメントの再スケジュールなど)、リソースは移動を停止できます。
- enrouteに、リソースは方向を変更し、別の緊急アポイントメントに移動できます。
- リソースは前のアポイントメントの後に休憩し、準備ができたらenrouteを設定できます。
- 問題が解決され、アポイントメントが不要になった場合、ディスパッチャはリソースの進行中にアポイントメントを取り消すことができます。
enroute機能に対して次のオプションを構成できます:
- ビジネス・ルールのenrouteサポート機能を有効にします。
- アクティビティ・タイプの追加ダイアログ・ボックスで、「enroute」ステータスの色を構成します。
- アクティビティ詳細ページおよびアクティビティのヒントにenrouteおよび移動の停止ボタンを追加します。
- 新しいAPIイベント'acivityTravelStarted'および'activityTravelStoped'を通知に使用します。
ルート機能の有効化
ビジネス・プロセスを採用する準備ができたら、enroute機能を有効にできます。 更新21Bにアップグレードすると、下位互換性を維持するために、すべてのインスタンスに対してenroute機能が無効になることに注意してください。 enroute機能を有効にすると、移動アクティビティの「enroute」ステータスがグローバルに使用可能になります。 この変更は、顧客への次のアクティビティ機能、ETAおよびOn my way通知に影響する可能性があります。 「enroute」ステータスはWhere is My Technicianページと統合され、ルーティング・モジュールでこれを使用して、次のアポイントメントに対する望ましくない調整を防止できます。
ノート: enrouteサポート・オプションを有効にすると、「enroute」ステータスは移動の計算オプションが有効になっているアクティビティ・タイプに対してのみ使用可能になります。 さらに、「enroute」ステータスをしばらく使用した後にenrouteサポート・オプションを無効にすると、「enroute」ステータスの現在のアクティビティはすべてサイクルを終了します。 新規アクティビティの「enroute」ステータスは設定できません。
- 構成、ビジネス・ルールの順にクリックします。
- enrouteサポート・チェック・ボックスをオンにします。 次のスクリーンショットは、「ビジネス・ルール」ページのenrouteサポート・チェック・ボックスを示しています:
- 「保存」をクリックします。 次の変更は、アクティビティおよびリソースに使用できます:
- 次のアクティビティ・セクションには、しばらくアイドル状態になりますオプションが含まれます。
- 次のアクティビティとして選択されたアクティビティのステータスはenrouteになります。
- アクティビティのETAは更新されますが、アクティビティにはサービス時間枠、アクセス時間またはSLAがあります。
- 移動の調整オプションは、アクティビティが「enroute」ステータスの場合に使用できます。
ルート・ステータスの色を設定
「enroute」ステータスのアクティビティの色を構成して、そのようなアクティビティをすばやく識別できます。
- 構成、アクティビティ・タイプに移動します。
- 必要なアクティビティ・タイプの変更をクリックします。 「enroute」ステータスの色は、デフォルトで保留中ステータスから継承されます。
- 別の色を設定し、更新をクリックします。
enrouteボタンへのアクセスの構成
リソースは、アクティビティの完了ダイアログ・ボックスで次のアクティビティを選択した後、または休憩後に、その日の開始時に「enroute」ステータスを設定できます。 リソースが休憩から戻ると、アクティビティ詳細ページまたはアクティビティのヒントでステータスを設定できます。 アクティビティの編集/表示ページおよびアクティビティのヒント・レイアウトにenrouteに移動ボタンを追加するには、この手順を使用します。
- 構成、ユーザー・タイプの順にクリックします。
- enrouteボタンを追加するユーザー・タイプを選択します。
- 画面構成をクリックします。
- アプリケーション画面で、アクティビティの編集/表示またはアクティビティのヒントをクリックします。
- ボタン要素を追加するか、クリックして追加をクリックします。
- 標準アクション画面を選択してから、enroute(enroute_activity)を選択します。
- 「OK」をクリックします。
- 表示条件を構成します。 アクティビティを開始する前に「enroute」ステータスを必須にするかどうかを指定してください。
- 「保存」.をクリックします
移動の停止ボタンへのアクセスの構成
場合によっては、リソースがステータスをenrouteに変更した後でも、アポイントメントの再スケジュールが必要になることがあります。 このような場合、ディスパッチャまたはリソースはアクティビティを保留中ステータスに戻してから再スケジュールできます。
- 構成、ユーザー・タイプの順にクリックします。
- enrouteボタンを追加するユーザー・タイプを選択します。
- 画面構成をクリックします。
- アプリケーション画面で、アクティビティの編集/表示またはアクティビティのヒントをクリックします。
- ボタン要素を追加するか、クリックして追加をクリックします。
- 標準アクション画面を選択してから、移動の停止(stop_travel)を選択します。
- 「OK」をクリックします。
- 表示条件を構成します。
- 「保存」をクリックします。 移動の停止は、ステータスがenrouteのアクティビティに対してのみ表示されます。
enroute機能の使用方法
「enroute」ステータスの使用
「enroute」ステータスを使用して、リソースが進行中で、まもなく到着することを顧客に知らせます。
ノート: リソースがアクティビティの「enroute」ステータスを設定すると、そのETAは(既存のサービス時間枠、アクセス時間またはSLAに関係なく)リアルタイム・トラフィックで更新され、移動がすぐに開始されます。
リアルタイム・トラフィックは、Oracle Field Service Enterprise Edition with Google Mapsの有効なライセンスを持っている場合にのみ使用できます。 リソースが顧客サイトに移動しない場合、「enroute」ステータスを使用することはベスト・プラクティスではありません。
アクティビティの「enroute」ステータスを設定するための前提条件:
- 「ビジネス・ルール」ページでenrouteサポートが選択されています。
- アクティビティ・タイプに移動の計算が選択されています。
- アクティビティはフィールド・リソースに割り当てられています。
- フィールド・リソースにアクティブ化されたルートがあります。
- ルートに開始済アクティビティがありません。
リソースは、ルートのオーダー・アクティビティ、未オーダー・アクティビティまたは未スケジュール・アクティビティをenrouteとして設定できます。 ただし、enrouteの最初のアクティビティではないアクティビティの「enroute」ステータスを設定するには、リソースに開始アクティビティと同様の権限が必要です。 ルート内でのアクティビティ順序変更の許可および未スケジュール・プールからスケジュール済プールへのアクティビティ移動の許可権限が必要です。
'enroute'ステータスでは、'事前コール'トリガーが起動され、顧客に通知できます。 「enrouteサポート」機能を有効にした場合、「enroute」ステータスが設定されるまで、Oracle Field Serviceではリソースがアクティビティへのアクセス方法とみなされることはありません。 さらに、「enroute」ステータスが設定されていない場合は、次のようになります:
- 移動時間は再計算されません
- 「事前コール」メッセージが設定されていません
- 「Where is My Technician」ページには、'進行中'ステータスおよびリソースの位置と追跡は表示されません。」
日初めまたは休憩後の顧客への移動
リソースがルートをアクティブ化するか、休憩を受け、顧客にアクセスする準備が整うと、自分のルートまたはアクティビティ詳細ページ、あるいはアクティビティ・ヒントを介して「enroute」ステータスを設定できます。 これは、ユーザー・タイプにenrouteボタンが構成されている場合にのみ可能です。
次の図は、「自分のルート」ページの初日にenrouteボタン、リソースがenrouteのときにルート・マップ、および「自分のルート」ページに「enroute」ステータスのアクティビティを示しています:
NOTE: 注意: リソースが以前に到着し、顧客サイトの近くで待機する場合は、「enroute」ステータスを使用しないでください。 ステータス変更によってETAが更新され、通知が送信されます。
場合によっては、リソースと顧客が、アポイントメントで指定されたサービス時間枠、アクセス時間またはSLAよりも早く対応することに同意することがあります。 enrouteページで計算された到着時刻が時間ウィンドウの開始から15分以上前の場合、ユーザーには適切なメッセージが通知されます。 たとえば、このアクティビティのSLAウィンドウは18:00に開始しますなどです。 次のスクリーンショットは、SLAウィンドウにメッセージが表示されたenrouteページを示しています:
アポイントメントに解決済の座標がない場合、デバイスのロケーションが使用できない場合、またはデバイスがオフラインの場合は、対応するメッセージがenrouteページのマップに表示されます。 メッセージは、アクティビティ・ロケーションが見つかりません、ロケーションを識別できませんまたはオフライン時はマップを使用できませんのいずれかです。 次のスクリーンショットは、解決済座標がないアクティビティのenrouteページを示しています:
前のアクティビティの完了と次のアクティビティへの移動
リソースがアクティビティを完了、未完了または取消済としてマークすると、次のアクティビティを選択して確認できます。 この確認後、アクティビティはenrouteになります。 この動作は、enrouteサポート機能が選択されている場合にデフォルトで使用できます。 コンテキスト・レイアウト・ページの構成済のenrouteアクション・リンクには依存しません。 次のスクリーンショットは、リソースが次のアクティビティを選択できる「アクティビティの終了」ページを示しています:
前のアポイントメントの後に休憩
アクティビティの完了直後に次のアクティビティに移動しない場合、リソースはしばらくアイドル状態になりますを選択できます。 完了時に次のアクティビティの選択を許可権限を持たないユーザーはアポイントメントの順序を変更できないため、このようなユーザーにはしばらくアイドル状態になりますオプションはありません。 次のスクリーンショットは、アクティビティの終了ページを示しています。このページでは、リソースがアイドル状態になることを選択できます:
「enroute」ステータスを選択した後のアクティビティの変更
リソースがすでにアクティビティに移動しているときに、緊急アクティビティが起動する場合があります。 この場合、リソースは緊急アクティビティを選択してenrouteをクリックできます。 前のアクティビティは保留中ステータスに戻り、ルートの最初にオーダーされ、一方、緊急アクティビティはenrouteに変更されます。 この動作は、権限ルート内でのアクティビティ順序変更の許可および未スケジュール・プールからスケジュール済プールへのアクティビティ移動の許可の影響を受けます。
次のスクリーンショットは、enrouteおよび保留中のアクティビティが表示された自分のルート・ページを示しています:
次のスクリーンショットは、enrouteボタンがある別のアクティビティのアクティビティ詳細を示しています:
次のスクリーンショットは、異なるenrouteアクティビティが表示された「自分のルート」ページを示しています:
移動の停止およびポイントの別の日またはリソースへの移動
アクティビティに移動中のリソースがアポイントメントを再スケジュールする必要がある場合は、移動の停止をクリックできます。 アクティビティは保留中ステータスに戻り、別のアクティビティを選択して作業できます。 次のスクリーンショットは、移動の停止ページを示しています:
enrouteアクティビティの取消
リソースがアクティビティのステータスをenrouteに変更したとします。 ディスパッチャが問題が解決されたことを認識し、リソースがカスタマを訪問する必要がない場合、ディスパッチャはアクティビティを取り消すことができます。
enrouteアクティビティの移動
ディスパッチャまたはリソースは、他のアクティビティの移動と同じ方法でenrouteアクティビティを移動できます。 ただし、移動の停止処理を使用してenrouteアクティビティを保留ステータスに変更する前に、アクティビティを移動する必要があります。 それ以外の場合、Oracle Field Serviceは保留中のアクティビティのみ移動できますというメッセージをユーザーに警告します。
enrouteおよび移動停止操作のトラブルシューティング
アクティビティ履歴を使用して、リソースがステータスをenrouteに変更したか、保留中に戻した時期を確認できます。
enrouteアクティビティのフィルタ
「enroute」ステータスのアクティビティをフィルタできます。 これを行うには、構成、フィルタ・ページでフィルタを作成します。 このスクリーンショットは、オプションとしてenrouteアクティビティを使用したフィルタを示しています:
enrouteアクティビティの再スケジュールの防止
ルーティングでは、ビジネス・ルール・レベルで設定するため、「enroute」ステータスが考慮されます。 一括ルーティングと即時ルーティングの両方で、双方向の「enroute」ステータスのアクティビティが変更されることはありません。 そのため、スケジュール解除、再スケジュール、別のプロバイダへの移動、ETAの変更、または「enroute」ステータスのアクティビティの前への別のアクティビティの挿入は、フィルタ条件に一致するアクティビティのバルク・ルーティングおよび即時ルーティングを介して行われません。
緊急アクティビティの即時ルーティングでは、「enroute」ステータスのアクティビティの直前に緊急アクティビティを挿入できますが、再スケジュールはできません。 この場合、enrouteアクティビティのステータスは自動的に保留に変更され、同じルートに保持されます。
アウトバウンド統合チャネル(Oracle Business Intelligence、Oracle Analytics、& Oracle Autonomous Database)での変更
アウトバウンド統合チャネルでアクティビティ・ステータス(appt.status)フィールドを構成した場合、「enrouteサポート」機能を有効にすると、対応するデータ・ソースに「「enroute」ステータス」オプションが表示されます。
Oracle Field Serviceを初めて使用する場合は、アクティビティ・エンティティの一部としてアクティビティ・ステータス・フィールドを構成し、アウトバウンド・チャネルで「配信中」ステータスを取得できます。 このイメージは、アウトバウンド統合チャネル用に選択されたActivity_statusフィールドを示しています:
プラグインAPIの変更
エラー・タイプおよびエラー・コードの変更
クローズ・メッセージには次のエラー・コードを使用できます:
クローズ・メッセージで使用可能なエラー・コード
コード |
発生する状況 |
---|---|
TYPE_ENTITY_ACTION |
|
CODE_ACTION_ON_PAST_DATE_NOT_ALLOWED |
エンティティがアーカイブされた(過去の)キューに割り当てられている場合、リクエストされたアクションは禁止されます:
|
TYPE_ENTITY_PROPERTY |
|
CODE_PROPERTY_VALUE_TOO_LARGE |
次のいずれか:
詳細は、プロパティ値の長さと制限の項を参照してください。 |
CODE_MANDATORY_PROPERTY_EMPTY |
次のいずれか: アクティビティの場合
在庫の場合
|
CODE_ACTIVITY_STATUS_INVALID |
詳細は、アクティビティ・ステータス・グラフ間の可能な遷移を参照してください。 |
CODE_INVENTORY_POOL_INVALID |
次のいずれか:
詳細は、在庫プール間で可能な遷移グラフを参照してください。 |
CODE_INVENTORY_AID_INVALID |
次のいずれか:
|
CODE_INVENTORY_PID_INVALID |
次のいずれか:
|
CODE_ACTIVITY_STATUS_INVALID_FOR_FUTURE |
'astatus'は'pending'または'cancelled'ではなく、アクティビティはプロバイダのタイムゾーンの現在の日付を基準にして将来の日付に割り当てられます |
CODE_ACTIVITY_STATUS_STARTED_ALREADY_IN_QUEUE |
(新規) 'astatus'が'started'または'enroute'で、同じキューに別の開始済アクティビティがあります |
CODE_ACTIVITY_STATUS_ENROUTE_ALREADY_IN_QUEUE (new) |
'astatus'は'started'または'enroute'で、同じキューに別のenrouteアクティビティがあります |
CODE_ACTIVITY_STATUS_INVALID_FOR_INACTIVE_QUEUE |
'astatus'は'pending'または'cancelled'ではなく、アクティブ化または非アクティブ化されていないキューにアクティビティが割り当てられています |
CODE_ACTIVITY_STATUS_INVALID_FOR_NON_TRAVEL_ACTIVITY (new) |
'astatus'は'enroute'で、アクティビティは「移動の計算」機能をサポートしていません(非移動アクティビティです) |
CODE_ACTIVITY_STATUS_REORDERING_IS_NOT_ALLOWED (new) |
現在のユーザーのユーザー・タイプでは、'astatus'は'enroute'で、アクティビティは順序付けられており、ルート内で最初ではありません。また、「ルート内でのアクティビティ順序変更の許可」オプションは無効です |
TYPE_INTERNAL |
|
CODE_UNKNOWN |
次の理由により、Oracle Field Serviceはメッセージを処理できません:
|
キュー・アクションのエラー・コードの変更
次の表では、キュー関連のアクションで使用可能なエラーについて説明します:
キュー関連アクションのエラー
コード |
アクションの原因 |
原因 |
---|---|---|
TYPE_ACTION_ERROR |
||
CODE_ACTION_ON_PAST_DATE_NOT_ALLOWED |
|
プラグインは、過去(アーカイブ済)のキューをアクティブ化または非アクティブ化しようとします。 |
CODE_ACTION_ON_FUTURE_DATE_NOT_ALLOWED |
|
プラグインは、将来のキューをアクティブ化または非アクティブ化しようとします。 |
CODE_ACTION_STARTED_ACTIVITY_EXISTS |
|
プラグインは、開始されたアクティビティがあるキューを非アクティブ化しようとします。 |
CODE_ACTION_ENROUTE_ACTIVITY_EXISTS (new) |
|
プラグインは、enrouteアクティビティがあるキューを非アクティブ化しようとします。 |
CODE_ACTION_PENDING_ACTIVITY_EXISTS |
|
プラグインは、スケジュールされた保留中のアクティビティが1つ以上あるキューを非アクティブ化しようとします。 |
CODE_ACTION_UNKNOWN |
"action"パラメータが、サポートされているどのキュー・アクションとも等しくありません。 |
|
CODE_ACTION_ENTITY_UNKNOWN |
"entity"パラメータが"queue"と等しくありません。 |
|
TYPE_ACTION_PARAM |
||
CODE_ACTION_PARAM_VALUE_INVALID |
|
"action_time"の形式が正しくありません。 |
TYPE_INTERNAL |
||
CODE_UNKNOWN |
|
システム状態が予期せず変更されたため、Oracle Field Serviceはメッセージを処理できません。 |
この機能により、Where is My Technician機能が透過的になり、ルーティングでenrouteアクティビティの再スケジュールを防ぐことができます。
有効化のステップ
enroute機能の有効化
ビジネス・プロセスを採用する準備ができたら、enroute機能を有効にできます。 更新21Bにアップグレードすると、下位互換性を維持するために、すべてのインスタンスに対してenroute機能が無効になることに注意してください。 「enroute」機能を有効にすると、移動アクティビティで「enroute」ステータスがグローバルに使用可能になります。 変更は、顧客への「次のアクティビティ」機能、ETAおよび「enroute」の通知に影響する可能性があります。 「enroute」ステータスは「Where is My Technician」ページと統合され、ルーティング・モジュールでこれを使用して次のアポイントメントに対する望ましくない調整を防止できます。
ノート: enrouteサポート・オプションを有効にすると、「enroute」ステータスは移動の計算オプションが有効になっているアクティビティ・タイプに対してのみ使用可能になります。 さらに、「enroute」ステータスをしばらく使用した後にenrouteサポート・オプションを無効にすると、「enroute」ステータスのすべての現在のアクティビティがサイクルを終了します。 新規アクティビティには「enroute」ステータスを設定できません。
- 構成、ビジネス・ルールの順にクリックします。
- enrouteサポート・チェック・ボックスをオンにします。
- 「保存」をクリックします。 次の変更は、アクティビティおよびリソースに使用できます:
- 次のアクティビティ・セクションには、しばらくアイドル状態になりますオプションが含まれます。
- 次のアクティビティとして選択されたアクティビティのステータスはenrouteになります。
- アクティビティのETAは更新されますが、アクティビティにはサービス時間枠、アクセス時間またはSLAがあります。
- 移動の調整オプションは、アクティビティが「enroute」ステータスの場合に使用できます。
主なリソース
以前は、割当アシスタントで提案されたリソースは郵便番号の差異に基づいており、数値の国に対してのみ有効でした。 更新21B以降、ルートの影響に基づいてリソースが提案されます。 ルートへの影響が最も最適なリソースが上部に表示されます。
リソースの順序は、次のファクタの影響を受けます:
- ルート・インパクト(アクティビティ所要時間+移動時間)
- 解決済アクティビティ座標
- 選択したアクティビティからリソースのルートおよびStart/End/Homeロケーションのアクティビティまでの距離
- リソース作業ゾーン一致
- 移動統計データの精度
この図は、リソースが最適なものから最適でないものの順に並んでいる割当アシスタントを示しています:
バック・オフィス・チームは、移動時間の節約、時間の短縮、車両燃料コストの削減により、運用コストの削減に役立つスマートなディシジョンを行えるようになりました。 移動時間を節約すると、リソースのスケジュールで別の割当に十分な時間を節約することもできます。
割当アシスタントでは、リソースはルートの影響に基づいて提案されます。 ルートへの影響が最も最適なリソースが上部に表示されます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
OICレシピを使用したOracle Field ServiceとOracle HCM Cloudのインテグレーション
現在、リソース管理ユーザー・インタフェースまたはREST APIを使用して、Oracle Field Serviceでリソースを作成できます。 更新21B以降、Oracle HCM Cloudから従業員の詳細を抽出し、Oracle Integrationを使用してOracle Field Serviceで詳細を自動的に更新できます。 統合は、Oracle Integrationでサンプル・レシピとして使用できます。 Oracle HCMをダウンロードして使用できます - Oracle Field Service I OFSリソース・レシピを統合のクイック・スタート・リファレンスとして作成および管理します。 このレシピは、特定のビジネス要件に基づいて拡張することもできます。
ノート: Oracle Field ServiceをOracle HCM Cloudと統合するには、Oracle Integration、Oracle HCM Cloudリリース13以降およびOracle Field Service更新21Aの有効なライセンスが必要です。 統合は、Oracle HCM CloudからOracle Field Serviceにのみ行われます。 つまり、Oracle HCM Cloudからのみ詳細を抽出し、Oracle Field Serviceで更新できます。 Oracle Field Serviceでリソースの詳細を変更しても、Oracle HCM Cloudで自動的には更新されません。
The 'Oracle HCM - Oracle Field Service I OFSリソース・レシピを作成および管理すると、次の主要な機能が提供されます:
- フィールド技術者従業員詳細をOracle HCM CloudからOracle Field Serviceに一括抽出します。
- Oracle HCM Cloudから従業員勤務スケジュール詳細を抽出し、スケジュールされた方法でOracle Field Serviceで更新します。
- Oracle HCM Cloudで新規従業員が作成されたときに、Oracle Field Serviceで新規リソースを作成します。
- Oracle HCM Cloudで既存の従業員詳細が更新されたときに、Oracle Field Serviceでリソースを更新します。
- Oracle HCM Cloudで従業員が削除されると、Oracle Field Serviceでリソースが中断されます。
- Oracle HCM Cloudから従業員ログイン詳細をフェッチし、Oracle Field Serviceで詳細を更新します。 統合ではユーザー・ログイン名のみがフェッチされ、パスワードはフェッチされません。
ORACLE INTEGRATIONからのレシピのインストール
次のステップに従って、Oracle Integrationからレシピをインストールします:
- Oracle Integrationインスタンスにログインします。
- すべて検索をクリックし、レシピを検索します。 または、下にスクロールして、ホーム、アクセラレータ&レシピ・ページでレシピを見つけます。 このイメージは、アクセレータ&レシピ・ページを示しています:
- 「+」をクリックしてレシピをインストールします。 レシピをインストールすると、「インストール済み」ラベルが表示されます。 このイメージは、プラス・アイコンが付いたレシピの例を示しています:
このイメージは、アイコンがインストールされたレシピの例を示しています:
Lookupの設定
異なる値を持つOracle Field ServiceおよびOracle HCM Cloudの類似エンティティをマップするようにLookupを構成する必要があります。 たとえば、Oracle HCM Cloudの職務コード"Field tech"は、Oracle Field Serviceの"Technician"とみなすことができます。
このレシピには4つのLookupがあります。 ビジネスの性質に応じて値は異なる場合があるため、ビジネスに応じてこれらの参照表を構成し、統合を使用できます。 このレシピで使用されるLookupは、Oracle Integrationのホーム、統合、参照で使用できます。 このイメージは、Lookupページを示しています:
レシピ内のLookupの設定
この表は、レシピで使用可能なLookupと、Oracle HCM CloudおよびOracle Field Serviceの値を示しています。
Oracle Integration参照 |
Oracle HCM Cloud値 |
Oracle Field Service値 |
説明 |
---|---|---|---|
Oracle_HCM_OFS_UserTypeLookup |
Field Tech |
Technician (技術者) | HCMジョブ・コードとOFSユーザー・タイプのマップ |
Oracle_HCM_OFS_ResourceTypeLookup |
Field Tech |
PR | HCMジョブ・コードとOFSリソース・タイプのマップ |
Oracle_HCM_OFS_LanguageLookup |
US | en | HCM言語とOFS言語タイプのマップ |
Oracle_HCM_OFS_WSLookUp |
US Day Shift |
9-18 | HCM勤務スケジュール・ラベルとOFS勤務スケジュール・ラベルのマップ |
マッピング表
マッピング表を使用して、同様の機能ロールを持つOracle Field ServiceおよびOracle HCM Cloudのエンティティを構成できます。 たとえば、Oracle HCM Cloudの「ビジネス・ユニット」は、どちらもリソース・レポート体系を管理するように設計されているため、Oracle Field Serviceでは「組織ユニット」とみなすことができます。
この表は、Oracle HCM Cloudエンティティおよびプロパティと、レシピで構成されている対応するOracle Field Serviceとの間のマッピングを示しています。
Oracle HCM Cloudプロパティ |
Oracle Field Serviceプロパティ |
コメント |
---|---|---|
ビジネス・ユニット |
組織ユニット |
組織ユニットはOracle Field Serviceのリソース・タイプです |
部門 |
バケット |
バケットはOracle Field Serviceのリソース・タイプです |
個人番号 |
リソースID |
該当なし |
ユーザー名 |
ログイン |
該当なし |
個人住所 |
生産資源事業所 |
該当なし |
個人アサイメント住所 |
生産資源事業所 |
該当なし |
注意: レシピでは、Oracle HCM Cloudのビジネス・ユニットがOracle Field Serviceの組織単位としてマップされます。 同様に、部門はバケットとしてマップされます。 従業員がOracle HCM Cloudのビジネス・ユニットの部門なしで構成されている場合、その従業員はOracle Field Serviceの対応する組織ユニットの下の子リソースとして構成されます。
機能フロー
統合で構成された次の機能フローを使用できます:
- Oracle HCM CloudからOracle Field Serviceに既存の従業員詳細を一括アップロードします。
- Oracle HCM Cloudから従業員勤務スケジュール詳細を抽出し、Oracle Field Serviceで作成または更新します。
- Oracle HCM Cloudで新規従業員が作成されたときに、Oracle Field Serviceで新規採用詳細を作成します。
- Oracle HCM Cloudで従業員詳細が更新されたときに、Oracle Field Serviceで従業員詳細を更新します。
- 従業員がOracle HCM Cloudから退職したときに、Oracle Field Serviceでリソースを休止します。
ORACLE HCM CLOUDからORACLE FIELD SERVICEへの従業員詳細の一括アップロード
HCM抽出を使用して、Oracle HCM Cloudから構成およびデータを一括で抽出できます。 ツールの詳細は、HCM抽出ガイドを参照してください。 データを抽出すると、既存の従業員の詳細が取得されます。 Oracle Integrationでは、対応するリソース、ユーザー、リソース・ロケーションおよび勤務スケジュールがOracle Field Serviceに作成されます。
次の情報を抽出できます:
- 基本従業員詳細: 個人番号、名、姓、個人Eメール・アドレス、電話番号、自宅住所など、従業員の基本詳細
- 従業員アサイメント詳細: 割り当てられたビジネス・ユニット、ジョブ、部門、ユーザー詳細、事業所などの従業員アサイメント詳細。
- 従業員が割り当てた勤務スケジュール詳細: 割り当てられた勤務スケジュール名、開始日、終了日などの勤務スケジュール詳細。
HCMホーム・ページ→自分のクライアント・グループ→データ交換→抽出定義(HCM抽出の下)をクリックして、抽出するように構成した詳細を表示します。 このイメージは、「抽出定義」ページを示しています:
抽出フロー
抽出フローでは、次のステップが発生します:
- 「抽出プロセスでは、職務コードが「フィールド技術者」、「ビジネス・ユニット」が"&"である全ての従業員が「アクティブ」としてフィルタ処理されます。
- 対応するリソースが使用できない場合は、抽出された従業員詳細がOracle Field Serviceで作成されます。 従業員の詳細がOracle Field Serviceに存在する場合は、詳細が更新されます。 Oracle Field Serviceのリソース詳細は、Oracle Integrationで作成したマッピングおよび参照構成に基づいて更新されます。
従業員勤務スケジュール詳細の作成および更新
HCM抽出を使用してOracle HCM Cloudから勤務スケジュール詳細を取得し、Oracle Field Serviceで勤務スケジュールを作成または更新できます。 勤務スケジュールの追加または更新時にOracle Field Serviceでリソース詳細を使用できない場合は、Oracle Integrationによってリソース詳細およびユーザー詳細も追加されます。 Oracle HCM OFS従業員勤務スケジュール統合は、スケジュールされた方法でほぼリアル・タイムで勤務スケジュールの変更をフェッチします。 これに対して抽出および統合をスケジュールできます。 Oracle HCM OFS従業員抽出統合を使用して、データを一括で抽出できます。
ノート: この統合では、Oracle HCM CloudのASSIGNタイプの勤務スケジュール割当から、従業員割当に関連付けられた勤務スケジュールのみがフェッチされます。 Oracle HCM Cloudで勤務スケジュール抽出を構成する場合、最初に抽出モード-すべて属性を使用して抽出を送信し、すべての詳細を取得する必要があります。 後で、必要な頻度でスケジュール済抽出を構成し、Extractモードを使用できます - 抽出を迅速に取得するために属性を変更しました。
ORACLE HCMクラウドで新規従業員が作成されるときに、ORACLEフィールド・サービスでリソースを作成
Oracle HCM Cloudで新規従業員を作成する場合、Oracle Integrationレシピで定義された次の統合を使用して、Oracle Field Serviceで新規リソースを作成できます:
- Oracle HCM OFS新規採用
- Oracle HCM OFSイベント・プロセッサ
新規採用フロー
Oracle HCM-OFS新規採用統合では、スケジュールされた方法でほぼリアルタイムでOracle HCM Cloudから新規従業員の詳細を取得します。 この統合は、「従業員新規採用」Atomフィードを介して更新をサブスクライブします。 Atomフィードをサブスクライブする方法の詳細は、Oracle HCM Cloud REST APIガイドを参照してください。
- 「統合により、ジョブ・コード、ビジネス・ユニット名およびアサイメント・ステータス「アクティブ」に従って、必要な従業員アサイメントがフィルタ処理されます。」
- データ(従業員情報およびフィルタ済アサイメント情報)は、Oracle HCM OFSイベント・プロセッサ統合に渡されます。
- Oracle HCM OFSイベント・プロセッサ統合は、マッピング表で定義されているように、Oracle HCM CloudからフェッチされたデータをOracle Field Serviceにマップします。 したがって、対応するリソースおよびユーザーが新規従業員用にOracle Field Serviceに作成されます。
- リソースおよびユーザーは、バケット(Oracle HCM Cloudの部門)および組織単位(Oracle HCM Cloudのビジネス・ユニット)の下にマップされます。 リソースには、従業員自宅住所および従業員割当事業所に対応するリソース事業所も移入されます。
ORACLE HCMクラウドで従業員詳細が更新されたときにORACLEフィールド・サービスでリソース詳細を更新
Oracle HCM Cloudで従業員詳細が更新されると、Oracle Field Serviceの既存のリソースの詳細を自動的に更新できます。 この自動化は、次の統合を使用して構成されます:
- Oracle HCM OFS従業員更新
- Oracle HCM OFSイベント・プロセッサ
従業員更新フロー
Oracle HCM OFS従業員更新統合では、スケジュールされた方法でほぼリアルタイムでOracle HCM Cloudの従業員更新の詳細を取得します。 この統合は、Atomフィード「Employee Update」をサブスクライブします。 Atomフィードをサブスクライブする方法の詳細は、Oracle HCM Cloud REST APIガイドを参照してください。
- 「統合により、ジョブ・コード、ビジネス・ユニット名およびアサイメント・ステータス「アクティブ」に従って、必要な従業員アサイメントがフィルタ処理されます。」
- データ(従業員情報およびフィルタ済アサイメント情報)は、Oracle HCM OFSイベント・プロセッサ統合に渡されます。
- Oracle HCM OFSイベント・プロセッサ統合は、マッピング表で定義されているように、Oracle HCM Cloudから受信したデータをOracle Field Serviceにマップします。 したがって、対応するリソースの詳細がOracle Field Serviceで更新されます。
従業員がORACLE HCMクラウドで退職したときにORACLEフィールド・サービスでリソースを中断
従業員がOracle HCM Cloudにいる場合、Oracle Field Serviceの既存のリソースを自動的に休止できます。 この自動化は、次の2つの統合を使用して実現されます:
- Oracle HCM OFS従業員の退職
- Oracle HCM OFSイベント・プロセッサ
Oracle HCM OFS Employee Terminate統合では、スケジュールされた方法でほぼリアル・タイムでOracle HCM Cloudの退職従業員の詳細を取得します。 この統合は、Atomフィード「Employee Terminate」をサブスクライブします。 従業員退職Atomフィードをサブスクライブする方法の詳細は、Oracle HCM Cloud REST APIガイドを参照してください。
- 「統合により、ジョブ・コード、ビジネス・ユニット名およびアサイメント・ステータス「アクティブ」に従って、必要な従業員アサイメントがフィルタ処理されます。」
- データ(従業員情報)は、Oracle HCM OFSイベント・プロセッサ統合に渡されます。
- Oracle HCM OFSイベント・プロセッサ統合は、Oracle HCM Cloudから受信したデータをマップし、Oracle Field Serviceのリソースのステータスを非アクティブに変更します。 また、対応するユーザーをOracle Field Serviceから削除します。
Oracle HCMをダウンロードして使用できます - Oracle Field Service I OFSリソース・レシピを統合のクイック・スタート・リファレンスとして作成および管理します。 このレシピは、特定のビジネス要件に基づいて拡張することもできます。
有効化のステップ
この機能をインストールするステップは、「Oracle Integration」からのレシピのインストールの項で説明しています。
主なリソース
更新21B以降、チャネル・タイプのアウトバウンド・チャネル名および説明が改善されました。 Oracle Autonomous Databaseは、Databases as a Serviceではなくアウトバウンド・チャネル名として表示されます。
Oracle Field Serviceで使用されるDBaaS REST APIは、Oracle Database as a Service (DBaaS)に加えて、Autonomous Data Warehouse (ADW)とAutonomous Transaction Processing (ATP)の両方をサポートしています。
これらのチャネル名は、Oracleの標準命名規則に従って更新されています:
- Business Intelligenceクラウド・サービスからOracle Business Intelligence
- Integration Cloud ServicesからOracle Integration
- Oracle Analytics Cloud ServiceからOracle Analytics
ユーザーがチャネル・タイプを選択すると、それに応じて簡単な説明が表示されます。 次の表に、チャネル・タイプの改訂された摘要を示します:
チャネル・タイプ | 概略 |
---|---|
Oracle Integration |
Oracle Integrationプラットフォームと統合して、クラウドおよびオンプレミス・アプリケーションとの統合を作成できます。 |
Oracle Analytics |
単一の統合分析プラットフォームであるOracle Analyticsと統合できます。 |
Oracle Autonomous Database |
Autonomous Data Warehouse、Autonomous Transaction Processing (ATP)およびDatabase as a Service (DBaaS)などのOracle Database Cloud Servicesと統合できます。 |
この機能により、統合エンドポイントについてより深く理解できます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
プラグインAPIを使用したルートのアクティブ化および非アクティブ化
現在、プラグインAPIフレームワークを使用して構築されたカスタム・プラグインを介してルートをアクティブ化および非アクティブ化することはできません。 更新21B以降、プラグインAPIフレームワークを使用して、カスタム・プラグインにルートのアクティブ化および非アクティブ化関数を実装できます。 ルートをアクティブ化および非アクティブ化し、現在選択されているルートの状態を取得できます。 標準のアクティブ化/非アクティブ化ダイアログ・ボックスのかわりにプラグインを使用できます。 ルートをアクティブ化および非アクティブ化する前に、データの収集などのシナリオを実装できます。
openメソッドのレスポンスには、現在のキュー状態を持つ新しいqueueキーが含まれます。 リソース・キーには、現在のリソース時間、リソース・タイムゾーンの差異、デバイス・クロックとUTCの差異などの時間関連フィールドが含まれるようになりました。
更新21Bでは、サンプル・プラグインがRedwoodスタイルで再設計されています。 この図は、Redwoodスタイルのサンプル・プラグインを示しています:
"キュー"エンティティ・コレクションに使用可能なフィールド
この表は、queueエンティティ・コレクションで使用可能なすべてのフィールドを示しています:
フィールド |
値の例 |
説明 |
必須(はい/いいえ) |
---|---|---|---|
date |
2021-02-03 |
キューの日付。 キューのキー・フィールドです。 |
Yes |
status |
notActivated |
キューのステータス。 可能な値は次のとおりです:
|
Yes |
isActual |
True |
ブール。 現在のキューを操作できる場合はtrue (アーカイブされず、将来実行されません)。 |
Yes |
activationTime |
2021-02-03 04:05:06 |
キューのアクティブ化の日時。 キューがアクティブ化されている場合に存在します。 |
No |
deactivationTime |
2021-02-03 04:05:06 |
キューが非アクティブ化された日時。 キューが非アクティブ化され、後でアクティブ化されていない場合に存在します。 |
No |
reactivationTime |
2021-02-03 04:05:06 |
キューのアクティブ化(再アクティブ化)を繰り返す日時。 非アクティブ化後にキューがアクティブ化された場合に存在します。 |
No |
例
"queue": {
"date": "2021-02-03",
"status": "notActivated",
"isActual": true
}
"queue": {
"date": "2021-02-03",
"status": "activated",
"isActual": true,
"activationTime": "2021-02-03 04:05:06"
}
"queue": {
"date": "2021-02-03",
"status": "deactivated",
"isActual": false、
"activationTime": "2021-02-03 04:05:06",
"deactivationTime": "2021-02-03 06:07:08",
"reactivationTime": "2021-02-03 05:06:07"
}
サポートされるキュー・アクション
activate_queue
このアクションにより、現在選択されているキューがアクティブ化されます。 キューが現在のキューでない(過去または将来のキューである)場合、エラーが表示されます。 キューが非アクティブ化されている場合、キューは再アクティブ化され、非アクティブ化時間は切り捨てられます。
この表では、activate_queueアクションでサポートされるパラメータについて説明します:
activate_queueでサポートされているパラメータ
パラメータ |
必須 |
タイプ |
説明 |
---|---|---|---|
action_time |
なし |
文字列 |
現在のリソース・タイムゾーンでのアクションの日時。 設定しない場合 - 現在の時間が使用されます(クローズ・メッセージ処理の瞬間)。 使用可能な形式を使用したISO 8601形式の日付/時間:
date部分を省略すると、現在のリソース日付が使用されます。 |
closeメッセージの例:
アクション時間を指定しない場合:
{
"apiVersion": 1,
"method": "close"
"actions": [
{
"entity": "queue",
"action": "activate_queue"
}
]
}
アクション時間の指定:
{
"apiVersion": 1,
"method": "close"
"actions": [
{
"entity": "queue",
"action": "activate_queue",
"action_time": "2021-01-02 03:04:05"
}
]
}
deactivate_queue
このアクションにより、現在選択されているキューが非アクティブ化されます。 キューが存在しない場合(過去または将来)、またはキューが開始されているか保留中のアクティビティがある場合 - エラーがスローされます。
この表では、キューの非アクティブ化アクションでサポートされるパラメータについて説明します:
deactivate_queueでサポートされているパラメータ
パラメータ |
必須 |
タイプ |
説明 |
---|---|---|---|
action_time |
なし |
文字列 |
現在のリソース・タイムゾーンでのアクションの日時。 設定しない場合 - (クローズ・メッセージの処理時に)現在の時間が使用されます。 使用可能な形式を使用したISO 8601形式の日付/時間:
date部分を省略すると、現在のリソース日付が使用されます。 |
closeメッセージの例:
アクション時間を指定しない場合:
{
"apiVersion": 1,
"method": "close"
"actions": [
{
"entity": "queue",
"action": "deactivate_queue",
}
]
}
アクション時間の指定:
{
"apiVersion": 1,
"method": "close"
"actions": [
{
"entity": "queue",
"action": "deactivate_queue",
"action_time": "2021-02-03 04:05:06"
}
]
}
キュー・アクションのエラー・タイプ
プラグインがアクションを実行するときに、検証、実行または内部タイプのエラーが発生する場合があります。
検証エラー
エラー・メッセージに検証タイプのエラーのみが含まれている場合、アクションは適用されず、エンティティ収集は更新されません。 そのため、クローズ・メッセージを同じ処理で再度送信し、エラーをなくすように修正できます。 次の表では、検証エラーについて説明します:
キュー・アクションの検証エラー
タイプ |
発生する状況 |
使用可能なメッセージ・フィールド |
---|---|---|
TYPE_ACTION_ERROR |
アクションの形式が無効であるか、適用できません |
|
TYPE_ACTION_PARAM |
アクション・パラメータに無効な値があるか、必須パラメータがありません |
|
TYPE_ACTION_PROPERTY |
"properties"パラメータで更新されるプラグインによって発行されたプロパティの値に無効な値があります |
|
実行エラー
実行エラーは、アクションの適用時に生成されるエラーです。 アクションが相互に適用されると、一部が失敗し、一部が正常に適用される場合があります。 エラー・メッセージには、失敗したアクションの実行エラーが含まれます。 これは、一部のアクションが適用された後にエンティティ・コレクションが更新される可能性があり、実行エラーが発生しない(または索引を含むエラーがない)ことを意味します。 そのため、失敗しないアクションは再度送信しないでください。
次の表では、実行エラーについて説明します:
タイプ |
発生する状況 |
使用可能なメッセージ・フィールド |
---|---|---|
TYPE_ACTION_FAILED |
検証ステージでチェックできないアクション・パラメータの値が正しくないため、アクションが拒否されました |
|
内部エラー
検証に成功したが、エンティティ・コレクションの更新または一部のアクションが失敗した場合は、内部エラーが発生します。 これは、エラーの原因にならなかったアクションにエンティティ収集の更新が適用されない可能性があることを意味します。 この場合、エンティティはプラグインに認識されない状態にあるため、更新を含むクローズ・メッセージを送信しないでください。
次の表では、内部エラーについて説明します:
タイプ |
発生する状況 |
使用可能なメッセージ・フィールド |
---|---|---|
TYPE_INTERNAL |
システム状態が予期せず変更されたため、Oracle Field Serviceはメッセージを処理できません。 原因となったアクションに関する情報は含まれていません。 アクションおよびエンティティ収集の更新によって、このようなエラーが発生する可能性があります。 |
該当なし |
キュー・アクションのエラー・コード
次の表では、キュー関連のアクションで使用可能なエラーについて説明します:
コード |
アクションの原因 | 原因 |
---|---|---|
TYPE_ACTION_ERROR |
||
CODE_ACTION_ON_PAST_DATE_NOT_ALLOWED |
|
プラグインは、過去(アーカイブ済)のキューをアクティブ化または非アクティブ化しようとします。 |
CODE_ACTION_ON_FUTURE_DATE_NOT_ALLOWED |
|
プラグインは、将来のキューをアクティブ化または非アクティブ化しようとします。 |
CODE_ACTION_STARTED_ACTIVITY_EXISTS |
deactivate_queue |
プラグインは、開始されたアクティビティがあるキューを非アクティブ化しようとします。 |
CODE_ACTION_PENDING_ACTIVITY_EXISTS |
deactivate_queue |
プラグインは、スケジュールされた保留中のアクティビティが1つ以上あるキューを非アクティブ化しようとします。 |
CODE_ACTION_UNKNOWN |
該当なし | "action"パラメータが、サポートされているどのキュー・アクションとも等しくありません |
CODE_ACTION_ENTITY_UNKNOWN |
該当なし | "entity"パラメータが"queue"と等しくありません |
TYPE_ACTION_PARAM |
||
CODE_ACTION_PARAM_VALUE_INVALID |
|
"action_time"の形式が正しくありません |
TYPE_INTERNAL |
||
CODE_UNKNOWN |
|
システム状態が予期せず変更されたため、Oracle Field Serviceはメッセージを処理できません。 |
例
"resource": {
"currentTime": "2021-02-03 04:05:06",
"deviceUTCDiffSeconds": 42,
"timeZoneDiffSeconds": -18000
}
'dataItems'オプションの使用可能なキーおよびデータ・サブセットの変更
次の表では、dataItemsオプションの使用可能なキーおよびデータ・サブセットの変更点について説明します:
キー |
影響を受けるコレクション |
説明 |
---|---|---|
キュー(新規) |
キュー(新規) |
現在のキュー状態(新規) |
team |
team | 現在のリソースが支援しているアシスタントおよびリソースに関する情報 |
リソース |
リソース | 現在選択されているリソースのプロパティ |
scheduledActivities |
activityList |
選択した日付にスケジュールされた(キューに属する)アクティビティ |
nonScheduledActivities |
activityList |
どの日付キューにも属さない未スケジュール・アクティビティ |
resourceInventories |
inventoryList |
"provider"プールの在庫 |
installedInventories |
inventoryList |
"install"プールの在庫 |
deinstalledInventories |
inventoryList |
"deinstall"プールの在庫 |
customerInventories |
inventoryList |
"customer"プールの在庫 |
使用可能なエンティティおよびデータ・コレクションの変更
次の表では、使用可能なエンティティおよびデータ収集における変更点について説明します:
ページ |
エンティティ・フィールド値 |
選択可能コレクション |
---|---|---|
メイン・メニュー |
user |
|
アクティビティ・リスト |
activitiyList |
|
アクティビティ・リスト ->在庫リスト |
inventoryList |
|
アクティビティ・リスト ->アクティビティ詳細 |
アクティビティ |
|
アクティビティ・リスト ->アクティビティ詳細 ->在庫リスト |
activityInventoryList |
|
アクティビティ・リスト ->在庫リスト ->在庫詳細 |
在庫 |
|
アクティビティ・リスト ->アクティビティ詳細 ->在庫リスト ->在庫詳細 |
activityInventory |
|
在庫検索 ->部品カタログ品目詳細 |
partsCatalogItem |
|
resourceエンティティ・コレクションで使用可能なフィールドの変更
この表は、'resource'エンティティ・コレクションで使用可能なフィールドを示しています:
フィールド | 説明 |
---|---|
|
Eメール・アドレス |
external_id |
外部ID |
pdate_fid |
日付フォーマット |
パック |
ステータス |
pid |
ID |
planguage |
メッセージ言語 |
pname |
Name |
pphone |
Phone |
ptime_fid |
時間書式 |
ptype |
リソース・タイプ |
time_zone |
タイム・ゾーン |
currentTime (新規) |
"open"メッセージの生成時のリソース・タイムゾーンでの"YYYY-MM-DD hh:mm:ss"書式の現在の時間。 |
deviceUTCDiffSeconds (新規) |
ブラウザ時間とUTC (サーバー時間)の差異(秒)。 プラグインは、この式を使用して実際のUTC時間を計算できます: UTC = Math.round(new Date().getTime() / 1000) - deviceUTCDiffSeconds. |
timeZoneDiffSeconds (新規) |
オープン・メッセージの生成時におけるプロバイダのタイムゾーンの差異(秒)。 |
プラグインAPIフレームワークを使用して、カスタム・プラグインにルートのアクティブ化および非アクティブ化関数を実装できるようになりました。
有効化のステップ
REST APIガイド(Oracle Help Center > 「関心のあるアプリケーション・サービス領域」 > REST APIから入手可能な)のRESTサービス定義を確認します。 Oracle RESTサービスの新しい場合は、「クイック・スタート」セクションから開始することができます。
主なリソース
更新21B以降、構成ページが再設計され、Redwoodのユーザー・エクスペリエンスが採用されました。 他の画面へのリンクは、システムを構成する順序で論理的にグループ化されています。
構成ページのメイン画面領域が再設計され、Redwoodのユーザー・エクスペリエンスが採用されました。 他の画面へのリンクは、システムを構成する順序に従って論理的にセクションにグループ化されます。 各セクションは特定の色で表示されるため、ユーザーはセクションの色を各セクション内のコンテンツに視覚的に関連付けることで、画面上のリンクを簡単に見つけることができます。
再設計された構成ページは、レスポンシブ形式に従い、デスクトップ、タブレットおよび携帯電話にコンテンツをミラー・リングします。
「構成」ページが再設計され、Redwoodのユーザー・エクスペリエンスが採用されました。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
更新21Bでは、メッセージ・レポートが改善され、次の拡張機能が追加されました:
- アクティビティおよびメッセージ・シナリオに関連付けられた番号(appt_number)を示す作業オーダー列が追加されました。 作業オーダーに関連付けられたメッセージ・シナリオを識別できるようになりました。
メッセージ・レポートには、作業オーダー番号列が表示されます:
- メッセージ・レポートは、作業オーダー番号で検索できます。
作業オーダー番号を使用して検索できるようになりました。
- 25,000を超えるレコードをエクスポートしようとすると、メッセージ「最大エクスポート制限(25,000)を超えました。パラメータを変更し、「適用」を押してレポートをエクスポートしてください。」が表示されます。
この機能を使用すると、メッセージ・シナリオに関連付けられた作業オーダー番号でメッセージ・レポートを検索できます。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。
主なリソース
更新21B以降では、有効なバルク・ルーティングを最適化する際に、事前割当済アクティビティがスケジュール解除または再スケジュールされないようにできます。 これにより、アクティビティ割当の際の不要な作業が排除され、カスタマ・エクスペリエンスと従業員満足度が向上します。
「最適化ストラテジー」セクションのフィルタ・セクション内で、次の翻訳が変更されました:
古い翻訳 |
新規翻訳 |
---|---|
フィルタ・パラメータ |
事前割当済アクティビティ処理ルール |
アクティビティ |
事前割当済アクティビティ・フィルタ |
宛先 |
可能なルーティング・アクション |
未割当アクティビティの宛先 |
可能なルーティング・アクション |
ルーティング・バケット内の未スケジュール・アクティビティ |
予定解除してルーティング・バケットに移動 |
ルーティング・バケット内のアクティビティ |
ルーティング・バケットに移動 |
事前割当済未スケジュール・アクティビティ |
スケジュールを取り消して同じルートにとどまる |
リソース・ルート |
別のルートに再割当 |
最適化を防止* |
ルーティング・バケットに移動せず、再割当てもしません |
アクティビティの順序を変更するには、グリッド行をドラッグ・アンド・ドロップ |
ルールの順序を変更するには、グリッド行をドラッグ・アンド・ドロップ |
選択したアクティビティが別のリソースまたは日に再スケジュールされないようにしたり、バルク・ルーティングを使用して選択したアクティビティがバケットにスケジュールされないようにするには、次のステップに従います:
- このようなアクティビティを記述するフィルタがあることを確認します。
- 指定された「最適化ストラテジー」フィルタの「可能なルーティング・アクション」の「ルーティング・バケットに移動せず、再割当てもしません」オプションを選択します。
- ルーティングの最適化のため、対象となるアクティビティを別のリソースにアサインしません。 ルーティング・エンジンは、このようなアクティビティの計画開始時間を変更しません。 ただし、ルーティングでは、十分な時間がある場合、他のアクティビティが前に挿入されることがあります。
- この機能を効果的に使用すると、アクティビティをロックしたり、完全に応答されていない「enroute」ステータス使用に適格でないアクティビティの登録中ルート・ステータスを識別できます。
たとえば、アクティビティに対して特別なプロパティ「ロック済(はい/いいえ)」を作成し、2つの処理ボタンを設定できます - 「ロック」および「ロック解除」。これに応じてプロパティ値を設定します。 「ロック済」が「はい」に設定されているアクティビティをフィルタ処理する「ロックされたアクティビティ」がある場合、このフィルタを「最適化ストラテジー・フィルタ」に追加して、ルート間でのアクティビティの移動または同じenrouteでの順序変更(あるいはその両方)を可能にできます。
技術者は、この特定のリソースがアクティビティを実行する顧客と連携しているときに、「ロック」をクリックしてアクティビティをロックできます。
ルーティング前の「ロック済= Yes」を持つアクティビティは、ETAおよびリソース割当が変更されません。 さらに、ルーティングの開始時にアクティビティに「ロック済=いいえ」があったが、ルーティングの開始後、ルーティング結果が適用される前に「ロック済」値を「はい」に変更した場合、そのようなアクティビティはルーティング結果によって変更されないため、現時点では同じETAおよび割当てが保持されます。
ただし、ルーティング実行中にルートに手動で介入すると、ルーティング結果が最適でなくなる可能性があるため、ルートを常に再最適化するために定期的な繰返しルーティング実行があることを確認してください。
この機能は、事前割当済アクティビティの効果的な処理に役立ちます。
有効化のステップ
アクティビティの再割当またはETAの変更を防止できます。
次のステップを実行します。
- Optimization strategy.filterにナビゲートします。
- 事前割当済アクティビティ処理ルール・ダイアログ・ボックスで、特定の最適化ストラテジー・フィルタの「ルーティング・バケットに移動せず、可能なルーティング処理に再割当しないでください」チェック・ボックスをクリックします。
主なリソース
更新21B以降、Routingではニュートラル言語の使用がサポートされるようになりました。 ユーザー・インタフェースとドキュメントの両方で、ニュートラル言語が使用されます。 これにより、カスタマ・エクスペリエンスが向上します。
次のユーザー・インタフェースが変更されました:
期間 | 名前が変更された用語 |
---|---|
ルーティング実行タブ | ルーティング実行のリスト |
実行サマリー・ブロック |
ルーティング実行要約 |
実行ルーティング・プラン |
ルーティング・プランの実行 |
順次ルーティング・プラン実行 |
順次ルーティング・プランの実行 |
即時ルーティング・プラン実行 |
即時ルーティング・プランの実行 |
実行要約 |
ルーティング要約 |
リソースは実行アクティビティを実行可能 |
リソースはアクティビティを開始可能 |
ルーティング実行はまだ実行済ではありません。 |
ルーティング実行はまだ実行されていません。 |
ルーティング実行ログID |
ルーティング実行ID |
実行順序 |
実行順序 |
選択したプランにはすでに後続作業があるため、実行オーダー値を適用できません。 別の実行順序計画を選択してください。 |
選択したオーダーは、選択したプランにすでに後続作業があるため適用できません。 別の計画を選択してください。 |
このリソースはアクティビティを実行できません |
このリソースはアクティビティを開始できません |
SLAは無効化されていますが、SLAウィンドウ内の遅延実行が優先されます |
アクティビティSLAウィンドウの終了後にアクティビティのスケジュールを開始しますが、SLAウィンドウ内の場合は、アクティビティSLAウィンドウの終了近くにアクティビティを配置することをお薦めします |
SLA終了後の実行は、短いエージング期間でペナル化されます |
アクティビティSLAウィンドウの終了後のアクティビティ開始のスケジュール設定は、経過期間を短くしてペナルティ化されます |
実行要約 |
ルーティング実行要約 |
実行エラーのルーティング |
ルーティング・アクティビティ割当エラー |
ルーティング・プラン実行: 結果 |
ルーティング・プラン実行: 結果 |
ルーティング・プラン実行: タイプ |
ルーティング・プラン実行: タイプ |
「ルーティングを開始できません」エラー・メッセージに、ルーティング実行を開始できない理由が表示されるようになりました:
- ルーティングを開始できません:システムはビジー状態です。 後で再試行してください。
- ルーティングを開始できません: 機能ルーティングは無効です。
- ルーティングを開始できません: ルーティング・プランは実行中の順序になっています。 後で再試行してください。
ユーザー・インタフェースとドキュメントの両方で、ニュートラル言語が使用されます。 これにより、カスタマ・エクスペリエンスが向上します。
有効化のステップ
この機能を有効化するうえで必要な操作はありません。