カスタム関数を作成して呼び出す

以下は、長期にわたるプログラミングの伝統に従ったカスタム関数の簡単な例です。

1. 空のクエリを作成するには:
   
   Excel    [データ の選択]> [他のソースからデータ > を取得する] > 空のクエリ。
   
   Power Query    左側の [クエリ] ウィンドウで空白の場所を右クリックし、[新しいクエリ] > [その他のソース] > [空のクエリ] を選択します。

2. 左側の [ クエリ ] ウィンドウで、名前をダブルクリックし、新しい空のクエリの名前を "HelloWorld" に変更します。

3. 新しいクエリを選択し、[ホーム ]> [詳細エディター] を選択します。

4. テンプレート スターター コードを次のコードに置き換えます。

   let
        HelloWorld = () => ("Hello World")
   in
        HelloWorld

5. [完了] を選択します。

6. クエリ "HelloWorld" をカスタム関数に変更しました。 関数アイコンは、その左側に 注意してください。

7. 関数を呼び出すには、関数を選択し、[データ プレビューで 呼び出し ] を選択します。
   
   

8. 関数の結果はデータ プレビューに表示され、既定の名前の [呼び出された関数] を持つクエリとして [クエリ] ペインに追加されます。 名前を "HelloWorldResult" など、より意味のある名前に変更することもできます。

9. そのクエリを選択し、[ ホーム ]> [閉じる] & [読み込み] を選択して、ワークシートに結果を表示します。

結果 

次の例では、パラメーターをカスタム関数に渡して、10 進数を 16 進数に変換する方法を示します。

1. 空のクエリを作成するには:
   
   Excel    [データ の選択]> [他のソースからデータ > を取得する] > 空のクエリ。
   
   Power Query    左側の [クエリ] ウィンドウで空白の場所を右クリックし、[新しいクエリ] > [その他のソース] > [空のクエリ] を選択します。

2. 左側の [ クエリ ] ウィンドウで、新しい空のクエリの名前を "MyHex" に変更します。

3. 新しいクエリを選択し、[ホーム ]> [詳細エディター] を選択します。

4. テンプレート スターター コードを次のコードに置き換えます。

   let
        MyHex = (parameter1) => Number.ToText(parameter1,"X")
   in
        MyHex

5. [完了] を選択します。

6. クエリ "MyHex" をカスタム関数に変更しました。 関数アイコンは、その左側に 注意してください。

7. 関数を呼び出すには、関数を選択し、[データ プレビュー] で [パラメーター 1 ] ボックスに数値を入力し、[ 呼び出し] を選択します。

   

8. 関数の結果はデータ プレビューに表示 され、既定 の名前の [呼び出された関数] を持つクエリとして [クエリ] ペインに追加されます。 名前を "MyHexResult" など、より意味のある名前に変更することもできます。

9. そのクエリを選択し、[ ホーム ]> [閉じる] & [読み込み] を選択して、ワークシートに結果を表示します。

結果 

少なくとも 1 つのパラメーターを持つ関数を作成した場合は、それをカスタム関数として呼び出して、テーブル内の各行に新しい列と新しい値を作成できます。

1. クエリを開くには、Power Query エディターから以前に読み込まれたクエリを見つけ、データ内のセルを選択し、[クエリ ]> [編集] を選択します。 詳細については、「Excel でクエリを作成、編集、読み込む (Power Query)」を参照してください。
   
   手記   この例では、クエリには 整数 データ型の列が少なくとも 1 つ必要です。

2. 「Create and invoke a custom function with a parameter with the 詳細エディター」セクションで説明されているように、"MyHex" カスタム関数を作成します。

3. クエリで、[列の 追加 ] > [カスタム関数の呼び出し] を選択します。 [ カスタム関数の呼び出し ] ダイアログ ボックスが表示されます。

4. [新しい列名] ボックスに、"HexConvert" などの 新しい列名 を入力します。

5. [関数クエリ] ドロップダウンから、定義済みのカスタム関数の名前を選択します。 この例では、"MyHex" を選択します。

6. カスタム関数がパラメーターを参照しているため、パラメーターが表示されるようになりました。

7. 関数のパラメーター として整数データ 型の列を選択します。
   
   

8. [OK] を選択します。

結果

パラメーターとして入力した整数列の 16 進値を示す新しい列が作成されます。