Salesforce 向け Adobe Sign:Simple Sign

Simple Sign は、コミュニティポータルのユーザーがセルフサービスの契約書に署名できるようにする簡単なコンポーネントです。Simple Sign は、任意の Salesforce Experience Cloud ポータル(顧客、パートナー、従業員など)に簡単に追加するか、その他の Lightning コンポーネントにシームレスに埋め込むことができます。

「Simple Sign」機能には、Salesforce Community Cloud の複数のエディションの次のポータルからアクセスできます。

  • B2C ポータル:お客様は、コミュニティユーザーログインおよびコミュニティユーザーログインプラスライセンスを使用します。
  • B2B ポータル:パートナーコミュニティユーザーライセンス。

コミュニティユーザーは外部ユーザーであるため、組織データへのアクセスは制限されています。デフォルトでは、内部ユーザーが生成したデータにアクセスできません。

コミュニティポータルで契約書の署名に Simple Sign を使用するには、次の手順を実行する必要があります。

前提条件

Simple Sign 機能にアクセスして使用するには、次のことを確認する必要があります。

  • Salesforce 用 Adobe Acrobat Sign パッケージバージョン 21.0 以降がインストールされている。
  • ポータルが機能するように、Salesforce 組織内で Lightning が有効になっていることを確認します。Lightning インターフェイスを有効にするには、上部メニューから「Lightning に切り替え」を選択します。または、自分の名前を選択し、ドロップダウンメニューから、「Lightning Experience に切り替え」を選択します。
  • Salesforce を Adobe Acrobat Sign にリンクする際に、「サンプルの契約書テンプレートの生成」オプションを選択します。
link-accounts

  • インストール中にテンプレートが生成されなかった場合、または古いバージョンのパッケージから v19 にアップグレードした場合は、「Adobe Acrobat Sign 管理者」タブに移動して、「サンプル自己署名契約テンプレートを生成」を選択します。
  • 契約テンプレート」タブに「テストコミュニティ契約」テンプレートが表示されていることを確認します。
verify-test-community-agreement

Chatter の有効化

SFDC 組織で Chatter を有効にするには、次の手順を実行します。

  1. セットアッププラットフォームツール機能設定Chatter/Chatter 設定に移動します。
  2. 編集」を選択します。
  3. 有効にする」チェックボックスをオンにします。
  4. 保存」を選択します。

デジタルエクスペリエンスを有効にする

デジタルエクスペリエンスを有効にするには、次の手順を実行します。

  1. 設定プラットフォームツール機能設定デジタルエクスペリエンス設定に移動します。
  2. デジタルエクスペリエンスを有効にする」チェックボックスをオンにします。
  3. エクスペリエンスのドメイン名を指定します。
    アカウントに既に設定済みのドメインがある場合は、同じ値をエクスペリエンスに使用できます。
  4. 保存」を選択します。
  5. 設定後はドメインを変更できないという警告のダイアログで、「OK」を選択します。

2 つの CSP 信頼済みサイトをアクティベート

Adobe Acrobat Sign アカウントのベース URL を許可するには、2 つの CSP(コンテンツセキュリティポリシー)信頼済みサイトを設定する必要があります。次の手順を実行します。

  1. 次のように、Acrobat Sign アカウントの shard 値を取得します。

    1. Adobe Acrobat Sign アカウントにログインします。
    2. URL から、echosign.com(場合によっては adobesign.com)部分の直前のパラメーター(shard 値)をコピーします。 
      例えば、URL https://caseyjones.na1.echosign.com の shard 値は na1 です。
    3. タブを閉じます。

    Adobe Acrobat Sign アカウント環境を特定する方法を参照してください。

    global-settings

  2. 設定設定セキュリティCSP 信頼済みサイトに移動し、「新規信頼済みサイト」を選択します。

    csp-trusted-sites

  3. 開いた新しいサイト定義ページで、次のように必須フィールドに入力します。

    1. 信頼済みサイトの名前 - 名前を指定します(AcrobatSign など)
    2. 信頼済みサイトの URL - サイト URL を入力します:https://secure。<shard>.adobesign.com
      例:https://secure.na1.adobesign.com
      アカウントが adobesign.com ドメインに更新されていない場合は、代わりに echosign.com を使用できます。
    3. アクティブ」チェックボックスをオンにします。
    4. コンテキスト - コンテキストについては、「エクスペリエンスビルダーサイト」を選択します。
    5. 「CSP ディレクティブ」の「frame-src のサイトを許可」チェックボックスをオンにします。
    6. 保存」を選択します。
    csp-trusted-site-definition

  4. 設定設定セキュリティCSP 信頼済みサイトに戻り、「新規信頼済みサイト」を選択します。

  5. 開いた新しいサイト定義ページで、次のように必須フィールドに入力します。

    1. 信頼済みサイトの名前 - 名前を指定します(AcrobatSign2 など)
    2. 信頼済みサイトの URL - サイト URL を入力します:https://secure.adobesign.com
    3. アクティブ」チェックボックスをオンにします。
    4. コンテキスト - コンテキストについては、「エクスペリエンスビルダーサイト」を選択します。
    5. 「CSP ディレクティブ」の「frame-src のサイトを許可」チェックボックスをオンにします。
    6. 保存」を選択します。
    2 番目の CSP 信頼済みサイト

  6. 2 つの CSP 信頼済みサイトを確認します。

    CSP 信頼済みサイト

コミュニティユーザープロファイルをクローンする

Adobe Acrobat Sign のセルフサービスポータルを使用するようにユーザープロファイルを設定するには、標準プロファイルのいずれかをクローンし、編集する必要があります。次の手順を実行します。

  1. 設定管理ユーザープロファイルに移動します。

  2. 標準の Customer Customer プロファイルのいずれかで、「クローン」を選択します。

    Customer Community プロファイルは 4 つあり、いずれかのプロファイルを使用してユーザープロファイルをクローンおよび作成できます。 クローンしたプロファイルのユーザライセンスのタイプを書き留めます。

    setup-profiles

  3. 複製されたプロファイルの直感的な名前を指定してから、「保存」を選択します。

    cloned-profile-name

  4. 開いたクローン済みプロファイルページで、「編集」を選択します。

    cloned-profile-edit

  5. カスタム編集ページで、「カスタムオブジェクト権限」まで下にスクロールし、すべての Adobe Acrobat Sign オブジェクトを有効にします。「Modify All」チェックボックスをオンにすることも、セキュリティを強化するために必要な権限のみを選択することもできます。

    cloned-prodile-custom-object-permissions

コミュニティのアカウント、担当者、ユーザーの作成

コミュニティのアカウント、担当者、ユーザーを作成する必要があります。 

ポータルユーザーを有効にするには、アカウント所有者が役割に関連付けられている必要があります。役割を Salesforce ユーザーに関連付けるには、設定管理ユーザーユーザーに移動します。次に、ユーザーのリストから、ユーザーに対して「編集」を選択し、開いたページでロールドロップダウンメニューを開き、ロールを選択し、「保存」を選択します。

アカウントを作成するには、次の手順を実行します。

  1. アプリランチャーから Sales アプリを起動します。

  2. アカウントドロップダウンメニューを開き、「+新規アカウント」を選択します。

  3. 開いた新規アカウントページで、「アカウント名」の値を入力し、「保存」を選択します。

    アカウント名では、Adobe Acrobat Sign Portal アカウントのようなアカウントが特定されている必要があります。アカウント名は、ここで指定する必要がある唯一の値です。

    create-new-account

SFDC コミュニティページを設定

  1. 設定プラットフォームツール機能設定デジタルエクスペリエンスすべてのサイトに移動します。

  2. 新規」を選択します。

  3. カスタマーサービスエクスペリエンスを選択します。

    セルフサービスのコンポーネントには、カスタマーサービスエクスペリエンスが必要です。

  4. カスタマーサービスページが読み込まれたら、「開始」を選択します。

  5. 表示される ページで、次の手順を実行します。

    1. コミュニティの名前を入力します。オプションで、サイト固有の名前を URL に追加できます。これは、複数のコミュニティがある場合に役立ちます。
    2. 名前を設定したら、「作成」を選択します。

    コミュニティの作成中は、美しいグラフィックが次々と表示されます。完了すると、コミュニティページが表示されます。 

    ウィンドウ上部に黄色でハイライトされているのがコミュニティ名です。

    アドレスバーに青緑色でハイライトされているのが URL に含まれるサイト固有の文字列です。

ユーザーを有効化するためにエクスペリエンスワークスペースを設定する

  1. 設定プラットフォームツール機能設定デジタルエクスペリエンスすべてのサイトに移動します。

  2. コミュニティで、「ワークスペース」を選択します。

  3. 開いた My Workspaces ページで、「管理」を選択します。

  4. コミュニティの管理ページで、次の手順を実行します。

    1. 左パネルから「設定」を選択して、ステータスインジケーターの「アクティベート」を選択します。
    2. 左パネルから「メンバー」を選択します。
    3. 検索ドロップダウンメニューで、「すべて」を選択します。
    4. Available Profiles」リストから、作成したカスタムプロファイルを選択します。
    5. 追加」をクリックして、プロファイルを「Selected Profiles」リストに移動します。
    6. 保存」を選択します。

コミュニティユーザーの「プロファイル表示」設定の「電子メール」を「公開」に設定

  1. 代理送信に使用するユーザーの取引先担当者ページを開いて、「ユーザーとしてエクスペリエンスにログイン」を選択します。

    ユーザーとしてエクスペリエンスにログイン

  2. 表示されるポータルインターフェイスの右上隅からユーザー名を選択して、ドロップダウンメニューから「設定」選択します。

  3. 開いた設定ページで、次の手順を実行します。

    1. プロファイル表示」セクションで、「電子メール」の値を「公開」に設定します。
    2. 保存」を選択します。

ワークスペースに Adobe Simple Sign コンポーネントを追加する

  1. 設定プラットフォームツール機能設定デジタルエクスペリエンスすべてのサイトに移動します。

  2. コミュニティリストで、「ワークスペース」を選択します。

  3. ページの「My Workspaces」セクションで、「ビルダー」を選択します。

  4. ページ左上から、「コンポーネント」アイコンをクリックし、メニューの下部までスクロールして、「Adobe Simple Sign」オプションをページレイアウトにドラッグ&ドロップします。

    Adobe Sign の契約書を表示したい場所にコンポーネントをドロップします。

    ポータルテンプレートに Simple Sign をドラッグします。

    ページが更新されて、追加したコンポーネントがページレイアウト上に表示されます。また、コンポーネントの管理パネルが右上隅に表示されます。

  5. 管理パネルから「契約テンプレート」を選択し、「公開」を選択してポータルを使用できるようにします。

    注意:

    ポータルまたは設定を変更するたびに、ポータルを再公開する必要があります。

Lightning コンポーネントへの Simple Sign コードの埋め込み

次のサンプルコードを使用して、Simple Sign コンポーネントを別の Lightning コンポーネントに埋め込むことができます。

<echosign_dev1:SimpleSign templateId="a0L190000019xUrEAI" />

コンポーネントを別のコンポーネントにプログラムで埋め込む場合は、追加のパラメーターを指定できます。

  • agreementId:処理中またはドラフト契約書の Salesforce ID。ドラフト契約書では、send-on-behalf を設定する必要があります。
  • templateId:生成された契約書を管理するテンプレートのSalesforce ID。
  • pollingInterval:署名 URL の取得を試行するまでの時間(ミリ秒単位)。最小値は 500、最大値は 50000、デフォルト値は 1000です。
  • showSigningModal:false に設定すると、オーバーレイモーダルで電子サインページが読み込まれず、署名 URL のみが返されます。true に設定すると、署名 URL が返され、電子サインページがオーバーレイモーダルに読み込まれます。デフォルト値は true です。

パラメーターは次のルールに従います。

  • agreementID または templateID のいずれかを指定する必要がある。両方が指定されている場合は、agreementID が使用されます。どちらも指定されていない場合は、エラーが返されます。
  • agreementID を使用する際には、契約書がドラフトまたは署名用に送信ステータス(残りの署名者が 1 名以上いる)となっている必要があります。
  • 契約書がドラフト状態の場合は、そのまま送信され、署名 URL が表示されます。
  • 契約書が処理中の場合、署名 URL が取得および表示されます。
  • 契約書が完了すると、エラーが表示されます。
  • templateID を使用している場合でも、自動送信が有効になります。
  • agreementID が使用されている場合は、テンプレートの自動送信設定が優先されます。
  • Simple Sign 契約テンプレートには、取引先責任者のマスターオブジェクトタイプが必要です。
  • 多くのコミュニティユーザーは、送信のためのライセンスを取得していないため、代理送信を強くお勧めします。

コンポーネントはイベントを消費者に公開することもできます。イベントハンドラーの例:

<aura:handler name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"/>

次の表に、使用可能なイベントを示します。

契約書が送信されました

name="notifyAgreementSent" event="echosign_dev1:AgreementSentEvent" action="{!c.onAgreementSent}"

テンプレートから契約書が読み込まれました

name="notifyAgreementLoaded" event="echosign_dev1:AgreementLoadedEvent" action="{!c.onAgreementLoaded}"

署名ページが開かれました

name="notifySigningLoaded" event="echosign_dev1:SigningLoadedEvent" action="{!c.onSigningLoaded}"

署名済み

name="notifyRecipientCompleted" event="echosign_dev1:RecipientCompletedEvent" action="{!c.onRecipientCompleted}"

署名なし

name="notifyRecipientNotCompleted" event="echosign_dev1:RecipientNotCompletedEvent" action="{!c.onRecipientNotCompleted}"

アクションを実行中にエラーが発生しました。

name="notifyError" event="echosign_dev1:ErrorEvent" action="{!c.onError}"

Simple Sign 用の契約テンプレートの設定

Salesforce 統合データへのアクセス権を付与する

パッケージのカスタムオブジェクトは、デフォルトでは外部ユーザーに対して「プライベート」として設定されています。コミュニティユーザー権限セットを有効にすると、カスタムオブジェクトとそのフィールドにアクセスできますが、他のユーザー(内部および外部の両方)によって作成されたレコードにはアクセスできません。

コミュニティポータル内で、管理者は電子サインフローを設定するために次の 2 つのオプションを使用できます。

  • 事前構築済みコンポーネント(「自分が署名」と Simple Sign)を使用する。
  • Apex API を使用して、独自のフローを作成する。 

いずれの場合も、管理者は契約テンプレートを使用して、コミュニティユーザーが電子サインフローを開始したり、参加したりできるようにすることがよくあります。これを機能させるために、コミュニティユーザーは、契約テンプレートと、通常は内部ユーザーが作成する結合マッピングおよびデータマッピングオブジェクトなどの関連リソースへの読み取り専用アクセス権を必要とします。

コミュニティユーザーライセンスのタイプによって、アクセスを許可する方法が決まります。

  • コミュニティユーザーログインライセンス:管理者は、コミュニティユーザープロファイルを通じて、契約テンプレートと結合/データマッピングオブジェクトの「すべて表示」を有効にして、アクセス権を付与できます。
  • コミュニティユーザーログインプラスライセンスおよびパートナーコミュニティユーザーライセンス:プロファイルから「すべて表示」のアクセス権を有効にすることはできません。管理者は、役割ベースの共有ルールを使用してアクセス権を付与する必要があります。

契約テンプレートおよび関連オブジェクトへのアクセス権の付与

コミュニティユーザーが契約テンプレートを使用して契約書を作成するには、契約テンプレートおよび関連オブジェクトへの「すべて表示」のアクセス権が付与されている必要があります。

  • 契約テンプレート(echosign_dev1__Agreement_Template__c)
  • 結合マッピング(echosign_dev1__SIGN_Merge_Mapping__c)
  • データマッピング(echosign_dev1__SIGN_Data_Mapping__c)

Acrobat Sign Document Builder テンプレートを、添付ファイルとして契約テンプレートと共に使用する場合は、コミュニティユーザーに以下のオブジェクトに対するアクセス権を付与する必要があります。

  • Document Builder テンプレート(adobesign__Document_Template__c)

  • オブジェクトフィールドマッピング(adobesign__Object_Field_Mapping__c)

Simple Sign の制限

  • 送信者の署名のみ」が有効になった状態でテンプレートが設定されていない場合、コミュニティユーザーに「使用できる署名 URL がありません」という内容のエラーが表示されます。

  • テンプレートで「フィールドのプレビューと配置を有効にする」オプションが選択されていない場合、契約書は送信前の状態のままとなり、署名 URL は読み込まれません。

  • テンプレートで「ホスト署名を有効にする」オプションが選択されていない場合、ホスト署名はサポートされません。

  • Simple Sign では、委任をサポートしていません。 他の受信者は署名URLにアクセスできません。

  • Simple Sign は、署名者を置き換え(委任の 1 方法)をサポートしていません。 新しい署名者は署名URLにアクセスできません。

  • Salesforce オブジェクトのメモや添付ファイルにアクセスするには、管理者がコミュニティ設定で「顧客ユーザーにメモや添付ファイルへのアクセスを許可する」を有効にしておく必要があります。

ヘルプをすばやく簡単に入手

新規ユーザーの場合