Merge pull request #12 from gadeyredhat/BXMSDOC-3070-master (#1084)

gadeyredhat · sterobin · commit dc9929924e46 · 2018-09-19T08:14:54.000-04:00
SME, peer &amp; QE reviews completed. Merging this PR.
diff --git a/assemblies/assembly_filtering-process-instances/dm/.gitignore b/assemblies/assembly_filtering-process-instances/dm/.gitignore
@@ -0,0 +1 @@
+build
diff --git a/assemblies/assembly_filtering-process-instances/dm/master-docinfo.xml b/assemblies/assembly_filtering-process-instances/dm/master-docinfo.xml
@@ -0,0 +1,8 @@
+<productname>{PRODUCT}</productname>
+<productnumber>{PRODUCT_VERSION}</productnumber>
+<subtitle>
+</subtitle>
+<abstract>
+	<para>This document describes how to filter through process instances of business applications using {CENTRAL} in {PRODUCT} {PRODUCT_VERSION}.</para>
+</abstract>
+<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
diff --git a/assemblies/assembly_filtering-process-instances/dm/master.adoc b/assemblies/assembly_filtering-process-instances/dm/master.adoc
@@ -0,0 +1,4 @@
+
+:DM:
+
+include::topics/main.adoc[]
diff --git a/assemblies/assembly_filtering-process-instances/drools/.gitignore b/assemblies/assembly_filtering-process-instances/drools/.gitignore
@@ -0,0 +1 @@
+build
diff --git a/assemblies/assembly_filtering-process-instances/drools/master-docinfo.xml b/assemblies/assembly_filtering-process-instances/drools/master-docinfo.xml
@@ -0,0 +1,8 @@
+<productname>{PRODUCT}</productname>
+<productnumber>{PRODUCT_VERSION}</productnumber>
+<subtitle>
+</subtitle>
+<abstract>
+	<para>This document describes how to run processes and tasks of business process applications using {CENTRAL} in {PRODUCT} {PRODUCT_VERSION}.</para>
+</abstract>
+<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
diff --git a/assemblies/assembly_filtering-process-instances/drools/master.adoc b/assemblies/assembly_filtering-process-instances/drools/master.adoc
@@ -0,0 +1,4 @@
+
+:DROOLS:
+
+include::topics/main.adoc[]
diff --git a/assemblies/assembly_filtering-process-instances/jbpm/.gitignore b/assemblies/assembly_filtering-process-instances/jbpm/.gitignore
@@ -0,0 +1 @@
+build
diff --git a/assemblies/assembly_filtering-process-instances/jbpm/master-docinfo.xml b/assemblies/assembly_filtering-process-instances/jbpm/master-docinfo.xml
@@ -0,0 +1,8 @@
+<productname>{PRODUCT}</productname>
+<productnumber>{PRODUCT_VERSION}</productnumber>
+<subtitle>
+</subtitle>
+<abstract>
+	<para>This document describes how to run processes and tasks of business process applications using {CENTRAL} in {PRODUCT} {PRODUCT_VERSION}.</para>
+</abstract>
+<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
diff --git a/assemblies/assembly_filtering-process-instances/jbpm/master.adoc b/assemblies/assembly_filtering-process-instances/jbpm/master.adoc
@@ -0,0 +1,4 @@
+
+:JBPM:
+
+include::topics/main.adoc[]
diff --git a/assemblies/assembly_filtering-process-instances/main.adoc b/assemblies/assembly_filtering-process-instances/main.adoc
@@ -0,0 +1,28 @@
+[id='assembly_filtering-process-instances']
+
+include::_artifacts/document-attributes.adoc[]
+
+= Filtering process instances
+// Context attribute is assembly specific and enables module reuse between assemblies.
+:doctype: book
+:imagesdir: _images
+:context: filtering-process-instances
+include::_artifacts/author-group.adoc[]
+
+// Purpose statement for the assembly
+In {PRODUCT}, you can view all process instances from the *Manage Process Instances* page. All users except those with `manager` or `rest-all` roles can access and filter through process instances in {CENTRAL}.
+
+.Prerequisites
+* Red Hat JBoss Enterprise Application Platform 7.1.0 is installed. For more information, see {URL_INSTALLING_ON_EAP}[_{INSTALLING_ON_EAP}_].
+* {PRODUCT} is installed. For more information, see the {URL_INSTALLING_ON_EAP}[_{INSTALLING_ON_EAP}_].
+* {PRODUCT} is running and you can log in to {CENTRAL} with the any role except `manager` and `rest-all`.
+
+// Modules - concepts, procedures, refs, etc.
+include::{enterprise-dir}/processes/interacting-with-processes-process-instances-filters-con.adoc[leveloffset=+1]
+
+include::{enterprise-dir}/processes/interacting-with-processes-process-instances-basic-filters-proc.adoc[leveloffset=+2]
+
+include::{enterprise-dir}/processes/interacting-with-processes-process-instances-advanced-filters-proc.adoc[leveloffset=+2]
+
+// Versioning info
+include::_artifacts/versioning-information.adoc[]
diff --git a/assemblies/assembly_filtering-process-instances/pam/.gitignore b/assemblies/assembly_filtering-process-instances/pam/.gitignore
@@ -0,0 +1 @@
+build
diff --git a/assemblies/assembly_filtering-process-instances/pam/master-docinfo.xml b/assemblies/assembly_filtering-process-instances/pam/master-docinfo.xml
@@ -0,0 +1,8 @@
+<productname>{PRODUCT}</productname>
+<productnumber>{PRODUCT_VERSION}</productnumber>
+<subtitle>
+</subtitle>
+<abstract>
+	<para>This document describes how to filter through process instances of business applications using {CENTRAL} in {PRODUCT} {PRODUCT_VERSION}.</para>
+</abstract>
+<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
diff --git a/assemblies/assembly_filtering-process-instances/pam/master.adoc b/assemblies/assembly_filtering-process-instances/pam/master.adoc
@@ -0,0 +1,4 @@
+
+:PAM:
+
+include::topics/main.adoc[]
diff --git a/assemblies/assembly_interacting-with-processes/main.adoc b/assemblies/assembly_interacting-with-processes/main.adoc
@@ -10,7 +10,7 @@ include::_artifacts/document-attributes.adoc[]
 include::_artifacts/author-group.adoc[]
 
 // Purpose statement for the assembly
-As a knowledge worker, you use {CENTRAL} in {PRODUCT} to run processes and tasks of the business process application developed by citizen developers. A business process is a series of steps which must be executed in a defined manner according to the process flow. You must have sound knowledge of the business process and should be able to determine the current step of a process or task. You can start and stop tasks, search and filter tasks, delegate, claim and release tasks, set due date and priority of tasks, view and add comments to tasks, and view the task history log.
+As a knowledge worker, you use {CENTRAL} in {PRODUCT} to run processes and tasks of the business process application developed by citizen developers. A business process is a series of steps which must be executed in a defined manner according to the process flow. You must have sound knowledge of the business process and should be able to determine the current step of a process or task. You can start and stop tasks, search and filter tasks and process instances, delegate, claim and release tasks, set due date and priority of tasks, view and add comments to tasks, and view the task history log.
 
 .Prerequisites
 * Installed Red Hat JBoss Enterprise Application Platform 7.1.0. For more information, see {URL_INSTALLING_ON_EAP}[_{INSTALLING_ON_EAP}_].
@@ -30,6 +30,12 @@ include::{enterprise-dir}/processes/interacting-with-processes-delegating-claimi
 
 include::{enterprise-dir}/processes/interacting-with-processes-filtering-finding-tasks-proc.adoc[leveloffset=+2]
 
+include::{enterprise-dir}/processes/interacting-with-processes-process-instances-filters-con.adoc[leveloffset=+2]
+
+include::{enterprise-dir}/processes/interacting-with-processes-process-instances-basic-filters-proc.adoc[leveloffset=+3]
+
+include::{enterprise-dir}/processes/interacting-with-processes-process-instances-advanced-filters-proc.adoc[leveloffset=+3]
+
 include::{enterprise-dir}/processes/interacting-with-processes-setting-date-priority-proc.adoc[leveloffset=+2]
 
 include::{enterprise-dir}/processes/interacting-with-processes-viewing-adding-comments-proc.adoc[leveloffset=+2]
@@ -38,7 +44,5 @@ include::{enterprise-dir}/processes/interacting-with-processes-viewing-history-l
 
 include::{enterprise-dir}/processes/interacting-with-processes-migrating-process-designer-proc.adoc[leveloffset=+1]
 
-
-
 // Versioning info
 include::_artifacts/versioning-information.adoc[]
diff --git a/doc-content/enterprise-only/processes/interacting-with-processes-filtering-finding-tasks-proc.adoc b/doc-content/enterprise-only/processes/interacting-with-processes-filtering-finding-tasks-proc.adoc
@@ -1,10 +1,10 @@
 [id='interacting-with-processes-filtering-finding-tasks-proc']
-= Filtering tasks using default or advanced filters
+= Filtering tasks using basic or advanced filters
 
 {Central} provides built-in filters to help you search tasks. You can filter tasks by attributes such as *Status*, *Filter By*, *Process Definition Id*, and *Created On*. It is also possible to create custom task filters using the *Advanced Filters* option. The newly created custom filter is added to the *Saved Filters* pane, which is accessible by clicking on the star icon on the left of the *Task Inbox* page.
 
 [float]
-== Filtering tasks using default filters
+== Filtering tasks using basic filters
 
 .Procedure
 . Go to *Menu* -> *Track* -> *Task Inbox*.
@@ -20,16 +20,15 @@ This pane lists the following task attributes which you can use to filter tasks:
 .. *Process Definition Id*: Filter tasks based on process definition ids.
 .. *Created On*: Filter tasks based on their creation date.
 
-You can use the *Advanced Filters* option available at the bottom of the *Filters* pane to create custom filters in {CENTRAL}.
+You can use the *Advanced Filters* option to create custom filters in {CENTRAL}.
 
 [float]
 == Filtering tasks using advanced filters
 
 .Procedure
 . Go to *Menu* -> *Track* -> *Task Inbox*.
-. On the *Task Inbox* page, click the filter icon on the left of the page to expand the *Filters* pane.
-. In the *Filters* pane, click *Advanced Filters*.
-. In the *New filtered list* window, enter the name and description, and click *Add New*.
+. On the *Task Inbox* page, click the *Advanced Filters* icon on the left of the page to expand it.
+. In the *Advanced Filters* tab, enter the name and description, and click *Add New*.
 . Select an attribute from the *Select column* drop-down list, for example, *Name*. The content of the drop-down changes to *Name != value1*.
 . Click the drop-down again and choose the required logical query. For the *Name* attribute, choose *equals to*.
 . Change the value of the text field to the name of the task you want to filter.
@@ -39,8 +38,7 @@ You can use the *Advanced Filters* option available at the bottom of the *Filter
 The name must match the value defined in the business process of the project.
 ====
 +
-. Click *Ok* and the tasks are filtered according to the filter definition.
-. Click *Save Filters*.
-. In the *Save As* window, enter the name of the filter and click *Save*.
+. Click *Save* and the tasks are filtered according to the filter definition.
+. Click on the star icon to open the *Saved Filters* pane.
 +
-You can view the custom filter by clicking on the star icon on the left of the page to open the *Saved Filters* pane.
+In the *Saved Filters* pane, you can view the saved advanced filters.
diff --git a/doc-content/enterprise-only/processes/interacting-with-processes-process-instances-advanced-filters-proc.adoc b/doc-content/enterprise-only/processes/interacting-with-processes-process-instances-advanced-filters-proc.adoc
@@ -0,0 +1,22 @@
+[id='interacting-with-processes-process-instances-advanced-filters-proc']
+= Filtering process instances using advanced filters
+
+You can create custom process instance filters using the *Advanced* filters option in {CENTRAL}.
+
+.Procedure
+. Go to *Menu* -> *Manage* -> *Process Instances*.
+. On the *Manage Process Instances* page, click on *Advanced Filters* icon.
+. In the *Advanced Filters* pane, enter the name and description of the filter, and click *Add New*.
+. Select an attribute from the *Select column* drop-down list, for example, *processName*. The content of the drop-down changes to *processName != value1*.
+. Click the drop-down again and choose the required logical query. For the *processName* attribute, choose *equals to*.
+. Change the value of the text field to the name of the process you want to filter.
++
+[NOTE]
+====
+The _processName_ must match the value defined in the business process of the project.
+====
++
+. Click *Save* and the processes are filtered according to the filter definition.
+. Click on the star icon to open the *Saved Filters* pane.
++
+In the *Saved Filters* pane, you can view all the saved advanced filters.
diff --git a/doc-content/enterprise-only/processes/interacting-with-processes-process-instances-basic-filters-proc.adoc b/doc-content/enterprise-only/processes/interacting-with-processes-process-instances-basic-filters-proc.adoc
@@ -0,0 +1,24 @@
+[id='interacting-with-processes-process-instances-basic-filters-proc']
+= Filtering process instances using basic filters
+
+{CENTRAL} provides basic filters for filtering and searching through process instances based on their attributes such as *State*, *Errors*, *Filter By*, *Name*, *Start Date*, and *Last update*.
+
+.Procedure
+. Go to *Menu* -> *Manage* -> *Process Instances*.
+. On the *Manage Process Instances* page, click the filter icon on the left of the page to expand the *Filters* pane.
++
+This pane lists the following process attributes which you can use to filter process instances:
++
+* *State*: Filter process instances based on their state (*Active*, *Aborted*, *Completed*, *Pending*, and *Suspended*).
+* *Errors*: Filter process instances that contain at least one or no errors.
+* *Filter By*: Filter process instances based on *Id*, *Initiator*, *Correlation Key*, or *Description* attribute.
++
+... Select the required attribute.
+... Enter the search query in the text field below.
+... Click *Apply*.
+
+* *Name*: Filter process instances based on process definition name.
+* *Start Date*: Filter process instances based on their creation date.
+* *Last update*: Filter process instances based on their last modified date.
+
+You can also use the *Advanced Filters* option to create custom filters in {CENTRAL}.
diff --git a/doc-content/enterprise-only/processes/interacting-with-processes-process-instances-filters-con.adoc b/doc-content/enterprise-only/processes/interacting-with-processes-process-instances-filters-con.adoc
@@ -0,0 +1,9 @@
+[id='interacting-with-processes-process-instances-filters-con']
+= Filtering process instances using basic or advanced filters
+
+{Central} now provides you with basic and advanced filters to help you filter and search through process instances. You can filter processes by attributes such as *State*, *Errors*, *Filter By*, *Name*, *Start Date*, and *Last update*. You can also create custom filters using the *Advanced Filters* option. The newly created custom filter is added to the *Saved Filters* pane, which is accessible by clicking on the star icon on the left of the *Manage Process Instances* page.
+
+[NOTE]
+====
+All users except those with `manager` or `rest-all` roles can access and filter process instances in {CENTRAL}.
+====

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
++
 +:DM:
++
 +include::topics/main.adoc[]