Salesforce 向け Adobe Sign:Simple Sign

最終更新日 : 2023年10月7日

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(コンテンツセキュリティポリシー)信頼済みサイトを設定する必要があります。 次の手順を実行します。

次のように、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

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

csp-trusted-sites

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

  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

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

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

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

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

CSP 信頼済みサイト

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

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

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

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

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

setup-profiles

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

cloned-profile-name

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

cloned-profile-edit

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

cloned-prodile-custom-object-permissions

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

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

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

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

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

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

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

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

create-new-account

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

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

「新規」を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

メモ

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

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 用の契約テンプレートの設定

Simple Sign 環境のテンプレートを設定して、マスターオブジェクトの参照に基づいて受信者を割り当てる必要があり、そのオブジェクトは「取引先担当者」にする必要があります。

「テンプレートの詳細」タブで次を実行します。

  1. Salesforceオブジェクトドロップダウンメニューを開いて、「その他のオブジェクトから選択」を選択します。
  2. 表示される新しいドロップダウンフィールドで、「取引先担当者」を選択します。

「受信者」タブで、次の手順を実行します。

  1. テンプレート上の既存の受信者を削除します。
  2. 「オブジェクトまたはランタイム変数から受信者を追加」を選択します。
  3. 表示される「受信者を追加」オーバーレイで、次の手順を実行します。
    1. 「オブジェクトまたは実行時変数を選択」フィールドで、「マスタオブジェクトフィールドに基づいて参照」を選択します。
    2. 最初の受信者タイプをマスターオブジェクト(取引先担当者)に設定し、マスターオブジェクトのソースフィールドを 取引先担当者 ID に設定します。
    3. 「保存」を選択します。

Simple Sign を使用するには、テンプレートにファイルを添付する必要があります。 アクティブな送信プロセスとは異なり、送信者は後で文書を添付することはできません。 ファイルをテンプレートに添付するには、次の手順を実行します。

「添付ファイル」タブに移動して、デバイスから文書をアップロードします。

または、「選択して文書を追加」セクションで文書の場所を選択します。

ルックアップフィールドを選択して、そのセクションで使用可能なすべての文書を表示します。

文書を選択して、テンプレートに 1 つずつ添付します。

すべての文書が添付されたら、「保存」を選択します。

メモ

アップロードしたすべてのファイルは、Salesforce に格納されます(「Salesforce CRM & ファイル」セクション)。

一部のポータルユーザーに Adobe Sign ライセンスがない場合は、「代理送信」機能を有効にして、ライセンスの制限を回避できます。 これにより、コミュニティユーザーは別のユーザーのライセンスを使用して、契約書を作成できます。

これを設定するには、次の 3 つの手順を実行します。

  1. カスタム設定で「他ユーザーの代理送信を許可する」を有効にします。
  2. 他ユーザーの代理送信を許可します。
  3. 上記のライセンスを持つユーザーの Salesforce ID を使用して契約テンプレートを設定します。

設定を有効にする

設定/プラットフォームツール/カスタムコード/カスタム設定に移動します。

これにより、カスタム設定ページが読み込まれます。

Adobe Sign 設定リストで「管理」を選択します。

「新規」(または前に設定済みの場合は「編集」)を選択します。

Adobe Sign 設定ページが読み込まれます。

「他ユーザーの代理送信を許可する」チェックボックスを見つけて、オンにします。

「保存」を選択します。

ユーザーが契約書を代理送信できるように設定する

ユーザーが代理送信機能をサポートできるよう、ユーザレコードレイアウトに 2 つのフィールドが追加されました。

設定/プラットフォームツール/オブジェクトとフィールド/オブジェクトマネージャーに移動します。

オブジェクトマネージャーページで、ユーザーラベルを選択します。 

ユーザーページの左パネルで、「ユーザーページレイアウト」を選択して、ユーザーのレイアウトを選択します。

configure-user-1

「ユーザーレイアウト」で「フィールド」オプションを選択して、次の 2 つのフィールドをレイアウトの「追加情報(編集ページにのみヘッダーを表示)」セクションに次の 2 つのフィールドをドラッグ&ドロップします。

  • 他のユーザーとして送信することを許可する
  • Adobe Acrobat Sign 電子メールを確認済み 

フィールドを設定したら、次の手順に従って特定のユーザーを有効にします。

  1. 設定/管理/ユーザー/ユーザーに移動します。
  2. 「コミュニティの取引先担当者」ユーザーの場合は、「編集」を選択します。
  3. ユーザー編集ページで、「追加情報」セクションを見つけます。
  4. 「他のユーザーとして送信することを許可する」と「Adobe Acrobat Sign 電子メールを確認済み」チェックボックスをオンにします。
  5. ユーザー編集ページを表示したまま、ブラウザーのアドレスバーの URL からユーザー ID をコピーします。

ユーザー ID はページの URL 内に表示されます(以下の例では黄色でハイライト表示されています)。

URL(上記でハイライト表示されている部分)から、次の手順のためにユーザー ID(太字)をコピーして保存しておきます。 必ず、最初に%2F、最後に%3を除外してください。 完了したら、「保存」を選択します。

URL:https://adobedocwinter18test-dev-ed.lightning.force.com/one/one.app?source=aloha#/setup/page?nodeId=ManageUsers&address=%2F0051I000000TA5N%3F

userID を使用してテンプレートを更新する

アプリケーションランチャー/Adobe Acrobat Sign/契約テンプレートに移動します。

編集する契約テンプレート名をクリックします。

「受信者」タブで、「代理送信」フィールドを選択して、このフィールドに Salesforce ユーザーID をペーストします。

プレースホルダー ID を安全に削除できます。

「保存」を選択します。 

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