Action engine - Cronologia

Renato.daverio: /* Scripting Task */

2017-11-06T17:06:15Z

‎Scripting Task

Renato.daverio: /* Example: move related Tickets to another Status */

2017-11-06T15:27:21Z

‎Example: move related Tickets to another Status

Renato.daverio: /* Reporting distribution by mail */

2017-11-06T15:26:35Z

‎Reporting distribution by mail

Renato.daverio: /* Example: move related Tickets to another Status */

2017-11-06T15:26:16Z

‎Example: move related Tickets to another Status

Renato.daverio: /* Example: move related Tickets to another Status */

2017-11-06T15:24:53Z

‎Example: move related Tickets to another Status

Renato.daverio: /* Task */

2017-11-06T15:22:06Z

‎Task

Renato.daverio: /* Task */

2017-11-06T14:59:12Z

‎Task

Renato.daverio: /* Basic Task */

2017-11-06T09:58:25Z

‎Basic Task

Renato.daverio: /* Basic Task */

2017-11-06T09:56:51Z

‎Basic Task

Renato.daverio: /* Services */

2017-11-06T09:48:24Z

‎Services

← Versione meno recente		Versione delle 17:06, 6 nov 2017
Riga 234:		Riga 234:

	[[File:Action task settings tab v1.0.jpg\|centre\|thumb\|500x500px\|Action Task Configuration]]		[[File:Action task settings tab v1.0.jpg\|centre\|thumb\|500x500px\|Action Task Configuration]]
		+
		+	===== Example: Update a Ticket Field =====
		+	There are 3 way to update a Ticket Field
		+
		+	//1. Ticket Model Entity - time expensive and complete.
		+	//Ticket Model refresh field values from DB at object instantiation and require a specific call to
		+	//update(....) to save field values.
		+	//ticketService.update (model) method cascade/run following procedure:
		+	// - history: in Ticket Tab will be inserted new record(s)
		+	// - transition related logic: Check if transition is allowed, raise notification etc...
		+	// - new events: new Action Events will be evaluated
		+
		+	function main(event, incomeParameters)
		+	{
		+	var ticketId = 14543;
		+	//STD Field "Short Description"
		+	var ShortDescriptionId = 25;
		+	var ticketService = taskRuntime.getService("TicketService");
		+	var ticket = ticketService.findModelById(new java.lang.Integer(ticketId));
		+	if (ticket == null)
		+	{
		+	taskRuntime.raiseError("ticket is null");
		+	}
		+	//single line
		+	ticket.getCustomFieldValues().put(new java.lang.Integer(ShortDescriptionId), "single line");
		+	//update ticket
		+	ticketService.update(ticket);
		+	}
		+
		+	function main(event, incomeParameters)
		+	{
		+	var ticketId = 14543;
		+	//CF Text Single Line
		+	var CfId = 1159;
		+	var ticketService = taskRuntime.getService("TicketService");
		+	var ticket = ticketService.findModelById(new java.lang.Integer(ticketId));
		+	if (ticket == null)
		+	{
		+	taskRuntime.raiseError("ticket is null");
		+	}
		+	//single line
		+	ticket.getCustomFieldValues().put(new java.lang.Integer(CfId), "single line");
		+	//update ticket
		+	ticketService.update(ticket);
		+	}
		+
		+	//2. Ticket Entity
		+	//Ticket works at hibernate level and is complex to be used for Custom Field.
		+	//For Insert/Update events: an update of value for a STD field with Ticket entity requires a User
		+	//reload of Ticket to see the new value.
		+	//For Event Button events: an update of value for a STD field doesn't require a User reload to see
		+	//new value.
		+
		+	function main(event, incomeParameters)
		+	{
		+	var ticketId = 14543;
		+	var ticketService = taskRuntime.getService("TicketService");
		+	var ticket = ticketService.findEntityById(new java.lang.Integer(ticketId));
		+	if (ticket == null)
		+	{
		+	taskRuntime.raiseError("ticket is null");
		+	}
		+	ticket.setShortDescription("single line");
		+	}
		+
		+	//3. Ticket Meta Entity
		+	//Ticket Meta wraps methods to manage both STD and Custom fields (standard way setValue(...) and
		+	// getValue(...) methods).
		+	//Ticket Meta refresh field values from DB at object instantiation, doen't require a call to update
		+	//(....) to save field values.
		+
		+	function main(event, incomeParameters)
		+	{
		+	var ticketId = 14543;
		+	//STD Field "Short Description"
		+	var ShortDescriptionId = 25;
		+	var ticketService = taskRuntime.getService("TicketService");
		+	var ticket = ticketService.findModelById(new java.lang.Integer(ticketId));
		+	var ticket_ME = ticketService.getMetaEntity(ticket);
		+	if (ticket_ME == null)
		+	{
		+	taskRuntime.raiseError("ticket is null");
		+	}
		+	//update ticket
		+	ticket_ME.setValue(new java.lang.Integer(ShortDescriptionId), "single line");
		+	}
		+
		+	function main(event, incomeParameters)
		+	{
		+	var ticketId = 14543;
		+	//CF Text Single Line
		+	var CfId = 1159;
		+	var ticketService = taskRuntime.getService("TicketService");
		+	var ticket = ticketService.findModelById(new java.lang.Integer(ticketId));
		+	var ticket_ME = ticketService.getMetaEntity(ticket);
		+	if (ticket_ME == null)
		+	{
		+	taskRuntime.raiseError("ticket is null");
		+	}
		+	//update ticket
		+	ticket_ME.setValue(new java.lang.Integer(CfId), "single line");
		+	}

	=== Scripting Task Tutorial ===		=== Scripting Task Tutorial ===

@@ Riga 210: / Riga 210: @@
   In Task Parameters Tab select Task.id.RelatedTickets (or the Alias Action.RelTickets)
-  In Task Conditions Tab insert --> Task.id.RelatedTickets.size <> 0 (or the Alias Action.RelTickets.size <>0)
+  In Task Conditions Tab insert --> Task.id.RelatedTickets.size <> 0
-  In Task Settings Tab insert --> Tickets.ticketType IN ("Incident") AND Tickets.ticketOpStatusName = "In Charge"
+  In Task Settings Tab insert --> Tickets.ticketType IN ("Incident")
   In Task Outcome Tab (eventually) define an Alias for output Tickets collection

@@ Riga 188: / Riga 188: @@
 ===== Reporting distribution by mail =====
 Allows to send a REP report result by mail to some receivers
 ===== Example: move related Tickets to another Status =====

@@ Riga 192: / Riga 192: @@
 ===== Example: move related Tickets to another Status =====
 In this example are listed the Tasks (and their configuration) required to perform following scenario:
-@ A "Change" Ticket (with eventually some related Tickets) is updated in "Completed" Status.
+# A "Change" Ticket (with eventually some related Tickets) is updated in "Completed" Status.
-@ Some of related Tickets could be "Incident".
+# Some of related Tickets could be "Incident".
-@ The "Incident" related Tickets (currently in Status "In Charge") shall be moved in "Completed" Status too.
+# The "Incident" related Tickets (currently in Status "In Charge") shall be moved in "Completed" Status too.
 Action Engine shall be configured as follow:

@@ Riga 192: / Riga 192: @@
 ===== Example: move related Tickets to another Status =====
 In this example are listed the Tasks (and their configuration) required to perform following scenario:
-* A "Change" Ticket with eventually some related Tickets is updated in "Completed" from "Developing"
+@ A "Change" Ticket (with eventually some related Tickets) is updated in "Completed" Status.
-* Some of related Tickets could be "Incident"
+@ Some of related Tickets could be "Incident".
-* The "Incident" related Tickets currently in Status "In Charge" shall be moved in "Completed" too.
+@ The "Incident" related Tickets (currently in Status "In Charge") shall be moved in "Completed" Status too.
 Action Engine shall be configured as follow:
 * Add new Action with "Event Type" = Ticket Updated
 * In Action - Tab "Condition" add:
   (Event.Data.ticketOpStatusName <> "Completed" AND Event.Ticket.ticketOpStatusName = "Completed")
 * In Tab Task add a Task with Type "Select Related Tickets"
   In Task Parameters Tab select Exent.Ticket in auto generated Parameter
   In Task Outcome Tab insert "Alias" = RelTickets in auto generated Parameter
-* In Tab Task add a Task with Type "Select Tickets"
+* In Tab Task add a new Task with Type "Select Tickets"
   In Task Parameters Tab select Task.id.RelatedTickets (or the Alias Action.RelTickets)
@@ Riga 215: / Riga 217: @@
   In Task Outcome Tab (eventually) define an Alias for output Tickets collection
-* In Tab Task add a Task with Type "Execute Tickets Transition"
+* In Tab Task add a new Task with Type "Execute Tickets Transition"
   In Task Parameters Tab select Task.id.SelectedTickets
@@ Riga 221: / Riga 223: @@
   In Task Conditions Tab insert --> Task.id.SelectedTickets.size <> 0
   In Task Settings Tab select "Ticket Type" = Incident and the Transition "In Charge - Completed"
 ==== Scripting Task ====

@@ Riga 128: / Riga 128: @@
 ==== Basic Task ====
-Predefined Task
+The following Task are predefined.
 ===== Create Ticket =====
-Allows to create a new Ticket
+Allows to create a new Ticket.
 ===== Create Ticket Activity =====
-Allows to create a new Ticket Activity
+Allows to create a new Ticket Activity.
 ===== Execute Tickets Transition =====
-Allows to move Ticket in another Workflow Status
+Allows to move Ticket in another Workflow Status.
 ===== Find Tickets =====
-Allows to find Tickets by filter
+Allows to find Tickets by filter.
 ===== Find Ticket Activities =====
-Allows to find Ticket Activities by filter
+Allows to find Ticket Activities by filter.
 ===== Relate Tickets =====
-TBC
+Allows to relate a collection of Tickets to current Ticket.
 ===== Select Related Tickets =====
-Allows to select only related Tickets from current Ticket
+Allows to select the collection of related Tickets from current Ticket.
 ===== Select Related Ticket Activities =====
-Allows to select only related Ticket Activities from current Ticket
+Allows to select the collection of related Ticket Activities from current Ticket.
 ===== Select Tickets =====
-TBC
+Allows to filter some Tickets from an input collection of Tickets.
 ===== Send Ticket Message =====
-Allows to send a Ticket Message to some receivers
+Allows to send a Ticket Message to some receivers.
 ===== Set Ticket Fields =====
-Allows to insert/update values for Ticket fields
+Allows to insert/update values for Ticket fields.
 ===== Set Ticket Activity Fields =====
-Allows to insert/update values for Ticket Activity fields
+Allows to insert/update values for Ticket Activity fields.
 ===== Reporting distribution by mail =====

@@ Riga 412: / Riga 412: @@
   //update ticket
   ticketService.update(ticket);
+  }