DocuSignとの連携

[まとめページに戻る](https://qiita.com/Keiji_otsubo/items/60afc2a8d211b6f7d89f)
[まとめA～M](https://qiita.com/Keiji_otsubo/items/f3ddedee6793bf1576f8)


まったくDocuSignは使ったことはないのですが、案外質問が多いので備忘録です。

+ [Docusign eSignature for Salesforceまとめ](https://qiita.com/Keiji_otsubo/items/9060cd42d8140811dd32)
+ [DocuSignとCongaの統合](https://qiita.com/Keiji_otsubo/items/1ea1e472df7759932ccf)
+ [Using S-Docs with Salesforce Lightning](https://www.sdocs.com/knowledge-base/sdocs/general-configuration/sdocs-with-salesforce-lightning/)

+ [アプリランチャーのトラブルシューティングツールにアクセスする﻿](https://support.docusign.com/s/document-item?language=en_US&bundleId=srl1586134368658&topicId=avi1598331575670.html&_LANG=enus)
+ [Docusign アプリ ランチャーのトラブルシューティング ページを使用してアカウント全体の問題を修正する﻿](https://support.docusign.com/s/document-item?language=en_US&rsc_301&bundleId=izj1586134369853&topicId=rag1597638195677.html&_LANG=enus)



# 権利放棄の送信者

+ [DocuSign 権利放棄の送信者は常に同じです](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007YvfQv)

DocuSign 権利放棄の送信者は、実際に誰が送信したかに関係なく、常に同じ人に設定されます。実際の送信者がメールの送信者になるようにこれを修正する方法を知っている人はいますか? 

:::note
[新しいドキュメントが生成および保存されました] 画面で [署名用に送信] ボタンを使用している場合は、実際にドキュメントを送信するのが誰であるかに関係なく、DS を SF に接続する統合ユーザーが署名のためにドキュメントを送信します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/c77e7b17-c4ce-0b9a-f575-6f7d6875f9f9.png)

文書を他の人に送信してもらうには、封筒テンプレートと、そのテンプレートを送信するカスタム ボタンが必要です。カスタム ボタンは、封筒テンプレートの「ウィザード」の一部として、関連するページ レイアウトに配置されます。

この記事を参照してください: https://support.docusign.com/s/document-item?bundleId=srl1586134368658&topicId=gou1591745811909.html&_LANG=it
:::

# マルチテンプレートでのエラー　Invalid Envelope. Invalid UUID

+ [Multiple DocuSign Templates Auto Population](https://trailhead.salesforce.com/en/trailblazer-community/feed/0D54S00000Cg0jUSAR)

:::note
UUIDというのがテンプレートのようです。　区切り文字に,を使います。
これが曲者。Salesforceの式で迷うところです。単純に"と"とで囲んだ中で,を使えば問題ないです。
DocuSign用の数式だと知らずにチェックしているとつい,の位置が違うって思ってしまいます。
:::

# Installed Package cannot finish configuring connection: "sf:INSUFFICIENT_ACCESS"

+ [Installed Package cannot finish configuring connection: "sf:INSUFFICIENT_ACCESS"](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX000000NAhQ)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/4780e08a-30e7-5377-4574-33f41171bbf4.png)

:::note
 You were on the right track.  Our fix for this turned out to be to disable "Enforce login IP ranges on every request" 

But I didn't know about the Troubleshooting Page/Tool, so much appreciated!

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/4772ef3c-a4cf-4f96-0fde-dcf415f04bed.png)

正解でした。この問題を解決するには、「すべてのリクエストでログイン IP 範囲を強制する」  を無効にする必要がありました。

しかし、トラブルシューティング ページ/ツールについては知りませんでした。本当に感謝しています。
:::


# Regrant Template": [100] Error occurred Reference ID: 51e1a1cf-5ad4-437b-9f93-484ff0b1167b

+ ["failed to initiate document generation" error](https://trailhead.salesforce.com/en/trailblazer-community/feed/0D54S00000C337V)

:::note
It was a DocuSign issue, they fixed the problem (IM-38513) !
:::

# ユーザーは現在、レコードに関連付けられている既存のSalesforceファイルを検索（またはアクセス）して、送信DocuSignドキュメントに添付することができません。

+ [DocuSign-Salesforceファイルを添付ファイルとして追加する](https://trailhead.salesforce.com/en/trailblazer-community/feed/0D54S00000Hm7zV)

:::note
The user would either need a see all files permission or would have to have the record shared with them (manually or programatically)
:::

# Docusign: Error in $A.getCallback() [TypeError: d is not a function] Failing descriptor: {ltng:outApp}

+ [Docusign: Error in $A.getCallback() [TypeError: d is not a function] Failing descriptor: {ltng:outApp}](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000HDNKh)

:::note
Please note that for DocuSign Apps Launcher (DAL) versions prior to 5.5 it is necessary to disable Lightning Web Security in Salesforce Setup > Session Settings > Lightning Web Security. 

In DAL versions 5.5 and newer this setting is required (enabled).

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/ba82c77c-80c0-4b99-d7c2-4dd74466c60b.png)
:::

# Please verify that you have been granted access to DocuSign, your account settings are correct and that you have responded to all activation emails.

+ [Facing Error while connecting with Docusign](https://trailhead.salesforce.com/en/trailblazer-community/feed/0D54S00000JeKeN)

:::note
Issue in our case is  some one from onsite has deactivated the Docusign admin user  because user left the organization so we faced this issue.

Solution : new user was created and we reconfigured again in salesforce as well as in DocuSign.

私たちの場合の問題は、ユーザーが組織を離れたため、オンサイトの誰かがDocusign管理者ユーザーを無効にしたため、この問題に直面したことです.

解決策 : 新しいユーザーが作成され、Salesforce と DocuSign で再構成しました。
:::

# DocuSignアカウントのアクティブ化について

+ [DocuSignアカウントのアクティブ化について](https://trailhead.salesforce.com/ja/trailblazer-community/feed/0D54S00000JgJELSA3)

:::note
英語のヘルプしかないのかもしれません。
３つの設定方法があるように書かれています。

Learn How to Create and Manage DocuSign Users in Salesforce
https://support.docusign.com/s/document-item?language=en_US&bundleId=izj1586134369853&topicId=zbp1629859390541.html&_LANG=enus
:::

# DocuSign CLM "A Component Error has Occurred!"

+ [DocuSign CLM "A Component Error has Occurred!"](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000JgciBSAR)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/045bb3de-9edd-78d0-d5a3-526e6d1142b2.png)

:::note
After getting into a call with the User, I noticed that the chrome browser randomly started to block the pop-ups for some reason, even though it did not do it before. There was solution was to whitelist the Salesfore URL and the DocuSign URL from allowing pop-ups.


ユーザーとの通話を開始した後、Chrome ブラウザーが何らかの理由でランダムにポップアップをブロックし始めたことに気付きました。ポップアップを許可しないように、Salesfore URL と DocuSign URL をホワイトリストに登録するという解決策がありました。
::: 

+ [DocuSign - create a link to DocuSign envelope and email from Salesforce](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007Pi1kp)

:::note
Please check this article.

Create Envelope Templates in DocuSign eSignature for Salesforce to Automate the Contract Process
https://support.docusign.com/s/document-item?language=en_US&bundleId=srl1586134368658&topicId=gou1591745811909.html&_LANG=enus

Create a Linked Envelope Template
https://support.docusign.com/s/document-item?language=en_US&bundleId=srl1586134368658&topicId=rwo1660537941538.html&_LANG=enus
:::

+ [Mapping a Multiselect picklist merge field on Docusign Envelope](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007RciAM)

:::note
According to Docusign support, it has been clarified that Docusign does not provide support for a Multi-select picklist merge field. However, an alternative approach to achieve similar functionality is by utilizing multiple checkboxes instead.
:::

# 差し込み項目

+ [Merge child fields into DocuSign document](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007Uvaap)

:::note
Relationships: You can only create merge fields in an envelope template if they are related to the Source Object (Account, Opportunity, etc.)

An envelope template using Opportunity as the Source Object will see Account and Opportunity fields, but not Case fields.

Merge fields can access up to four (4) levels of relation to a Source Object. Here are the possible relationship paths:

+ Source Object → Field
+ Source Object → Reference → Field
+ Source Object → Child → Field
+ Source Object → Reference → Reference → Field
+ Source Object → Child → Reference → Field

https://support.docusign.com/s/document-item?language=en_US&bundleId=srl1586134368658&topicId=zce1616797759905.html&_LANG=enus

参照項目: エンベロープ テンプレートに差し込み項目を作成できるのは、差し込み項目がソース オブジェクト (取引先、商談など) に関連している場合のみです。

Opportunity をソース オブジェクトとして使用するエンベロープ テンプレートには、Account フィールドと Opportunity フィールドが表示されますが、Case フィールドは表示されません。

差し込みフィールドは、ソース オブジェクトとの関係の最大 4 レベルにアクセスできます。考えられる関係パスは次のとおりです。
:::

:::note
If you want to user DocuSign merge fields that are coming from SF objects that are not related to the source object (or you have a requirement merge fields from unrelated SF objects), then you have to go for a XML and DocuSign workflow solution (in Product Suit: DocuSign CLM).
:::



+ [DocuSign 署名の差し込みフィールドが機能しない](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007JAwnJ)

:::note
Basically, In the DocuSign Gen Template add the Signature field as a merge field.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/60067218-af13-99d7-14d5-2bef23ee0424.png)

In the DocuSign Envelopes when you add the Signature make sure to set the Template Role as Signer 1.
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/aeb88e30-8633-2609-bc77-f7475b8ec293.png)
:::

+ [DocuSign Gen Salesforce テンプレート - マージフィールド](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007bLI1R)

:::note
DocuSignは現在、複数選択リストのテキストアンカーをサポートしていません。解決策は、フィールドの値を複製してテキスト値を返す数式フィールドをオブジェクト内に作成することです。 
:::

# その他

+ [Using Docusign in Opportunities and Quotes](https://trailhead.salesforce.com/ja/trailblazer-community/feed/0D54S00000HDWDf)
+ [DocuSign アプリ ランチャー: 現在のエンベロープ テンプレートを Salesforce に戻す エンベロープ テンプレートの 1 つが DocuSign Apps Launcher から誤って削除されました。](https://trailhead.salesforce.com/en/trailblazer-community/feed/0D54S00000Jdqi4)
+ [Docusign Gen for CPQ: Parameters for tag <#Content Select#>](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000Jfu5u)
+ [Docusign Gen コンテンツを 1 行で表示する方法](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000JgZJy)
+ [DocuSign Gen XML 構文](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V000077j9CE)
+ [DocuSign 電子署名エンベロープ テンプレートに差し込み項目を追加できません。](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000C4VPZ)
+ [Multiple Conditions for Conditional Content](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007DgXSi)
+ [DocuSign ライセンスを持たない Salesforce ユーザーが、DocuSign System Sender 経由でエンベロープを送信および署名できるか](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000BsRI1)

:::note
I recently just finished setting this up in our system and the documentation Adam provided is a good start but left some notes out. After messing about with the setting and doing some tests i found that the user sending the envelope (Not the system sender assigned) does not need to exist in Docusign or in the E-signature App in salesforce.

The admin assigned to the "System Sender" does need to have a license and account on the Docusign website and in the E-Signature App.

Finally, the user sending the envelope needs the "Docusign User" & "Docusign Sender" permission sets.

Now when your users send envelopes in salesforce, it will show that the Admin assigned as "System Sender" has sent it.

最近、システムでのセットアップを完了したところです。Adam が提供したドキュメントは出発点としては適切ですが、いくつかのメモが省略されています。設定をいじっていくつかのテストを行った結果、エンベロープを送信するユーザー（システムに割り当てられた送信者ではない）は、Docusign または Salesforce の電子署名アプリに存在する必要がないことがわかりました。


「システム送信者」に割り当てられた管理者は、Docusign Web サイトと電子署名アプリのライセンスとアカウントを持っている必要があります。

最後に、エンベロープを送信するユーザーには、「Docusign ユーザー」および「Docusign 送信者」権限セットが必要です。

これで、ユーザーが Salesforce でエンベロープを送信すると、「システム送信者」として割り当てられた管理者が送信したことが表示されます。
:::

+ [Docusign のジェネレータと署名。これを統合しており、ドキュメントを生成して送信するときにうまく機能しています。ただし、ユーザーが署名タグを生成して送信すると、受信者には署名タグが表示されません。私には何が欠けているのでしょうか？](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007aiV3O)

:::note
分かりました。それはDocusignの承認者フィールドの「共有」チェックボックスでした
:::

+ [Omniscript を使用した Docusign テンプレートの生成](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007XI8KN)

:::note
OmniScript 用の DocuSign テンプレートの準備

https://help.salesforce.com/s/articleView?id=sf.os_preparing_a_docusign_template_for_omniscript.htm&type=5
:::


# 翻訳

+ [【未解決】コンポーネント Docusign を翻訳](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007RKYl9)

# リスト内の子「商談製品」レコードを Docusign テンプレートに追加します。

+ [Adding Child "Opportunity Product" Records in a list to a Docusign template.](https://trailhead.salesforce.com/trailblazer-community/feed/0D54S00000A8vpgSAB)

:::note
これは可能ですが、動的ではありません。つまり、存在する可能性のある商談製品ごとに行を明示的に追加する必要があります。製品が 5 つある場合は、5 行を追加する必要があります。
:::


# 資料

+ [Document Generation Word Template Merge Tags](https://support.docusign.com/s/document-item?language=en_US&rsc_301=&bundleId=cky1576795586980&topicId=uno1576795541214.html&_LANG=enus)

# 画面フロー

+ [スクリーンフローからDocuSign Genを起動する](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX000000Ng430AC)

:::note
それをやりました。より細かく制御できるのでとても便利です。Docusign Apps Launcher 6.3.1 統合とNavigate Everywhere画面フロー コンポーネントを使用しています。  

1. DocuSignアプリランチャーアプリにアクセスする
2. テンプレートの1つを編集モードに切り替えます
3. 作成ボタンの矢印に移動します
4. UIを使用して、ページレイアウトで使用するためのドキュメント生成ボタンのバージョンを統合で作成し、保存します。
5. セットアップでは、ボタンを作成したgenテンプレートのオブジェクトマネージャのソースオブジェクトに移動します。
6. オブジェクトのボタン、リンク、アクションに移動します
7. DocuSign UIが作成したボタンを見つけて、「ボタンまたはリンクのURL」をコピーします。
8. 画面フローにnavigateEverywhereLFAアクションを追加する
9. アクションの宛先タイプを url に設定します
10. アクションの宛先URLをコピーしたボタンのURLに設定します。動作させるには、フロー構文に少し翻訳する必要があるでしょう。

例えば：

これは、18 桁の ID とボタン名が変更された、Docusign ボタンが作成した生の URL です。ドキュメント生成ソースは CPQ Quotes であるため、SBQQ__Quote__c.Id が参照されます。

```
{!URLFOR(IF($Site.prefix == '/s','/apex/dfsle__gendocumentgenerator', $Site.Prefix +'/apex/dfsle__gendocumentgenerator'), null, [sId = SBQQ__Quote__c.Id, templateId = '- 18 digit SF gen template ID -', recordId = SBQQ__Quote__c.Id, title = 'Visible Name of Button'])}
```


これは、私が画面フロー テキスト文字列に翻訳した実用的なバリエーションです。これが、私が宛先 URL として提供するものです。

```
URLFOR('/apex/dfsle__gendocumentgenerator', null, [sId = {!varRecordID}, templateId = {!ActualDocGenTemplateToUse}, recordId = {!varRecordID}])
```
:::

# Ending position out of bounds: 0

+ [Adobe Sign Merge Mapping - Out of Bounds Error](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000SXIuv)

:::note
please thoroughly review this help article, and also make sure to enable the "Merge Mapping Error" notification for help troubleshooting: 

1. Navigate to Setup > Platform Tools > Custom Code > Custom Settings.
2. Select Adobe Sign Settings.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/d5d5c6d5-6695-4a60-88ba-3cae1c44c51d.png)


Platform Tools > Custom Code > Cust" style="display: block;" />
3\. On the Adobe Sign Settings page, select Manage.
4\. On the Custom Setting page, select New or Edit.
5\. Select the Enable Mapping Error Notification check box.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/12b29df8-82eb-4611-bb7b-8109d78300ab.png)

The email notification is enabled by default, but can be turned off by adjusting the setting: 
  6\. Select
Save.
:::