構造化リスト値 – 順序付けられた値のシーケンス

このチュートリアルでは、構造化リスト値を作成して利用する方法を学習します。また、さまざまなコンテキストや式を使用してそれらを最大化し、目的のデータと結果を取得する方法も学びます。リストを簡単に作成するための短縮法についても説明します。

目次

• 構造化リスト値の作成
• 連番と文字に二重ドットを使用する
• 構造化リストからの項目へのアクセス
• リストの結合と同等化
• 結論

構造化リスト値の作成

リストは、順序付けられた値のシーケンスです。リストを比較する場合、その順序が考慮されます。リスト初期化子は中括弧のセットです。数式バーに中括弧 ( { } ) を入力して Enter キーを押すと、空のリストが作成されます。[クエリ] ページのクエリ名の横に、リストに関連付けられたアイコンも表示されます。

値を含むリストを作成するには、まずクエリ ペイン内のスペースを右クリックして新しいクエリを作成します。次に、[新しいクエリ]をクリックし、[空のクエリ]を選択します。

次に、数式バーに値を入力します。複数の値がある場合は、それぞれをカンマで区切ります。リスト内の値は同じ型である必要はないため、プリミティブ型または構造化型のいずれでもかまいません。これは、テキスト、リスト、およびレコードの値を含むリストです。

連番と文字に二重ドットを使用する

連続した番号のリストを作成する必要がある場合は、そのための短縮形があります。まず、初期化子を入力し、その後に最初の数値を入力します。次に、ドットを 2 つ入力し、最後の数字を入力します。

1 から 5 までの連続番号のリストが作成されたことがわかります。番号は増分である必要があります。したがって、最後の数値を -5 に変更すると、開始値が終了値より大きいため、空のリストが得られます。

この方法は文字でも機能します。

コード内の最初の値から最後の値までの文字のリストが作成されたことがわかります。ただし、値を逆に変更すると、空のリストが表示されます。これは、文字に関連付けられた Unicode 文字値が増分されないためです。

これは、このプロセスをさらに詳しく説明するためのクエリです。

これを詳細エディター ウィンドウに入力して[完了]を押すと、文字に関連付けられた数値が表示されます。

ただし、この方法は日付では機能しません。数式バーに日付値を入力すると、エラー メッセージが表示されます。

構造化リストからの項目へのアクセス

リストを作成する方法は他にもあります。リストを返すM関数を使用することも、同様にリストを返すテーブルから単一の列を抽出することもできます。しかし、より一般的には、リストはM関数のパラメータとして使用されます。このような場合、関数に正しいパラメーター値を提供できるように、リストの作成方法を理解しておくことが重要です。

リスト内の項目にアクセスするには、位置インデックス演算子を使用して、ゼロから始まる位置でその項目を参照できます。この例では、インデックス演算子 0 が最初の値 1 を取り出していることがわかります。

インデックス演算子を 0 から 2 に変更すると、最後の値は 3 になります。

したがって、インデックス演算子を 3 に変更してリストから 4 番目の項目を取得する場合、リストに十分な値がないため、エラーが発生します。

位置インデックス演算子に疑問符を追加すると、「not-found」動作がエラーを返す動作からnullを返す動作に変わります。これをオプション項目の選択を行うとも言います。

リストの結合と同等化

リストでは組み合わせ演算子と方程式演算子を使用できます。リストは、結合演算子であるアンパサンド ( & ) を使用して結合できます。

最初のリストには 1 ～ 5 の数字が含まれ、2 番目のリストには 2 と 3 が含まれています。これらのリストが 1 つのリストに結合されていることがわかります。

リストを比較する場合、順序が考慮されます。この例では、それらが互いに等しくないため、コードが FALSE を返したことがわかります。

結論

構造化リスト値は、データと情報をリスト形式で表示するため、LuckyTemplates データ レポートで一般的です。データを整理および分類して、レポートを説得力のあるものにするのに役立ちます。特定のテキスト、数値、さらには値をリストしたい場合は、リストを使用することを強くお勧めします。

メリッサ

Power Query でレコードとリストから値を抽出する
LuckyTemplates でランキング計算に基づいて自動リストを作成する