このセクションの記事

もっと見る

[toc] 

概要

このページでは、D3Workerを利用している場合に、帳票DX for Salesforce の設定を Salesforceの開発環境（Sandbox）から本番環境へ移行する手順を説明します。

 

前提条件

2つの組織に存在する項目や表示ラベルが一致していること（帳票に使用するものに限る）

 

パターン1：開発バケット・本番バケットを使い分けている場合

開発バケット・本番バケットでXAテンプレートを分けて管理している場合は、以下の複製作業が必要です。

1. XAテンプレートを本番バケットに複製する

  1. XAデザイナーにログインします。

  2. 「開発」バケットをクリックして開きます。


     

  3. 移行対象のテンプレートにチェックを入れます。


     

  4. 「一括操作」から「複製」をクリックします。


     

  5. 複製先として本番用バケットを選択します。

     

  6. 「複製」をクリックします。

     

2. D3Workerの設定を本番反映する

  1. D3Workerにログインし、「ワーク」＞「文書とデータのマッピング」を開きます。

  2. テンプレート名が「バケット名/テンプレート名」となっているので、バケット名を本番用バケットに修正します。

     

  3. Sandbox環境で出力を実行し、本番バケットのテンプレートが呼び出されていることを確認します。

    💡
    補足

    「サービス」の接続先をSandbox環境に設定しているものがある場合は、本番環境に変更して「接続の確認」を行ってください。 接続先を本番環境に変更した後にSandbox環境で実行すると、本番環境に接続されますのでご注意ください。

    （例）Salesforce Files [配送]

     

3. 設定レコードの移行

Sandbox上で設定レコードをエクスポートし、本番環境でインポートを行います。

詳細は【帳票DX for Salesforce】エクスポート・インポート機能を使用したSandbox環境から本番環境への移行手順をご参照ください。

 

4. アクションボタン／Visualforceページを本番組織にリリースする

  1. Sandboxで開発したアクションボタンとVisualforceページを、変更セット機能などを用いて本番組織にリリースします。
  2. 本番組織でSandboxと同じボタンから出力を確認します。

 

パターン2：同一バケットのテンプレートをそのまま使用する場合

開発時と本番利用時でバケットの使い分けをしていない場合（すべて「本番」バケットに統一してテンプレートを作成している場合など）は、以下の手順で移行が可能です。

  1. Sandbox上で設定レコードをエクスポートし、本番環境でインポートを行います。

    詳細は【帳票DX for Salesforce】エクスポート・インポート機能を使用したSandbox環境から本番環境への移行手順をご参照ください。

  2. Sandboxで開発したアクションボタンとVisualforceページを、変更セット機能などを用いて本番組織にリリースします。
  3. 本番組織でSandboxと同じボタンから出力を確認します。
💡
補足

D3Workerで「サービス」の接続先をSandbox環境に設定しているものがある場合は、本番環境に変更して「接続の確認」を行ってください。 接続先を本番環境に変更した後にSandbox環境で実行すると、本番環境に接続されますのでご注意ください。

（例）Salesforce Files [配送]

 

パターン3：開発用・本番用で別のCIDを発行している場合

開発用・本番用でそれぞれご契約があり、複数CIDを発行している場合は、テンプレート及びマッピングの移行が必要になります。

前提：以下のように使い分けている場合

  • 本番用のCID（本番Salesforce組織）
  • 開発・検証用のCID（Sandbox組織）

1. XAテンプレートの移行

  1. XAデザイナーにログインします。

  2. 開発用グループの該当バケットをクリックして開きます。 XAグループはCID単位で発行されています。

    ⚠️
    注意

    開発用グループと本番用グループで異なる名称のバケットにテンプレートを移行した場合、ViewFramerのマッピング「documentizer」タブでテンプレートを再指定＞再マッピング＞再配備を行う必要があります。

    開発用CIDでも「本番」バケットを使用するなど、本番移行先と同一のバケット名になるようテンプレートを作成することを推奨します。

     

  3. 移行対象のテンプレートにチェックを入れます。

     

  4. 右クリックをして「エクスポート」をクリックします。

     

  5. xarファイルがダウンロードされます。

2. エクスポートしたテンプレートを本番用グループにインポートする

  1. XAデザイナーにログインします。

  2. 本番用グループの該当バケットをクリックして開きます。

     

  3. 「新規追加」をクリックし「ファイルインポート」を選択します。

     

  4. 「テンプレート」タブを開き、エクスポートしたテンプレートファイルをドラッグアンドドロップ、もしくは「ファイルを選択」でファイルを選択します。

     

  5. ファイル名横のチェックボックスをクリックしてインポートするファイルを選択し「実行」をクリックします。

    詳細は【XA】XAデザイナでのテンプレートのエクスポート/インポート方法（.xatファイルの取得・インポート方法）をご参照ださい。

     

4. D3Workerの設定を本番反映する

Sandbox環境のD3Workerのワークをエクスポートし、本番環境のD3Workerでインポートを行います。 詳細は「D3Workerでのワークのエクスポート/インポート方法(Salesforce)」をご参照ください。

利用している「サービス」にSalesforceへの接続先設定がある場合は、インポート先の本番環境のみSalesforceへの接続を再設定してください。

（例）Salesforce Files [配送]

 

5. 設定レコードの移行

設定レコードを移行する前に、本番環境にて以下の設定内容が正しく設定されているかご確認ください。

  • OPROARTS(帳票DX) の D3W用 CID / UID / UPW

  • document DX Static Setting の D3Worker API URL（テナント URL が変わる場合）

     

上記の確認を行ったら、Sandbox上で設定レコードをエクスポートし、本番環境でインポートを行います。 
詳細は「【帳票DX for Salesforce】エクスポート・インポート機能を使用したSandbox環境から本番環境への移行手順」をご参照ください。

⚠️
注意

  • 設定レコードを本番環境へインポートする際に、インポート先バケット名が本番環境用のバケット名になっているかご確認ください。

  • D3Workerインポート後にワーク名やワーク内のフィールド名が変わった場合は、帳票DX側で再設定が必要です。

 

6. アクションボタン／Visualforceページを本番組織にリリースする

  1. Sandboxで開発したアクションボタンとVisualforceページを、変更セット機能などを用いて本番組織にリリースします。
  2. 本番組織でSandboxと同じボタンから出力を確認します。


 

関連記事