Field Service モバイルアプリケーションのディープリンクスキーマ

URI スキーマの形式

サポートされている URI スキーマ

com.salesforce.fieldservice://v1/sObject/<id>/details

他のすべてのオブジェクト種別の [詳細] タブにリンクします。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/details

この例は、作業指示の [詳細] タブにリンクします。

com.salesforce.fieldservice://v1/sObject/<id>/related

他のすべてのオブジェクト種別の [関連] タブにリンクします。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/related

この例は、作業指示の [関連] タブにリンクします。

com.salesforce.fieldservice://v1/sObject/<id>/products

他の該当するオブジェクト種別の [商品] タブにリンクします。オブジェクトに [商品] タブがない場合は、[詳細] タブにリンクします。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/products

この例は、作業指示の [商品] タブにリンクします。

com.salesforce.fieldservice://v1/sObject/<id>/feed

該当するすべてのオブジェクト種別の [フィード] タブにリンクします。オブジェクトに [フィード] タブがない場合は、[詳細] タブにリンクします。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/feed

この例は、作業指示の [フィード] タブにリンクします。

com.salesforce.fieldservice://v1/sObject/<id>/location

該当するすべてのオブジェクト種別の [ロケーション] タブにリンクします。オブジェクトに [ロケーション] タブがない場合は、[詳細] タブにリンクします。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/location

この例は、作業指示の [ロケーション] タブにリンクします。

com.salesforce.fieldservice://v1/sObject/<id>/edit

指定した Salesforce レコードの編集ページへのリンク。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/edit?Subject=Example%20Subject

この例は、このレコードの編集ページにリンクし、「Subject」項目に「Example Subject」の値を入力します。

com.salesforce.fieldservice://v1/sObject/<id>/createservicereport

特定の作業指示またはサービス予定についてのサービスレポートが作成されます。<id> 値には、作業指示またはサービス予定のレコードを指定する必要があります。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/createservicereport

この例は、作業指示またはサービス予定についてのサービスレポートを作成します。

com.salesforce.fieldservice://v1/sObject/<id>/flow/<api_name>

モバイルアプリケーション内から [Field Service Mobile フロー] を起動します。たとえば、この URL を使用して、カスタムサービスクローズフローを起動できます。この機能を使用するには、アプリケーション拡張からこのフローを参照する必要があります。アプリケーション拡張は、[設定] の [Field Service Mobile 設定] で確認できます。[アプリケーション拡張機能] セクションの拡張にこのフローが含まれていることを確認してください。詳細は、「Field Service モバイルアプリケーションへのフローの接続」を参照してください。URI 内の拡張では URL エンコード化された名前を使用します。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/flow/service_response_flow?Subject=Example%20Subject

この例は、「Subject」入力変数の値である「Example Subject」で渡された「service_response_flow」を起動します。

com.salesforce.fieldservice://v1/sObject/<id>/quickaction/<api_name>

モバイルアプリケーション内からクイックアクションを起動します。サポートされるクイックアクションは、レコードの作成、レコードの更新、および Field Service Mobile 拡張機能です。クイックアクションには、次の URL のパラメーターを使用して入力を渡すことができます。

例: com.salesforce.fieldservice://v1/sObject/0WO5500000001UZGAA/quickaction/close_order

この例は、close_order クイックアクションを起動します。

com.salesforce.fieldservice://v1/globalaction/<api_name>?<params>

モバイルアプリケーション内からグローバルクイックアクションを起動します。サポートされるグローバルクイックアクションは、レコードの作成、レコードの更新、および Field Service Mobile 拡張機能です。グローバルクイックアクションには、次の URL のパラメーターを使用して入力を渡すことができます。

例: com.salesforce.fieldservice://v1/globalaction/Create_Work_Order?Subject=Example%20Subject

この例では、グローバルクイックアクションを起動して作業指示を作成します。

com.salesforce.fieldservice://v1/login/<server_name>/<server_url>

指定された URL を使用してサーバーへの接続を追加します。ユーザーがサーバーにアクセスするには、ディープリンクをクリックし、既存のログイン情報を入力します。サーバーは [サーバーの変更] リストに保存され、繰り返しログインする必要がなくなるため、ユーザーはすばやくアクセスできるようになります。

パラメーター:

• <server_name> は、サーバーを識別するために使用する、わかりやすい名前です。スペース、カンマ、ピリオド、その他の「無効な」文字は、特に作業者が複数のサイトにログインする必要がある場合は避けてください。
• <server_url> は、Salesforce Field Service モバイルアプリケーションがログインに使用する URL です。URL を指定するときは、「http」や「https」を含めないでください。

例: com.salesforce.fieldservice://v1/login/employee/my.site.com/contractor/login

この例では、ログイン URI を設定し、ユーザーを直接 https://my.site.come/contractor/login に送信し、[サーバーの変更] リストに employee として保存しています。

セキュリティに関する考慮事項:

• 特にユーザー名とパスワードを追加する場合は、クリックする前にリンク元を信頼するようにしてください。このため、作業員にはベストプラクティスについてのトレーニングを実施し、ログインリンクは直接メールで送信しないことをお勧めします。
• モバイルオペレーティングシステムの種類には関係なく、多くのメールク��イアントやメッセージングアプリケーションでは、本文中でのモバイルアプリケーションへの有効なリンクはサポートされていません。リンク起動時にアプリケーションを開くことはサポートされていますが、リンクを起動するどうかは、テクノロジーや配布の選択内容によって異なります。リンクの問題に遭遇した場合は、まず Web ブラウザーでリンクを試してください。アプリケーションでリンクが開いた場合は、適切にフォーマットされています。Web リンクが機能しても、選択した配布方法では機能しない場合は、別の方法でリンクを共有してください。シームレスなエクスペリエンスを提供するには、アプリケーションにリダイレクトする Web リンクを使用するとよいでしょう。リンクを開くために使用するアプリケーションやオペレーティングシステムによっては、QR コード、Web サイトリンク、PDF、テキストメッセージなどのオプションも機能します。iOS や Android では、すべてのサードパーティアプリでリンクを開けるとは限りません。

ディープリンクのパラメーターの受け渡し

クイックアクションやフロー URL など、ディープリンクのスキーマでパラメーターを渡す場合には、次のパラメーターを使用できます。

• URL 符号化されたテキストパラメーター。例、Short%20text%20input。
• 通貨の数。例、1 または 1.45。
• Boolean 値。例、true または false。この値では、大文字と小文字は区別されません。パラメーターが渡されていない場合、デフォルトの false になります。
• URL エンコードされた日付と dateTime パラメーター。例、2019-12-11T17%3A01%3A00.000%2B0000。URL エンコードされたタイムゾーンを含みます (GMT の場合は +0000、AST の場合は-0400 など)。

ディープリンク URI のスキーマでは、これら以外のパラメーターはサポートされていません。

複数のパラメーターを渡すには、パラメーターの間にアンパサンド (&) を使用します。例、firstname=John&lastname=Doe。

パラメーター数に制限はありません。さらに、各パラメーターには最大 100,000 文字を含めることができます。ディープリンクは最大 1 MB のエンコードが可能ですが、これよりも少ないデータ量でエンコードすることをお勧めします。