Przeszukiwanie procesów i zadań

Zapytanie TWSearch zawiera następujące kroki.

1. Zdefiniuj kolumnę danych, które mają zostać pobrane. Patrz Kolumny.
2. Zdefiniuj filtry, które mają zostać zastosowane do kolumny. Patrz sekcja Filtry wyszukiwania.
3. Zdefiniuj porządek sortowania zwracanych rekordów. Patrz Kolejność wyników wyszukiwania.
4. Zdefiniuj sposób organizowania wyników. Patrz: organizacja wyników wyszukiwania.
5. Wykonaj wyszukiwanie i przeanalizuj wyniki w celu uzyskania listy zmiennych złożonych. Patrz: Wykonanie wyszukiwania.

Wszystkie kolumny, warunki i kryteria sortowania są przechowywane przez obiekt TWSearch.

var search = new TWSearch();

Każda kolumna, która ma zostać zwrócona, jest zdefiniowana jako obiekt TWSearchColumn. W poniższym kodzie przykładowym jest definiowana kolumna, która zwraca identyfikator instancji procesu.

var colInstanceId = new TWSearchColumn();
colInstanceId.type = TWSearchColumn.Types.ProcessInstance;
colInstanceId.name = TWSearchColumn.ProcessInstanceColumns.ID;

Każda kolumna ma typ i nazwę. Najczęściej używane typy to: ProcessInstance, Task i BusinessData.

TWSearchColumn.Types.ProcessInstance
TWSearchColumn.Types.Task
TWSearchColumn.Types.BusinessData

W poniższym przykładzie kolumna dla danych biznesowych ma nazwę serviceOrderNumber.

var colServiceOrderNumber = new TWSearchColumn;
colServiceOrderNumber.type = TWSearchColumn.Types.BusinessData;
colServiceOrderNumber.name = "serviceOrderNumber";

Istnieje możliwość wyszukiwania tablic kolumn – przedstawiono to poniżej.

search.columns =
     new Array(
       colInstanceStatus,
     colInstanceId,
     colInstanceName,
     colTaskId,
     colTaskStatus,
     colClosedDateTime,
     colDueDateTime,
     );

Definiując warunki, można zastosować filtry do dowolnej kolumny. Każdy warunek definiuje się jako obiekt TWSearchCondition. W poniższym przykładowym kodzie jest definiowana kolumna, która pobiera nazwę instancji procesu, a następnie zawęża wyniki do nazw instancji procesów, które rozpoczynają się od łańcucha Service Order Fulfillment (Realizacja zamówienia na usługę).

var colInstanceName = new TWSearchColumn();
colInstanceName.type = TWSearchColumn.Types.ProcessInstance;
colInstanceName.name = TWSearchColumn.ProcessInstanceColumns.Name;
     
var condInstanceName = new TWSearchCondition;
condInstanceName.column = colInstanceName;
condInstanceName.operator = TWSearchCondition.Operations.StartsWith;
condInstanceName.value = "Service Order Fulfillment:";

Jeśli warunek daty jest tworzony przy użyciu obiektu TWDate, należy najpierw przekształcić datę w łańcuch, gdy zostanie skonstruowany warunek. Następujący kod przykładowy definiuje kolumnę, która zwraca datę zakończenia zadania, a następnie definiuje before i after jako warunek daty zakończenia.

var colDueDateTime = new TWSearchColumn;
colDueDateTime.type = TWSearchColumn.Types.Task;
colDueDateTime.name = TWSearchColumn.TaskColumns.DueDate;
  
var condDueDateTimeBefore = new TWSearchCondition;
condDueDateTimeBefore.column = colDueDateTime;
condDueDateTimeBefore.operator = TWSearchCondition.Operations.LessThan;
condDueDateTimeBefore.value = tw.local.dueDateBefore.format("MM/dd/yyyy HH:mm:ss", "PST");
 
var condDueDateTimeAfter = new TWSearchCondition;
condDueDateTimeAfter.column = colDueDateTime;
condDueDateTimeAfter.operator = TWSearchCondition.Operations.GreaterThan;
condDueDateTimeAfter.value = tw.local.dueDateAfter.format("MM/dd/yyyy HH:mm:ss", "PST");

W poprzednim przykładzie przedstawiono również możliwość zdefiniowania wielu warunków dla jednej kolumny. Aby określić wyniki, wyszukiwanie stosuje wszystkie warunki jako tablicę warunków niewykluczających (niejawny operator AND).

var conditions = new Array(condInstanceName, condInstanceStatus, condTaskStatus);
search.conditions = conditions;

Jeśli warunki wyszukiwania są dynamiczne, można wykorzystać metodę tablicową JavaScript push przedstawioną w kolejnym przykładzie kodu.

var conditions = new Array(condInstanceName, condInstanceStatus, condTaskStatus);
 if(tw.local.fieldRepIdentifier != "All") {
 conditions.push(condFieldRepIdentifier);
 }
 search.conditions = conditions;

W przypadku każdej kolumny można zdefiniować kryteria porządkowania. Każda kolejność jest definiowana jako obiekt TWSearchOrdering. Poniższy kod przykładowy wyświetla listę pobranych identyfikatorów instancji procesów w porządku rosnącym.

var orderInstanceId = new TWSearchOrdering();
orderInstanceId .column = colInstanceId;
orderInstanceId .order = TWSearchOrdering.Orders.Ascending;

Wyszukiwanie przechowuje tablicę wszystkich kryteriów porządkowania, które mają zostać zastosowane do wyników.

search.orderBy = new Array(orderInstanceId );

Konieczne jest również wskazanie, czy wyniki mają być organizowane wg instancji procesu, czy wg zadania. W tym celu należy użyć obiektu TWSearch.organizedBy. Zachowanie jest takie samo jak zachowanie zapisanych wyszukiwań w Process Portal. W przypadku organizowania wg instancji procesu zostanie uzyskany jeden wynik na instancję procesu. Poniższy kod przykładowy organizuje wyniki wyszukiwania wg zadania.

search.organizedBy = TWSearch.OrganizeByTypes.Task;

Po podaniu kolumn, warunków, porządku i sposobu organizowania wyszukiwania można je wykonać, aby pobrać tablicę wierszy JavaScript.

var results = search.execute();

Metoda execute zwraca obiekty TWSearchResults.

Poniższy kod analizuje rodzimą tablicę JavaScript w celu utworzenia tablicy zmiennych niestandardowych.

tw.local.serviceOrderTasks = new tw.object.listOf.ServiceOrderTask();
 for(var i = 0; i < results.rows.length; i++) {
   var row = results.rows[i];
   tw.local.serviceOrderTasks[i] = new tw.object.ServiceOrderTask();
 
   tw.local.serviceOrderTasks[i].processInstanceId = row.values[0].toString();
   tw.local.serviceOrderTasks[i].processInstanceName = row.values[1].toString();
   tw.local.serviceOrderTasks[i].taskId = row.values[2].toString();
   tw.local.serviceOrderTasks[i].taskStatus = row.values[3].toString();
   if(null != row.values[4])
   {
     tw.local.serviceOrderTasks[i].closedDate = row.values[4].toString();
   }
   if(null != row.values[5])
   {
     tw.local.serviceOrderTasks[i].dueDate = row.values[5].toString();
   }   
 }

SystemErr     R RHINO USAGE WARNING: Missed Context.javaToJS()  
conversion:                                                     
Rhino runtime detected object Tue May 05 08:00:00 EDT 2020 of   
class java.util.Date where it expected String, Number, Boolean  
or Scriptable instance. Please check your code for missing      
Context.javaToJS() call.