FieldIndex() は、field_name 項目内の value 項目値の位置を返します (ロード順)。
構文:
FieldIndex(field_name , value)
戻り値データ型： 整数
引数：
| 引数 | 説明 |
|---|---|
| field_name | インデックスが必要な項目名。たとえば、テーブルの列など。 文字列値でなければなりません。これは、項目名は単一引用符で囲む必要があることを意味します。 |
| value | 項目 field_name の値。 |
制限事項:
-
value が項目 field_name の項目値の中にない場合は、0 を返します。
-
チャートの数式のいずれかでこのチャート関数を使用する場合、チャートの Y 値でのソートや、テーブルの数式列のソートはできません。よって、これらのソート機能は自動的に無効になります。ビジュアライゼーションまたはテーブルでこのチャート関数を使用する場合、ビジュアライゼーションのソートによりソートされた入力がこの関数に戻ります。この制限は、同等のスクリプト関数に適用されません。
例と結果:
以下の例では、テーブル Names の項目 First name を使用しています。
| 例 | 結果 |
|---|---|
|
アプリに例のデータを追加して実行します。 |
テーブル Names が、例のデータのようにロードされます。 |
|
チャート関数: 軸 First name を含むテーブルで、メジャーとして次の項目を追加します。 |
|
|
FieldIndex ('First name','John') |
1 ('John' が First name 項目のロード順序の最初に登場するため) ただし、フィルター パネルではアルファベット順にソートされるため、John は上から 2 番目に表示されます) |
|
FieldIndex ('First name','Peter') |
4 (FieldIndex() では、1 つの値しか返されないため。この場合は 4 がロード順序における最初の項目) |
|
スクリプト関数: テーブル Names が、例のデータのようにロードされます。 |
|
|
John1: Load FieldIndex('First name','John') as MyJohnPos Resident Names; |
MyJohnPos=1 ('John' がFirst name 項目のロード順序の最初に登場するため) ただし、フィルター パネルではアルファベット順にソートされるため、John は上から 2 番目に表示されます) |
|
Peter1: Load FieldIndex('First name','Peter') as MyPeterPos Resident Names; |
MyPeterPos=4 (FieldIndex() では、1 つの値しか返されないため。この場合は 4 がロード順序における最初の項目) |
例で使用されているデータ:
Names:
LOAD * inline [
First name|Last name|Initials|Has cellphone
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC|No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
John1:
Load FieldIndex('First name','John') as MyJohnPos
Resident Names;
Peter1:
Load FieldIndex('First name','Peter') as MyPeterPos
Resident Names;