How To: Create a DocuSign Envelope List View

Use a DocuSign envelope list view to see all envelopes received, sent, drafted and deleted in the last 30 days. You generate the list view using the DocuSign Envelope SmartObject list method, which, as configured here, returns envelope activity.

DocuSign only returns envelopes used in the last 30 days. To show envelopes older than 30 days, you need to create a custom search filter with parameters to specify a date range. For more information on how to create a custom search filter, see the How To: Create a Custom DocuSign Search Filter for the Envelope List topic.

Before You Begin

The DocuSign service type allows K2 to integrate with DocuSign. For more information on how to enable this integration see DocuSign Feature Activation.

Runtime Example

Scenario

You want to create a list view based on the created, sent, deleted and drafted DocuSign envelopes within the last 30 days.

Steps

In this step, you create a view and add the control.

  1. From the K2 Designer, locate the Envelope SmartObject within the DocuSign category. Select Envelope and click the Generate a View option.
  2. Check the List check box and name the view Envelope List View. Click OK.
  3. Select the Envelope List View and click Edit.
  4. Drag the Drop-Down List control onto the canvas. The control is available in the Input section of the Toolbox.

In this step, you configure the control properties.

  1. Select the Drop-Down List control by clicking on it. Click the ellipsis next to Type in the Data Source section of the control's properties.
  2. The Configure Data Source page shows. In the Use a SmartObject as data source section, click the SmartObject ellipsis to select the Folder SmartObject located within the DocuSign category. Click OK.
  3. Click the Display ellipsis and change the Display value to Name. Click OK.

In this step, you disable an element within the initialize rule.

  1. From the K2 Designer, click the Rules tab. Select the View executed Initialize rule and click on Edit Rule.
  2. Select then execute the List method and uncheck the check box to disable this action.
  3. The initialize rule after disabling the action:
  4. Click OK to close the Rule Designer. The Envelope List View shows as follows:

In this step, you add a rule to the control.

  1. From the K2 Designer, select the Layout tab. Select the Drop-Down List control, click the Rules tab, and then click Add Rule .
  2. On the Rule Designer page, click the select event link and then select Changed.
  3. Select the Actions tab. Select the Execute a method on the View. Click the select method link and select List. Next you click the configure link.
  4. On the Execute the List Method page, expand the Envelope List View in the context browser and drag the Controls > Drop-Down List > Folder > ID property into the Folder ID parameter. Click Finish.
  5. Add a name for this rule, such as When Drop-Down List is Changed. Click OK to close the Rule Designer.
  6. Click Finish to save your changes.

In this step, you run the view.

  1. Select the Envelope List View, right click it, and then select Check In.
  2. Locate and click the Runtime URL.
  3. The list view opens and displays an empty list until you select a folder from the drop down menu at the top, above the filter and search menus.
  4. From the drop down menu, select a folder.
  5. In this example, select Sent Items to view all sent envelopes.