Box Status
印刷

SalesforceでのBox Doc Genの設定

Admin , Salesforce , Article , New , Instruction , Integration , P4
重要:
以下の手順は、日本時間2025年1月3日時点で最新のものですが、Boxの管理外であるSalesforceのインターフェースに対する変更に応じて変わる可能性があります。

前提条件:

  • 組織に対してBox for Salesforceのインストールと設定が完了している。 つまり、以下の状態です。
    • Boxサービスアカウントがサインインしている
    • Boxサービスアカウントとは別のユーザーであるBoxユーザーがサインインしている
    • Box for Salesforceルートフォルダが存在している
    • 適切な権限がユーザーに割り当てられている
  • 組織にBox Doc Genを使用する資格がある (詳細については、Box担当者までお問い合わせください)。
  • Box Doc GenがBox管理コンソール ([Enterprise設定] > [コンテンツと共有] > [Box Doc Gen] > [構成の編集]) で有効になっている。
    • Box Doc Genが有効化されたら、Salesforce管理者は、BoxサービスアカウントとBoxユーザーを再度関連付けて、新しいDoc Genのアプリケーションスコープを承認する必要があります。

注:

  1. ドキュメントの生成はサービスアカウントが実行します。
  2. 生成されたドキュメントは、適切なBox for Salesforceフォルダに保存されます。
  3. ドキュメントやUI Elementsの表示は、特定のユーザーまたは標準のユーザーとして実行されます。

Box Doc Gen権限セットの割り当て

Box Doc Gen for Salesforceを使用すると、以下の操作にSalesforceの特定のユーザーを割り当てることができます。

  1. Salesforceで使用されるテンプレートの作成と管理
  2. テンプレートを使用したドキュメントの生成

これを行うには、該当するユーザーにカスタムのBox権限セットを割り当てる必要があります。

Salesforce管理者として、以下の手順を実行します。

  1. Salesforceのアプリケーションランチャーで [Box設定] を探して移動します。
  2. [権限の割り当て] セクションで、[割り当て] をクリックします。
    1. Box Doc Genテンプレートマネージャの場合は、[割り当ての管理] をクリックして、Box Doc Genテンプレートの作成、編集、設定を行うユーザーの権限セットを管理します。

      注: この権限セットにより、これらのユーザーは、アプリケーションランチャーでBox Doc GenおよびBox Doc Genテンプレートを確認できます。

    2. Box Doc Genユーザーの場合は、[割り当ての管理] をクリックして、Salesforceでドキュメントを生成するユーザーの権限セットを管理します。

SalesforceへのBox Doc Genテンプレートの追加

[Box Doc Genテンプレート] タブでは、Box Doc Genテンプレートマネージャの権限を持つユーザーが、ドキュメント生成のためのテンプレートを作成および管理できます。 [Box Doc Genテンプレート] タブには、sObject、ステータス、フォルダIDを含む、利用可能なすべてのテンプレートのリストが表示されます。

Box Doc Genテンプレートマネージャの権限セットが割り当てられているユーザーとして、以下の手順を実行します。

  1. アプリケーションランチャーで、[Box Doc Genテンプレート] を探して移動します。
  2. 右上の [新規] をクリックして、テンプレートマネージャを起動します。
  3. [テンプレートの作成] ステップで、以下の手順に従います。
    1. [テンプレート名] で、Salesforceのテンプレートの名前を選択します。
    2. [生成されたファイルの名前] で、生成されたファイルに付ける名前を選択します。
    3. [オブジェクト] で、テンプレートに関連付けるSalesforceオブジェクトを選択します。
    4. [次へ] をクリックします。
  4. [JSONをダウンロード] ステップで、以下の手順に従います。
    1. [JSONファイルをダウンロード] をクリックして、{ObjectName}DocGen.jsonという名前のファイルをダウンロードします。 これを使用して、Microsoft Wordアドインにタグを取り込みます。
    2. [次へ] をクリックします。
  5. Box Doc Gen Template CreatorというMicrosoft Wordアドインで、テンプレートを作成および編集します  (次の手順を参照)。
  6. [テンプレートをアップロード] ステップで、以下の手順に従います。
    1. テンプレートをdocxファイルまたはpdfファイルとして添付します。
    2. [アップロード] をクリックします。
    3. アップロードが完了したら、[次へ] をクリックします。
  7. (省略可) [プレビュー] ステップで、サンプルレコードでテンプレートをテストします。
    1. [Sample Record (サンプルレコード)] で、テンプレートをテストするレコードを探して選択します。
    2. [プレビュー] をクリックします。
    3. [次へ] をクリックします。
  8. [設定] ステップで、テンプレートの設定を確定できます。
    1. [Box Signで利用可能] チェックボックスをオンにして、テンプレートの承認と署名を可能にします。
    2. [出力タイプ] では、生成するファイルの種類を選択します。
    3. [Save and Finish (保存して終了)] をクリックします。

完了すると、[Box Doc Genテンプレート] タブには、詳細情報、ドキュメントをプレビューするためのタブ、以前に実行したジョブ、ドキュメント内のタグが表示されます。

Microsoft WordのBox Doc Gen Template Creatorを使用したテンプレートの作成

Box Doc Genテンプレートを作成および編集するには、Box Doc Gen Template Creator Wordアドインの使用をお勧めします。 Box Doc Genテンプレートの作成方法の詳細については、こちらを参照してください。

Box Doc Gen Template CreatorでSalesforceのタグの使用を開始するには、最初に、タグをインポートする必要があります。 タグをインポートするには、以下の手順に従います。

  1. テンプレートとなるファイルをMicrosoft Wordで開き、Box Doc Genテンプレートを開きます。
  2. [自分のデータで開始] をクリックします。
  3. 以前にダウンロードしたjsonファイルをアップロードします。
  4. [タグを生成] をクリックします。
  5. 適切なフィールドを検索して選択し、独自のテンプレートを作成します。 タグは、カーソルの横に表示されます。

オブジェクトへのBox Doc Genボタンの追加と表示

ユーザーがドキュメントを生成できるようにするには、事前にボタンを作成し、該当するオブジェクトページに追加する必要があります。

  1. Salesforceインスタンスの右上にある歯車アイコンをクリックして [Setup (セットアップ)] に移動します。
  2. 左上の [Object Manager (オブジェクトマネージャ)] タブに移動します。
  3. ユーザーがドキュメントを生成するためのボタンを追加するオブジェクトを選択します。
  4. 左側のサイドバーで、[Buttons, Links, and Actions (ボタン、リンク、およびアクション)] に移動します。
  5. 右上隅の [New Action (新規アクション)] をクリックします。
    • [Action Type (アクション種別)] ドロップダウンで、[Lightning Component (Lightningコンポーネント)] を選択します。
    • [Lightning Component (Lightningコンポーネント)] ドロップダウンで、[box:dgRecordPage] を選択します。
    • [Label (ラベル)] フィールドに、ボタンに付ける名前を入力します (例: 「ドキュメントの生成」)
      1. 必要に応じて、事前に入力されているフィールドを編集します (スペースは使用しません)。
      2. 必要に応じて、アイコンを別のロゴに変更します。
  6. 完了したら、[Save (保存)] をクリックします。

Create DocGen button gif.gif

該当するオブジェクトにBox Doc Genボタンを追加したら、Box Doc Genボタンを追加するページの編集を開始できます。

  1. Salesforce Object Managerの該当するオブジェクトで、[Page Layouts (ページレイアウト)] に移動します。
  2. 適切なページレイアウトを選択します。
  3. [Mobile and Lightning Actions (モバイルおよびLightningアクション)] を選択します。
  4. パレットで、作成したBox Doc Genボタンを探して、[Salesforce Mobile and Lightning Experience Actions (SalesforceモバイルおよびLightning Experienceアクション)] 内の任意の場所にドラッグします  (ボタンにカーソルを合わせて、作成したBoxのボタンであることを確認することをお勧めします。 [Generate Document (ドキュメントの生成)] という名前の標準のボタンも存在します)。
  5. [Save (保存)] をクリックします。

Add DocGen Button gif.gif

一括操作用のDoc Genの設定

ユーザーがSalesforceのリストビューから、特定のオブジェクトの複数のレコードのドキュメントを一度に生成できるようにすることもできます。 最初に、ボタンを作成して、該当するリストビューに追加します。

まず、一括操作用のDoc Genボタンを作成するには、以下の手順に従います。

  1. [Setup (セットアップ)] に移動します。
  2. [Objects (オブジェクト)] の下に入れ子になっている [Object Manager (オブジェクトマネージャ)] に移動します。
  3. ユーザーがドキュメントを生成するためのボタンを追加するオブジェクトを選択します。
  4. 左側のサイドバーで、[Buttons, Links, and Actions (ボタン、リンク、およびアクション)] に移動します。
  5. 右上にある [New Button or Link (新規ボタンまたはリンク)] をクリックします。
    • [Label (ラベル)] で、ボタンに付けるラベルを選択します。
    • [Name (名前)] で、名前を選択するか、事前に入力されている [Name (名前)] フィールドを編集します (スペースは使用しません)。
    • [Display Type (表示の種類)] で、[List Button (リストボタン)] を選択します。
    • 式に「/flow/box/Generate_Box_Documents?retURL=001/o」を入力します。
  6. [Save (保存)] をクリックします。
    自動的に生成されたコンピュータの説明のスクリーンショット
注:
  • retURLは、オブジェクトの種類によって異なります。
  • [Process Automation Settings (プロセスの自動化設定)] の [Enable Lightning runtime for flows (フローのLightningランタイムを有効化)] は必須です。

Create List Button gif.gif

Batch Doc Genボタンを作成したら、オブジェクトのリストビューがユーザーに表示されるようにします。

オブジェクトのリストビューを編集するには、以下の手順に従います。

  1. [Object Manager (オブジェクトマネージャ)] で、リストビューボタンを追加するオブジェクトを選択します。
  2. 左側のサイドバーで、[List View Button Layout (リストビューボタンレイアウト)] に移動します。
  3. [List View (リストビュー)] の行のドロップダウンをクリックし、[Edit (編集)] をクリックします。
  4. [Custom Buttons (カスタムボタン)] セクションまでスクロールして、新しく作成したボタンを選択し、[Add (追加)] の矢印をクリックしてボタンを追加します。
  5. [Save (保存)] をクリックします。

Add List button.gif

これで、ユーザーのリストビューでこのボタンを使用できるようになります。

関連記事