ヒントと例
メトリック計算式
メトリック計算式をテキスト形式で定義します。 定義済みの演算で構成できます。
個々の演算は、次の 2 つの基本グループに分けられます:
集計演算: 集計演算の入力は、結果の値が計算される値のセットです (たとえば、平均、最大値など)。
スカラー演算: スカラー演算の入力は、結果の値が計算される 1 つ以上の値です (たとえば、数値の絶対値、税の一部の取得など)。
演算は 定数 を使用することも、単項演算子または二項演算子 (例: 加算、減算など) を使用して組み合わせたり、入れ子にすることができます。
スカラー演算には、属性の形式または派生統計 (イベント期間) の形式で直接利用可能な値を取得するための演算も含まれます。
一部の演算では、演算が評価されるコンテキストの指定もサポートされています。 これは、特定のアクティビティのみ、またはすべてのアクティビティまたはイベントなど、値を集計できる集計演算にとって重要です。 メトリック コンテキストまたは親の演算コンテキストから生じる暗黙的なコンテキストもサポートされます。
メトリック計算式は、サポートされているデータ型 の 1 つを返すことができます。 特定の計算式のデータ型は、この記事の式の構文定義の次に定義されています。
集計演算
集計演算 は、各メトリックの基礎です。 最もよく使用される集計操作は次の通りです:
- COUNT: 集計値の数値を返します (
incl. COUNTIF, COUNTUNIQUE)。 - SUM: 集計値の合計を返します (
incl. SUMIF)。 - AVG: 集計値の平均を返します。
- MIN: 集計値の最小値を返します。
- MAX: 集計値の最大値を返します。
集計演算の任意パラメーターは、入力値を変更するための演算コンテキストとスカラー演算になります。 サポートされている算出コンテキストの完全なリストは、算出コンテキスト で説明されています。
スカラー演算
スカラー演算の目的は、1 つの値を取得し、その値を目的の状態に変換することです。 現在サポートされている演算は、いくつかのタイプに分けることができます:
- 数学演算: - 数値の絶対値を取得する演算、丸めなどが含まれます。
- 日時演算: - 日付の一部の取得、日付の加算など、日付に関する演算が含まれます。
- 文字列演算: - 部分文字列の取得、文字列の分割など、文字列データを操作する演算が含まれます。
- 統計演算: – ケースの数、ケースの待ち時間など、さまざまな統計を取得する演算が含まれます。
- その他: - イベント、ケース、派生統計などにアクセスする演算など、その他の演算が含まれます。
属性名
演算のパラメーターとして属性名を使用する場合、参照する方法が 3 つあります:
属性名を直接 使用します (例:
Resource)。GETVALUE("attribute name") 演算 (例:
GETVALUE("Resource")) を使用します。短縮された属性名 を直接使用します (例:
attribute "Resource ID"はResourceIDとして参照される場合があります)。
2 番目の形式は、属性名が名前付け規則を満たしていない場合に使用されます。 属性の名前付け規則は次のように定義されています:
属性名は文字またはアンダースコアで始まる必要があります。
属性名には、次の Unicode 標準クラスの文字のみを含めることができます: 文字 (Lu、Ll、Lt、Lm、Lo、または Nl)、結合文字 (Mn または Mc)、10 進数文字 (Nd)、接続文字 (Pc )、またはフォーマット文字 (Cf)。
上記の Unicode 文字クラスについては、Unicode Standard, Version 3.0 のセクション 4.5 を参照してください。
3 番目の形式は、属性名が名前付け規則を満たしているが空白文字も含まれている場合にオプションで使用されます。 2 番目の形式 GETVALUE("attribute name" を使用する代わりに)、空白文字を削除して短縮版 attributename を使用することができます。 どちらの形式も同等です。
有効な属性名の例
DocumentCategoryDocCatDocCat23
無効な属性名の例
Document.CategoryDocument Category23DocCat
メトリック計算式の例
マップ内のアクティビティの相対的な期間を計算するには:
AVG (DURATION()) / AVG (VIEWCASES, DURATION())