S-Docs works great with the custom objects and even the Force.com platform edition, which is entirely comprised of custom objects. S-Docs allows you to generate a variety of outputs that can merge Salesforce data from both standard and custom objects. Your documents can span many relationships to include data from formula fields, rich text, parent records, child, grandchild and related objects all within the same document. In addition, using the S-Docs template editor allows you to design the final output using an easy WYSIWYG editor. Finally, you can easily email your finished documents directly from Salesforce and have the entire interaction captured seamlessly as an activity.
Since every organization creates different custom objects to meet their unique requirements, you need to configure S-Docs to recognize which custom objects you want to leverage with S-Docs.
For the purposes of this guide, we assume your custom object is named CustomObj and has an API name of ChangeToYourCustomObj__c. (Note: the API name has two underscores.) S-Docs can also integrate with other AppExchange apps. (Note: there are a few setup differences.) This document will walk you through the step-by-step configuration process and includes many illustrations. It is intended for Salesforce.com administrators who are familiar with standard configuration tasks.
As a note, S-Docs does not use traditional templates (e.g. existing MS Word .dot or PDF files), but rather you design your template and define your merged fields all within Salesforce S-Docs Template records. Each time a user generates a document, the S-Docs engine merges the template record with your Salesforce custom object record data and delivers the merged document all within the Force.com platform. There is no need to have a shared network drive or an external document repository nor the need for connectors, macros or any downloads. You don’t need to log into any other system, share credentials or pass your data to any external servers. It is all self-contained on the Force.com platform.
To take advantage of S-Docs with custom objects you will need to complete the following Salesforce configuration steps (click to scroll down to a specific step):
- Add “ChangeToYourCustomObj__c” as an available picklist value for your S-Docs Templates.
- Create a lookup field named “ChangeToYourCustomObj__c” (note the two underscores) on the SDoc Relationship object - this allows S-Docs records to be linked to your custom object records.
- Create an S-Docs button and place it on your CustomObject’s page layout – this enables users to initiate the document generation process.
- Create your first template- where, as an admin, you design your document layout using the WYSIWYG editor and define what Salesforce data you want to merge.
Detailed instructions are provided below. Sample templates can be found here.
Note: This guide details configuring S-Docs in Salesforce Classic. Although the setups are fairly similar, please reference this documentation for more information regarding S-Docs in Salesforce Lightning.
- Click on Setup (found on at top-right corner of your Salesforce homepage).
- Navigate to App Setup ➤ Create ➤Object.
- Click on the SDoc Template link (not the Edit link).
- Click on the Related to Type link ( found under the "custom fields and relationships" section). Don't click on Edit or Replace links.
- Scroll down to the "Picklist Values" section and click on the New button.
- Add your custom object’s API name (e.g. ChangeToYourCustomObj__c) as a picklist value, then click Save. *Note: if you are using S-Docs with another AppExchange managed package, then your custom object API name should include the domain name of the package followed by two underscores and then the object name (e.g. package__ChangeToYourCustomObj__c). You should use the entire API name for the S-Docs picklist value.
You should substitute your object’s API name (not use the example ChangeToYourCustomObj__c shown above).
STEP 1b: Confirm you can create a template using your Custom Object:
You should now be able to create a template and choose your custom object (e.g. ChangeToYourCustomObj__c) from the picklist in the "Related to type" field. Make sure that the Available for use and Initially Visible checkboxes are checked.
This step allows you to associate the S-Doc with the Custom object, so that users can see a related list of all S-Docs created on your Custom Objects page layout.
- Navigate to Setup ➤ App Setup ➤ Create ➤ Objects.
- Select SDOC_Relationship.
- Under Custom Fields and Relationships click the New button. You will enter the new field wizard:
Step 1 of 6 - Pick Lookup Relationship. Click Next.
Step 2 of 6 - Select your Customer Object (e.g. ChangeToYourCustomObj__c) from picklist values, then click Next.
Step 3 of 6* - Field label and field name should be your custom object name without the “__c.” In our example it would be "CustomObj." Click Next.
Step 4 of 6 - Checkbox should be visible for all users.
Step 5 of 6 - Checkbox should add the field for the layout.
Step 6 of 6 - Accept default. Click Save.
*Note: If you are using S-Docs with another AppExchange managed package, your field name in step 3 above will need to accommodate for the double underscore in the field name, which is not allowed by Salesforce. Since your API name includes the domain name of the package followed by two underscores and then the object name (e.g. package__ChangeToYourCustomObj__c), you will need to replace the first double underscore with “_u_” and remove the remaining “__c.” In our example, your field name should be set to: package_u_CustomObj.
Just like using S-Docs with other objects, you need to place an S-Docs button on the record detail page layout. Users click the button to initiate creating a document from the record detail page.
Step3a: Create the S-Docs button.
- Navigate to Setup ➤ App Setup ➤ Create ➤ Objects.
- From the list of custom objects, click on your Custom Object link. Do not click on the Edit link.
- From the custom object definition page, scroll down to the “Custom Buttons and Links” related list, and click on the New button.
- Type the button Label (e.g. "S-Docs").
- Display Type: choose Detail Page Button.
- Choose a Behavior (we recommend 'Display in existing Window with Sidebar').
- Content Source: Choose URL.
- *Use the following URL without quotes (note that double underscores are used in two places):
*Note: If you are using S-Docs with an object within another AppExchange managed package, your button syntax should include the entire object API name that includes the domain (e.g. package__ChangeToYourCustomObj__c). Note that double underscores are used throughout. Your button syntax should therefore look similar to the following:
- *Optional* You can have users save clicks by enabling the “One-Click” feature. Enabling this will bypass the document creation wizard. An administrator simply needs to change the button definition to include a list of pre-selected S-Docs template IDs that will be automatically generated. Placing this button will let users create all the documents encoded in the button without any additional interaction. The button syntax uses a parameter called “doclist,” which is followed by one or more template IDs to be auto-generated. Here is an example of the button syntax (replace the highlighted values with your own template Ids):
- Click "Save"
Step 3b: Place button on your page layout
- Navigate to the page layout: Setup ➤App Setup ➤ Create ➤ Objects.
- Click on your object name from the Label column (do not click on the Edit link).
- Scroll down to the page layout related list section, and click the Edit link next to the page layout where you want to add the S-Docs button (you will repeat this for each page layout that you want the S-Docs button to appear).
- From the Salesforce page layout screen, click Buttons, located in the top left toolbar menu. Once clicked, the right panel will display available buttons, where you should see your new button.
- Click and begin dragging the S-Docs button that you just created into the lower portion of the page (your custom objects Detail Page Layout). Once you drag the button over the Custom Buttons section, you will see a green checkbox (indicating OK to drop) and you can release the button.
- Be sure to click Save to apply the changes to the page layout and repeat steps 3-6 for any other layouts where you would like to add the button.
If you have already created an S-Docs template for your custom object, you can now open one of your custom object records, click on the S-Docs button, and generate your document. Otherwise, you will need to create at least one S-Docs template to begin using it with your custom Object. The next section describes this step.
- Go to the S-Docs template home page by clicking on All Tabs, and then selecting Templates.
- Click the New button from the S-Doc template object home page.
- Create your Custom Object template record. Be sure to select your Custom Object name from the “related to type” picklist values. Before you can first use this template, you should confirm you have also checked the Available for Use and Initially Visible checkboxes.
- Click Save, then click the Template Editor button.
- Once in the editor mode, you can design your quote template using the WYSIWYG editor. The editor allows you to add text, format styles, insert tables, insert images and merge Salesforce data by using the Insert Field and Insert Related List buttons.
- You can also leverage existing HTML templates by clicking on the Source button and then pasting your HTML. More information regarding template design and sample templates are available here.
- Once your template is saved, you can test it by opening a sample custom object record, clicking on the S-Docs button, selecting your new template, and then clicking on Generate.
- Click on the document link or icon to open the document.
- The document will open on the desktop.