GetStateCounts - チャート関数
GetStateCounts() チャート関数は、指定された選択ステートに一致する一意の値の合計数を計算するために使用されます。
GetStateCounts() を使用すると、GetSelectedCount()、GetNotSelectedCount()、GetAlternativeCount()、GetPossibleCount()、GetExcludedCount() の関数の計算を 1 つの関数呼び出しに組み合わせることができます。選択された除外値の個数も計算に追加できます。各関数の計算で返される合計を加算するか減算するかを指定できます。
構文:
GetStateCounts (field_name, state_name [, state_type1,...state_typeN])
戻り値データ型: 整数
引数 | 説明 |
---|---|
field_name | 選択ステートを計算する項目。存在しない項目名の場合、結果は NULL になります。 |
state_name | 代替ステートの名前。引数が空 ('') または NULL の場合、継承された代替ステートが使用されます。既定のステートを明示的に使用するには、$ を使用します。名前付き (空でない) ステート名が既存のステートと一致しない場合、結果は NULL となります。 |
state_type |
項目値の 1 つ以上のステート タイプのリスト。これらのステート タイプはカウントに集計されます。ステート タイプはキーを使用して指定されます。各キーを単一引用符で囲んで入力します。 この引数を省略すると、関数は列挙と同じ順序で、項目のすべての使用可能なステート カウントを含む文字列を返します。 使用できるステートのリストについては、下表を参照してください。 |
ステート タイプは特定のキーを使用して参照されます。キーの数値バージョンまたはテキスト バージョンを使用できます。同じ数式で複数のキーを組み合わせると、結果をさらにカスタマイズできます。ステートの数を合計に加えるのではなく、合計から減算できます。これを実行するには、テキスト キーを使用し、ステート タイプのプレフィックスにマイナス記号 (-) を付けます。
ステート タイプおよび該当する場合は、マイナス記号は単一引用符で囲む必要があります。
項目のステート タイプ | 説明 | 数値キー | テキスト キー |
---|---|---|---|
選択済み | 選択された値を計算に含めます。同等の関数については、「GetSelectedCount - チャート関数」 を参照してください。 | 1 | S |
オプション | オプション (選択されていないが選択可能) 値を計算に含めます。同等の関数については、「GetPossibleCount - チャート関数」 を参照してください。 | 2 | O |
選択解除 |
選択されていない値を計算に含めます。このステート タイプは、項目が AND モードの場合にのみ使用できます。 このステート タイプは、GetNotSelectedCount() 関数の include_excluded 引数が既定値の False に設定されていると仮定して、 関数が返すのと同じ計算を返します。GetNotSelectedCount() の詳細については、「GetNotSelectedCount - チャート関数」を参照してください。 |
3 | D |
代替値 | 代替値を計算に含めます。同等の関数については、「GetAlternativeCount - チャート関数」 を参照してください。 | 4 | A |
除外値 | 除外 (選択されていない) 値を計算に含めます。同等の関数については、「GetExcludedCount - チャート関数」 を参照してください。 | 5 | X |
選択除外値 | 選択された除外値を計算に含めます。 | 6 | XS |
使用に適しているケース
GetStateCounts() を使用すると、カスタム選択ステートを計算できます。この関数を使用すると、複数の関数呼び出しを 1 つの関数呼び出しに統合できるため、数式の記述プロセスが簡素化されます。
たとえば、ある項目の除外値、代替値、選択された除外値の合計数を計算する必要があるとします。この合計を計算するには、 GetStateCounts() を使用できます。
例 | 結果 |
---|---|
=GetStateCounts(ProductName, Null(), 'S') | 継承された代替ステートで、ProductName の選択された数を返します。 |
=GetStateCounts(ProductName, '', 'X', 'A', 'XS') | ProductName の除外値、選択された除外値、代替値の合計数を返します。継承された代替ステートが使用されます。 |
=GetStateCounts(ProductName, '', 'S', 'XS') | 継承されたステートでの ProductName のユーザー選択の合計数を返します。 |
ProductName 項目が AND モードであると仮定します。 =GetStateCounts(ProductName, '', 'D', '-O') |
ProductName の可能な値の数から減算した、選択されていない値の数を返します。継承された代替ステートが使用されます。 |
=GetStateCounts(ProductName, '', 'X', , 'A', 'XS') | ProductName の除外値、選択された除外値、代替値の合計数を返します。継承された代替ステートが使用されます。 |
=GetStateCounts(ProductName, '$', 'O') | 既定の代替ステートでの ProductName の実行できる個数を返します。 |
=GetStateCounts(ProductName, 'StateA', 'S') | StateA という名前の代替ステートで、ProductName の選択された個数を返します。 |