Stages Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
Last revisionBoth sides next revision
72:custom_reports_getting_started_creating_data_collector [2019/02/07 14:31] – created ext-bkkr72:custom_reports_getting_started_creating_data_collector [2019/02/27 17:39] – ext-bkkr
Line 1: Line 1:
 ====== Creating Stages Data Collector ====== ====== Creating Stages Data Collector ======
 +
 +==== Create a Data Collector ====
 +
 +  - Log into Stages as a user different to the superuser (administrator).
 +      - The user needs at least (RMC) permissions of the domain Reports and Data Collectors.
 +      - //Note: Otherwise you cannot get the Data Collector running because the Data Collector is running in the context of the user who saved the collector the last time. For security reasons, the superuser context is disabled.//
 +  - Select your metric in the Processes Application in Stages where you want to add a Data Collector.
 +  - Select the Data Collectors tab, click on the **+ SIgn** to add a new Data Collector.
 +  - Enter a name for this Data Collector and click on the **Script** tab.
 +  - Click the **More** button to enter the first Column name "DocumentName" and continue with the others.
 +  - Enter a data collector script.
 +
 +<code>
 +var artifacts =
 +pkit.getCurrentProject().getEntities("containsProcess@SYSTEM")
 +[0].getEntities("containsArtifact@SYSTEM");
 +for (i = 0; i <artifacts.length; i++) {
 +var artifacts_instances =
 + artifacts[i].getEntities("containsInstance@SYSTEM");
 +for (j = 0; j <artifacts_instances.length; j++) {
 + var artifacts_revisions =
 + artifacts_instances[j].getEntities("containsRevision@SYSTEM");
 +if (artifacts_revisions.length == 0) {
 + dataset.setColumnValue("State", "no version");
 + } else {
 + dataset.setColumnValue("State",
 + artifacts_revisions[0].getProperty("state"));
 + }
 + dataset.setColumnValue("DocumentName",
 + artifacts_instances[j].getProperty("LogicalName"));
 + dataset.storeResultRow();
 + }
 +}
 +</code>
 +
 +Click on **Save**
 +
 +Click on the **Preview** tab to see a preview on the results.
 +
 +Click on the **Script **tab and click **Save**  to store the Data collector.
 +
 +==== Add a Collection Interval ====
 +
 +  - Click on the Data Collector to get the context menu and select **Add collection**  interval.
 +  - Enter the cron expression.
 +  - Click Save to store the interval.
 +
 +====   ====