Using Custom Entities

OneSpan Sign for Microsoft Dynamics CRM permits users to create specialized Custom Entities.

Administrators can use these entities to perform the following procedures:

• Creating a transaction Using a Custom Entity
• Adding a Sub-Grid to Display Associated transactions

Creating a transaction Using a Custom Entity

You can create a OneSpan Sign transaction using the record of an existing Custom Entity. The following procedure describes how to do so by adding a button to the Custom Entity. When that button is clicked, the system will create a new transaction from the Custom Entity record.

To create a OneSpan Sign transaction from an existing Custom Entity:

1. Ensure that in your OneSpan Sign for Microsoft Dynamics CRM organization, the Ribbon Workbench for adding buttons is installed.
2. Log in to OneSpan Sign for Microsoft Dynamics CRM as an Administrator.
3. Navigate to Settings > Customization. A new page appears.



4. Click Ribbon WorkBench.
5. Select the unmanaged solution that contains your Custom Entity, and click OK. A new page appears.



6. Select the Custom Entity from the ENTITIES list. The upper part of the screen may change.
7. In the Solution Elements tab, right-click Commands, and then click Add New.
8. Under Actions, click the search icon, and then click Add.
9. Select Javascript Function Action as the rule, and click OK.
10. Enter SDK.eSignLive.com.Automation.CreatePackage in the Function Name field.
11. Click the search button in the Library field.
12. Select the eSignLive Package Automation Web resource, and click OK.
13. Under Actions, click OK.
14. In the Toolbox section, click Button, then drag and drop it to the Form ribbon.
15. Specify esl.account.Command0.Command as the Command, and provide an Id and Label Text. The Label Text you specify will appear on your new button in the Form ribbon.
16. Click Publish.

The new button becomes available in the Custom Entity, and clicking it will create a new transaction.

Adding a Sub-Grid to Display Associated transactions

You may want to add a transaction sub-grid to a Custom Entity in order to display the OneSpan Sign transactions associated with that entity. If so, perform the following procedure.

To add a transaction sub-grid to a Custom Entity:

1. Log in to OneSpan Sign for Microsoft Dynamics CRM as an Administrator.
2. Navigate to Settings > Customization. A new page appears.

3. Click either Customize the System or Solutions.

   If you click Solutions, the solution you select must: (1) contain your Custom Entity; (2) be unmanaged.

A new page appears.



4. From the menu, expand Entities, and select the relevant Custom Entity.
5. Select Forms.
6. Double-click the form where you want to add the sub-grid. A new page appears.



7. From the top menu, click the Insert tab.
8. Select the Sub-Grid option. A new dialog box appears.
9. In the Set Properties panel:
   • Type the Schema name for the sub-grid control.
   • In the Label field, type the display name of the sub-grid.
10. In the Data Source panel:
    • Ensure that records are selected with the Only Related Records option.
    • The views related to the Custom Entity are displayed under the Entity drop-down list. Select the esignLivePackages view.
11. In the Additional Options panel:
    • Select the Required View from the View Selector options.
    • Select the Off option in the View Selector.
12. Click Set. The sub-grid is added to the form's tab location (see Step 7).
13. Click the Home tab, and then click Save.
14. Click Publish. A transaction sub-grid is added to the Custom Entity's form (see Step 6).