QPR ProcessAnalyzer Expression Query Examples: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page contains example KPI Analyses.
This page contains example expression queries.


== Single ValueType Examples ==
== Single ValueType Examples ==
Line 51: Line 51:


=== Cases grouped by case attributes ===
=== Cases grouped by case attributes ===
Same analysis for for case attributes:
Same analysis for case attributes:
<pre>
<pre>
{
{
Line 83: Line 83:
       "Name": "Category",
       "Name": "Category",
       "Direction": "Ascending"
       "Direction": "Ascending"
    }
  ]
}
</pre>
=== Flows Statistics===
<pre>
{
  "Root": "
    Let(\"flowDifferences\", Flows.(_.AverageDuration-_.MedianDuration));
    Let(\"minDifference\", Min(flowDifferences));
    Let(\"maxDifference\", Max(flowDifferences));
    Let(\"range\", maxDifference-minDifference);
    Flows;",
  "RowInitExpression": "
    Let(\"difference\", _.AverageDuration - _.MedianDuration);
    Let(\"caseCount\", Count(_.Cases));
    Let(\"FlowOccurrenceCount\", Count(_.FlowOccurrences));",
  "Values": [
    {
      "name": "Flow",
      "expression": "_.From.if(isnull(_), \"START\", _.Name) + \" -> \" + _.To.if(isnull(_), \"END\", _.Name)"
    },
    {
      "name": "Flow bottleneck index",
      "expression": "(difference - minDifference).TotalSeconds / range.TotalSeconds * 100"
    },
    {
      "name": "Difference between average and median duration (days)",
      "expression": "difference.TotalDays"
    },
    {
      "name": "Average duration (days)",
      "expression": "_.AverageDuration.TotalDays"
    },
    {
      "name": "Median duration (days)",
      "expression": "_.MedianDuration.TotalDays"
    },
    {
      "name": "Duration standard deviation (days)",
      "expression": "_.DurationStandardDeviation.TotalDays"
    },
    {
      "name": "Case count",
      "expression": "caseCount"
    },
    {
      "name": "Flow occurrence count",
      "expression": "FlowOccurrenceCount"
    },
    {
      "name": "Rework %",
      "expression": "(FlowOccurrenceCount / caseCount - 1) * 100"
    }
  ],
  "Ordering": [
    {
      "name": "Flow bottleneck index",
      "Direction": "Descending"
     }
     }
   ]
   ]
Line 113: Line 174:
       "Name": "Case count",
       "Name": "Case count",
       "Expression": "Count(_)"  
       "Expression": "Count(_)"  
    }
  ]
}
</pre>
=== 3 Grams ===
<pre>
{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "CaseId",
      "Expression": "Name"
    }
  ],
  "Values": [
    {
      "Expression": "
        Flatten(
          _
          .Array(
            StringJoin(\"->\",
            Array(\"0\",
              GetAt(0, Events).Type.Name,
              If(
                Count(Events) > 1,
                GetAt(1, Events).Type.Name,
                \"0\"
                )
              )
            ),
            StringJoin(\"->\",
              Events.Where(!IsNull(NextInCase))
              .Array(Type.Name,
                NextInCase.Type.Name,
                If(
                  !IsNull(NextInCase.NextInCase),
                  NextInCase.NextInCase.Type.Name,
                  \"0\"
                )
              )
            )
          )
        ).Where(_ != \"\")
      ",
      "DimensionOrderExpression": "OrderByValue(_)",
      "Type": "Pivot"
    }
  ],
  "Ordering": [
    {
      "Name": "CaseId",
      "Direction": "Ascending"
     }
     }
   ]
   ]
Line 172: Line 180:


=== Case duration distribution by hours ===
=== Case duration distribution by hours ===
Following analysis shows case duration distribution by hours (works like the [[Duration_Analysis_(PAPO)|Duration Analysis]])
Following analysis shows case duration distribution by hours (works like the Duration Analysis)
<pre>
<pre>
{
{
Line 224: Line 232:
</pre>
</pre>


=== Influence Analysis for Case Attributes ===
=== Root Causes for Case Attributes ===
The following example shows how to create the [[Influence_Analysis_for_Case_Attributes_(PAPO)|Influence Analysis for Case Attributes]] using the expression language. To run this query, you must set '''RuntimeComparison'''='''1''' in order to get the [[Generic_Properties_and_Functions_in_QPR_ProcessAnalyzer_Expressions#Generic Properties|ComparisonEventLog]] available in the expressions. You also need to pass the [[Filtering_in_QPR_ProcessAnalyzer_Queries|Comparison]] parameter which the influence analysis comparison between case sets is based on.
The following example shows how to create the Root Causes using the expression language. You need to pass the Comparison parameter which the influence analysis comparison between case sets is based on.


<pre>
<pre>
Line 307: Line 315:
     {
     {
       "Name": "Value",
       "Name": "Value",
      "Direction": "Ascending"
    }
  ]
}
</pre>
=== 3 Grams ===
<pre>
{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "CaseId",
      "Expression": "Name"
    }
  ],
  "Values": [
    {
      "Expression": "
        Flatten(
          _
          .Array(
            StringJoin(\"->\",
            Array(\"0\",
              GetAt(0, Events).Type.Name,
              If(
                Count(Events) > 1,
                GetAt(1, Events).Type.Name,
                \"0\"
                )
              )
            ),
            StringJoin(\"->\",
              Events.Where(!IsNull(NextInCase))
              .Array(Type.Name,
                NextInCase.Type.Name,
                If(
                  !IsNull(NextInCase.NextInCase),
                  NextInCase.NextInCase.Type.Name,
                  \"0\"
                )
              )
            )
          )
        ).Where(_ != \"\")
      ",
      "DimensionOrderExpression": "OrderByValue(_)",
      "Type": "Pivot"
    }
  ],
  "Ordering": [
    {
      "Name": "CaseId",
       "Direction": "Ascending"
       "Direction": "Ascending"
     }
     }
Line 389: Line 450:
* Seconds: Timerange(Datetime(2017,1,1), Datetime(2017,1,2), Timespan(0, 0, 0, 1))
* Seconds: Timerange(Datetime(2017,1,1), Datetime(2017,1,2), Timespan(0, 0, 0, 1))


For equal duration time ranges, the [[QPR_ProcessAnalyzer Expressions#Other functions|Timespan]] function is the useful, and for non-equal durations, the [[QPR_ProcessAnalyzer Expressions#Other functions|For]] function needs to be used.
For equal duration time ranges, the Timespan function is the useful, and for non-equal durations, the For function needs to be used.


== Pivot ValueType Examples ==
== Pivot ValueType Examples ==
Line 510: Line 571:


</pre>
</pre>
[[Category: QPR UI]]
[[Category: QPR ProcessAnalyzer]]

Latest revision as of 22:19, 18 April 2023

This page contains example expression queries.

Single ValueType Examples

Events grouped by event attributes

The following analysis calculates:

  1. Number of cases
  2. List of case names
  3. List of distinct case names (single case appears only once in the list)

for each event attribute Color and Category.

{
  "Root": "Events",
  "Dimensions": [
    {
      "Name": "Color",
      "Expression": "Color"
    },
    {
      "Name": "Category",
      "Expression": "Category"
    }
  ],
  "Values": [
    {
      "Name": "Count",
      "Expression": "Count(_)" 
    },
    {
      "Name": "Cases",
      "Expression": "StringJoin(\",\", _.Case.Name)" 
    },
    {
      "Name": "DistinctCases",
      "Expression": "StringJoin(\",\", Distinct(_.Case.Name))" 
    }
  ],
  "Ordering": [ 
    {
      "Name": "Color",
      "Direction": "Ascending"
    },
    {
      "Name": "Category",
      "Direction": "Descending"
    }
  ]
}

Cases grouped by case attributes

Same analysis for case attributes:

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "Color",
      "Expression": "Color"
    },
    {
      "Name": "Category",
      "Expression": "Category"
    }
  ],
  "Values": [
    {
      "Name": "Count",
      "Expression": "Count(_)" 
    },
    {
      "Name": "Cases",
      "Expression": "StringJoin(\",\", _.Name)" 
    }
    ],
  "Ordering": [ 
    {
      "Name": "Color",
      "Direction": "Ascending"
    },
    {
      "Name": "Category",
      "Direction": "Ascending"
    }
  ]
}

Flows Statistics

{
  "Root": "
    Let(\"flowDifferences\", Flows.(_.AverageDuration-_.MedianDuration));
    Let(\"minDifference\", Min(flowDifferences));
    Let(\"maxDifference\", Max(flowDifferences));
    Let(\"range\", maxDifference-minDifference);
    Flows;",
  "RowInitExpression": "
    Let(\"difference\", _.AverageDuration - _.MedianDuration);
    Let(\"caseCount\", Count(_.Cases));
    Let(\"FlowOccurrenceCount\", Count(_.FlowOccurrences));",
  "Values": [
    {
      "name": "Flow",
      "expression": "_.From.if(isnull(_), \"START\", _.Name) + \" -> \" + _.To.if(isnull(_), \"END\", _.Name)"
    },
    {
      "name": "Flow bottleneck index",
      "expression": "(difference - minDifference).TotalSeconds / range.TotalSeconds * 100"
    },
    {
      "name": "Difference between average and median duration (days)",
      "expression": "difference.TotalDays"
    },
    {
      "name": "Average duration (days)",
      "expression": "_.AverageDuration.TotalDays"
    },
    {
      "name": "Median duration (days)",
      "expression": "_.MedianDuration.TotalDays"
    },
    {
      "name": "Duration standard deviation (days)",
      "expression": "_.DurationStandardDeviation.TotalDays"
    },
    {
      "name": "Case count",
      "expression": "caseCount"
    },
    {
      "name": "Flow occurrence count",
      "expression": "FlowOccurrenceCount"
    },
    {
      "name": "Rework %",
      "expression": "(FlowOccurrenceCount / caseCount - 1) * 100"
    }
  ],
  "Ordering": [
    {
      "name": "Flow bottleneck index",
      "Direction": "Descending"
    }
  ]
}

Return only dimension values

The following analysis returns a list of all dimensions but doesn't calculate any KPI's:

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "Region",
      "Expression": "Region"
    }
  ],
  "Values": []
}

Return only single KPI value without dimensioning

The following analysis calculates a KPI for all filtered data but doesn't slice it to any dimensions:

{
  "Root": "Cases",
  "Dimensions": [],
  "Values": [
    {
      "Name": "Case count",
      "Expression": "Count(_)" 
    }
  ]
}

Case duration distribution by hours

Following analysis shows case duration distribution by hours (works like the Duration Analysis)

{
  "Root": "Cases",
    "Dimensions": [
      {
        "Name": "Case Duration in Hours",
        "Expression": "Duration.TotalHours.Round(0)"
      }
    ],
    "Values": [
      {
        "Name": "Case Count",
        "Expression": "Count(_)" 
      }
    ],
    "Ordering": [ 
      {
        "Name": "Case Duration in Hours",
        "Direction": "Ascending"
    }
  ]
}

Monthly average case duration

The following analysis calculates monthly average case duration. Case start month needs to be a dimension and KPI is the average case duration (also rounding is used).

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "Start Month",
      "Expression": "StartTime.Month"
    }
  ],
  "Values": [
    {
      "Name": "Average Case Duration in Days",
      "Expression": "Round(Average(_.Duration.TotalSeconds) / 3600, 0)"
    }
  ],
  "Ordering": [
    {
      "Name": "Start Month",
      "Direction": "Ascending"
    }
  ]
}

Root Causes for Case Attributes

The following example shows how to create the Root Causes using the expression language. You need to pass the Comparison parameter which the influence analysis comparison between case sets is based on.

{
  "Root": "
    Let(\"nAllCases\", Count(Cases));
    Let(\"nAllSelectedCases\", Count(ComparisonEventLog.Cases));
    Let(\"pAllSelectedCases\", nAllSelectedCases / nAllCases);
    ConcatLevel((CaseAttributes.(Let(\"attribute\", _), Values.[attribute, _])))
  ",
  "Dimensions": [
    {
      "Name": "Attribute",
      "Expression": "_[0].Name"
    },
    {
      "Name": "Value",
      "Expression": "_[1]"
    }
  ],
  "RowInitExpression": "
    Let(\"attribute\", _[0][0]);
    Let(\"selectedAttribute\", (ComparisonEventLog.CaseAttributes.Where(Name == attribute.Name))[0]);
    Let(\"value\", _[0][1]);
    Let(\"cases\", attribute.CasesHavingValue(value));
    Let(\"selectedCases\", selectedAttribute.CasesHavingValue(value));
    Let(\"notSelectedCases\", Except(cases, selectedCases));
    Let(\"nCases\", Count(cases));
    Let(\"nSelectedCases\", Count(selectedCases));
    Let(\"nNotSelectedCases\", Count(notSelectedCases));
    Let(\"pSelectedCases\", (nCases == 0) ? 0 : nSelectedCases / nCases);
    Let(\"pDiff\", pSelectedCases - pAllSelectedCases);
    Let(\"nContribution\", nCases * pDiff);
  ",
  "Values": [
    {
      "Name": "# Cases",
      "Expression": "nCases",
      "Type": "Single"
    },
    {
      "Name": "# Selected",
      "Expression": "nSelectedCases",
      "Type": "Single"
    },
    {
      "Name": "# Not selected",
      "Expression": "nNotSelectedCases",
      "Type": "Single"
    },
    {
      "Name": "Selected %",
      "Expression": "pSelectedCases",
      "Type": "Single"
    },
    {
      "Name": "Difference %",
      "Expression": "pDiff",
      "Type": "Single"
    },
    {
      "Name": "Contribution #",
      "Expression": "nContribution",
      "Type": "Single"
    },
    {
      "Name": "Contribution %",
      "Expression": "(nAllSelectedCases == 0) ? 0 : nContribution / nAllSelectedCases",
      "Type": "Single"
    }
  ],
  "Ordering": [ 
    {
      "Name": "Contribution #",
      "Direction": "Descending"
    },
    {
      "Name": "Attribute",
      "Direction": "Ascending"
    },
    {
      "Name": "Value",
      "Direction": "Ascending"
    }
  ]
}

3 Grams

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "CaseId",
      "Expression": "Name"
    }
  ],
  "Values": [
    {
      "Expression": "
        Flatten(
          _
          .Array(
            StringJoin(\"->\", 
            Array(\"0\", 
              GetAt(0, Events).Type.Name, 
              If(
                Count(Events) > 1, 
                GetAt(1, Events).Type.Name, 
                \"0\"
                )
              )
            ),
            StringJoin(\"->\", 
              Events.Where(!IsNull(NextInCase))
              .Array(Type.Name, 
                NextInCase.Type.Name, 
                If(
                  !IsNull(NextInCase.NextInCase), 
                  NextInCase.NextInCase.Type.Name, 
                  \"0\"
                )
              )
            )
          )
        ).Where(_ != \"\")
      ",
      "DimensionOrderExpression": "OrderByValue(_)",
      "Type": "Pivot"
    }
  ],
  "Ordering": [ 
    {
      "Name": "CaseId",
      "Direction": "Ascending"
    }
  ]
}

Dynamic ValueType Examples

Count of occurred event types by time (Event Type Trends Analysis)

The following analysis shows how many different types of events occurred divided to time ranges.

{
  "Root": "EventTypes",
  "Dimensions": [
    {
      "Name": "Event Name",
      "Expression": "Name"
    }
  ],
  "Values": [
    {
      "Name": "Event Count",
      "Expression": "GetAt(0, _.Count)" 
    },
    {
      "ValueDimensionExpression": "For(\"i\", 1, i < 12, i + 1, DateTime(2017, i, 1))",
      "NameExpression": "\"\" + _.Year + \"-\" + If(_.Month < 10, \"0\", \"\") + _.Month",
      "Expression": "GetAt(0, Count(
        _.Events.Where(TimeStamp.Year == ValueDimension.Year &&
        TimeStamp.Month == ValueDimension.Month)
      ))",
      "Type": "Dynamic"
    }
  ],
  "Ordering": [ 
    {
      "Name": "Event Name",
      "Direction": "Ascending"
    }
  ]
}

Case counts for each case attributes values by time (Profiling Trends Analysis)

The following analysis shows case counts for each case attribute values ("Region" in this example) and for each months.

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "Region",
      "Expression": "Region"
    }
  ],
  "Values": [
    {
      "ValueDimensionExpression": "For(\"i\", 1, i < 12, i + 1, DateTime(2017, i, 1))",
      "NameExpression": "\"\" + _.Year + \"-\" + If(_.Month < 10, \"0\", \"\") + _.Month",
      "Expression": "GetAt(0, Count(
        _.Events.Where(TimeStamp.Year == ValueDimension.Year && TimeStamp.Month == ValueDimension.Month)
      ))",
      "Type": "Dynamic"
    }
  ],
  "Ordering": [ 
    {
      "Name": "Region",
      "Direction": "Ascending"
    }
  ]
}

Examples for generating different time ranges:

  • Quarters: For(\"i\", 1, i <= 4, i + 1, DateTime(2017, i * 3, 1))
  • Months: For(\"i\", 1, i <= 12, i + 1, DateTime(2017, i, 1))
  • Weeks: Timerange(Datetime(2017,1,2), Datetime(2018,1,1), Timespan(7))
  • Days: Timerange(Datetime(2017,1,1), Datetime(2018,1,1), Timespan(1))
  • Hours: Timerange(Datetime(2017,1,1), Datetime(2017,1,31), Timespan(0, 1))
  • Minutes: Timerange(Datetime(2017,1,1), Datetime(2017,1,2), Timespan(0, 0, 1))
  • Seconds: Timerange(Datetime(2017,1,1), Datetime(2017,1,2), Timespan(0, 0, 0, 1))

For equal duration time ranges, the Timespan function is the useful, and for non-equal durations, the For function needs to be used.

Pivot ValueType Examples

Event type ordering

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "CaseId",
      "Expression": "Name"
    }
  ],
  "Values": [
    {
      "Expression": "
        Flatten(
          _
          .Events
          .For(\"i\", IndexInCase + 1, i < Count(Case.Events), i + 1, 
            StringJoin(\">\", 
              Array(
                Type.Name, 
                GetAt(i, Case.Events).Type.Name
              )
            )
          )
        )
      ",
      "DimensionOrderExpression": "OrderByValue(_)",
      "Type": "Pivot"
    }
  ],
  "Ordering": [ 
    {
      "Name": "CaseId",
      "Direction": "Ascending"
    }
  ]
}

Repeats

{
  "Root": "Cases",
  "Dimensions": [
    {
      "Name": "CaseId",
      "Expression": "Name"
    }
  ],
  "Values": [
    {
      "Expression": "
        Flatten(
          _
          .FindRepeats(Events.Type.Name)
          .Repeat(
            Count(GetAt(1, _)) - 1, 
            StringJoin(\"->\", GetAt(0, _))
          )
        )
      ",
      "DimensionOrderExpression": "OrderByValue(_)",
      "Type": "Pivot"
    }
  ],
  "Ordering": [ 
    {
      "Name": "CaseId",
      "Direction": "Ascending"
    }
  ]
}

Workload per resource

{
  "Root": "
TimeRange(DateTime(2012,1,1,12,0), DateTime(2012,1,1,13,0), TimeSpan(0, 0, 5))
", 
  "Dimensions": [
    { 
      "Name": "Time",
      "Expression": "_"
    }
  ], 
  "Values": [
    {
      "Type": "Pivot",
      "Expression": "
Def(\"ActiveEventUnitsAt\", \"at\", 
  Cases:GetAt(0, Events)
    .RecursiveFind(
      NextInCase,
      TimeStamp <= at 
      && (IsNull(NextInCase) || (NextInCase.TimeStamp > at))
    )
  .Unit
);
Let(\"CurrentTime\", 
  GetAt(
    0, 
    _
  ), 
  Flatten(
    EventLog
    .ActiveEventUnitsAt(
      CurrentTime
    )
  )
)
"
    }
  ]
}