Manual:Extension/Workflows/Activity/SetTemplateParams: Difference between revisions

No edit summary
No edit summary
Line 1: Line 1:
==<span class="mw-headline">Description</span>==
==<span class="mw-headline">Description</span>==
<span style="color: rgb(4, 30, 73)">The ''SetTemplateParams'' activity allows automatic setting of template parameters on a page.</span>  
<span style="color: rgb(4, 30, 73)">The ''SetTemplateParams'' activity allows template parameters to be set automatically on a page.</span>  


* Templates are accessed by the order of appearance on the page.
* Templates are accessed by the order of appearance on the page.
Line 8: Line 8:


{| class="wikitable" style=""
{| class="wikitable" style=""
! colspan="2" style="background-color:rgb(234, 236, 240);text-align:center;" |'''Short profile'''
! colspan="2" style="background-color:rgb(234, 236, 240);text-align:center;" class="" |'''Short profile'''
|-
|-
| style="" |Name
| style="" |Name
Line 27: Line 27:
=== Input properties ===
=== Input properties ===
{| class="wikitable" style="width:100%;"
{| class="wikitable" style="width:100%;"
! style="background-color:rgb(234, 236, 240);text-align:center;" |Name of property
! style="background-color:rgb(234, 236, 240);text-align:center;" class="" |Name of property
!Source
!Source
! style="background-color:rgb(234, 236, 240);text-align:center;" |Description
! style="background-color:rgb(234, 236, 240);text-align:center;" class="" |Description
!Possible values
!Possible values
! style="background-color:rgb(234, 236, 240);text-align:center;" |Type
! style="background-color:rgb(234, 236, 240);text-align:center;" class="" |Type
|-
|-
| style="" |<code>title</code>
| style="" |<code>title</code>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
| style="" |Name of the wiki page that includes the template(s).
| style="" |Name of the wiki page that includes the template(s).
|
|<code>"Main_page"</code>
| style="" |string
| style="" |string
|-
|-
Line 42: Line 42:
|  -
|  -
|Name of user that will be shown as revision user.
|Name of user that will be shown as revision user.
|
|<code>"WikiSysop"</code>
|string
|string
|-
|-
Line 48: Line 48:
|  -
|  -
|Index of the template on page (starting from 0).
|Index of the template on page (starting from 0).
|
|<code>"2"</code>
|int
|int
|-
|-
Line 54: Line 54:
|  -
|  -
|Param to modify. Can be a string in case of named params, or a number, in case of non-named params (starting from 1, accessor for the param)
|Param to modify. Can be a string in case of named params, or a number, in case of non-named params (starting from 1, accessor for the param)
|
|<code>"comment"</code> OR <code>"1"</code>
| rowspan="2" |int, string
| rowspan="2" |int, string
|-
|-
Line 60: Line 60:
|  -
|  -
|New parameter value to set.
|New parameter value to set.
|
|<code>"New value of parameter"</code>
|-
|-
|<code>minor</code>
|<code>minor</code>
|  -
|  -
|<span style="color: rgb(4, 30, 73)">The edit will be marked as</span> ''major'' <span style="color: rgb(4, 30, 73)">or</span> ''minor'' <span style="color: rgb(4, 30, 73)">revision.</span>
|<span style="color: rgb(4, 30, 73)">The edit will be marked as</span> ''major'' <span style="color: rgb(4, 30, 73)">or</span> ''minor'' <span style="color: rgb(4, 30, 73)">revision.</span>
|
|<code>default="0"</code>
*''1'' (=minor revision)
*''1'' (=minor revision)
*''0'' (=major revision)
*''0'' (=major revision)
Line 73: Line 73:
=== Output properties ===
=== Output properties ===
{| class="wikitable" style="width:100%;"
{| class="wikitable" style="width:100%;"
! style="background-color:rgb(234, 236, 240);text-align:center;" |Name of property
! style="background-color:rgb(234, 236, 240);text-align:center;" class="" |Name of property
!Source
!Source
! style="background-color:rgb(234, 236, 240);text-align:center;" |Description
! style="background-color:rgb(234, 236, 240);text-align:center;" class="" |Description
! style="background-color:rgb(234, 236, 240);text-align:center;" |Type
! style="background-color:rgb(234, 236, 240);text-align:center;" class="" |Type
|-
|-
|<code>revisionId</code>
|<code>revisionId</code>

Revision as of 11:32, 22 May 2023

Description

The SetTemplateParams activity allows template parameters to be set automatically on a page.

  • Templates are accessed by the order of appearance on the page.
  • Non-existing templates are counted as links, so they do not count in this list.
  • Params inside the template can be specified by their name, or the index in case of non-named params. Index for non-named params starts at 1 (not 0!), as to be consistent with how template params are accessed in the template itself.
  • Nested templates are not supported as of now.
Short profile
Name SetTemplateParams
Async Yes
BPMN type bpmn:Task
BPMN Extension Element "wf:type" set_template_param

Properties

Input properties

Name of property Source Description Possible values Type
title - Name of the wiki page that includes the template(s). "Main_page" string
user - Name of user that will be shown as revision user. "WikiSysop" string
template-index - Index of the template on page (starting from 0). "2" int
template-param - Param to modify. Can be a string in case of named params, or a number, in case of non-named params (starting from 1, accessor for the param) "comment" OR "1" int, string
value - New parameter value to set. "New value of parameter"
minor - The edit will be marked as major or minor revision. default="0"
  • 1 (=minor revision)
  • 0 (=major revision)
int

Output properties

Name of property Source Description Type
revisionId - The revision ID of the edited page. string
timestamp - The revision time of the edited page. timestamp

Example

<bpmn:task id="EditTemplate" name="Edit template">
	<bpmn:extensionElements>
		<wf:type>set_template_param</wf:type>
	</bpmn:extensionElements>
	<bpmn:property name="title" default="DummyPage" validation="required,existing-title"/>
	<bpmn:property name="user" default="WikiSysop" validation="existing-user"/>
	<!-- Index of the template on page (starting from 0) -->
	<bpmn:property name="template-index" default="2"/>
	<!-- Param to modify. Can be a string in case of named params, or a number, in case of non-named params (starting from 1, accessor for the param) -->
	<bpmn:property name="template-param" default="1"/>
	<!-- New value to set -->
	<bpmn:property name="value" default="Super edited param"/>
	<bpmn:property name="minor" default="0"/>

	<!-- Output properties -->
	<bpmn:property name="revisionId"/>
	<bpmn:property name="timestamp"/>
  <bpmn:incoming>Flow_1qh6vpl</bpmn:incoming>
  <bpmn:outgoing>Flow_0if1kyp</bpmn:outgoing>

</bpmn:task>




To submit feedback about this documentation, visit our community forum.