Web Forms code example (#143)

* added example

* updates for webforms

* using correct base path

* changing docusign js events

* adding web forms SDK

---------

Co-authored-by: Paige Rossi <paige.rossi@docusign.com>

Author: RomanBachaloSigmaSoftware

app/__init__.py

@@ -12,6 +12,7 @@
 from .monitor import views as monitor_views
 from .admin import views as admin_views
 from .connect import views as connect_views
+from .webforms import views as webforms_views
 from .views import core
 
 session_path = "/tmp/python_recipe_sessions"
@@ -113,6 +114,8 @@
 
 app.register_blueprint(connect_views.cneg001)
 
+app.register_blueprint(webforms_views.weg001)
+
 if "DYNO" in os.environ:  # On Heroku?
     import logging
 

app/consts.py

@@ -22,6 +22,10 @@
 # Name of static pdf file
 pdf_file = "World_Wide_Corp_lorem.pdf"
 
+web_form_template_file = "World_Wide_Corp_Form.pdf"
+
+web_form_config_file = "web-form-config.json"
+
 # Base uri for callback function
 base_uri_suffix = "/restapi"
 
@@ -109,5 +113,6 @@
     "CLICK": "Click",
     "ROOMS": "Rooms",
     "ADMIN": "Admin",
-    "CONNECT": "Connect"
+    "CONNECT": "Connect",
+    "WEBFORMS": "WebForms"
 }

app/docusign/ds_client.py

@@ -33,6 +33,10 @@
     "asset_group_account_read", "asset_group_account_clone_write", "asset_group_account_clone_read"
 ]
 
+WEBFORMS_SCOPES = [
+    "signature", "webforms_read", "webforms_instance_read", "webforms_instance_write"
+]
+
 
 class DSClient:
     ds_app = None
@@ -57,6 +61,8 @@ def _auth_code_grant(cls, api):
             use_scopes.extend(CLICK_SCOPES)
         elif api == "Admin":
             use_scopes.extend(ADMIN_SCOPES)
+        elif api == "WebForms":
+            use_scopes.extend(WEBFORMS_SCOPES)
         else:
             use_scopes.extend(SCOPES)
         # remove duplicate scopes
@@ -93,6 +99,8 @@ def _jwt_auth(cls, api):
             use_scopes.extend(CLICK_SCOPES)
         elif api == "Admin":
             use_scopes.extend(ADMIN_SCOPES)
+        elif api == "WebForms":
+            use_scopes.extend(WEBFORMS_SCOPES)
         else:
             use_scopes.extend(SCOPES)
         # remove duplicate scopes

app/docusign/utils.py

@@ -3,6 +3,7 @@
 import requests
 import urllib
 import json
+import re
 
 from docusign_esign import ApiClient, AccountsApi
 from flask import session, flash, url_for, redirect, render_template, current_app
@@ -146,3 +147,12 @@ def get_user_info(access_token, base_path, oauth_host_name):
     api_client = create_api_client(base_path, access_token)
     api_client.set_oauth_host_name(oauth_host_name)
     return api_client.get_user_info(access_token)
+
+def replace_template_id(file_path, template_id):
+    with open(file_path, 'r') as file:
+        content = file.read()
+
+    content = re.sub('template-id', template_id, content)
+
+    with open(file_path, 'w') as file:
+        file.write(content)

app/ds_config_sample.py

@@ -16,6 +16,7 @@
     "rooms_api_client_host": "https://demo.rooms.docusign.com/restapi",
     "monitor_api_client_host": "https://lens-d.docusign.net",
     "admin_api_client_host": "https://api-d.docusign.net/management",
+    "webforms_api_client_host": "https://apps-d.docusign.com/api/webforms/v1.1",
     "allow_silent_authentication": True,  # a user can be silently authenticated if they have an
     # active login session on another tab of the same browser
     "target_account_id": None,  # Set if you want a specific DocuSign AccountId,

app/static/assets/search.js

@@ -6,6 +6,7 @@ const DS_SEARCH = (function () {
     ROOMS: "rooms",
     ADMIN: "admin",
     CONNECT: "connect",
+    WEBFORMS: "webforms"
   }
 
   const processJSONData = function () {
@@ -142,6 +143,8 @@ const DS_SEARCH = (function () {
         return "eg";
       case API_TYPES.CONNECT:
         return "cneg";
+      case API_TYPES.WEBFORMS:
+        return "weg";
     }
   }
 

app/static/demo_documents/World_Wide_Corp_Web_Form.pdf

@@ -45,7 +45,7 @@ <h2>{{ group["Name"] }}</h2>
                     {% for example in group["Examples"] -%}
                         {% if not example["SkipForLanguages"] or "python" not in example["SkipForLanguages"] %}
                             {% if example.CFREnabled == "AllAccounts" or example.CFREnabled == "CFROnly" %}
-                                {% set api_prefix = "a" if api["Name"] == "Admin" else "c" if api["Name"] == "Click" else "r" if api["Name"] == "Rooms" else "m" if api["Name"] == "Monitor" else "" %}
+                                {% set api_prefix = "a" if api["Name"] == "Admin" else "c" if api["Name"] == "Click" else "r" if api["Name"] == "Rooms" else "m" if api["Name"] == "Monitor" else "w" if api["Name"] == "WebForms" else "" %}
                                 <h4
                                     id="{{ api_prefix + 'example' + '0' * (3 - example['ExampleNumber'] | string() | length ) + example['ExampleNumber'] | string() }}"
                                 >

app/static/demo_documents/web-form-config.json

@@ -45,7 +45,7 @@ <h2>{{ group["Name"] }}</h2>
                     {% for example in group["Examples"] -%}
                         {% if not example["SkipForLanguages"] or "python" not in example["SkipForLanguages"] %}
                             {% if example.CFREnabled != "CFROnly" %}
-                                {% set api_prefix = "a" if api["Name"] == "Admin" else "c" if api["Name"] == "Click" else "r" if api["Name"] == "Rooms" else "m" if api["Name"] == "Monitor" else "cn" if api["Name"] == "Connect" else "" %}
+                                {% set api_prefix = "a" if api["Name"] == "Admin" else "c" if api["Name"] == "Click" else "r" if api["Name"] == "Rooms" else "m" if api["Name"] == "Monitor" else "cn" if api["Name"] == "Connect" else "w" if api["Name"] == "WebForms" else "" %}
                                 <h4
                                     id="{{ api_prefix + 'example' + '0' * (3 - example['ExampleNumber'] | string() | length ) + example['ExampleNumber'] | string() }}"
                                 >