クエリのフィールドは、その結果に表示される情報を定義します。ソースパネルから、クエリに含めるデータを選択できます:
- ソース列は、Workivaプラットフォームでアクセスできるテーブルやスプレッドシートから直接データを提供します。クエリにソース列を追加すると、異なるデータタイプを使用したり、その値に対して計算を実行するなど、そのデータが結果にどのように表示されるかを調整できます。
- 計算は、複数のソース列に基づいて値を返します。例えば、複数のソース列の値を合計したり、値の文字列を連結したりするなどが挙げられます。
注: クエリにソース列を追加するには、少なくともそのテーブルまたはシートへの閲覧者アクセス権が必要です。ソースパネルを閲覧するには、[すべて展開する] または[すべて折りたたむ] をクリックして、すべての列を表示または非表示にします。特定のテーブルや列を検索するには、[フィルターの表示] をクリックし、名前で検索します。
クエリフィールドを定義する
特定の列または完全なソースをクエリ結果に追加するには、[ソース]パネルでそれらを選択し、[フィールドに追加]をクリックするか[フィールド]タブの下に移動させます。
クエリに列を追加した後、フィールド タブでその列を選択し、フィールドプロパティ の右パネルからその列のソース、ID、およびデータタイプを表示できます。このパネルでは、クエリ結果にフィールド名やデータがどのように表示されるかを調整することもできます。
- フィールドのデータを明確にするために、ヘッダー の下に、クエリ結果に表示される名前を入力します。例えば、クエリに異なるソースからの同じ名前の複数のフィールドが含まれている場合、コンテキストを追加するためにそれらの名前を更新します。
- 数値のテキストデータを小数の桁数または整数に変換するなど、結果に別のデータタイプを返すには、[キャストタイプ]から使用するデータタイプを選択します。
注: タグ値は文字列として保存される。タグを別のデータタイプとして使用するには、キャストタイプ で希望のタイプを選択します。
- 日付またはタイムスタンプの結果で日付がどのように表示されるかを調整するには、関数で、表示する略語(日や四半期など)を選択します。また、カスタム書式の場合は、
%Y-%m
YYYY-mm のように、その値の新しい書式の式を入力します:エクスプレッション 表示 %b
JanやDecなどの省略形の月名 %M
省略形でない月の名前(JanuaryやDecemberなど) %c
1桁または2桁の月の数値(1月は1、12月は12など) %m
2桁の月の数値(1月は01など) %D
1stや23rdなど、英語の接尾辞が付いた日付 %Y
4桁の年の数値 %y
2桁に省略された年 注: デフォルトでは、日付やタイムスタンプはISO 8601書式で表示されます。
- 集計タイプ で、フィールドの値の計算または集計のどちらを結果に返すかを選択します。例えば、フィールドはそのレコードのカウントや、金額の平均や合計を返すことができます。計算を提供するには、実行する集計を選択します:
集計 フィールドまたはキャストタイプ 結果 合計 号 フィールドの値の合計 カウント すべて フィールドに値を持つレコードの総数 最大 整数、数値、日付、タイムスタンプ フィールドの最大値または最も遅い値 最小 整数、数値、日付、タイムスタンプ フィールドの最小値または最も早い値 平均 整数、数値 フィールドの値の平均値 注: ユニークな値を持つレコードのみを計算に含めるには、個別の集計を使用する を選択します。
- [適用]をクリックします。
計算を定義する
計算では、以下を含むエクスプレッションを使用することで、複数のソース列に数式を自動的に適用できます。
- 列の値の合計を計算する
{1} + {2}
などの演算子 - 列の値の文字列を生成する
concat({1}, {2})
のような関数。
- [計算]を[ソース]パネルからクエリへ移動して、クエリ内で選択します。
- プロパティ パネルのヘッダーに、計算の名前がクエリ結果でどのように表示されるかを入力します。
注: 計算のエイリアスを設定するには、それをヘッダーとして入力します。計算は、エイリアスを設定するために
AS
を含む構文をサポートしていません。 - 計算に含める列を[ソース]パネルから[プロパティ]パネルの[含まれる列]の下に移動します。
ヒント: 計算に列を含めるには、クエリで計算を選択し、ソース パネルの列の右クリックメニューから、計算に追加 を選択することもできます。
- [計算]で、演算子と関数を使用して計算する数式または式を入力し、割り当てられた数値トークンとして表されて含まれる列を入力します(
{1} + {2}
など)。- 列の数値トークンを計算に素早く追加するには、[含まれる列]セクションでその名前をクリックします。
- 関数または演算子の構文を素早く追加するには、[計算]メニューから目的の構文を選択します。
- 計算でパラメータの値を参照するには、[パラメータ]メニューからパラメータを選択するか、ReportingPeriod のようにコロンの後にパラメータの名前を入力します。
注: パラメータを追加するには、パラメータメニューから、新しいパラメータの作成 を選択します。
- [適用]をクリックします。
クエリフィールドと計算を配置する
フィールドと計算がクエリ結果にどのように表示されるかを定義するには、それらを表示する順番に並べます。フィールド タブでクエリフィールドや計算を移動するには、適切な位置までドラッグするか、その上で右クリックしてフィールドを上下に移動するか、またはフィールドの最上部または最下部に移動するかを選択します。
クエリフィールドまたは計算を複製する
別の集計や数式で使用する場合など、クエリフィールドまたは計算のコピーを作成するには、次の操作を行ないます。
- クエリの[フィールド]タブで、コピーするフィールドまたは計算を右クリックし、[フィールドの複製]を選択します。
- [copied_fieldname]_copyというヘッダーを持つ複製を選択し、ヘッダーと追加プロパティを[フィールドプロパティ]
の右パネルで更新します。
- [保存]をクリックします。
クエリフィールドまたは計算を削除する
クエリからフィールドまたは計算を削除するには、[フィールド]タブで、[消去]をクリックするか、フィールドを右クリックして[フィールドの削除]を選択します。