フォームPDFファイル生成

多くの企業では、作業の証明として印刷可能なPDFファイルを必要とします。これらのドキュメントは、検査結果、報告情報、購入した追加サービスなどを示す必要なドキュメントをエンド・カスタマに提供します。アセット・ベースの管理フローの一環として、PDFファイルを使用すると、クライアントはアセットに対して実行されたアクションを追跡し、監査機能を強化できます。
25Cリリース以降、Oracle Fusion Field Serviceでは、モバイル・ワーカーによって取得されたデータをPDFファイルに自動的に変換し、最終宛先にアップロードしたり、最終顧客に直接提供するフル・サイクル・フローが導入されました。

仕組みは?

この機能の主要なワークフローは次のとおりです:

自動PDF生成

モバイル・ワーカーは、iOSまたはAndroidアプリでフォームを記入します。
この情報に基づいて、PDFファイルが自動的に作成されます。
生成されたPDFが、Fusionの関連作業オーダーに追加されるか、OCI Object Storageにアップロードされます。

ノート: FusionまたはOCIへのファイルの添付は、iOSまたはAndroidインストール済アプリケーションを使用する場合にのみ使用できます。

オンデマンドPDF生成

モバイル・ワーカーがフォームに記入して送信します。
ストレージにアップロードする必要のないPDFファイルはオンデマンドで生成により、即時の可用性を確保します。

ノート: 構成設定は、PDFをストレージにアップロードするか、すぐに生成するかどうかを制御します。

PDFファイルの印刷および共有

現場のモバイル・ワーカーは、アクティビティのロケーションで完了したフォームのハード・コピーを顧客に簡単に提供できるようになりました。インストールされているiOSおよびAndroidアプリを使用すると、モバイル・ワーカーは次のことができます:

印刷: ローカル・プリンタに接続し、物理コピーを生成します。
共有: 電子メールまたはデバイスにインストールされている他のアプリを介してPDFを送信します。

「印刷」および「共有」オプションは、「フォーム履歴」ページおよび特定の送信済フォームを表示するとき(PDF生成をサポートするフォームの場合)の両方で使用できます。

送信済フォームのリスト(「フォーム履歴」ページ)

送信されたフォーム
特定のフォームが送信されます。

フォームが送信されました - 資産検証

ブラウザ・ユーザーの場合: PDF形式のフォームは、ブラウザから直接印刷できます。 「印刷」ボタンは、「フォーム履歴」ページおよび個々の送信済フォームで使用できるようになりました。

次の表に、アプリケーションにマップされた印刷および共有関数を示します:

印刷と共有

適用	印刷	共有
iOSアプリ	はい	はい
Androidアプリ	はい	はい
ブラウザ	はい	いいえ

印刷および共有用のストレージからPDFをダウンロード

オンライン: ネットワークに接続すると、FusionアタッチメントまたはOCIオブジェクト・ストレージからPDFファイルがダウンロードされるため、印刷または共有できます。
オフライン: ネットワーク接続がない場合、インストールされているアプリケーションとブラウザ・アプリケーションの両方に、オフラインのためPDFファイルをダウンロードまたは準備できないことを示す通知が表示されます。

オンデマンドPDF生成

オンデマンドでPDFを生成するように構成されたフォームの場合、ファイルはインストールされているアプリケーションまたはブラウザの埋込み機能を使用して生成されます。この機能は、オンライン・モードとオフライン・モードの両方で使用できます。

さらに、インストールされているアプリケーションまたはブラウザは、次の場合に、組込み機能を使用してPDFファイルを生成します:

PDFがストレージにアップロードされましたが、インターネット接続は使用できません。
フォームはオンデマンドでPDFを生成するように構成されました。

PDFファイルのレイアウトと視覚化

Oracle Fusion Field Serviceでは、電子完了フォーム・ビューとは異なる印刷可能なPDFを生成して、情報を論理的に表示し、適切なブランディングを適用できます。これらのPDFは、ブランディング、レイアウト、およびPDFに含める必要があるデータを定義する顧客設計テンプレートから生成されます。

PDFファイル名

PDFファイル名は、次のパラメータを使用して自動的に生成されます:

フォーム名: 送信済フォームの名前。
投稿者: フォームを送信したユーザーの名前。
提出日時: フォームが送信された日時(ユーザーのプリファレンスに従って書式設定されます)。
添付ID: 添付の一意の数値識別子。

たとえば、2025年2月26日午後5時15分に「検査」フォームがユーザー「William」によって送信され、ユーザーが構成した日付書式が「mm/dd/yy」であるとします次のPDFファイル名が生成されます: 'Inspection-William-02260515-15'.

特殊文字の処理

特殊文字の処理は、オペレーティング・システム、ブラウザおよびストレージごとに固有です。 Oracleでは、オペレーティング・システム、ブラウザおよびストレージの様々な組合せがサポートされるため、PDFファイル名で使用できる特殊文字を大幅に制限します。これは、ファイルを常に生成して宛先にアップロードできるようにするために必要です。

現在、ラテン記号a-z、A-Z、数字0-9のみ - (ハイフン)および_ (アンダースコア)は、PDFファイル名で使用できます。その他の文字はすべて削除されます。

たとえば、2025年2月26日の午後5時15分にユーザー「Arndt William」によって「Claim Report」フォームが送信され、ユーザーの日付書式がmm/dd/yy',に設定されると、アプリケーションによってファイル名が生成されます: 'ClaimReport-ArndtWilliam-02262025-15'.

ここで:

'ClaimReport'は、スペースが削除されたフォーム名から導出されます。
'ArndtWilliam'は、スペースが削除されたモバイル・ワーカーの名前です。
'02262025'は2025年2月26日を表します。
'15'は、繰返しフォーム提出からのPDFの複数のバージョンを保存できる一意の識別子です。

OCI Object Storageでのファイルの検索方法

OCI Object Storageでは、PDFファイルへのパスはパターンに従います: 'object/file name'. オブジェクト・ストレージUIでは、パスのオブジェクト部分はフォルダとしてビジュアル化され、ファイル名はそのフォルダ内の特定のレコードを表します。

'オブジェクト' (フォルダ)名は、作業オーダー識別子とフォーム名を組み合せて動的に生成されます。

作業オーダー識別子は、次のように決定されます:

サービス作業オーダーの場合は、作業オーダー番号を使用します。
メンテナンス作業オーダーの場合は、WO IDを使用します。
他のアプリケーションからの作業オーダーの場合は、「作業オーダー[appt_number]」フィールドの値を使用します。

OCI Object StorageでPDFを検索:

オブジェクト・ストレージ内のPDFファイルを検索するには、'バケット内のオブジェクト・ストレージ・オブジェクトの検索'関数を使用します。

特定の作業オーダーのファイルを検索するには: 検索で関連する作業オーダー識別子を使用します。
作業オーダーに関連する特定のフォームを検索するには: 使用次の組合せ作業オーダー識別子および検索問合せのフォーム名。

構成方法

新しい「PDFの生成」セクションがフォームの構成に追加されました。この項では、PDF生成を有効にしてチューニングできる様々なパラメータについて説明します。

これらの設定にアクセスするには:

「Forms &プラグイン」ページにナビゲートします。
必要なフォームを選択します。
「編集」をクリックします。

新規フォーム・パラメータ: PDFオプション

このパラメータは、PDFファイルの処理方法を制御します。使用可能なオプションは次のとおりです。

PDF FIlesを生成しない: Default. このフォームのPDFファイルを作成しない場合は、このオプションを選択します。
印刷および共有用のPDFの生成: PDFファイルを生成し、顧客サイトで印刷したり、他のアプリケーションを使用してクライアントと共有するためにデバイスで使用できるようにするには、このオプションを選択します。
PDFの生成およびFusion添付へのアップロード: フォームの送信時にPDFファイルを生成し、Fusionの関連するサービスまたはメンテナンス作業オーダーにファイルを添付するには、このオプションを選択します。
PDFの生成およびOCIオブジェクト・ストレージへのアップロード: PDFファイルを生成してOCI Object Storageに自動的にアップロードするには、このオプションを選択します。

PDFファイルの生成

ストレージへの接続

これらは、ストレージへの接続を設定するために「添付」プロパティの構成に使用されているパラメータと同じです

Fusion添付

アプリケーション - Fusion APIに接続するアプリケーション
Fusionビジネス・オブジェクト - サービス作業オーダーまたはメンテナンス作業オーダーのいずれか
添付カテゴリ - PDFファイルをアップロードするためのFusionのカテゴリ

OCIオブジェクト・ストレージ

アプリケーション - OCIオブジェクト・ストレージに接続するアプリケーション

PDFテンプレート

ここでPDFの生成に使用するテンプレートを添付する必要があります。添付ファイルには次の制限が適用されます:

HTMLファイルである必要があります
ファイル・サイズは500KBを超えることはできません

ノート: テンプレートを添付しないと、フォーム設定を編集できません。

PDFテンプレート

フォーム構成でのPDFテンプレート&検証

フォームは動的であり、多くの場合、新しいフィールドの追加、表示条件の調整、デフォルト値の変更などの更新が必要です。これらの変更には、関連するHTMLテンプレートの変更が必要になる場合があります。これはフォーム構成ページで直接可能になり、古いバージョンを新しいバージョンに置き換えることができます。

実行方法:

フォーム構成ページにナビゲートします。
ページ・ヘッダーの「アクション」メニューをクリックします。
「HTMLテンプレートの添付」を選択し、テンプレートを置き換えます。

HTMLテンプレートの添付

アプリケーションは、フォームの構成をテンプレートと比較することによって、フォームの構成を「検証」します。フォーム設定にテンプレート・フィールドがない場合は、エラーが表示されます。 「公開」をクリックすると検証が行われます。検証エラーを含むレポートが表示されます。ただし、これらのエラーによって公開が妨げられることはありません。

ノート: 「アクション」 ->「検証」をクリックすると、公開前にフォームを検証できます。

フォーム・テンプレート検証

エクスポート &フォームのインポート

Formsでは、「エクスポートおよびインポート」中にすべての新しいパラメータがサポートされるようになり、環境間のスムーズな移行が保証されます。

「選択したPDF生成オプション」および「HTMLテンプレート」は、エクスポートされたファイルに含まれ、別の環境に移行できます。
PDFをアップロードするためにストレージに接続するように選択したアプリケーションがターゲット環境にない場合、インポートは失敗します。

PDF生成フォームのビジュアル識別

「PDFの生成」に構成されたフォームは、「Forms &プラグイン」ページで視覚的に識別できるようになりました。これには、次のような説明ラベルが含まれます:

このフォームは、サービス作業オーダーのPDFを生成します。
「このフォームでは、PDFをOCI Object Storageにアップロードします。」。

ビジュアル表現

HTMLテンプレートを準備する方法

アプリケーションは、フォーム構成にアタッチされた「カスタムHTMLテンプレート」に基づいて「PDFファイル」を生成します。テンプレートによって、ブランディング、レイアウト、構造化データ挿入などの「PDFの外観」が決定されます。

ブランディング

ヘッダー、フッターおよびセクション・ヘッダーの「ブランド色」を使用します。
シームレスなレンダリングに「Base64イメージ」で「ロゴ」を埋込みます。

レイアウト

ニーズに合わせてレイアウトを定義します。
適切な印刷のために、ページの幅に適合していることを確認します。

サポートされているフィールド

HTMLテンプレートには、様々なデータを表示できます。これには、入力、チェック・ボックス、ドロップダウン・リスト、イメージ、シグネチャなど、すべてのタイプの「製品フィールド、プロパティおよびフォーム・フィールド」が含まれます。これらすべてが、生成されたPDFに正しく表示されます。ただし、テンプレートで特に使用可能な「製品フィールド」のリストは、次に説明するリストに制限されます。

テンプレートで使用できる製品フィールド:

作業指示[appt_number]
住所[caddress]
携帯電話[ccell]
市区町村[ccity]
電子メール[cemail]
名前[cname]
電話[cphone]
SLA時間枠の開始[sla_window_start]
SLA時間枠終了[sla_window_end]
状態[cstate]
アカウント番号[customer_number]
郵便番号[czip]
日付[date]
期間[length]
シリアル番号[invsn]
在庫タイプ[invtype]
数量[quantity]
名前[pname]
電話[pphone]
Eメール・アドレス[email] (リソースEメール)

現品票

テンプレートにタグを追加することで、PDFに表示するフィールドのデータを定義します。タグは、「デフォルト&検証」ルールと同じ構文に従います。最初の部分はエンティティ(アクティビティなど)を表し、2番目の部分はフィールドまたはプロパティ・ラベル(account_numberなど)を表します。フォーム・フィールドにエンティティを指定せず、ラベルのみを残す必要があります。

タグは二重中カッコで囲む必要があります。

タグの例

製品フィールド/プロパティ - {{activity.account_number}}
フォーム・フィールド - {{signature}}

ファイル・タイプ:テンプレートは.htmlファイル・タイプである必要があります。

リモート・コンテンツ

HTMLテンプレートではリモート・コンテンツは許可されません。すべてのイメージ、スタイル、アイコンなどを埋め込む必要があります。

ビジネス上の利点

現場で取得したデータをPDFファイルに変換することを目的とした、すぐに使えるフル・サイクル・ソリューションにより、お客様は次のことが可能になります:

アクティビティの証拠とドキュメントをより効率的に顧客に提供します。
PDF生成ソリューションのメンテナンス作業を削減します。
Oracle Fusionフィールド・サービスおよびファイル・ストレージと統合して、&取得PDFファイルを保存する必要性を排除します。
Oracle Fusionフィールド・サービスでPDF生成&アップロードを有効にして、本番までの時間を短縮します。

有効化のステップ

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

ヒントと考慮事項

1. PDFファイルを「Fusion作業オーダー」に添付するには、次の設定を使用してFusion APIに接続するアプリケーションを作成する必要があります:

アプリケーション・タイプを選択します: REST/SOAP APIを使用するアプリケーション。
認証には、「OAuthユーザー・アサーション」を選択します。

「ログインに基づくアイデンティティ・ユーザー」設定を使用して、フォームに入力した技術者の名前でファイルが常にアップロードされるようにすることをお薦めします。これにより、アセットのトラブルシューティング、インシデントの調査または技術者のパフォーマンス評価に使用できるコンプライアンス・チェックを実行できます。

ログインに基づくアイデンティティ・ユーザー

2. PDFファイルを印刷してテストします。すべての情報が画面に正しく配置され、印刷時の幅と高さに適合していることを確認します。

3. PDFファイルは、バンドル・ルールを使用してアプリケーションによって結合された関連アクティビティのフォームに対して印刷および共有できます。