Create presentation using data links - Zoho Show

Note:

  • This task is applicable to all services except Zoho Creator.
  • Each time the zoho.show.createPresentationUsingDatalinks integration task is executed, it triggers an API request in the back-end. This call is deducted from the external calls limit available for the service from which the task is executed, based on your pricing plan.
  • Only actual executions that receive a response (whether success or failure) are counted, not the number of times the task appears in the script. For example, if zoho.show.createPresentationUsingDatalinks integration task is placed inside a for each task that iterates five times, the number of external calls consumed will be five, even though the task appears only once in the script. 

Overview

This task is used to duplicate an existing presentation or library template and update data link values in the newly created presentation.

Syntax

<response> = zoho.show.createPresentationUsingDatalinks(<rid>, <dataFieldValues>, <docName>, <toPublish>, <teamId>, <folderId>, <connection>);

Scope

ZohoShow.showdocslist.CREATE

Parameter

ParameterDescriptionData type
<response>Variable that holds the details of the created presentationKEY-VALUE
<rid>

ID of the source presentation or library template

Note: Getting the Presentation ID (rid)

  • You can get the presentation ID (rid) directly from the presentation URL.
  • The URL of a Zoho Show presentation will be in the following format:

https://show.zoho.in/show/open/{rid}

Note: Getting the Presentation ID (rid)

  • To get the library template rid:
  • Go to Library → Templates in Zoho Show.
  • Click the three-dot menu next to the required template.
  • Select Edit template.
  • The template opens in a new tab with a URL similar to the one below:

https://show.zoho.in/show/open/{template_rid}

TEXT
<dataFieldValues>Map containing data link (dataField) IDs and their corresponding valuesKEY-VALUE
<docName>Name of the new presentationTEXT
<toPublish>Specifies whether the presentation should be published or notBOOLEAN
<teamId>

WorkDrive team ID

Note:

  • To get the teamId, open the following URL in your browser (make sure you are logged in):

https://show.zoho.in/show/api/presentation/products

  • The API returns a JSON response containing details of your WorkDrive teams.
  • Look for the teamId field in the response.

Sample response (trimmed):

{
  "product": "TEAMDRIVE",
  "teamId": "91382829",
  "name": "Test team"
}
 

In this example,
91382829 is the teamId.

TEXT
<folderId>

WorkDrive folder ID

Note:

  • If folderId is passed as null, the presentation will be created in the My Folder (default location).
  • To use a specific folder, the folderId can be obtained from the WorkDrive URL.

Folder inside My Folder:

https://workdrive.zoho.com/{teamId}/privatespace/folders/{folderId}

Team Folder:

https://workdrive.zoho.com/{teamId}/teams/{teamId}/ws/{teamFolderId}/folders/files

Folder inside a Team Folder:

https://workdrive.zoho.com/{teamId}/teams/{teamId}/ws/{teamFolderId}/folders/{folderId}

TEXT
<connection>Name of Zoho Show connectionCONNECTION

Example

The following script creates a presentation named - User details by duplicating an existing presentation and updating data link values.
Name - Nivesha , Gender- Female

dataFieldValues = Map();
dataFieldValues.put("28X-XXX-XXX-XXX-XXX","Nivesha");
dataFieldValues.put("C1XXX-XXX-XXX-XXX-XXX","Female");
rid = "w7XXXXXX";
teamId = "62XXXXXX";
folderId = "z5XXXXXX";
docName = "User details";
toPublish = true;
response = zoho.show.createPresentationUsingDatalinks(rid, dataFieldValues,docName,toPublish,teamId,folderId,"zoho_show_connection");

where:

w7XXXXXX
-This is the presentation ID.
62XXXXXX
- This is the WorkDrive team ID
z5XXXXXX
- This is the WorkDrive folder ID
User details
- Name of the new presentation that is created
zoho_show_connection
- This is the text that represents the name of the connection link

Response

{
  "CreatedTime": "1587722356436",
  "PresentationId": "lz*********",
  "DocumentName": "User details",
  "OpenURL" : "https://show.zoho.com/show/open/lz*********"
  "Published document url": "https://show.zohopublic.com/publish/lz*********"
}