Merge pull request #155 from docusign/add-code-snippets-connected-fields

add code snippets for Connected Fields

Author: nianiB9

src/main/java/com/docusign/controller/connectedFields/examples/AbstractConnectedFieldsController.java

@@ -37,10 +37,12 @@ public AbstractConnectedFieldsController(DSConfiguration config, String exampleN
     protected static ApiClient createApiClient(
             String accessToken,
             String basePath) {
+        //ds-snippet-start:ConnectedFields1Step2
         ApiClient apiClient = new ApiClient(basePath);
         apiClient.addDefaultHeader(
                 HttpHeaders.AUTHORIZATION,
                 BEARER_AUTHENTICATION + accessToken);
+        //ds-snippet-end:ConnectedFields1Step2
 
         return apiClient;
     }
@@ -54,8 +56,12 @@ protected static ApiClient createApiClient(
      * @return an instance of the {@link EnvelopesApi}
      */
     protected EnvelopesApi createEnvelopesApi(String basePath, String userAccessToken) {
+    //ds-snippet-start:ConnectedFields1Step6
+
         ApiClient apiClient = createApiClient(userAccessToken, basePath);
         return new EnvelopesApi(apiClient);
+    //ds-snippet-end:ConnectedFields1Step6
+
     }
 
     protected String getExamplePagesPath() {

src/main/java/com/docusign/controller/connectedFields/examples/CF001SetConnectedFields.java

@@ -63,7 +63,7 @@ protected Object doWork(WorkArguments args, ModelMap model, HttpServletResponse
         JsonNode extensionApp = SetConnectedFieldsService.findAppById(
                 this.session.getExtensionApps(),
                 args.getAppId());
-
+        //ds-snippet-start:ConnectedFields1Step6
         EnvelopesApi envelopesApi = createEnvelopesApi(session.getBasePath(), user.getAccessToken());
 
         EnvelopeDefinition envelope = SetConnectedFieldsService.makeEnvelope(
@@ -74,6 +74,7 @@ protected Object doWork(WorkArguments args, ModelMap model, HttpServletResponse
                 envelopesApi,
                 session.getAccountId(),
                 envelope);
+        //ds-snippet-end:ConnectedFields1Step6
 
         DoneExample.createDefault(getTextForCodeExampleByApiType().ExampleName)
                 .withMessage(getTextForCodeExampleByApiType().ResultsPageText

src/main/java/com/docusign/controller/connectedFields/services/SetConnectedFieldsService.java

@@ -59,6 +59,7 @@ public static EnvelopeSummary signingViaEmail(
 		return envelopesApi.createEnvelope(accountId, envelope);
 	}
 
+        //ds-snippet-start:ConnectedFields1Step3
 	public static String getConnectedFieldsTabGroups(String accountId, String accessToken) throws Exception {
 		String url = String.format(
 				"https://api-d.docusign.com/v1/accounts/%s/connected-fields/tab-groups",
@@ -70,6 +71,8 @@ public static String getConnectedFieldsTabGroups(String accountId, String access
 				.header("Authorization", "Bearer " + accessToken)
 				.header("Accept", "application/json")
 				.build();
+		//ds-snippet-end:ConnectedFields1Step3
+
 
 		try {
 			HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
@@ -86,8 +89,12 @@ public static String getConnectedFieldsTabGroups(String accountId, String access
 
 	public static EnvelopeDefinition makeEnvelope(String signerEmail, String signerName, JsonNode selectedApp)
 			throws Exception {
+        //ds-snippet-start:ConnectedFields1Step4
 		String appId = selectedApp.has(APP_ID) ? selectedApp.get(APP_ID).asText() : "";
+	    //ds-snippet-end:ConnectedFields1Step4
+
 		JsonNode tabLabels = selectedApp.get(TABS);
+        //ds-snippet-start:ConnectedFields1Step5
 
 		EnvelopeDefinition envelopeDefinition = new EnvelopeDefinition();
 		envelopeDefinition.setEmailSubject("Please sign this document set");
@@ -111,9 +118,10 @@ public static EnvelopeDefinition makeEnvelope(String signerEmail, String signerN
 		signHere.setAnchorUnits("pixels");
 		signHere.setAnchorYOffset("10");
 		signHere.setAnchorXOffset("20");
+        //ds-snippet-end:ConnectedFields1Step5
 
 		List<Text> textTabs = new ArrayList<Text>();
-
+        //ds-snippet-start:ConnectedFields1Step4
 		if (tabLabels != null && tabLabels.isArray()) {
 			for (JsonNode tab : tabLabels) {
 				JsonNode extensionData = tab.get(EXTENSION_DATA);
@@ -138,7 +146,9 @@ public static EnvelopeDefinition makeEnvelope(String signerEmail, String signerN
 				String extensionContract = getText(extensionData, "extensionContract");
 				String requiredForExtension = getText(extensionData, "requiredForExtension");
 				String tabLabel = getText(tab, TAB_LABEL);
+        //ds-snippet-end:ConnectedFields1Step4
 
+        //ds-snippet-start:ConnectedFields1Step5
 				Text textTab = new Text();
 				textTab.setRequireInitialOnSharedChange("false");
 				textTab.setRequireAll("false");
@@ -194,6 +204,7 @@ public static EnvelopeDefinition makeEnvelope(String signerEmail, String signerN
 		envelopeDefinition.setRecipients(recipients);
 
 		return envelopeDefinition;
+		//ds-snippet-end:ConnectedFields1Step5
 	}
 
 	public static List<Map<String, String>> convertJsonToList(String jsonString) throws Exception {