更新20C

改訂履歴

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

日付	機能	注意
2020年8月10日	セグメント化可能なアクティビティとセグメント化可能なアクティビティのリンク	文書の更新。 機能情報の改訂。
2020年8月10日	リソース・マネージメントの改善点	文書の更新。 機能情報の改訂。
2020年7月24日		初版作成。

概要

このガイドでは、Oracle Field Service更新20cの新機能および改善された機能について理解する必要がある情報の概要を示します。 このガイドは本アップデートでの新規・改善機能の概要を理解するのに必要な情報およびアップデートに必要なタスクについて説明します。個々のセクションは機能の概略説明、その機能を実装に必要なステップ、ヒントおよび考慮点、他に必要なリソースが記述されています。 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に送信してください。

機能のサマリー

管理

表示画面に表示される言語の用語集翻訳表示

Oracleでは、Oracle Field Serviceにリストされている一部の言語の翻訳は提供されません。 これらの言語は、用語集内の言語画面で選択できますが、独自の用語集翻訳を指定する必要があります。

更新20C以降、次のスクリーンショットに示すように、翻訳を使用できない言語には「*」記号が付き、Oracleでは「言語」画面に用語集の翻訳がありません:

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• Oracle Field Serviceの管理

Where Is My Technician構成の改善点

更新20C以降では、顧客との通信を支援し、顧客と従業員の安全性を支援する多数の新しい構成を実行できます。 これには次のものがあります。

• 到着時間に使用するフィールドを構成します。
• 技術者が実行しているサービスのタイプを表示または非表示にします。
• 顧客住所を表示または非表示にします。
• マップ上の顧客の概算位置を表示します。
• 前のアポイントメントを完了した後、もしくはルートをアクティブ化してから、地図上で技術者のポジションが取得不可の時間を設定します。
• Where is My Technician画面のロケールを構成します。
• Where is My Technician URLのカスタム・ドメインを設定します。

これらの設定を構成するには:

1. 構成、テーマの順にクリックします。
2. 編集するWhere is My Technicianテーマをクリックします。
3. 到着時間を構成する手順は、次のとおりです:
   1. 属性をクリックします。
   2. 到着時間ドロップダウン・リストから次のいずれかの値を選択します:

• 表示しない: Where is My Technician画面で到着時間を非表示にするには、このオプションを選択します。
• 通知時間、配信ウィンドウ、サービス時間枠: アクティビティ・ステータス、値の可用性および優先度に従って使用可能な値を選択するには、このオプションを選択します:
  • 通知時間:
    • デリバリ時間枠
    • ETA
    • サービス時間枠
    • アウトバウンド・レスポンス・メッセージを介して返される値
  • デリバリ時間枠
  • サービス時間枠
• 通知時間: 技術者が到着することを顧客に通知した時間を表示するには、このオプションを選択します。 アプリケーションでは、この値は自動的に更新されません。 オプションは、次のとおりです。
  • デリバリ時間枠
  • ETA
  • サービス時間枠
  • アウトバウンド・レスポンス・メッセージを介して返される値
• デリバリ時間枠
• サービス時間枠
• ETA

'ARRIVAL_TIME_RANGE'プレースホルダーを構成して、通知時間に使用する値を構成できます。 配信ウィンドウ、サービス時間枠またはETAが空の場合、到着時間は画面に表示されません。 このスクリーンショットは、属性タブの到着時間フィールドを示しています:

4. 技術者が実行するサービスのタイプを構成する手順は、次のとおりです:
   1. 属性をクリックします。
   2. サービスのタイプ・ドロップ・ダウン・リストから次のいずれかの値を選択します:

• 表示しない:サービスのタイプを非表示にするには、このオプションを選択します。
• アクティビティ・タイプ:アクティビティ・タイプをサービスのタイプとして表示するには、このオプションを選択します。

このスクリーンショットは、Where is My Technicianテーマの属性タブのサービスのタイプ・フィールドを示しています:

5. 顧客所在地の表示を構成する手順は、次のとおりです:
   1. 属性をクリックします。
   2. Customer Positionドロップダウン・リストから次のいずれかの値を選択します:

• 表示しない: 顧客住所を非表示にするには、このオプションを選択します。
• 顧客所在地: Where is My Technician画面に顧客住所を表示するには、このオプションを選択します。 このフィールドは、住所、市区町村、郵便番号および都道府県フィールドで構成されます。 これらの値のいずれかが空の場合、それらは画面に表示されません。

属性タブで使用可能な技術者名および技術者の写真の表示は、同じway (as in previous versions)で動作します。 「リソース情報」画面のAvatarフィールドで使用可能な写真が技術者の写真として使用されることに注意してください。

6. マップに顧客ポジションを設定する手順は、次のとおりです:
   1. マップをクリックします。
   2. Customer Positionドロップダウン・リストから次のいずれかの値を選択します:

• 表示しない: マップ上の顧客座標を非表示にするには、このオプションを選択します。 このオプションを選択すると、技術者のポジションは非表示になります。 属性タブの顧客住所フィールドを使用して、顧客の住所を画面上で非表示にします。
• 完全一致:顧客の正確なポジションをマップに表示するには、このオプションを選択します。
• 近似:マップ上の顧客ロケーションの周囲にバブルを表示するには、このオプションを選択します。

このスクリーンショットは、マップ・タブの「顧客ポジション」フィールドを示しています:

7. マップ上の技術者の位置を設定する手順は、次のとおりです:
   1. マップをクリックします。
   2. 技術者ポジション・ドロップ・ダウン・リストから次のいずれかの値を選択します:

• 表示しない:マップ上の技術者座標を非表示にするには、このオプションを選択します。
• 稼働トラックとともに表示: 技術者の運転中のトラックを表示し、マップ上の顧客の正確な位置を表示するには、このオプションを選択します。
• 稼働トラックなしで表示:顧客ポジションを完全または近似として選択した場合に、運転中のトラックなしで技術者アイコンを表示するには、このオプションを選択します。 顧客のポジションを概算として選択すると、技術者がマップ上のバブルに達するまで技術者アイコンが使用可能になります。 その後、技術者アイコンは非表示になります。
• 技術者が前のアポイントメントを完了した後、またはルートをアクティブ化した後に、指定した時間の技術者のポジションを非表示にするには、「ポジションを表示しない」を選択します。 前のアクティビティのアクティビティ・ステータスは、完了、未完了、取消済、一時停止またはアクティビティ順序が変更された場合があります。 設定時間が経過するとすぐに、技術者アイコンがマップに表示されます。 これは、前の顧客の座標または技術者の自宅のロケーションを非表示にするのに役立ちます。 このフィールドはデフォルトで0 (ゼロ)に設定されています。つまり、技術者の位置は、技術者が前のポイントを完了した直後に表示されます。

このスクリーンショットは、Where is My Technician画面の顧客の位置と技術者の位置を示しています。

8. Where is My Technician画面のロケールを構成するには:
   1. ローカライズをクリックします。
   2. ロケール・ドロップ・ダウン・リストから必要な値を選択します。 デフォルト・テキストの翻訳、日付と時間の翻訳および書式は、ここで選択するロケールによって異なります。 'English - 新しいテーマには、米国がデフォルトで設定されています。
9. カスタム・ドメインを使用してWhere is My Technician URLに会社名をブランド化する手順は、次のとおりです。
   1. Brandingをクリックします。
   2. カスタム・ドメイン名フィールドに、Where is My Technician URLで使用するドメイン名を入力します。 ドメイン名は256文字に制限されています。 「たとえば、次のようになります。」 https://wmt.example.com/k694jg. ここで、k694gは一意のトークンです。

ノート: カスタム・ドメイン・フィールドが空の場合、Where is My Technician URLをiFrameで開くことはできません。

1. 3. プロキシ・ページを使用してHTTPS webサーバーを構成します。 すべてのリクエストを索引ページにルーティングするようにwebサーバーを構成します。
   4. index.htmlページをwebサーバーのルートに追加します。

NGINXの構成例

server {

listen 80;

server_name  wmt.example.com;

location / {

ルート/usr/share/nginx/html;

try_files $uri /index.html;

}

}

iFrameでカスタム・ドメインを使用してWhere Is My Technician URLを開く方法の例

<!DOCTYPE html>

<html>

<head>

iframe </title>内の<title> WMT

<style type="text/css">

html {

オーバーフロー: auto;

}

html、

body,

div,

iframe {

マージン: 0px;

padding: 0px;

height: 100%;

border: none;

}

iframe {

display: block;

width: 100%;

border: none;

overflow-y: auto;

overflow-x: hidden;

}

</style>

</head>

<body>

<iframe id="wmt-chrome"

src="#"

frameborder="0"

marginheight="0"

marginwidth="0"

width="100%"

height="100%"

scrolling="auto">

</iframe>

</body>

<script type="text/javascript">

document.getElementById('wmt-chrome').setAttribute('src', 'https://{custom_domain_name}' + window.location.pathname);

</script>

</html>

Oracle Field Serviceでは、次の言語のデフォルトの翻訳および日時書式がサポートされています:

チェコ語、デンマーク語、ドイツ語、ギリシャ語および英語でサポートされているデフォルトの翻訳と日時書式:

スペイン語でサポートされているデフォルトの翻訳と日時書式は次のとおりです:

フィンランド語、フランス語(ヨーロッパ)、ヒンディ語、ハンガリ語、イタリア語および日本語でサポートされているデフォルトの翻訳と日時書式:

韓国語、オランダ語、ノルウェー語(ブークモール)、ポーランド語、ルーマニア語、ロシア語、スウェーデン語およびトルコ語でサポートされているデフォルトの翻訳と日時書式:

有効化のステップ

この機能を有効にするために何もする必要はありません。

非推奨のサーベイ機能の削除

以前は、サーベイ機能は非推奨になりました。 更新20C以降、サーベイの構成画面は削除されました。 さらに、ポストサーベイ(PAS)のメッセージ・ステップ構成でサーベイ質問を選択するオプションも削除されました。 したがって、メッセージ・シナリオでサーベイを追加したり、サーベイを使用することはできません。

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• Oracle Field Serviceの管理

ログイン・ポリシーのMD5およびSHA-1の削除

以前は、弱いパスワード・ハッシュの無効化およびSHA-1オプションは非推奨になりました。

Update 20C以降、これらのオプションは「ログイン・ポリシー」画面から削除されます。

弱いパスワード・ハッシュの無効化機能の削除

ポリシーの追加画面および「ポリシーの編集」画面で、内部認証方式の弱いパスワード・ハッシュの無効化チェック・ボックスが削除されます。 更新20C以降では、アプリケーションはセキュアなSHA-256ハッシュを使用してユーザー・パスワードを保存し、パスワードを格納するmd5ハッシュのサポートを削除します。

シグネチャ・ハッシュ・アルゴリズムの削除

「ポリシーの追加」画面のSAML認証メソッドのシグネチャ・ハッシュ・アルゴリズム・ドロップ・ダウン・リストが削除されます。 ハッシュ・アルゴリズムとしてSHA-256を選択した既存のログイン・ポリシーの設定は表示されません。

SAMLログイン・ポリシーのオプションとしてSHA-1ハッシュを選択できなくなりました。 ハッシュ・アルゴリズムは、SAML統合用にダウンロードできるOFSメタデータXMLでSHA-256にすでに設定されています。 SHA-1ハッシュとのSAML統合がある場合、引き続き機能します。 このような場合、既存のSHA-1 SAMLログイン・ポリシーのシグネチャ・ハッシュ・アルゴリズム設定が表示されます。 この設定は、セキュリティ・ハッシュ・アルゴリズムをSHA-256に変更して変更を保存すると削除されます。

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

フォームおよび標準画面での複数のバーコードのスキャン

以前は、1つのバーコード/QRコードのみをスキャンできました。 更新20C以降では、シングル・クリックで複数のバーコードをスキャンでき、バーコード/QRコード・スキャナ・オプションをコア・アプリケーションの標準画面に追加できます。 現在、バーコード・スキャン機能はAndroidおよびiOSアプリケーション用のOracle Field Service Mobileで使用できるため、この機能を使用するにはアプリケーションをインストールする必要があります。

バーコード/QRコード・スキャナ・フィールドの構成

次のステップを実行します。

1. 標準画面でバーコード/QRコード・スキャナ・チェック・ボックスを構成するには:
   1. 構成、ユーザー・タイプの順にクリックします。
   2. バーコードをスキャンするオプションを追加するユーザー・タイプを選択します。
   3. 画面構成をクリックします。
   4. 「アプリケーション」画面で、オプションを追加する画面名を見つけてクリックします。 たとえば、在庫をインストールします。
   5. 新規要素セクションから、入力要素をフォームの必要な位置にドラッグ・アンド・ドロップします。
   6. 要素をクリックし、バーコード/QRコード・スキャナ・チェック・ボックスを選択します。 翻訳や可視性など、その他の詳細を入力します。
   7. 「保存」をクリックします。
2. 複数のバーコード/QRコード・スキャナのチェック・ボックスを構成するには:
   1. カスタム・フォームを作成するか開きます。 または、構成、ユーザー・タイプ、画面構成の順にクリックし、標準画面を開きます。
   2. 新規要素セクションから、入力要素を必要な回数だけドラッグ・アンド・ドロップします。
   3. すべての要素のバーコード/QRコード・スキャナ・チェック・ボックスを選択します。 翻訳や可視性など、その他の詳細を入力します。

複数のバーコード/QRコード・スキャナ・チェック・ボックスを追加する場合は、セクションにバーコード/QRコード・スキャナ・チェック・ボックスおよびテキスト要素のみが含まれていることを確認します。 セクションに他のタイプの要素が含まれている場合、バーコード・スキャナはトリガーされません。 このスクリーンショットは、3つのバーコード・スキャナ・チェック・ボックスが追加されたビジュアル・フォーム・エディタを示しています:

4. 「保存」をクリックします。

複数スキャナ・フィールドの使用

たとえば、シリアル番号、モデル番号およびMACアドレスの3つのバーコード・スキャナ・フィールドを同じ順序で追加したとします。

• これらのバーコードのスキャンを開始するには、空の「シリアル番号」フィールドの横にあるバーコード・スキャナ・アイコンをクリックします。 アプリケーションによってプロセスが実行されます。
• シリアル番号がスキャンされると、カメラが開き、下にある次の要素であるモデル番号をスキャンできます。
• モデル番号がカメラに表示され、スキャンの結果が画面に表示されます。 このフローは、セクション内のすべてのバーコードをスキャンするまで、すべての空の要素に対して続行されます。 次の画面は、インストール済に追加画面のバーコード・スキャナ・フィールド、バーコードのスキャンおよびフィールドに表示されるバーコードを示しています:

スキャンはいつでも中断したり、スキャンしたフィールドを再スキャンしたり、セクション内の残りの空のフィールドのスキャンを続行できます。

ノート: 複数のバーコードのスキャンは、空のフィールドに対してのみ機能します。 スキャンされたフィールドはスキップされ、セクション内の次の空のフィールドに自動的に移動します。

バーコード/QRコード・スキャナ・オプションを使用できないフィールド

ビジュアル・フォーム・エディタでは、次のフィールドのバーコード/QRコード・スキャナ・チェック・ボックスを使用できません:

• アクティビティ・フィールド
  • 自動計算フィールド:
    • アクセス・スケジュール[access_schedule]
    • アクセス時間[access_hours]
    • コンプライアンス・アラート[activity_compliance]
    • アラート[activity_alerts]
    • SLA終了[sla_window_end]
    • SLA開始[sla_window_start]
    • 移動時間[travel]
    • リソースID [pid]
    • タイム・スロット[time_slot]
  • 自動計算されない(ただし、特定のデータを含む)フィールド:
    • ポイント[apoints]
    • 座標X [acoord_x]
    • 座標Y [acoord_y]
    • Duration [length]
  • 自動計算されないフィールド:
    • 名前[cname]
    • 作業指示[appt_number]
    • 携帯電話[ccell]
    • 電子メール[cemail]
    • 電話[cphone]
    • アカウント番号[customer_number]
    • 状態[cstate]
    • 郵便番号[czip]
    • 市区町村[ccity]
    • 住所[caddress]
  • 自動計算フィールド:
    • 最初の手動操作[first_manual_operation]
    • 最初の手動操作インタフェース[first_manual_operation_interface]
    • ユーザーが実行した最初の手動操作[first_manual_operation_user_id]
    • ユーザー(ログイン)が実行する最初の手動操作[first_manual_operation_user_login]
    • ユーザー(名前)が実行する最初の手動操作[first_manual_operation_user_name]
    • 自動ルーティング終了日[auto_routed_to_date]
    • リソースへの自動ルーティング[auto_routed_to_provider_id]
    • リソース(名前)に自動ルーティング[auto_routed_to_provider_name]
    • 割当のアクティビティ時間[atime_of_assignment]
    • 予約のアクティビティ時間[atime_of_booking]
    • キャパシティ・カテゴリ[activity_capacity_categories]
    • 座標ステータス[acoord_status]
    • 日付[date]
    • 開始 - 終了[eta_end_time]
    • 搬送ウィンドウ[delivery_window]
    • 終了[end_time]
    • 通知時間[time_delivered]
    • ワーク・ゾーン[aworkzone]
    • アクティビティID [aid]
    • アクティビティ・ステータス[astatus]
    • 開始[ETA]
    • サービス・ウィンドウ[service_window] [service_window]
    • 移動見積メソッド[travel_estimation_method]
• 在庫フィールド
  • 自動計算フィールド:
    • 変更済在庫ID [inv_change_invid]
    • リソースID [inv_pid]
    • アクティビティID [inv_aid]
    • 在庫ID [invid]
    • 在庫プール[invpool]
  • 自動計算されない(ただし、特定のデータを含む)フィールド:
    • 数量[quantity]
• リソース・フィールド
  • 自動計算フィールド:
    • ID [pid]
    • 期間見積への影響を開始するためにレポート・データに残っている稼働日数[skip_days_for_stats]
    • 再アクティブ化済[reactivated]
    • 待機カレンダ[oncall_calendar]
    • ワーク・ゾーン[resource_workzones]
    • 有効作業スキル[resource_effective_workskills]
    • タイム・スロット[resource_time_slots]
    • キャパシティ・カテゴリ[resource_capacity_categories]
    • 作業スキル[resource_workskills]
    • カレンダ[calendar]
    • キュー・ステータス[queue_status]
    • 合計[total]
    • 保留中[pending]
    • アラート[alerts]
  • 自動計算されないフィールド:
    • 名前[pname]
    • 外部ID [external_id]
    • 電子メール・アドレス[email]
    • 電話[pphone]
• サービス・リクエスト・フィールド
  • 自動計算フィールド:
    • 作成済[srcreated]
    • アクティビティ[appt_ident]
    • リクエストID [srid]
    • ユーザーID [sr_uid]
    • リソースID [sr_pid]
    • アクティビティID [sr_aid]
    • 在庫ID [sr_invid]
  • 自動計算フィールドの場合があるフィールド:
    • ユーザー[uname]
    • 日付[srdate]
• ユーザー・フィールド
  • 自動計算フィールド:
    • ユーザーID [uid]
    • 登録済[sucreated]
    • 失敗したログイン試行[login_attempts]
    • ブロック先[login_blocked_to]
    • 最終ログイン[last_login]
    • 最終パスワード変更[last_password_change]
    • 更新済[suupdated]
    • メイン・リソース[main_resource_id]
  • 自動計算されない(ただし、特定のデータを含む)フィールド:
    • リフレッシュ率[refresh_rate]
    • モバイル・リソース数[mobile_provider_count]
    • モバイル・アクティビティ数[mobile_activity_count]
    • モバイル在庫数[mobile_inventory_count]
    • コラボレーション・グループ[collab_assigned_user_group]
    • ヘルプ・デスクのオペレータ[collab_operator_helpdesk]
  • 自動計算されないフィールド:
    • ユーザー名[uname]
    • ログイン[ulogin]
    • パスワード[password]

  

有効化のステップ

この機能を構成するステップは、前の項を参照してください。

主なリソース

• Oracle Field Serviceの管理

AndroidおよびiOSアプリケーション

AndroidおよびiOSアプリケーション用のOracle Field Service Mobileをアップグレードするための通知

20C以降、Oracle Field Serviceモバイル・アプリケーションにログインすると、アプリケーションを最新のメジャー・バージョンにアップグレードするための通知メッセージが表示されます。 この通知は、インストールされているAndroidおよびiOSアプリケーションの現在のバージョンが、使用可能な最新バージョンのアプリケーションより1つ以上低いメジャー・バージョンである場合に表示されます。

• Androidアプリケーションのアップグレード通知メッセージ

このイメージは、Androidアプリケーションに表示される通知メッセージを示しています:

Androidアプリケーションに表示される通知メッセージ

• iOSアプリのアップグレード通知メッセージ

このイメージは、iOSアプリケーションに表示される通知メッセージを示しています:

iOSアプリケーションに表示される通知メッセージ

有効化のステップ

アプリをアップグレードするステップ:

1. 更新ボタンをクリックして、Google PlayまたはApp Storeからアプリを更新します。

ノート: 「No Thanks」または「Not Now」を選択した場合、OFSの次のバージョンがリリースされるまで通知は表示されません。

すべての画面およびホスト・プラグインからのサポート・ファイルのダウンロード

更新20C以降、インストールされたAndroidおよびiOSアプリケーションでは、ホスティングされたプラグイン内のすべてのネイティブ画面およびファイルのエクスポート・ファイルのダウンロードがサポートされるようになりました。 構成画面、レポートおよび予測内からファイルをエクスポートできます。

Androidデバイスからのファイルのダウンロード

1. エクスポートまたはダウンロードをクリックします。
2. Androidデバイスがエクスポートまたはファイルのダウンロードを開始すると、ダウンロードの開始メッセージが表示されます。

このイメージは、androidデバイスでのダウンロード開始メッセージを示しています。

Androidデバイスでのダウンロード・メッセージの開始

3. 通知センターでダウンロードのステータスをレビューします。
4. デバイスのネイティブ機能に従って、ダウンロードしたファイルにアクセスできます。

ダウンロードのステータスを示す通知センター

ノート: Androidアプリケーションのプラグイン内からJSONファイルを開くと、コンテンツはアプリケーション内に表示され、ファイルとしてダウンロードされません

iOSデバイスからのファイルのダウンロード

1. エクスポートまたはダウンロードをクリックします。
2. ダウンロードが完了すると、iOSデバイスに「Download finished」という通知メッセージが表示されます。

iOSデバイスでの終了メッセージのダウンロード

3. iOSデバイスでは、ファイルの保存を確認するか、他の使用可能なオプションから選択するよう求められます。 これはネイティブiOS機能に基づく場合があります。

iOSデバイスのファイルに保存オプション

4. ファイルに保存をクリックし、ファイルを保存するロケーションを選択します。 ファイルの保存先として指定したロケーションは、iOSデバイスのネイティブ機能によって異なる場合があります。

iOSデバイスでファイルを保存するロケーションを選択するオプション

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• AndroidおよびiOSモバイル・アプリケーションの使用

API

SOAP APIの削除

更新20C以降、次のSOAP APIが削除されます:

• アクティビティ管理API
• Resource Management API
• スマート・ロケーションAPI
• GPS API
• 履歴API

有効化のステップ

この機能を有効にするために何もする必要はありません。

指定したアクセス・スケジュール情報に一致するリソースの検索

更新20C以降では、一致するリソースの検索( POST /rest/ofscCore/v1/resources/custom-actions/findMatchingResources)ファンクションを使用して、アクティビティ情報の一部として、リクエストで指定されたアクセス・スケジュールに基づいて一致するリソースを検索できます。

リクエストにアクセス・スケジュール情報を指定すると、次のようになります:

• 結果の'workTime'フィットネス値では、リクエストされた日付のアクセス時間との時間間隔交差が使用されます。
• リソース・スケジュールがリクエストされると、'arrivalTimeOptions'パラメータの値'maxStartTime'および'minStartTime'には、アクセスが使用可能な時間のみが含まれます。

リクエスト例

リクエストの例を示します。

POST https://<instance_name>.etadirect.com/rest/ofscCore/v1/resources/custom-actions/findMatchingResources

{

"activity": {

"activityType": "default_customer_activity_type",

"timeZone": "Eastern",

"city": "11111",

"duration": 60,

"string_text_activity_property": "IN",

"accessSchedule": "{"schedule":[{"daysOfWeek":["Mon","Tue","Wed","Thu","Fri","Sat","Sun"],"hours":[["09:00","12:00"]]}],"exceptDates":[]}"

},

"date" : "2020-05-19",

"fields" : ["workTime", "workZone",  "workSkill",  "resourcePreference", "resourceId"],

"schedulesToReturn" : ["2020-05-20"],

"criteria" : {"workTime":100,"workSkill":0,"workZone":0,"resourcePreference":0},

"schedulesFields":["fitness","freeTimeWindows","arrivalTimeOptions"],

"limit" : 1,

"offset" : 1

}

サンプル・レスポンス

次に、JSON形式のレスポンス本文の例を示します。

{

"totalResults": 8532,

"limit": 1,

"offset": 1,

"items": [

{

"resource": {

"resourceId": "fmr_tech",

"status": "active",

"language": "en",

"languageISO": "en-US"

},

"fitness": {

"workTime": 180,

"workZone": 100,

"workSkill": 100,

"resourcePreference": 1

},

"schedules": {

"2020-05-20": {

"fitness": {

"workTime": 180,

"workSkill": 100,

"workZone": 100,

"resourcePreference": 1

},

"freeTimeWindows": [

[

"00:05",

"23:55"

]

],

"arrivalTimeOptions": [

{

"minStartTime": "09:00",

"maxStartTime": "12:00",

"workZoneMatch": false、

"setPositionInRoute": {

"position": "first"

}

}

]

}

}

}

],

"links": [

{

"rel": "prev",

"href": "https://<instance_name>.etadirect.com/rest/ofscCore/v1/resources/custom-action/findMatchingResources/?limit=1&offset=0"

},

{

"rel": "next",

"href": "https://<instance_name>.etadirect.com/rest/ofscCore/v1/resources/custom-action/findMatchingResources/?limit=1&offset=2"

}

]

有効化のステップ

RESTのサービス定義は、Oracle Help Center→「関心のあるアプリケーション・サービス領域」→REST APIから入手可能なREST APIガイドで確認してください。 Oracle RESTサービスを初めて使用する場合は、「クイック・スタート」セクションから開始できます。

主なリソース

• REST API for Oracle Field Service

APIパラメータとフィールド・ラベルの関係の識別

更新20C以降では、アクティビティ、リソース、ユーザーおよび在庫のメタデータ・カタログ・スキーマのラベル'x-ofs-fieldLabel'を使用して、APIパラメータとそれに対応するフィールド・ラベル間の関係をOracle Field Serviceで識別できます。

この機能には、次のメタデータAPI関数の更新が含まれます:

• /rest/ofscCore/v1/metadata-catalog/activities

スキーマが変更されました: activity, getActivitySchema、createActivitySchema、updateActivitySchema、bulkUpdateActivityItemSchema

• /rest/ofscCore/v1/metadata-catalog/resources

スキーマが変更されました: resource

• /rest/ofscCore/v1/metadata-catalog/users

スキーマが変更されました: user

• /rest/ofscCore/v1/metadata-catalog/inventories

スキーマが変更されました: inventory

サンプル・レスポンス

レスポンスの例を次に示します。

{

...

properties:

{

"integer_text_service_request_pro":

{

"type": "integer",

"title": "Integer text service request pro",

"x-ofs-fieldLabel: "integer_text_service_request_pro"

},

"postalCode":

{

"type": "string",

"description": "The postal code of the customer. This field is used for geocoding and must contain a valid address.",

"title": "Postal Code",

"x-ofs-fieldLabel": "czip"

},

...

}

有効化のステップ

RESTのサービス定義は、Oracle Help Center→「関心のあるアプリケーション・サービス領域」→REST APIから入手可能なREST APIガイドで確認してください。 Oracle RESTサービスを初めて使用する場合は、「クイック・スタート」セクションから開始できます。

主なリソース

• REST API for Oracle Field Service

メタデータAPIのプロパティ・コレクションの改善

更新20C以降、プロパティ・コレクションを返すメタデータAPI関数のレスポンス・スコープを改善できます。

次のメタデータAPI関数のレスポンス範囲を改善できます:

• プロパティの取得: GET /rest/ofscMetadata/v1/properties/{label}
• プロパティの取得: GET /rest/ofscMetadata/v1/properties
• プロパティの列挙値を取得: GET /rest/ofscMetadata/v1/properties/{label}/enumerationList

Get properties関数には、次の問合せパラメータを使用できます:

• entity (オプション) : enum - 指定されたエンティティに関連するプロパティのみを取得します。 使用可能な値: [resource, user, activity, inventory, serviceRequest]. 次に例を示します: GET /properties?entity=resource,user
• type (オプション) : enum - 指定されたタイプのプロパティのみを取得します。 使用可能な値: [string, integer, enumeration, file, field]. 次に例を示します: GET /properties?type=string,integer

この問合せパラメータは、プロパティの取得、プロパティの取得およびプロパティの列挙値の取得関数に使用できます:

• language (オプション) : string - 指定した言語への翻訳の量を減らします。 次に例を示します: /properties?language=en-USの取得。 このパラメータを使用すると、変換構造体は返されず、指定した言語の実際の値をnameおよびhintフィールドから直接取得できます。

リクエスト例

'language'パラメータを使用したリクエストの例を次に示します。

GET https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/properties/Alternative+route?language=en-US

サンプル・レスポンス

次に、JSON形式のレスポンス本文の例を示します。

{

"label":"Alternative route",

"name":「代替ルートが見つかり、使用されます。」、

"hint":"Alternative route",

"type":"integer",

"entity":"activity",

"gui":"checkbox",

"cloneFlag":false,

"links":[

{

"rel":"canonical",

"href":"https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/properties/Alternative+route"

},

{

"rel":"describedby",

"href":"https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/properties"

}

]

}

有効化のステップ

RESTのサービス定義は、Oracle Help Center→「関心のあるアプリケーション・サービス領域」→REST APIから入手可能なREST APIガイドで確認してください。 Oracle RESTサービスを初めて使用する場合は、「クイック・スタート」セクションから開始できます。

主なリソース

• REST API for Oracle Field Service

すべてのリソースの最後の位置情報の取得

更新20C以降では、リクエストのresourcesパラメータを省略することで、GET last known position of resourcesファンクション(GET /rest/ofscCore/v1/resources/custom-actions/lastKnownPositions))を使用して、すべてのリソースにおいて最後に確認された位置情報を取得できます。

有効化のステップ

RESTのサービス定義は、Oracle Help Center→「関心のあるアプリケーション・サービス領域」→REST APIから入手可能なREST APIガイドで確認してください。 Oracle RESTサービスを初めて使用する場合は、「クイック・スタート」セクションから開始できます。

主なリソース

• REST API for Oracle Field Service

ワーク・ゾーン・キーのフィールドの順序の取得

更新20C以降、'GET work zone key' (GET /rest/ofscMetadata/v1/workZoneKey)ファンクションは、ワーク・ゾーン・キーのフィールドの順序に関する情報を提供する'apiParameterName'および'order'パラメータを返します。

• order  (integer) - フィールド・リスト内のアイテムの順序を示すフィールド。

• apiParameterName  (string) -ワーク・ゾーン・キーのアクティビティ・フィールド・ラベルと一致するアクティビティ操作で使用されるAPIパラメータの名前

レスポンスの例:

{

"current": [

{

"label": "ccity",

"length": 4,

"function": "caseInsensitive",

"order": 0,

"apiParameterName": "city"

},

{

"label": "czip",

"length": 4,

"function": "caseInsensitive",

"order": 1,

"apiParameterName": "postalCode"

}

],

"links": [

{

"rel": "canonical",

"href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/workZones"

},

{

"rel": "describedby",

"href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/workZones"

}

]

}

有効化のステップ

RESTのサービス定義は、Oracle Help Center→「関心のあるアプリケーション・サービス領域」→REST APIから入手可能なREST APIガイドで確認してください。 Oracle RESTサービスを初めて使用する場合は、「クイック・スタート」セクションから開始できます。

主なリソース

• REST API for Oracle Field Service

キャパシティ管理

キャパシティ計算での最終移動時間の考慮

20C以降では、Oracle Field Service (OFS)アプリケーションのチェック・ボックスを選択して、使用時間に日の開始および日の終了の移動時間を含めることができます。

技術者ルートでの開始または最初の移動時間は、開始ロケーションから最初のアクティビティまでの所要時間です。 日末または最終移動時間は、アプリケーションで構成されているように、ルート内の最後のアクティビティから技術者終了ロケーションへの取得にかかる時間です。 これらの設定を使用すると、技術者の各出張タイプの最初および最後の出張時間を個別に含めるか除外できます。

使用済割当パラメータは、構成済の最初および最後の移動時間に基づいて計算されます。

ノート: OFSで作業時間とみなされる移動時間の量は、リソース・タイプ構成の「移動手当」セクションで制御されます。 『Oracle Field Serviceの管理』ガイドの「フィールド・リソース・ロール」のリソース・タイプの追加に関する項を参照してください。

各キャパシティ・エリアの個々の設定は、次のように構成できます:

1. adminユーザーとしてログインします。
2. 割当て容量を選択します。
3. 左側のペインからキャパシティ・エリアを選択します。
4. 構成アイコンをクリックします。

容量構成画面

5. 「日次開始移動時間は使用時間に含まれます」 「および含めるか除外する日次更新移動時間は使用時間に含まれます」で、リソースの最初の移動時間と最後の移動時間を選択します。
6. 「保存」をクリックします。

ノート: 下位互換性を維持するために、すべてのキャパシティ・エリアの新規パラメータの初期設定は最初の移動時間に含まれますが、最終移動時間には含まれません。

移動手当のリソース・タイプ設定

リソース・タイプ構成の移動許容量設定によって、使用済割当パラメータから使用される移動時間が決まります。

たとえば、「移動日」の開始フィールドには、次のいずれかの設定を指定できます:

• 最初のアクティビティへの移動時間は、作業時間開始からは含まれません。
• 最初のアクティビティへの移動時間は、作業時間開始から含まれます。
• リソースには、作業時間開始までの最大[NN]分の移動時間が割り当てられます。

移動時間は、選択した設定に基づいてリソースの使用済割当から使用されます。 この表は、リソース・タイプおよびキャパシティ管理設定に基づいて、リソースの使用済割当に追加される移動時間を示しています。

リソース・タイプ設定	キャパシティ管理設定	選択した設定に基づいて使用済割当パラメータに追加される時間
最初のアクティビティへの移動時間は、作業時間開始からは含まれません。	使用時間には、日の開始移動時間が含まれます。	最初の移動時間がリソース・タイプ設定に含まれていないため、0分が使用されます。
	日次開始移動時間は使用時間に含まれません。	最初の移動時間がリソース・タイプ設定に含まれていないため、0 分が使用されます。
最初のアクティビティへの移動時間は、作業時間開始から含まれます。	使用時間には、日の開始移動時間が含まれます。	リソース・タイプおよびキャパシティ管理設定が構成されているため、見積出張が使用されます。
	日次開始移動時間は使用時間に含まれません。	容量管理モジュールで設定が無効になっているため、0分が使用されます。
リソースには、作業時間開始の[30]分前までの移動時間が割り当てられます。	使用時間には、日の開始移動時間が含まれます。	キャパシティ管理の設定が有効になっていても、リソース・タイプの設定で作業時間より前に割り当てられる移動時間の量が指定されているため、推定移動マイナス30分が使用されます。 たとえば、移動推定が45分の場合、45-30=15分が使用済割当パラメータに追加されます。
	日次開始移動時間は使用時間に含まれません。	容量管理モジュールで設定が無効になっているため、0分が使用されます。

ノート: 前述のロジックは、日末移動時間の計算にも使用されます。

有効化のステップ

各キャパシティ・エリアの個々の設定を構成する方法については、前の項を参照してください。

主なリソース

• キャパシティの使用

コア・アプリケーション

アシスタントの割当

以前は、移動画面には、新しいルートでのアクティビティの位置やアイドル状態が存在した場所は表示されませんでした。 更新20C以降、アシスタントの割当と呼ばれる移動画面には、既存の機能とは別に次の機能が含まれています:

• 新規ルートのアクティビティ位置をビジュアル化します。 (新規関数)
• ルートへの移動の影響、つまりアクティビティの割当後にルートがどのように変化するかを表示します。 (新規関数)
• アイドル期間の表示。 (新規関数)
• 選択した日付の技術者にアクティビティを割り当てるか、アクティビティを未スケジュールとして設定します。 (既存の関数)
• 選択した日付のバケットにアクティビティを割り当てるか、アクティビティを未スケジュールとして設定します。 (既存の関数)
• リソース・ルートのアクティビティの順序を変更します。 (既存の関数)
• アクティビティを未オーダーとして設定します。 (既存の関数)
• アクティビティ詳細を表示します。 (既存の関数)

「アシスタントの割当の概要」

モビリティの移動処理は、新しいアシスタントの割当によって自動的に置換されます(たとえば、コア・アプリケーションのアクティビティ詳細から移動)。 また、「ユーザー・タイプ」画面の「アクティビティ管理」セクションでディスパッチ・コンソールでアシスタントの割当を使用設定を選択した場合にのみ、アシスタントの割当にディスパッチ・コンソールにアクセスできます。 「ユーザー・タイプ」画面で、次の設定を使用して「アシスタントの割当」画面の動作を定義できます:

• リソース間の移動を許可
• 未スケジュール・プールからスケジュール済プールへのアクティビティの移動を許可
• 未スケジュール・プールへのアクセスの許可
• ルート内のアクティビティの並替えを許可
• アクティビティの再スケジュール / 未スケジュール・プールへの移動の許可

ノート: アシスタントの割当機能を使用してセグメント可能なアクティビティを移動することはできません。 アシスタントの割当では、訪問機能はサポートされていません。 アシスタントの割当はレガシー管理では使用できません。

この表では、アシスタントの割当機能の構成および使用方法について説明します。

アシスタントの割当の構成

Configure/Perform	アプリケーション	画面	適用対象
アクティビティのアクション・リンク移動	モビリティ、コア・アプリケーション	アクティビティ詳細	単一アクティビティ
アクティビティ・ヒントのアクション・リンク移動	コア・アプリケーション	ディスパッチ・コンソール	単一アクティビティ
ドラッグ・アンド・ドロップによるアクティビティの移動	コア・アプリケーション	ディスパッチ・コンソール・リスト・ビュー、マップ・ビュー	1つ以上のアクティビティ
グループ処理移動	コア・アプリケーション	ディスパッチ・コンソール・マップ・ビュー	1つ以上のアクティビティ

アシスタントの割当機能のユーザー・インタフェースについて

アシスタントの割当機能は2つの画面に分かれています: メイン画面およびルート詳細画面。 「メイン」画面にはアクティビティの受信に適格なすべてのリソースおよびバケットがリストされ、ルート詳細画面には特定のリソースのルートがリストされます。

メイン画面

「メイン」画面は、通常のアクティビティを割り当てようとすると表示されます。 画面上に最大5つのリソースを表示し、スクロールして詳細を表示できます。 このスクリーンショットは、メイン画面を示しています:

次の表では、メイン画面の凡例について説明します:

メイン画面の凡例

凡例	Component	処理または摘要
1	ヘッダー	単一のアクティビティを移動する場合は、アクティビティ識別子を表示できます。 複数のアクティビティを移動する場合は、アクティビティ数を表示できます。
2	リソース・タブ	リソース・タブを使用して、アクティビティをリソースに移動します。 ここに表示されるリソースは、次の条件を満たします: ワーク・ゾーン一致 作業スキル一致 プロバイダのプリファレンス 必要な在庫 アクティビティ・リンク
3	バケット・タブ	バケット・タブを使用して、アクティビティをバケットに移動します。 ここに表示されるバケットは、リソースと同じ条件を満たします。
4	日付ピッカー	アクティビティを別の日付に再スケジュールするか、アクティビティを未スケジュールに設定します。
5	オプション-検索してすべて表示	検索: 名前または外部IDを使用してリソースを検索します。 バケット・タブが表示されている場合は、バケット内を検索します。 すべて表示 : 次の条件に関係なく、すべてのリソースを表示します: ワーク・ゾーン一致 作業スキル一致 プロバイダのプリファレンス 必要な在庫 アクティビティ・リンク 検索基準を満たすリソースがない場合、またはすべて表示を無効にした場合は、表示するリソースがありませんというメッセージが表示され、割当ては無効になります。 この場合、バケットには表示するバケットがありませんというメッセージが表示されます。
6	リソース/バケット詳細	リソース名、photo/avatar/icon,および親リソース名を表示します。
7	ルートの影響	このリソースにアクティビティを割り当てた場合にルートが変更される所要時間を表示します。 この時間には、追加の移動時間および移動されるすべてのアクティビティの所要時間が含まれます。 次のように計算されます: (total_activities_duration_after_assign + total_travel_time_after_assign - total_activities_duration_before_assign - total_travel_time_before_assign)
8	アクティビティ・ポジション	このオプションは、リソース・タブでのみ使用できます。 各リソースのリソース・ルート上のアクティビティの位置を表示します。 日付を変更すると、それに応じてルートが更新されます。 移動しようとしているアクティビティは、濃い枠線で表示されます。 このオプションは、次のことを理解するのに役立ちます: 配置: アクティビティがルート内のどこに配置されるか。 Warnings: 割当後に、移動中のアクティビティまたは他のルート・アクティビティが危険にさらされるかどうか。 アクティビティ・ステータス: アクティビティのステータスは、定義された色で表示されます。 未オーダー: リソース・ルートの未オーダー・アクティビティの数。 これは、レガシー管理での表示と同じ方法で表示されます。 アイドル期間: リソースがアイドル状態であるタイム・スロットは、レガシー管理で強調表示されるのと同じように、リソース・ルートで強調表示されます。 次のいずれかを実行すると、各リソースまたはバケットのルート詳細のかわりに+Nアクティビティが表示されます: 選択した日付のリソースに50を超えるアクティビティを割り当てようとしています。 50を超えるアクティビティを未スケジュールとしてリソースに割り当てようとしています。 50を超えるアクティビティをバケットに割り当てようとしています(スケジュール済および未スケジュールの両方)。 移動されるアクティビティの少なくとも1つにアラートがある場合、メッセージは赤に変わります。
9	詳細	矢印をクリックして、リソースのルート詳細画面を開きます。
10	割当てボタン	選択したリソースにアクティビティを割り当てる場合にクリックします。 アクティビティは、この画面に表示される場所と同じ場所にあります。 ルート詳細画面に移動して、アクティビティの順序を変更したり、順序なしに設定できます。
表示されない	アクティビティのヒント	アクティビティをクリックすると、アクティビティのヒントが表示されます。

ルート詳細画面

ルート詳細画面には、アクティビティを移動する、選択した日の特定のリソースのルート内のアクティビティが表示されます。 アクティビティを移動すると、移動されるアクティビティが暗いバックグラウンドで強調表示されます。 Route details画面のスクリーンショットを次に示します:

次の表では、ルート詳細画面の凡例について説明します:

ルート詳細画面の凡例

凡例	Component	処理または摘要
1	Header	単一のアクティビティを移動する場合は、アクティビティ識別子を表示できます。 複数のアクティビティを移動する場合は、アクティビティ数を表示できます。
2	戻るリンク	メイン画面に移動する場合にクリックします。 この画面で割当をクリックする前に戻るをクリックすると、ここで行ったすべてのルート変更が失われます。
3	ルート詳細	リソース名、photo/avatar/icon,および親リソース名を表示します。
4	日付	アクティビティを移動する日付を表示します。 日付は変更できません。
5	アクティビティ詳細	アクティビティ識別子、アクティビティ・タイプ、ロケーション、アイドル時間などのアクティビティ詳細を表示します。
6	スタック・メニュー	スタック・メニューを使用して、アクティビティを順序なしに設定するか、移動を取り消します。
7	警告	アクティビティの警告(ある場合)を表示します。 次の警告が表示されます: SLAウィンドウが失われる可能性があります サービス時間枠が失われる可能性があります ワーク・ゾーンの不一致 作業スキル不一致
8	未オーダー	アクティビティをこのスペースにドラッグ・アンド・ドロップして、順序なしとして設定します。
9	割当	割当てをクリックして変更をコミットします。

アシスタントの割当を使用したアクティビティの移動

アクティビティは、あるリソースから別のリソース、あるバケットから別のバケット、バケットからリソース、またはリソースからバケットに移動できます。 単一のアクティビティまたは複数のアクティビティを一度に移動できます。 便宜上、アクティビティを移動する手順は、メイン詳細とルート詳細の2つの画面に分かれています。 メイン画面を使用して、アクティビティを割り当てることができる特定のリソースを決定します。 また、ルート詳細画面を使用して、順序変更や順序なしとしての設定などの追加の調整を行います。 この手順では、単一のアクティビティを移動する方法について説明します。同じ手順を使用して、複数のアクティビティを移動できます。

プロシージャ:

1. ディスパッチ・コンソール、リスト・ビューまたはマップ・ビュー画面のアクティビティ詳細、アクティビティのヒントから、移動するアクティビティを選択します。 アシスタントの割当が表示され、アクティビティの移動に必要なすべての基準に一致するリソースが表示されます。 ドラッグ・アンド・ドロップでアクティビティを移動し、ターゲット・リソースがすべての基準に一致する場合、アプリケーションは単にアシスタントの割当を表示せずにアクティビティをターゲットに移動します。
2. リソースのルートの影響とアイドル時間を確認します。
3. デフォルトでは、すべて表示は無効です。 これをクリックすると、必要な基準に一致するかどうかに関係なく、すべてのリソースが表示されます。
4. アクティビティを割り当てることができる最適なリソースを決定します。
5. 「割当て」をクリックします。 選択したリソースにアクティビティが割り当てられます。 移動されるアクティビティは、より暗いバックグラウンドで強調表示されます。 未オーダー・アクティビティを移動すると、メイン画面およびルート詳細画面に順序付きで表示されます。 したがって、未オーダー・アクティビティの数はメイン画面では変更されません。 ただし、未オーダー・アクティビティをバケットに移動した場合、アクティビティ・ステータスはオーダー済または未オーダーのままになります。
6. ルート詳細画面を使用して、さらに調整を行います:
   1. アクティビティを未順序付けとして設定するには、アクティビティを未順序付けスペースにドラッグ・アンド・ドロップします。 または、スタック・アイコンをクリックし、順序なしで設定をクリックします。
   2. 移動を取り消すには、スタック・アイコンをクリックし、移動しないをクリックします。 アクティビティはこの画面から削除され、技術者には割り当てられません。 移動したアクティビティが画面に残っている場合、移動しないは使用できません。
   3. ルート内のアクティビティを並べ替えるには、アクティビティを目的の位置にドラッグ・アンド・ドロップします。
   4. 変更を保存するには、割当てをクリックします。 未オーダー・アクティビティを移動し、ルート詳細画面で未オーダー・アクティビティとして設定していないとします。 アクティビティがオーダーどおりに追加され、ルート上の適切な位置に表示されます。
   5. 変更を保存せずにメイン画面に移動するには、戻る矢印をクリックします。

既存の移動リンク

アクティビティのヒントに移動リンクを追加した場合は、アシスタントの割当を使用するように自動的にリダイレクトされます。 削除して再構成する必要はありません。

デモの視聴

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• 「割当アシスタンス準備トレーニング」を参照
• コア・アプリケーションの使用

コア・アプリケーションでのRedwoodテーマの有効化

更新20C以降では、Oracleの新しいRedwoodテーマを使用できます。 新しいRedwoodテーマを適用すると、コア・アプリケーションに新しいデザインの色、アイコンなどが表示されます。 「レガシー管理」の画面にクラシック・テーマが表示されます。

ノート: 以前に使用されていたクラシック・テーマおよびバニラ・テーマは非推奨となり、将来のバージョンで削除される予定です。

Redwoodテーマには、次の特性があります:

• Redwoodストライプを使用したヘッダーの新しい色
• ヘッダーおよびアクション・メニューの更新されたアイコン
• アバター要素の変更済フォーム
• 技術者画面の処理ボタンの下に処理バーが表示されます
• 技術者画面のフォントおよびボタンの更新

画面情報

新しいRedwoodテーマが適用されると、バージョン情報画面にRedwoodテーマに基づいた新しい設計が表示されます。 既存のすべてのテーマについて、古い設計が表示されます。

ノート: 「バージョン情報」画面には、コア・アプリケーションのURLのみが表示されます。 レガシー管理のURLは表示されなくなりました。

大画面デバイスで開くと、バージョン情報画面がどのように表示されるかを次に示します:

Redwoodテーマの画面について - 大画面デバイス

小さな画面のデバイスで開くと、次のようにバージョン情報画面が表示されます:

Redwoodテーマの画面について - 小さな画面のデバイス

Redwoodテーマを表示する画面の例

前のVanillaテーマと最新のRedwoodテーマを示す画面の例を次に示します。

• 管理:

このイメージは、大画面デバイスのRedwoodテーマを示しています:

Redwoodテーマ - 大画面デバイス

このイメージは、小さな画面のデバイスのRedwoodテーマのアクティビティ画面を示しています:

Redwoodテーマ - 小さな画面のデバイス

• ディスパッチ・コンソール

このイメージは、大画面デバイスのVanillaテーマのディスパッチ・コンソールを示しています:

Redwoodテーマのディスパッチ・コンソール - 大画面デバイス

このイメージは、小さな画面のデバイスのRedwoodテーマのディスパッチ・コンソールを示しています:

Redwoodテーマのディスパッチ・コンソール - 小さな画面のデバイス

• 自分のルート

このイメージは、大画面デバイスでのRedwoodテーマの「自分のルート」画面を示しています:

Redwoodテーマの自分のルート - 小さな画面のデバイス

このイメージは、小さな画面のデバイスでのRedwoodテーマの「自分のルート」画面を示しています:

Redwoodテーマの自分のルート - 小さな画面のデバイス

有効化のステップ

コア・アプリケーションでRedwoodテーマを有効にするには、次のステップに従います:

1. 「構成」.をクリックします
2. テーマ・ページで、Redwoodを選択します。
3. デフォルトの設定をクリックします。

次にコア・アプリケーションにログインすると、選択したRedwoodテーマがランディング・ページおよびその他の関連画面に表示されます。

このイメージは、大画面デバイスのRedwoodテーマを含むランディング・ページを示しています:

Redwoodテーマのランディング・ページ - 大画面デバイス

主なリソース

• コア・アプリケーションの使用

他の画面でのナビゲーションの改善

以前は、コア・アプリケーションに表示される一部の画面は、レガシー管理用に構成されたレイアウトに基づいていました。 20C以降、コア・アプリケーション用に構成されたレイアウトに基づいて画面が表示されます。 次の画面が変更されました:

アクティビティ詳細、リソース・プリファレンスおよびリスト・ビュー画面の変更

画面	変更
アクティビティの追加および詳細の編集	シフト画面からアクセスできるアクティビティの追加および「詳細」の編集画面は、レガシー管理用に構成されたビジュアル・フォーム・エディタに基づいていました。 これらの画面は、コア・アプリケーション用に構成したビジュアル・フォーム・エディタに基づいています。
リソース・プリファレンスおよびメッセージ	以前は、コア・アプリケーションでリソース・プリファレンスおよびメッセージ画面を正しく表示するには、レガシー管理でそれらの権限を設定する必要がありました。 これで、レガシー管理で設定した権限に関係なく、コア・アプリケーションで構成されたリソース・プリファレンスおよびメッセージ画面が表示されます。
リスト・ビュー(変更、移動および取消グループ・アクション)	ディスパッチ・コンソールのリスト・ビューでの変更、移動、取消などのグループ・アクションの表示は、レガシー管理用に構成した方法に基づいています。 これらのグループ・アクションの表示は、コア・アプリケーションのリスト・ビューのコンテキスト・レイアウトの構成方法に基づいています。
ディスパッチ・コンソールのリソース・ヒント	以前は、リソース・ヒント・コンテキスト・レイアウトにセクションの終わり要素を追加して、リソース・ヒントにヘッダーを表示する必要がありました。 これで、ヘッダーは他の設定とは無関係に表示されます。

このスクリーンショットは、「シフト・アクティビティ」画面からアクセスできるアクティビティの追加画面を示しています:

このスクリーンショットは、リソース・ヒントのヘッダーを示しています:

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

リソース画面でのナビゲーションの改善

以前は、リソース情報、ワーク・ゾーン、ロケーションなどのメイン・ヘッダーがリソースの内部画面に表示されていませんでした。 その結果、他の画面に移動するには、何回かクリックする必要がありました。 更新20C以降、メイン・ヘッダーは次の画面に表示されます:

• リソース情報
• リソース・カレンダ
• ロケーション
• 作業スキル
• ワーク・ゾーン
• リソース履歴

このスクリーンショットは、「リソース情報」画面のメイン・ヘッダーを示しています:

戻るリンクをクリックすると、ナビゲート元の画面が表示されます。 たとえば、ディスパッチ・コンソール、管理またはリソースからリソース情報に移動できます。 そのため、リソース情報の戻るリンクをクリックすると、ナビゲート元の特定の画面に移動します。 メイン・ヘッダーのない画面からこれらのリソース画面のいずれかにアクセスした場合、メイン・ヘッダーもリソース画面に表示されません。 たとえば、リソースのルートまたは「アクティビティ・リスト」画面からリソース・カレンダに移動した場合、メイン・ヘッダーは表示されません。 このような場合、元の画面は変更されません。 子リソースの追加、リソースの編集および在庫画面は、常に既存のヘッダーを使用して表示されます。

画面の小さいデバイスでは、画面名のみが表示され、前の画面の名前は表示されません。 戻るリンクは、大きい画面の場合と同じように機能します。

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

リソース・マネージメントの改善点

以前は、リソース・タイプでリソースをフィルタし、名前と外部IDでリソースを検索できました。 更新20C以降では、ユーザー・タイプでリソースをフィルタ処理し、ログインIDでリソースを検索することもできます。 その他の変更が可能になりました:

• グループを作成しなくても、管理、カレンダおよびマップ画面で組織単位またはバケットにナビゲートできます。
• カレンダ画面にスケジュールの名前を表示できます。
• 管理、カレンダおよびマップ画面で50を超えるリソースを管理できます。
• カスタム・アクティビティ・プロパティをリソース・ロケーションの移動キーとして使用できます。
• シングル・クリックで複数のリソースのユーザー・タイプを設定できます。

リソース画面で改善を使用する方法

リソース画面では、次の変更を使用できます:

• ユーザー・タイプによるリソースのフィルタ
• ログインIDによるリソースの検索
• シングル・クリックで複数のリソースのユーザー・タイプを設定

リソース画面で改善を使用するには、次の手順を実行します:

1. ハンバーガ・アイコンをクリックし、リソースをクリックします。 割り当てられている組織単位またはバケットに属するリソースが表示されます。
2. リソースをユーザー・タイプでフィルタするには、ユーザー・タイプ・チェック・ボックスを選択します。 一致するリソースが表示されます。
3. ログインIDでリソースを検索するには、検索フィールドにログインIDを入力します。 一致するリソースが表示されます。
4. 複数のリソースのユーザー・タイプを設定するには、必要なリソースのチェック・ボックスを選択します。 ユーザー・タイプの設定をクリックし、選択したすべてのリソースに割り当てるユーザー・タイプを選択します。 「適用」をクリックします。 ユーザー・タイプの設定グループ処理は、管理者がリソース・コンテキストのレイアウト構造に追加した場合にのみここに表示されます。 ユーザーのユーザー・タイプを変更すると、ユーザーが表示できる画面とそれらの画面に対する権限が異なる場合があることに注意してください。 このスクリーンショットは、リソース画面のユーザー・タイプによるリソースのフィルタ・セクションを示しています:

このスクリーンショットは、リソース画面で複数のリソースのユーザー・タイプを設定するための「ユーザー・タイプの設定」画面を示しています:

改善された管理、カレンダおよびマップ画面での使用方法

これらの変更は、管理、カレンダおよびマップ画面で使用できます:

• グループを作成しなくても、管理、カレンダおよびマップ画面で組織単位またはバケットにナビゲートできます。
• 管理、カレンダおよびマップ画面で50を超えるリソースを管理できます。
• カレンダ画面にスケジュールの名前を表示できます。

組織単位またはバケットにナビゲートする手順は、次のとおりです:

1. 管理、カレンダまたはマップ画面に移動します。
2. 現在表示されているグループ名をクリックします。
3. リソース・セクションに移動し、リソースをクリックします。
4. リソースの選択画面で、詳細を表示する組織単位またはバケットを選択します。 選択できるリソースは、組織単位または(現在ログインしているユーザーが)アクセス権を持つバケットのみです。 新しく選択したリソースがリストの最初に表示されます。 表示した最後の5つの組織単位またはバケットがリストに保存されます。 これらは、次回ログインするまで表示されます。 このスクリーンショットは、リソース画面で組織単位に基づいてリソースをフィルタする方法を示しています:

このスクリーンショットは、リソース画面で組織単位を選択する方法を示しています:

50を超えるリソースを管理する手順は、次のとおりです:

1. 管理、カレンダまたはマップ画面に移動します。
2. 現在表示されているグループ名をクリックします。
3. リソース・セクションに移動し、リソースをクリックします。
4. グループ内に50を超えるリソースが存在する場合は、スクロールしてリソース数を制限せずに探しているリソースを表示および検索できます。

カレンダ画面にスケジュールの名前を表示する手順は、次のとおりです:

1. ハンバーガ・アイコンをクリックし、カレンダをクリックします。
2. 任意の日のタイトルをクリックし、スケジュール名の表示を選択します。 現在表示しているすべての日について、スケジュールの名前が表示されます。 このスクリーンショットは、カレンダ画面のスケジュール名の表示オプションを示しています:

ノート: この設定は、ユーザー・ログイン時に保持されます。

カスタム・アクティビティ・プロパティをリソース・ロケーションの移動キーとして使用する手順は、次のとおりです:

1. アクティビティ・エンティティの任意のタイプ(ファイルおよびイメージを除く)のカスタム・アクティビティ・プロパティを作成します。
2. 統計画面のアクティビティ移動統計フィールドにカスタム・プロパティを追加します。
3. 移動統計を収集するアクティビティ・タイプの移動の計算チェック・ボックスを選択します。
4. 「リソース情報」画面に移動し、ロケーションをクリックします。
5. 「リソース・ロケーション」セクションでプラス記号をクリックします。 ステップ1で追加したカスタム・プロパティが表示されます。
6. カスタム・プロパティの値を入力し、発行をクリックします。

このスクリーンショットは、統計画面に追加されたカスタム・アクティビティ・プロパティを示しています:

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

ワーク・ゾーンの視覚化の改善

リソース・ワーク・ゾーンの検索-新規コンテンツ

更新20Cから、コア・アプリケーションの「リソース・ワーク・ゾーン」画面でリソースを検索できるようになり、アクティブなワーク・ゾーンおよび削除されたワーク・ゾーンを見つけやすくなりました。 一時ワーク・ゾーンは特別なカレンダ・アイコンを使用して視覚的に表示され、リソースに割り当てられた各ワーク・ゾーンの下に繰返し詳細が表示されます。

ワーク・ゾーンを検索するには:

1. 管理、ディスパッチ・コンソールまたはリソース画面から「リソース情報」画面を開きます。
2. スタック・アイコンをクリックし、ワーク・ゾーンをクリックします。
3. 検索ボックスに、検索するワーク・ゾーンを入力します。 一致するワーク・ゾーンのリストが表示されます。 このリストには、次のスクリーンショットに示すように、カレンダ・アイコン付きの一時ワーク・ゾーンと、割当日の下の繰返し詳細が表示されます:

次の表に示すように、ワーク・ゾーンの繰返しルールが表示されます:

繰返し	条件	メッセージ
日次	発生間隔日数 = 1	メッセージは表示されません
日次	発生間隔日数= 3	3日ごとに繰り返す
毎週月曜日、火曜日、水曜日、金曜日	発生間隔の週数= 1	毎週月曜日、金曜日に繰り返す
毎週月曜日、火曜日、水曜日、金曜日	発生間隔の週数= 2	月曜日～金曜日の2週間ごとに繰り返す

コア・アプリケーション・ガイドの変更点

追加: ディスパッチャ・アクティビティの章/リソース・セクションでワーク・ゾーン・トピックを検索する手順は、次のとおりです。

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

コア・アプリケーションでのアクセス・スケジュールの更新

以前は、「アクセス・スケジュール」フィールドを読取り専用フィールドとしてコア・アプリケーションに追加できました。 更新20C以降では、これらのフィールドを編集できます。 「アクセス・スケジュール」フィールドには、アクセス・スケジュール・フィールドと「アクセス時間」フィールドがあります。 「アクセス時間」フィールドは自動計算されます。 未スケジュール・アクティビティまたはオフライン・モード(あるいはその両方)の場合、アクセス時間は空にできます。 オンラインになり、スケジュール済アクティビティのアクセス・スケジュールの変更が移入されるとすぐに、アクセス時間データが表示されます。

「アクセス・スケジュール」フィールドを画面に追加するには、次のステップを実行します:

1. 構成、ユーザー・タイプの順にクリックします。
2. 「アクセス・スケジュール」フィールドを追加するユーザー・タイプをクリックします。
3. 「画面」構成をクリックします。 「アプリケーション」画面で、フィールドを追加する画面を見つけてクリックします。
4. 新規要素セクションから、入力要素をビジュアル・フォーム・エディタの必要な位置にドラッグ・アンド・ドロップします。
5. 要素をクリックし、アクティビティ・フィールドのドロップダウン・リストで鉛筆アイコンをクリックします。
6. アクセス・スケジュール[access_schedule]を選択し、OKをクリックします。
7. 翻訳と表示を追加します。
8. ステップ4からステップ7を繰り返して、アクセス時間[access_hours]フィールドを追加します。
9. 「保存」をクリックします。 アクセス・スケジュールは読取り専用モードおよび読取り/書込みモードで追加できますが、アクセス時間は読取り専用としてのみ追加できます。 ほとんどのコンテキスト(アクティビティ関連の画面、リストおよびヒントを含む、アクティビティ詳細のみを除く)では、「アクセス・スケジュール」フィールドにアクセス時間も含まれます(計算されている場合)。

このスクリーンショットは、ビジュアル・フォーム・エディタに追加される「アクセス・スケジュール」フィールドを示しています:

「アクセス・スケジュール」フィールドを編集する手順は、次のとおりです:

1. アクセス・スケジュール詳細を編集するアクティビティのアクティビティ詳細画面を開きます。
2. 「アクセス・スケジュール」フィールドの横にある鉛筆アイコンをクリックします。
3. アクセス・スケジュールを編集する曜日を選択または選択解除します。 プラス(+)またはマイナス(-)アイコンを使用して、アクセス・スケジュール間隔を追加または削除します。 1週間あたり最大2つのアクセス・スケジュール間隔を設定できます。 複数の曜日に同じアクセス・スケジュールが設定されている場合は、すべての曜日のアクセス・スケジュール間隔を一度に設定できます。 このスクリーンショットは、アクティビティ詳細画面の「アクセス・スケジュール」フィールドを示しています:

4. アセットにアクセスできない日を編集するには、「例外日数」セクションのプラス記号をクリックし、カレンダで日付を選択します。 例外日を削除するには、マイナス記号アイコンを使用します。

例: 次のアクセス・スケジュールを設定できます:

月-金 : 午前11:00から午後2:30

土、日 : 午後4:30から午後8:30

例外: 7/2/2020

このスクリーンショットは、アクティビティに追加されたアクセス・スケジュールの詳細を示しています:

つまり、アセットには、月曜日から金曜日の午前11時から午後2時30分、土曜日および日曜日の午後4時30分から午後8時30分までアクセスできます。 非稼働日は7月4日です。

5. 「適用」をクリックします。

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

コア・アプリケーションでのリソース履歴の表示

以前は、リソース履歴はレガシー管理でのみ使用可能でした。 更新20C以降では、コア・アプリケーションでリソース履歴を表示、フィルタ、ソートおよびエクスポートできます。 このためには、リソース履歴アイテムをリソース履歴コンテキスト・レイアウトに追加する必要があります。

「リソース情報」画面にリソース履歴を追加する手順は、次のとおりです:

1. 構成、ユーザー・タイプの順にクリックします。
2. 「リソース履歴」オプションを追加するユーザー・タイプを選択します。
3. 画面構成をクリックします。
4. 「アプリケーション」画面で、リソース/ユーザー情報を見つけてクリックします。
5. クリックして追加ボタンをクリックします。
6. 「リソース履歴」を選択し、OKをクリックします。
7. 新規可視性の追加をクリックし、「保存」をクリックします。 このスクリーンショットは、リソース情報のコンテキスト・レイアウトを示しています:

リソース履歴を表示する手順は、次のとおりです:

1. 管理、ディスパッチ・コンソールまたはリソース画面から「リソース情報」画面を開きます。
2. スタック・アイコンをクリックし、リソース履歴をクリックします。 「リソース履歴」画面には、アクション、値、アクション時間およびユーザー列が表示されます。
3. アクション、アクション時間またはユーザー列をクリックして、履歴をフィルタおよびソートします。
4. エクスポートをクリックして、履歴をカンマ区切り値(.CSV)ファイルにエクスポートします。

このスクリーンショットは、「リソース履歴」画面を示しています:

次のスクリーンショットは、アクション、アクション時間およびユーザー列のフィルタを示しています:

この機能を使用すると、次のスクリーンショットに示すように、「アクティビティ履歴」画面も「リソース履歴」画面と同じルック・アンド・フィールで更新されます:

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• Oracle Field Serviceの管理
• コア・アプリケーションの使用

セグメント化可能なアクティビティとセグメント化可能なアクティビティのリンク

更新20C以降では、通常のアクティビティをセグメント化可能なアクティビティにリンクするために使用するのと同じリンク・タイプを使用して、セグメント化可能なアクティビティを別のセグメント化可能なアクティビティにリンクできます。

リンクされたセグメント化可能なアクティビティをルーティングする手順は、次のとおりです:

• セグメント化可能なアクティビティがフィルタに適合する複数日ルーティング・プランを実行します。
• スケジュールされた時間に実行されている一括ルーティング・プランを設定して、ルーティングするすべてのリンク可能なセグメント化可能なアクティビティをカバーします。

ノート: 一括ルーティングのみが、リンクされたセグメント化可能なアクティビティのルーティングをサポートします。 即時ルーティングでは、リンクがあるすべてのセグメント可能なアクティビティが無視されます。

サポートされているリンク・タイプおよび制約

セグメント化可能なアクティビティ間のリンクでサポートされているリンク・タイプと制約を次に示します:

• 「同時」  (セグメント化可能なアクティビティ): 使用可能な制約はありません
• セグメント化可能なアクティビティ終了からセグメント化可能なアクティビティ開始:
  • 同日 : 後者のアクティビティの最早(カレンダ時点)セグメントは、前者のアクティビティの最早 (カレンダ時点)セグメントが終了する日と同じ日に開始する必要があります。
  • 前のアクティビティの任意のセグメントに参加した同じプロバイダ : 後者のアクティビティのすべてのセグメントは、同じリソースによって実行される必要があります。
  • 異なるプロバイダ: 後者のアクティビティのすべてのセグメントは、前のアクティビティの任意のセグメントに参加していたものとは異なるリソースによって実行される必要があります。
• セグメント化可能なアクティビティ開始からセグメント化可能なアクティビティ開始:
  • 異なるプロバイダ: 後者のアクティビティのすべてのセグメントは、前者のアクティビティのいずれかのセグメントに参加したそれら以外の異なるリソースにより実行される必要があります。
  • サポートされていないアクティビティ・リンク・タイプまたは制約(あるいはその両方)を追加しようとすると、警告が表示され、リンクは追加されません。
• 通常のアクティビティ開始にリンクされたセグメント化可能なアクティビティ開始 (またはその逆):
  • 異なるプロバイダ: 後者のアクティビティのすべてのセグメントは、前者のアクティビティのいずれかのセグメントに参加したそれら以外の異なるリソースにより実行される必要があります。

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• コア・アプリケーションの使用

コア管理

レガシー管理通知の削除

以前は、「ユーザー・タイプ」画面の一般タブのアクセス設定セクションにあるディスパッチ操作にレガシー管理を使用設定は非推奨になりました。 更新20C以降、この削除およびサポート通知は画面構成タブの「レガシー管理」セクションに表示されます:

これらの画面構成は非推奨になり、20C更新ではサポートされなくなります。 この構成セクションは、今後の20D四半期更新で削除されます。 「レガシー管理」画面構成をアプリケーション画面に移行してください。

このセクションでコンテキスト・レイアウトを編集しようとすると、削除およびサポート通知の警告が表示されます:

「レガシー管理」画面は非推奨であり、今後の20D四半期更新で削除されます。 20C更新では、「レガシー管理」画面および画面構成はサポートされなくなりました。 対応するアプリケーション画面を更新または構成してください。 レガシー管理レイアウトを実行しますか?

削除およびサポート通知

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• Oracle Field Serviceの管理

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

プラグインAPIコンテキストの削除

以前は、ユーザー・タイプ→画面構成画面の「プラグインAPI」セクションを使用したプロパティの構成は非推奨になりました。 更新20C以降、プラグインAPIを使用するプラグインがあり、フォーム＆プラグイン画面の使用可能なプロパティ・セクションを使用するようにプラグインをまだ構成していない場合、プラグインは自動的に更新されます。

プラグインAPIを介してプラグインで使用可能なプロパティのリストは、ユーザー・タイプ→画面構成画面のプラグインAPIレイアウトではなく、フォーム＆プラグインの使用可能なプロパティ・セクションで定義されます。

少なくとも1つのユーザー・タイプのプラグインAPIレイアウト(モビリティのアクティビティ・プロパティ、モビリティの在庫プロパティ、モビリティのリソース・プロパティなど)に存在するすべてのプロパティが、フォーム＆プラグインの使用可能プロパティのリストに追加されます。 例外は次のプロパティで、使用可能プロパティのリストには追加できません:

• activity_alerts
• access_hours
• activity_compliance
• atravelarea
• travel_estimation_method
• service_window_end
• service_window_start
• eta_end_time
• pid (リソース・エンティティでは引き続き使用可能)

任意のユーザー・タイプのプラグインで使用可能なプロパティは、これらのユーザー・タイプで使用されていない場合でも、そのようなすべてのプラグインで使用可能になります。 ユーザー・タイプごとに異なるデータを表示するようにプラグインのレイアウトを構成した場合は、プラグインをクローニングして手動で構成する必要があります。

フォーム＆プラグイン画面の変更点

これらのプロパティをフォーム＆プラグイン画面の使用可能プロパティのリストに追加できるようになりました:

• access_schedule
• acoord_accuracy
• activity_capacity_categories
• apoints
• auto_routed_to_date
• auto_routed_to_provider_id
• aworkzone
• date
• time_delivered

プラグインAPIの変更点

これらのプロパティを読取り専用として使用可能プロパティのリストに追加できるようになりました。これは、プラグインAPIを介して更新できないことを意味します:

• activity_capacity_categories
• auto_routed_to_date
• auto_routed_to_provider_id
• aworkzone
• date
• time_delivered

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• モバイル・プラグイン・フレームワーク

プラグインAPIでのユーザーおよびチーム・データの送信

以前は、プラグインがメイン・メニューから開かれた場合にのみ、ユーザー・フィールドをカスタム・プラグインに送信できました。 更新20C以降では、プラグインを開く画面に関係なく、カスタム・プラグインにユーザー・フィールドを送信できます。 これで、'open'メソッドのレスポンスが拡張され、'user'および'team'アイテムに現在のユーザーおよびチーム作業(ある場合)に関する情報が含まれるようになりました。

Openメソッドのレスポンスには、現在のユーザーに参照されるリソースを表すmain_resource_idフィールドで拡張されたuserアイテムが含まれます。 同様に、'open'メソッドのレスポンスは、チーム作業に関する情報を含む'team'アイテムで拡張されます。 現在のリソースに関する次の情報で構成されます:

• 現在のリソースを支援するリソース。
• 現在のリソースが支援しているリソース。
• 現在のリソースが支援しているリソースも支援しているその他のリソース。

'ready'メソッドの'dataItems'オプションは、'team'アイテムの可用性を制御します。

プラグインがメイン・メニューから開いている場合、チーム・アイテムは送信されません。

Openメソッドのレスポンスは、使用可能な場合、アクティビティ・リストおよび在庫リストで拡張されます。

チーム作業が設定されていない場合のチーム・コレクションの構造

チーム作業が設定されていない場合のopenメソッドのteamコレクションの構造:

"team": {

"assistingTo": {},

"assistingMe": [],

"teamMembers": {}

}

チーム作業設定時のチーム・コレクションの構造

チーム作業が設定されている場合のopenメソッドのteamコレクションの構造:

"team": {

"assistingTo": { - 支援しているリソースのリストを持つオブジェクト

"3000001": [ - 支援しているユーザーを支援している追加リソースのリストを含む配列(現在のユーザー3000035はこのリストにありません。)

"3000008", - リソース3000001を支援するリソースID

"3000037"

],

"3000015": []

}

"assistingMe": [ - 自分を支援しているリソースのリストを含む配列

"3000003", - 自分を支援しているリソースID

"3000008"

]

"teamMembers": { - すべてのチーム・メンバーの情報を含むオブジェクト

"3000001": {

"uid": 1000001, - リソースはこのユーザーIDのメイン・リソースです

"external_id": "resource_1", - リソース外部ID

"pname": "Resource 1", - リソース名

},

"3000003": {

"uid": 1000003,

"external_id": "resource_13",

"pname": "Resource 3"

},

"3000008": {

"uid": 1000008,

"external_id": "resource_8",

"pname": "Resource 8"

},

"3000015": {

"uid": 1000015,

"external_id": "resource_15",

"pname": "Resource 15"

},

"3000037": {

"uid": 1000037,

"external_id": "resource_37",

"pname": "Resource 37"

}

}

}

'dataItems'オプションで使用可能なキーおよびデータ・サブセットの変更

次の表に、'dataItems'オプションで使用可能なキーおよびデータ・サブセットを示します:

キー	影響を受けるコレクション	説明
team (新規)	team (新規)	現在のリソースが支援しているアシスタントおよびリソースに関する情報(新規)
リソース	リソース	現在選択されているリソースのプロパティ
scheduledActivities	activityList	選択した日付にスケジュールされた(キューに属する)アクティビティ
nonScheduledActivities	activityList	日付キューに属していない未スケジュール・アクティビティ
resourceInventories	inventoryList	"provider"プールの在庫
installedInventories	inventoryList	"install"プールの在庫
deinstalledInventories	inventoryList	"deinstall"プールの在庫
customerInventories	inventoryList	"customer"プールの在庫

使用可能なエンティティおよびデータ・コレクションの変更

画面	エンティティ・フィールド値	選択可能コレクション
メイン・メニュー	user	user
アクティビティ・リスト	activitiyList	ユーザー(新規) team (新規) リソース activitiyList inventoryList
アクティビティ・リスト ->在庫リスト	inventoryList
アクティビティ・リスト ->アクティビティ詳細	アクティビティ	ユーザー(新規) team (新規) リソース activitiyList (新規) アクティビティ inventoryList
アクティビティ・リスト ->アクティビティ詳細 ->在庫リスト	activityInventoryList
アクティビティ・リスト ->在庫リスト ->在庫詳細	inventory	ユーザー(新規) team (新規) リソース activitiyList inventoryList (新規) inventory
アクティビティ・リスト ->アクティビティ詳細 ->在庫リスト ->在庫詳細	activityInventory	ユーザー(新規) team (新規) リソース activitiyList (新規) アクティビティ inventoryList (新規) inventory
在庫検索 ->部品カタログ品目詳細	partsCatalogItem	ユーザー(新規) team (新規) リソース activitiyList inventoryList partsCatalogItem

エンティティ・データ・コレクションへの変更の適用順序

プラグインが次のようないくつかのコレクションを送信する場合: : 'close'メソッドの'activityList'、'activity'、'inventoryList'および' inventory'では、アプリケーションは次の順序で変更を適用しようとします:

1. 'activityList'
2. 'activity'
3. 'inventoryList'
4. 'inventory'

プラグインが'activityList'および'activity'エンティティ・データ・コレクションで同じアクティビティ変更を受信すると、'activity'エンティティ・データ・コレクションからの変更のみが適用されます。 'activityList'エンティティ・データ・コレクションからの変更は無視されます。 ただし、'activity'エンティティ・データ収集がプラグインに送信されない場合は、'activityList'の現在のアクティビティを変更できます。

例

{

"apiVersion": 1,

"method": "close",

"backScreen": "default",

"wakeupNeeded": false、

"activity": {

"aid": "8761055",

"ACTIVITY_NOTES": "new changes 1" <---この変更が適用されます

},

"activityList": {

"8761054": {

"ACTIVITY_NOTES": "another activity"

},

"8761055": {

"ACTIVITY_NOTES": "new changes 2" <---この変更は適用されず、無視されます

}

}

}

プラグインがinventoryListおよび在庫エンティティ・データ収集で同じアクティビティ変更を受信すると、在庫エンティティ・データ収集からの変更のみが適用されます。 inventoryListエンティティ・データ・コレクションからの変更は無視されます。 ただし、在庫エンティティ・データ収集がプラグインに送信されない場合は、inventoryListの現在の在庫を変更できます。

例

{

"apiVersion": 1,

"method": "close",

"backScreen": "default",

"wakeupNeeded": false、

"inventory": {

"invid": "1055",

"INVENTORY_NOTES": "new changes 1" <---この変更が適用されます

},

"inventoryList": {

"1054": {

"INVENTORY_NOTES": "another inventory"

},

"1055": {

"INVENTORY_NOTES": "new changes 2" <---この変更は適用されず、無視されます

}

}

}

エンティティ・データ・コレクションの変更

• (新規) team: 現在のリソースを支援しているアシスタントおよびリソースに関する情報
• resource: 定義済会社アセットを表すリソース・ツリーのエレメント
• activity: リソースの時間のかかるアクティビティを表すOracle Field Serviceのエンティティ
• activityList: アクティビティ・リスト
• inventory: アクティビティ中に取付けまたは取外し可能な機材
• inventoryList: 在庫リスト
• user: 現在Oracle Field Serviceにログインしており、プラグインを開くことができるユーザー
• partsCatalogItem: getPartsプロシージャを介して取得できるように、部品カタログ品目を識別する情報

ノート: 'team' (新規)、'resource'、'user'および'partsCatalogItem'コレクションはプラグインAPIを介して更新できません。 'close'メッセージとともに送信された場合、Oracle Field Serviceはそれらを無視します。

エンティティの使用可能なプロパティのリストの変更

エンティティで使用可能なプロパティのリストは事前定義されており、plug-in.rの構成に依存しません。

フィールド	タイプ	値の例	説明
uid	数値	2315	ユーザーの内部ID
ulogin	文字列	admin	ログイン
uname	文字列	管理	Name
フォーマット	Object<String, String>	{      "date": "m/d/y",      "long_date": "l, F jS, Y",      "time": "h:i A",      "datetime": "m/d/y h:i A" }	PHPスタイルの日付書式文字列のコレクション
su_zid	数値	2	タイムゾーンID
week_start	数値	0	週の開始日(0-6)。0 - 日曜日、1 - 月曜日
ulanguage	数値	1	言語ID (1 - 英語)
design_theme	数値	1	デザイン・テーマID
allow_vibration	数値	0	1 - モバイル・デバイスでの振動が許可されます, 0 - 禁止
allow_desktop_notifications	数値	0	1 - ブラウザ・デスクトップ通知が許可される, 0 - 禁止
sound_theme	数値	0	サウンド通知の設定、0 - オフ、1 - 小さい、2 - 大きい、3 - 持続的
providers	配列<Number>	[ 38, 3000001 ]	子孫を除く、ユーザーに表示されるリソースのリスト
main_resource_id (optional) (new)	数値(新規)	1111 (new)	メイン・リソースとして設定されているリソースID (新規)

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• モバイル・プラグイン・フレームワーク

ルーティング

ルーティング・レポートの改善

更新20Cでは、ルーティング結果を分析する機能が改善されました。 内容は次のとおりです:

実行サマリーの変更

• ルーティング実行IDが追加列として実行サマリー表に追加されました
• ページ区切り、ソートおよびフィルタ処理を含むように実行サマリー表が再設計されました

ルーティング・レポートの変更

• ルーティング・レポート・ウィンドウは、デフォルトで全画面モードで最大表示に表示されます。
• ルーティング・レポート表は、ページ区切り、ソートおよびフィルタ処理を含むように再設計されました
• ルーティング・レポートは、追加の分析のためにXML、CSVまたはExcel形式でダウンロードできます
• 標準リソースおよびアクティビティのヒントがルーティング・レポートに追加されました

特定のルーティング実行の結果にアクセスするには、実行サマリー・ウィジェットを開きます。 次の表に、特定の日付のすべてのルーティング・プラン実行のリストが表示される場合があります。

必要なルーティング実行を選択するには、表をソートします。 表をソートするには、任意の列の列ヘッダー(時間や実行IDなど)をクリックします。ソート順序(ASCまたはDESC)を選択するには、列ヘッダーの横にある三角形をクリックします。 次の列はソート可能です:

• 実行ID
• 時間
• バケット名
• プラン名
• ユーザー名
• アクティビティ
• リソース
• ステータス

ルーティング実行の数が大きすぎて単一のページに収まらない場合(20を超える場合など)、リストの下部にあるページングを使用して別のページに切り替えることができます。

フィルタリングを使用してリストを絞り込むこともできます。 リストのフィルタに使用するコンテンツ(3つ以上の記号)の入力を開始するだけで、入力すると、1つ以上の列のコンテンツにフィルタリング記号が含まれるレコードのみが表示されます。 次のいずれかのフィールドにフィルタ条件となる文字列が含まれている場合は、レコード全体が表示されます:

• 実行ID
• バケット名
• プラン名
• ユーザー名

ルーティング実行の結果にアクセスするには、サマリー・ウィンドウをオープンするために必要なルーティング実行に属する明細をクリックします。

特定のルーティング結果へのアクセス

次のステップを実行します。

1. 「実行サマリー」タブをクリックします。

実行サマリー表には、特定の日付のすべてのルーティング・プラン実行のリストが表示されます。

実行サマリー画面

2. 列ヘッダーをクリックし、列ヘッダーの横にある三角形をクリックしてソート順序(ASCまたはDESC)を選択します。 これらの列をソートできます:

• 実行ID
• 時間
• バケット
• ルーティング・プラン
• ユーザー
• アクティビティ
• リソース
• ステータス

3. ルーティング実行を選択します。

既存のページにルーティング実行がリストされていない場合、別のページに切り替えることができます。 ルーティング実行の数が多い場合は、検索結果が複数のページにわたって実行される可能性があります。

フィルタリングを使用してリストを絞り込みます。 コンテンツの入力を開始してリストをフィルタすると、1つ以上の列のフィルタリング記号に一致するレコードのみが表示されます。

フィルタ結果が表示されたルーティング・レポート

これらのフィールドの少なくとも1つにフィルタする文字列が含まれている場合は、レコード全体を表示できます:

• 実行ID
• バケット名
• プラン名
• ユーザー名

4. ルーティング実行の行をクリックしてサマリー・ウィンドウをオープンし、そのルーティング実行の結果にアクセスします。

ルーティング・サマリー画面

有効化のステップ

この機能を有効にするために何もする必要はありません。

主なリソース

• レポートの構成および使用

重要なアクションと考慮事項

非推奨と削除

1. Activity Management、Resource Management、HISTORYおよびSmart Location SOAP APIは、20C (2020年8月)更新で削除されます。 まだREST APIに移行していない場合は、現在と2020年7月の間に移行することをお薦めします。

2. コア管理は20D (November 2020) Updateで削除されます。 コア・アプリケーションへの移行の準備として、構成内のユーザー・タイプごとにアプリケーション画面の構成を開始することを強くお薦めします。 これにより、20D (2020年11月)更新を使用して「レガシー・コア管理」画面を削除する準備が整います。

3. サーベイ機能は、20C (2020年8月)更新で削除されます。

4. Oracle Field Service APIへのアクセスに使用するhttps://api.etadirect.com URLスキームは非推奨であり、次回のOCIデータ・センター移行の一部として削除されています。 OCIの移行前に、URLを変更する必要があります。 現在の統合を確認および変更し、必要に応じてURLを変更して、https://<instance_name>.etadirect.comを使用します。 インスタンス名は、OFSアプリケーションの構成→バージョン情報画面で確認できます。 または、サービス・コンソールに表示される代替インスタンス名を使用できます。 まずTESTで変更を行い、その変更を本番インスタンスに適用することをお薦めします。