Azure Logic Apps Standard SDK (プレビュー) を使用して C# で標準ワークフロープロジェクトを作成する

適用対象: Azure Logic Apps (Standard)

Important

このプレビュー機能は、 Microsoft Azure プレビューの追加使用条件に従います。

コード開発、ソース管理、単体テスト、IntelliSense、デバッグ、リファクタリング用のVisual Studio Code ツールを使用してAzure Logic Appsで Standard ワークフローをプログラムでビルドするには、Azure Logic Apps Standard SDK を使用します。この SDK を使用すると、命令型のコーディングスタイルを使用して、C# と.NETでワークフローを完全に定義できます。ワークフロー設計をより詳細に制御できるだけでなく、Azureホスト型コネクタと組み込み操作のAzure Logic Apps エコシステムにフルアクセスできます。 Visual Studio Codeで既に知っている可能性があるプロジェクト構造、デバッグエクスペリエンス、開発パターンを使用して、ワークフローを整理、開発、テストします。

このガイドでは、次のタスクを完了する方法について説明します。

ワークスペースとコード優先ワークフロープロジェクトを作成します。
Azureホスト型コネクタを有効にし、接続を設定します。
ワークフローをローカルで実行およびデバッグします。
さらにワークフローをプロジェクトに追加します。

既定では、SDK によってロジックアプリプロジェクトが生成されます。これには、確認して独自のコードに置き換えることができるサンプルコードが含まれています。

前提条件

Azureでリソースを作成できるAzure アカウントとサブスクリプション。無料の Azure アカウントを取得します。
Visual Studio Code および Azure Logic Apps (Standard) 拡張機能。
Visual Studio Codeでの C# と.NET開発に関する知識。

既知の問題と制限事項

プレビューリリース中は、次の制限事項が適用されます。

Area	Limitation
組み込みのサービスプロバイダーベースの処理	現在使用できませんが、今後のリリースで予定されています。プレビュー期間中は、コード優先ワークフローで使用できるのは、Azureホスト型コネクタと -managed コネクタのみです。
動的スキーマ	プレビュー期間中は現在使用できません。
カスタムコード	現在サポートされているのはコールバックメソッドのみです。プレビュー期間中、インラインラムダ関数はサポートされていません。
アクション	ワークフローでこれらの操作を使用して参照する前に、それらを追加して名前を付ける必要があります。
マネージド ID 認証	サポートは開発中です。ここでは、接続文字列または API キー認証を使用します。

プロジェクトのワークスペースを作成する

ワークフローを構築する前に、Standard ロジックアプリプロジェクト用のワークスペースを作成する必要があります。

Visual Studio Code のアクティビティバーで、Azure アイコンを選択します。
Azure ウィンドウの Workspace ツールバーで、Azure Logic Apps メニューを選択し、 新しいロジックアプリワークスペースの作成を選択します。

Windows Defenderファイアウォールで、Visual Studio Codeである Code.exe のネットワークアクセス権を付与するように求めるメッセージが表示された場合。 func.exe (Azure Functions Core Tools) では、自宅や職場のネットワークなどのプライベートネットワーク>アクセスを許可 を選択します。

[ ロジックアプリワークスペースの作成 ] タブが開き、プロジェクトとロジックアプリに関する詳細を指定できます。

このタブで、次の情報を指定します。

財産	Description
ワークスペースの親フォルダーパス	ローカルワークスペースのパスとフォルダー名。このワークスペース名は、フォルダーファイルとプロジェクトファイルに使用されます。このフォルダーを作成するには、次の手順に従います。 1. [ 参照 ] を選択して、[ フォルダーの選択] ウィンドウを開きます。 2. ワークスペースフォルダーを作成する場所を参照します。 3. フォルダーを作成し、フォルダーを 1 回だけ選択します。 4. [ ワークスペースの親フォルダーの選択 ] を選択します (フォルダーをダブルクリックしないでください)。
ワークスペース名	Visual Studio Codeのワークスペースの名前。
ロジックアプリ名	ロジックアプリプロジェクトの名前。
ロジックアプリのプロジェクトとワークフローの種類	この一覧には、Standard ロジックアプリプロジェクトで使用できるフレーバーが表示されます。 Standard SDK プロジェクトの場合は、コード優先ワークフローのロジックアプリ (コードフル) を選択します。
ワークフロー名	Standard ロジックアプリプロジェクトの最初のワークフローの名前。
ワークフローの種類	- ステートフル: 実行履歴を含む AI 以外のワークフロー。 - 会話エージェント: チャットを通じた人間の対話をサポートし、実行履歴を含む AI 主導のワークフロー。 - 自律型エージェント: 人間に依存しない自動化をサポートし、実行履歴を含む AI 駆動型ワークフロー。

準備ができたら、[ 次へ] を選択します。
[ 確認と作成 ] タブで入力内容を確認し、[ ワークスペースの作成] を選択します。

Visual Studio Code、ワークスペース内のファイルの作成者を信頼するかどうかを確認するメッセージが表示されます。
確認するには、[ はい、作成者を信頼します] を選択します。

Visual Studio Code、ワークスペースとロジックアプリプロジェクトを作成して開きます。このプロジェクトは、Explorer ウィンドウに表示されます。

ワークスペースが開いたら、グローバルなマルチテナント Azureでホストおよび実行されるAzure コネクタを有効にするように求められます。
次の手順に進み、これらのコネクタを有効にします。

Azure ホスト型コネクタを有効にする

このプレビューリリースでは、コードファーストワークフローでAzureホストされるマネージドコネクタのみを使用できます。

Visual Studio Code でこれらのコネクタを有効化するよう求めるメッセージが表示されたら、Use connectors from Azure を選択してください。
これらのコネクタに使用するAzure サブスクリプションを選択します。
コネクタリソースを管理するリソースグループを選択します。

使用する認証の種類を選択します。

Authentication	Description
接続キー	プレビュー期間中は、マネージド ID が現在使用できないため、接続文字列とアクセスキーを使用します。
マネージド ID	資格情報、キー、またはシークレットをローカルまたはクラウドで処理、格納、管理しないように、Microsoft Entraを使用してセキュリティを強化することをお勧めします。

プロジェクトとワークフローのコードを確認する

Visual Studio Codeのアクティビティバーで、Explorer (ファイルアイコン) を選択してプロジェクトを表示します。

エクスプローラー ウィンドウで、次の主要なプロジェクトファイルとそのサンプルコードを確認します。

Files	Description
`Program.cs`	ホストをビルド、構成、開始して、ホストがワークフローを実行する方法を定義します。
`<workflow_name>.cs`	コード内のトリガーとアクションを使用してワークフローを定義します。

例えば次が挙げられます。

コードフルロジックアプリプロジェクトでは、ワークフローファイルでコードを使用してオートメーションのステップを定義します。その後にアクションが続く 1 つのトリガーから始まります。これらの手順の構造は、ワークフローデザイナーのシーケンスに似ていますが、C# で表されます。
SDK によってワークフロー定義がコンパイルされ、Azure Logic Apps ランタイムで実行されます。

トリガーとアクションの接続を設定する

ワークフロー内のトリガーまたはアクションが機能する必要がある接続を設定するには、次の手順に従います。

Visual Studio Codeで、Explorer ウィンドウで、ロジックアプリプロジェクトとワークフローコードファイル (例: <workflow_name.cs) を開きます。

コードファイルで、Azure マネージドコネクタに関連付けられているアクション定義を見つけます。次に例を示します。

var getCurrentWeatherAction = WorkflowActions.Managed.Msnweather("msnweather").CurrentWeather(
    location: () => "98058",
    units: () => unitsInput.Imperial);

マウスポインターをアクション呼び出しの上に移動します。表示されたツールヒントから、[ コネクタの管理] を選択します。

例えば次が挙げられます。

接続ビューが開き、そのコネクタのリソースグループ内の既存の接続が表示されます。
接続を選択します。

-又は-

接続を作成するには、[ 新規追加] を選択し、接続の一意の識別子を指定します。

Visual Studio Codeconnections.json ファイルに接続を作成して記録します。

Important

プロジェクトでは、 local.settings.json ファイルを使用して、接続文字列やその他の資格情報を安全に格納します。このファイルをソース管理にコミットしていないことを確認します。

ワークフローの実行とデバッグ

Visual Studio Codeのアクティビティバーで、Explorer ウィンドウ (ファイルアイコン) を開いてプロジェクトを表示します。
Visual Studio Codeタイトルバーで、Run メニューを開き、 デバッグの開始を選択します。 (キーボード: F5)

-又は-

Program.cs ファイルのショートカットメニューを開き、[概要] を選択してデバッグを開始します。 (キーボード: F5)

プロジェクトのコンパイルが開始されると、Azure Logic Apps ランタイムがロジックアプリのローカルでの実行を開始します。アプリが起動すると、[ 概要 ] ページが開きます。
- プロジェクトに 1 つのワークフローがある場合は、[ 概要 ] ページでワークフローの実行履歴が直接開きます。
- プロジェクトに複数のワークフローがある場合は、最初にワークフローを選択します。
[概要] ページを使用すると、トリガーの実行、ワークフローの実行履歴の確認、入力と出力の確認を行うことができます。

Note

Azure Logic Apps Standard SDK を使用して作成されたワークフローの場合、実行履歴では、ビジュアルデザイナーで作成されたワークフローと同じ豊富なビジュアル表現が使用されます。ワークフローの作成方法に関係なく、ワークフローの監視とトラブルシューティングは同じ方法で行うことができます。

新しいワークフローをプロジェクトに追加する

Visual Studio Codeのアクティビティバーで、Explorer (ファイルアイコン) を選択してプロジェクトを表示します。
プロジェクトレベルでショートカットメニューを開き、[ ワークフローの作成] を選択します。

[ ワークフローの作成 ] タブで、次の情報を入力します。

財産	Description
ワークフロー名	標準ロジックアプリプロジェクト内のワークフローの名前。
ワークフローの種類	- ステートフル: 実行履歴を含む AI 以外のワークフロー。 - 会話エージェント: チャットを通じた人間の対話をサポートし、実行履歴を含む AI 主導のワークフロー。 - 自律型エージェント: 人間に依存しない自動化をサポートし、実行履歴を含む AI 駆動型ワークフロー。

完了したら、[ 次へ] を選択し、[ ワークフローの作成] を選択します。

作成が完了すると、ワークフローの一覧に新しいワークフローが表示されます。
ワークフローとその操作の編集を開始するには、新しいワークフローコードファイルを開きます。

ファイルが開き、サンプルワークフローコードが表示されます。

次のステップ

ロジックアプリを Azure

Azure Logic Apps Standard SDK リファレンス

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-06-05