作業指示書フォームのカスタマイズに関する考慮事項
この記事では、Dynamics 365 Field Service で作業指示書フォームをカスタマイズする際の一般的な考慮事項を示します。
作業指示書サブグリッドをポップアップ形式で開く
作業指示書のサブフォームをダイアログ ボックスとしてポップアウトし、作業指示書フォームを離れることなく編集できるように構成します。 この構成は、ディスパッチャーが作業指示書のコンテキストを維持するのに役立ちます。 管理者は、作業指示書サブグリッド レコードをポップアップ形式で開く設定エリアで設定します。 詳細については、その他の設定 を参照してください。
簡易作業指示書コマンドの表示
作業指示書は既定で簡易表示となり、関連性の高いコマンドのみが表示されます。 管理者は、簡略化された作業指示コマンドを表示 設定を向こうにして、すべてのコマンドを表示します。 詳細については、作業指示書 / 予約の設定 を参照してください。
コンテキストに関連するコマンドを表示するように コマンド バーをカスタマイズ することができます。
カスタム作業指示書のステータス
作業指示書のサブ状態の編集はできません。システム ジョブおよび プラグインがこれらの状態に依存しているためです。 代わりに、管理者は作業指示書のシステムのステータスに対応するカスタム作業指示サブステータスを作成できます。 詳細については、オプション セット (選択) 値は編集しないでください を参照してください。
Bing Maps を作業指示書フォームに追加する
Bing Maps コントロールを、すぐに使用できる作業指示書フォームから手動で削除した場合、元に戻すことはできません。
フォーム デザイナーで Bing Maps ボタンを有効にするには、アドレス タイプの属性の少なくとも 1 つでフォームにマスク ValidForMap が追加されている必要があります。
<DisplayMask>ValidForAdvancedFind\|ValidForForm\|ValidForGrid\|ValidForMap</DisplayMask>
Bing Maps コントロールを追加する必要のあるフォームを含む、サンドボックス環境でソリューションを作成します。 管理ソリューションとしてエクスポートします。
ソリューションの
customizations.xmlファイルで、formxml部分に移動します。次のマップ コントロールを
<controlDescriptions>に追加します。
<controlDescription forControl="{8b67ae03-1701-54d2-09be-35295876ca8a}">
<customControl id="{4273EDBD-AC1D-40d3-9FB2-095C621B552D}">
<parameters>
<datafieldname>msdyn\_mapcontrol</datafieldname>
</parameters>
</customControl>
<customControl formFactor="0" name="MscrmControls.Map.MapControl">
<parameters>
<value>msdyn\_mapcontrol</value>
<mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>
<latitude>msdyn\_latitude</latitude>
<longitude>msdyn\_longitude</longitude>
<addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>
<outputLatitude>msdyn\_latitude</outputLatitude>
<outputLongitude>msdyn\_longitude</outputLongitude>
</parameters>
</customControl>
<customControl formFactor="1" name="MscrmControls.Map.MapControl">
<parameters>
<value>msdyn\_mapcontrol</value>
<mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>
<latitude>msdyn\_latitude</latitude>
<longitude>msdyn\_longitude</longitude>
<addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>
<outputLatitude>msdyn\_latitude</outputLatitude>
<outputLongitude>msdyn\_longitude</outputLongitude>
</parameters>
</customControl>
<customControl formFactor="2" name="MscrmControls.Map.MapControl">
<parameters>
<value>msdyn\_mapcontrol</value>
<mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>
<latitude>msdyn\_latitude</latitude>
<longitude>msdyn\_longitude</longitude>
<addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>
<outputLatitude>msdyn\_latitude</outputLatitude>
<outputLongitude>msdyn\_longitude</outputLongitude>
</parameters>
</customControl>
</controlDescription>
同じファイルで "Bing Maps" を検索します。
次のコードを持つコントロールを、追加する必要がある行とセルに追加します。
<control disabled="false" id="msdyn\_mapcontrol" classid="{F9A8A302-114E-466A-B582-6771B2AE0D92}" uniqueid="{8b67ae03-1701-54d2-09be-35295876ca8a}" datafieldname="msdyn\_mapcontrol"/>
ファイルを保存し、そこから新しい管理ソリューション zip ファイルを作成します。
対象の環境にソリューションをインポートします。
チップ
これらの手順を実行してもマップ コントロールがフォームに表示されない場合、アクティブなフォームのカスタマイズを削除してみてください。
新しい作業指示書の構成要素
新しい作業指示書エクスペリエンスでは、作成者がフォームで使用できるいくつかの新しいコンポーネントが導入されています。 次のセクションでは、これらのコード コントロールのオプションと制限事項を示します。 コード コントロールの操作の詳細については、開発者ドキュメントの Power Apps コード コントロール を参照してください。
チップ
フィールド レベルのセキュリティを構成して、ユーザーが目的のフィールドのみを更新できるようにします。 場合によっては、たとえばフォーム内のフィールドが読み取り専用に設定されている場合でも、ユーザーが一部のフィールドを更新する可能性があります。 ただし、ユーザーが適切なフィールド レベルのセキュリティを持っていない場合、システムは更新されたフォームを保存しません。
作業指示書のフォーム
フォームヘッダーとコマンドバー
- ヘッダー: 完全にカスタマイズ可能です。 作成者は Maker Portal に表示される情報を変更することができます。 セクションやタブを非表示にしたり、独自のカスタム タブを作成したりすることもできます。
- フォーム スイッチャー: 作成者は、セキュリティ ロールに基づいて、ユーザーが表示できるフォーム を制御できます。
- コマンド バー: 既定で簡略化されたコマンド バーを使用します。 管理者は、 簡素化された作業指示コマンドを表示する 設定をオフにできます。 カスタム追加したコマンドがなくなった場合は、Maker Portal にアクセスして再び表示できるようにすることができます
Copilot による作業指示書の要約
Field Service の Copilot を使用して、作業指示書と関連する予約 (タイムライン メモなど) を要約するコントロールです。
このコントロールは、既定およびカスタムの作業指示書フォームでは機能しますが、作業指示書以外のエンティティでは機能しません。
現在、Copilot はカスタム フィールドを集計できません。 既定のフィールドを要約するだけです。
作業指示書の状態
作業指示ステータスとサブステータスを選択するためのコントロールです。
- カスタム システム サブステータスを追加 できます。
- ステータス ドロップダウン コントロールは他のエンティティでも使用できますが、次の点に注意してください:
- アイコンはサポートされていません
- ステータス カラーはすべて紫です
Field Service はカスタム システム ステータスをサポートしていません。 追加した場合、ステータス アイコンは表示されません。 システム ステータスの色は変更できません。
作業指示書の重要度
作業指示の優先順位を設定するコントロールです。 これは、作業指示フォームと作業指示グリッドで機能します。
- カスタムの優先順位と色を追加できます。
- このコントロールは作業指示書フォームで使用できますが、作業指示書以外のエンティティでは機能しません。
タイムラインのカウント
タイムライン内のノートの数を表示するコントロールです。 番号を選択すると、フォームのタイムライン タブに移動します。
- このコントロールは、カスタム エンティティにタイムライン コントロールが含まれている場合でも、カスタム エンティティでは機能しません。
- このコントロールは、カスタムの作業指示書フォームをサポートします。
このコントロールをタイムライン コントロールと同じタブに配置すると、新しいノートを追加してもカウントは自動的に増加しません。 ページを更新して、更新された番号を確認してください。 作業指示エンティティのアクティビティとメモが無効になっている場合、カウントは常にゼロ (正確です) を示します。
場所カード
作業を完了する場所の場所と、利用可能な場合は機能する場所に関する情報を示すコントロールです。
- このコントロールは、カスタム作業指示書フォームでは機能しますが、作業指示書以外のエンティティでは機能しません。
既定のズーム レベルは現在固定されており、変更することはできません。 機能的なロケーション ピッカーは、最も子階層にあるエンティティのみを表示し、ビル > 階 > 部屋といった上位階層のパンくずを表示しません。
取引先担当者カード
サービスまたは請求先取引先企業の取引先担当者、および取引先担当者ごとに報告されたもの (使用可能な場合) を表示するコントロール。
- このコントロールは、カスタムの作業指示書フォームで機能します。 作業指示書以外のフォームに配置された場合、コントロールは 編集モード を入力しません。
取引先担当者は、取引先担当者ごとに報告された請求先の取引先企業の取引先担当者、サービス アカウントの取引先担当者にマッピングできます。 他の種類の取引先担当者では機能しません。 非接触フィールドを指している場合、検索は機能しません。
資産カード
プライマリ資産の資産と、作業指示書の製品、サービス、タスクを介して設定されたセカンダリ資産を表示するコントロールです。 コントロールは資産の子ノードをレンダリングします。
このコントロールは、カスタム作業指示書フォームに配置できますが、非作業指示エンティティでは機能しません。
コントロールが 3 列のフォーム レイアウトに配置されている場合、コントロールは狭いフォーム ファクターに適応するため、全画面の資産ビューを開くアイコンは読み込まれません。
予約カード
次のアクションに関する推奨事項を提供することで、サービス マネージャーが作業指示を確実に進める際に活用できるコントロールです。 スケジュールされていない作業指示の場合は予約の提案が表示され、スケジュールされている場合は予約の詳細が表示され、作業指示が完了すると概要が表示されます。
- このコントロールは、作業指示書以外のエンティティでは機能しません。
- この制御では、システム ステータス、サブステータス、およびプライマリ解像度のマッピングが正しく構成されている必要があります。 構成がされていない場合、コントロールの読み込みに失敗します。 具体的には、システム ステータスが正しい作業指示書のシステム ステータス フィールドにマップされていない場合です。
財務概要カード
作業指示書に関連する製品とサービスに基づいて、作業指示書のコストと価格を要約するコントロールです。
- このコントロールは、カスタムの作業指示書フォームで機能します。
コストと価格設定機能が有効化されている ことを確認し、このコントロール内のデータを表示します。 このコントロールには、作業指示書に設定されたものとは異なる NTE 近接値を設定できます。
製品とサービスのサブグリッド
作業指示書の製品とサービスを編集できるコントロールです。 推定および実際の期間と数量をインラインで更新し、ステータスを変更します。 フィールドの詳細な変更はサイド ペインで可能です。
- このコントロールは、カスタムの作業指示書フォームで機能します。 次の制限に注意してください。
- コントロールは作業指示書製品にバインドされています。 2 番目のエンティティをマップすることを選択できます:
- 作業指示書製品: サービス タブは空白です
- 作業指示サービス: 「製品」 タブは作業指示サービスにバインドされますが、タブは引き続きインターフェイス内の製品を参照します。
- このコントロールは、作業指示製品および作業指示サービスに依存しているため、作業指示エンティティでは機能しません。
製品/サービスステータスのカスタム値はサポートされていません。 製品またはサービスのタブを非表示にすることはできません。両方のタブにエンティティをマッピングする必要があります。
タスク サマリー カード
作業指示書のタスクを要約するコントロールです。
このコントロールは、カスタムの作業指示書フォームで機能します。
コントロールで使用されるビューに、完了率、推定期間、実際の期間フィールドが含まれていることを確認してください。
タスク サブグリッド
タスクを完了としてマークし、検査結果を入力するインライン アクションを使用して、作業指示書のタスクを管理できるコントロールです。 フィールドの詳細な変更はサイド ペインで可能です。
- このコントロールは、カスタムの作業指示書フォームで機能します
- このコントロールは、作業指示書以外のエンティティでは機能しません。
% completed フィールドがビューに表示されない場合、進行状況は表示されず、完了または未完了としてマークするアクションは機能しません。
参照 > ナレッジ記事カード
ナレッジ記事を表示し、作業指示書にリンクできるコントロールです。 このコントロールを使用すると、作業指示書から直接新しい記事を作成することもできます。
- このコントロールは、カスタムの作業指示書フォームで機能します。
- 作業指示書とナレッジ記事に強く依存しているため、作業指示書以外のエンティティでは機能しません。
参考資料 > ガイド カード
作業指示書のタスクにリンクされた Dynamics 365 Guides を要約するコントロールです。 Web からガイドをプレビューすることはできませんが、ガイドの名前と関連フォルダーを確認することはできます。
- このコントロールは、カスタム作業指示書フォームで使用できます。
- このコントロールは、作業指示サービス タスクと作業指示エンティティに強く依存しているため、作業指示以外のエンティティには使用できません。
参考資料 > メディアカード
タイムライン ノートに添付されたメディアのサムネイルを表示するコントロールです。
- このコントロールは、カスタムの作業指示書フォームで機能します。
- このコントロールは、エンティティでアクティビティとメモが有効になっており、タイムライン コントロールが存在する限り、カスタム エンティティに対して機能します。
作業指示書グリッド
グリッドとアクション バー
作業指示を表示および選択するためのコントロールです。 このコントロールを使用すると、優先度をインラインで編集し、サイド ペインでさらに編集を行うことができます。 システム ステータスは、システム ステータスとサブステータスを組み合わせたフィールドです。
このコントロールは、作業指示書以外のエンティティには適用できません
既知の問題と制限事項:
- このコントロールをサブグリッドに適用すると、ビュー セレクターは表示されません。 Maker Portal で選択されたビューのみが表示されます。
- 作業指示グリッドをカスタマイズした場合、ソリューション階層化ルールにより、新しいコントロールは表示されません。 コントロールを表示するには、まずそのようなカスタマイズを削除してください。
- 新しいグリッド エクスペリエンスは列のフィルター処理をサポートしていません。 読み取り専用グリッド に変更して列をフィルタリングします。
- 新しいグリッド コントロールを環境から削除すると、再度インストールすることはできません。 ご不明点に付いてはサポートにご連絡ください。
- 予約済みリソース 列 (msdyn_bookingsummary) は、新しい作業指示エクスペリエンスでのみ機能します。 クラシック グリッド ビューではサポートされていません。
コンテキスト メニュー
作業指示を選択して迅速なアクションを実行する場合のインライン メニューです。
- このコントロールは、作業指示エンティティで使用できます。
- コンテキスト メニューのオプションは、作業指示書のステータスに応じて変化します。
コンテキスト メニューの項目は変更できません。
サイド ペイン
作業指示フォームからさらに編集するためにインラインでロードできるフォームが複数あります。
- 作業指示書: 作業指示書ライト フォームを変更することで、サイド ペインに表示される情報を編集できます。
- 資産: 顧客資産 - シンプル フォームを変更することで、サイド ペインに表示される情報を編集できます。
次のサイド ペインは、完全なレコードを開いた場合と同じフォームをレンダリングします:
- 製品: 作業指示書の製品
- サービス: 作業指示書のサービス
- タスク: 作業指示書のサービス タスク
一度に開くことができるのは片側のみです。 ペインの幅を変更することはできません。