Distribute App From Table - creates and distributes app documents, using data from the table section.
For each row of the table, a new app document is created and assigned to a user from the designated table column. Values from columns can optionally be passed to the newly created app documents as input parameters, if their names match column aliases.
Where you can use action:
Workflow
Parameters:
App name (type:text) - a name of app to create. Examples:
=APPNAME
APPNAME
=if(1>10, APPNAME1, APPNAME2)
Table section (type:text) - a name of table section with users and params.
Column with user (type:text) - alias of a column that holds users’ ID. New app documents will be distributed to these users. If the email column is left blank, the application will be distributed to the users specified by the workflow.
Example 1:
The section above is shown - a table named SECTION1, where column A has the alias ID, column B has the alias YEAR, and column C has the alias MONTH. Then the workflow will execute the action step Distribute app from table with the parameters:
App name: TEST1
Table section: SECTION1
User column: ID
Creates 4 new instances of app TEST1. Each instance is assigned to a user from column A. Assuming that app TEST1 has input parameters YEAR, MONTH and USER, values from columns B, C and A will be passed to them. (More about input parameters: App Input Parameters)
Example 2:
The section above is shown - a table named SECTION1. Column A has the alias ID, column B has the alias YEAR, and column C has the alias MONTH. Then in the workflow, the action step Distribute app from table with parameters will be executed:
App name: TEST1
Table section: SECTION1
User column: ID
4 new TEST1 app documents will be created. In case the ID column is empty, the editor of the distributed app is the person or group that has been set on the workflow action. Assuming that the TEST1 app has input parameters named YEAR, MONTH and ID, the corresponding values from columns B,C and A will be passed to them.
We will also get the same result if the column with user is left blank.
Remark: When user ID is in USER column, this user is editor of a distributed app. When User column is empty, user, which is set in workflow action in this app (using "set editors", "add editors"), is the editor.
Remark: You can't enter user group in USER column
0 Comments