Visual Studio でロジック アプリを管理する

適用対象: Azure Logic Apps (従量課金)

ロジック アプリは Azure Portal で作成、編集、管理、およびデプロイできますが、ロジック アプリをソース管理に追加したり、各種のバージョンを発行したり、さまざまなデプロイメント環境用の Azure Resource Manager テンプレートを作成したりする場合は Visual Studio も使用できます。 Visual Studio Cloud Explorer では、他の Azure リソースと共にロジック アプリを検索して管理できます。 たとえば、Azure Portal に既に展開されているロジック アプリのオープン、ダウンロード、編集、実行、実行履歴の表示、無効化、有効化を行うことができます。 初めて Visual Studio で Azure Logic Apps を使う場合は、Visual Studio でロジック アプリを作成する方法を学習してください。

Azure portal でロジック アプリを管理することもできます。

重要

Visual Studio からロジック アプリを展開または発行すると、Azure Portal にあるそのアプリのバージョンが上書きされます。 したがって、Azure Portal で行った変更を残しておきたい場合は、次に Visual Studio から展開または発行する前に、Azure Portal から Visual Studio のロジック アプリを更新する必要があります。

前提条件

• Azure サブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。

• まだお持ちでない場合は、以下のツールをダウンロードしてインストールしてください。

  • Visual Studio 2019、2017、または 2015 - Community Edition 以降。 Azure Logic Apps の拡張機能は、現在 Visual Studio 2022 では使用できません。 このクイックスタートでは、無料の Visual Studio Community 2017 を使用します。

    重要

    Visual Studio 2019 または 2017 をインストールする場合は、 [Azure の開発] ワークロードを選択してください。 詳細については、「Visual Studio Cloud Explorer で Azure アカウントに関連付けられているリソースを管理する」を参照してください。

    Cloud Explorer for Visual Studio 2015 をインストールするには、Visual Studio Marketplace から Cloud Explorer をダウンロードします。 詳細については、Visual Studio Cloud Explorer での Azure アカウントに関連付けられているリソースの管理 (2015) に関するページをご覧ください。

  • Azure SDK (2.9.1 以降)

  • Azure PowerShell

  • 必要なバージョンの Visual Studio 拡張機能用の最新の Azure Logic Apps ツール。

    • Visual Studio 2019

    • Visual Studio 2017

    • Visual Studio 2015

    Azure Logic Apps Tools は、Visual Studio Marketplace から直接ダウンロードしてインストールできます。または、この拡張機能を Visual Studio 内からインストールする方法を確認できます。 インストールが完了したら、必ず Visual Studio を再起動してください。

  • Visual Studio で Azure Government サブスクリプションを使用するには、追加のセットアップに関する次のトピックを参照してください。

    • Visual Studio 2019:クイック スタート: Visual Studio を使用した Azure Government への接続

    • Visual Studio 2017:Azure Environment Selector Visual Studio 拡張機能の紹介。これは、Visual Studio Marketplace からダウンロードしてインストールできます。

• 組み込みの Logic Apps デザイナーを使用する際の Web へのアクセス

  デザイナーが Azure でリソースを作成し、ロジック アプリでコネクタからプロパティとデータを読み取るためには、インターネット接続が必要です。

ロジック アプリを見つける

Visual Studio では、Azure サブスクリプションに関連付けられていて、Cloud Explorer を使って Azure Portal に展開されたすべてのロジック アプリを検索できます。

1. Visual Studio を開きます。 [表示] メニューで [Cloud Explorer] を選びます。

2. Cloud Explorer で [アカウント管理] アイコンを選択します。 ロジック アプリに関連付けられている Azure サブスクリプションを選び、 [適用] を選択します。 次に例を示します。

   

3. [アカウント管理] アイコンの横にある [リソースの種類] を選択します。 Azure サブスクリプションで [ロジック アプリ] を展開し、サブスクリプションに関連付けられているすべてのデプロイ済みのロジック アプリを表示できるようにします。

次に、Logic App Editor でロジック アプリを開きます。

Visual Studio でロジック アプリを開く

Visual Studio では、Azure portal から直接デプロイされているか、Visual Studio から Azure リソース グループ プロジェクトとしてデプロイされている作成済みのロジック アプリを開くことができます。

1. Cloud Explorer を開いて、ロジック アプリを検索します。

2. ロジック アプリのショートカット メニューから、 [Logic App Editor で開く] を選びます。

   ヒント

   このコマンドが Visual Studio 2019 にない場合は、Visual Studio の最新の更新プログラムが適用されていることを確認してください。

   

   ロジック アプリ デザイナーでロジック アプリを開いた後、デザイナーの下端で [コード ビュー] を選んで、基になっているロジック アプリの定義構造を確認することができます。 ロジック アプリの配置テンプレートを作成する場合は、そのロジック アプリの Azure Resource Manager テンプレートをダウンロードする方法を学習してください。 詳しくは、Resource Manager テンプレートに関するページをご覧ください。

Azure からのダウンロード

Azure portal からロジック アプリをダウンロードし、Azure Resource Manager テンプレートとして保存することができます。 その後、Visual Studio でそのテンプレートをローカルに編集し、さまざまな展開環境用にロジック アプリをカスタマイズできます。 ロジック アプリをダウンロードすると、Resource Manager テンプレート内のその定義は自動的に "パラメーター化" され、JavaScript Object Notation (JSON) も使用されます。

1. Visual Studio で Cloud Explorer を使用して、Azure からダウンロードするロジック アプリを開きます。

2. ロジック アプリのショートカット メニューから、 [Logic App Editor で開く] を選びます。

   ヒント

   このコマンドが Visual Studio 2019 にない場合は、Visual Studio の最新の更新プログラムが適用されていることを確認してください。

   ロジック アプリ デザイナーでロジック アプリが開きます。

3. デザイナーのツール バーで、 [ダウンロード] を選びます。

   

4. 場所の指定を求められたら、その場所を参照し、ロジック アプリの定義の Resource Manager テンプレートを JSON (.json) ファイル形式で保存します。

   ロジック アプリの定義は、Resource Manager テンプレートの resources サブセクションにあります。 Visual Studio でロジック アプリの定義と Resource Manager テンプレートを編集できるようになります。 また、このテンプレートを Azure リソース グループ プロジェクトとして Visual Studio ソリューションに追加することもできます。 Visual Studio でのロジック アプリ用の Azure リソース グループ プロジェクトについて確認してください。

統合アカウントへのリンク

企業間 (B2B) エンタープライズ統合シナリオ向けのロジック アプリを構築するには、お使いのロジック アプリを、そのロジック アプリと同じリージョンにある以前作成した統合アカウントにリンクさせます。 統合アカウントには取引先、契約、スキーマ、マップなどの B2B 成果物が含まれているため、これを使用すると、お使いのロジック アプリでは XML 検証やフラット ファイルのエンコードとデコードに B2B コネクタを使用できます。 このリンクは Azure portal を使用して作成できますが、前提条件を満たした後には Visual Studio を使用することもできます。また、ロジック アプリは Azure リソース グループ プロジェクト内に JSON (.json) ファイルとして存在することになります。 Visual Studio でのロジック アプリ用の Azure リソース グループ プロジェクトについて確認してください。

1. Visual Studio で、お使いのロジック アプリを含む Azure リソース グループ プロジェクトを開きます。

2. ソリューション エクスプローラーで <ロジック アプリ名>.json ファイルのショートカット メニューを開き、[Open With Logic App Designer](ロジック アプリ デザイナーで開く) を選びます。 (Ctrl + L)

   

   ヒント

   このコマンドが Visual Studio 2019 にない場合は、Visual Studio に最新の更新プログラムが適用されており、Azure Logic Apps ツール拡張機能がインストールされていることを確認してください。

3. [プロパティ] ウィンドウにお使いのロジック アプリの [統合アカウント] プロパティが表示されるよう、デザイナーのタブまたはサーフェスを選択し、ロジック アプリ デザイナーにフォーカスがあることを確認します。

   

   ヒント

   [プロパティ] ウィンドウがまだ開いていない場合、 [表示] メニューから、 [プロパティ ウィンドウ] を選択します。 (F4 を押す)

4. [統合アカウント] プロパティの一覧を開き、次のように、ロジック アプリにリンクする統合アカウントを選択します。

   

5. 完了したら、忘れずにその Visual Studio ソリューションを保存します。

Visual Studio で [統合アカウント] プロパティを設定し、そのロジック アプリを Azure Resource Manager テンプレートとして保存すると、そのテンプレートには、選択した統合アカウントのパラメーター宣言も含まれます。 テンプレート パラメーターとロジック アプリの詳細については、ロジック アプリの自動デプロイの概要に関する記事を参照してください。

デプロイメントの場所を変更する

Visual Studio で、デプロイの自動化に利用する Azure リソース グループ プロジェクト内に JSON (.json) ファイルとしてロジック アプリが存在する場合、そのロジック アプリには場所の種類と特定の場所が設定されます。 この場所は、Azure リージョンまたは既存の統合サービス環境 (ISE) です。

ロジック アプリの場所の種類や場所を変更するには、ロジック アプリ デザイナーを利用し、ソリューション エクスプローラーからロジック アプリのワークフロー定義 (.json) ファイルを開く必要があります。 Cloud Explorer を使用してこれらのプロパティを変更することはできません。

重要

場所の種類を [リージョン] から 統合サービス環境に変更すると、課金、上限、統合アカウント サポートなどに使用されるロジック アプリの価格設定モデルに影響します。 場所に別の種類を選択する前に、ロジック アプリに与える影響を理解しておいてください。

1. Visual Studio で、お使いのロジック アプリを含む Azure リソース グループ プロジェクトを開きます。

2. ソリューション エクスプローラーで <logic-app-name>.json ファイルのショートカット メニューを開き、 [Open With Logic App Designer](ロジック アプリ デザイナーで開く) を選択します。 (Ctrl + L)

   

   ヒント

   このコマンドが Visual Studio 2019 にない場合は、Visual Studio に最新の更新プログラムが適用されており、Azure Logic Apps ツール拡張機能がインストールされていることを確認してください。

3. [プロパティ] ウィンドウにお使いのロジック アプリの [Choose Location Type](場所の種類の選択) プロパティと [場所] プロパティが表示されるよう、デザイナーのタブまたはサーフェスを選択し、ロジック アプリ デザイナーにフォーカスがあることを確認します。 プロジェクトの場所の種類は [リージョン] または [統合サービス環境] に設定されています。

   

   ヒント

   [プロパティ] ウィンドウがまだ開いていない場合、 [表示] メニューから、 [プロパティ ウィンドウ] を選択します。 (F4 を押す)

4. 場所の種類を変更するには、 [Choose Location Type](場所の種類の選択) プロパティを開き、必要な場所の種類を選択します。

   たとえば、場所の種類が [統合サービス環境] の場合、 [リージョン] を選択できます。

   

5. 特定の場所を変更するには、 [場所] プロパティの一覧を開きます。 場所の種類に基づき、たとえば次のように必要な場所を選択します。

   • 別の Azure リージョンを選択します。

     

   • 別の ISE を選択します。

     

6. 完了したら、忘れずにその Visual Studio ソリューションを保存します。

Visual Studio で場所の種類または場所を変更し、そのロジック アプリを Azure Resource Manager テンプレートとして保存すると、そのテンプレートには、その場所の種類と場所のパラメーター宣言も含まれます。 テンプレート パラメーターとロジック アプリの詳細については、ロジック アプリの自動デプロイの概要に関する記事を参照してください。

Azure から更新する

Azure Portal で行ったロジック アプリの編集による変更を残しておきたい場合は、Visual Studio で保持されているそのアプリのバージョンを、これらの変更で更新する必要があります。

• Visual Studio のロジック アプリ デザイナーのツール バーで、 [最新の情報に更新] を選びます。

  または

• Visual Studio の Cloud Explorer で、ロジック アプリのショートカット メニューを開き、 [最新の情報に更新] を選びます。

ロジック アプリの更新を発行する

Visual Studio から Azure にロジック アプリの更新を展開する準備ができたら、ロジック アプリ デザイナーのツール バーで [発行] を選びます。

ロジック アプリを手動で実行する

Azure に展開されているロジック アプリを、Visual Studio から手動で開始することができます。 ロジック アプリ デザイナーのツール バーの [トリガーの実行] を選びます。

実行履歴を確認する

ロジック アプリの実行の状態を確認して問題を診断するには、実行の入力や出力などの詳細を Visual Studio で確認できます。

1. Cloud Explorer でロジック アプリのショートカット メニューを開き、 [実行履歴を開く] を選びます。

   

2. 特定の実行の詳細を表示するには、実行をダブルクリックします。 次に例を示します。

   

   ヒント

   プロパティでテーブルを並べ替えるには、そのプロパティの列ヘッダーを選びます。

3. 入力と出力を確認するステップを展開します。例えば次のようにします。

   

ロジック アプリを無効または有効にする

次にトリガー条件が満たされたときにトリガーが発動しないようにするには、ロジック アプリを無効にします。 ロジック アプリを無効にすると、ワークフロー インスタンスに次のような影響が生じます。

• Azure Logic Apps サービスによって、進行中および保留中の実行がすべてその完了まで続行されます。 このプロセスは、ボリュームやバックログによっては、完了までに時間がかかる場合があります。

• Azure Logic Apps は、新しいワークフロー インスタンスを作成することも実行することもありません。

• トリガーは、次にその条件が満たされたときに起動されません。

• トリガーの状態には、ロジック アプリが停止したポイントが記憶されます。 そのため、ロジック アプリを再度有効にすると、前回の実行以降のすべての未処理の項目に対してトリガーが起動されます。

  前回の実行以降の未処理の項目に対してトリガーが起動しないようにするには、ロジック アプリを再度有効にする前に、トリガーの状態をクリアします。

  1. ロジック アプリで、ワークフローのトリガーをどこでもかまわないので編集します。
  2. 変更を保存します。 この手順により、トリガーの現在の状態がリセットされます。
  3. ロジック アプリを再度有効にします。

• ワークフローが無効になっている場合でも、実行を再送信できます。

ロジック アプリを無効にする

Cloud Explorer でロジック アプリのショートカット メニューを開き、 [無効化] を選びます。

ロジック アプリを有効にする

Cloud Explorer でロジック アプリのショートカット メニューを開き、[有効化] を選びます。

ロジック アプリを削除する

ロジック アプリを削除すると、ワークフロー インスタンスに次のような影響が生じます。

• 進行中および保留中の実行があれば、それらのキャンセルを Azure Logic Apps がベスト エフォートで試みます。

  大量のボリュームやバックログがあったとしても、ほとんどの実行は完了前または開始前にキャンセルされます。 ただし、キャンセル プロセスは完了までに時間がかかる場合があります。 その間、ランタイムがキャンセル プロセスに対処する傍ら、いくつかの実行が実行対象として選択されてしまう可能性があります。

• Azure Logic Apps は、新しいワークフロー インスタンスを作成することも実行することもありません。

• ワークフローを削除してから同じワークフローを再作成しても、再作成されたワークフローに、削除したワークフローと同じメタデータが割り当てられることはありません。 削除したワークフローの呼び出し元となったワークフローを再保存する必要があります。 これにより、呼び出し元は、再作成されたワークフローの正しい情報を取得します。 それ以外の場合、再作成したワークフローの呼び出しは、Unauthorized エラーで失敗します。 この動作は、統合アカウントのアーティファクトを使用するワークフローや、Azure 関数を呼び出すワークフローにも当てはまります。

Azure Portal からロジック アプリを削除するには、Cloud Explorer でロジック アプリのショートカット メニューを開き、 [削除] を選びます。

トラブルシューティング

Logic Apps デザイナーでロジック アプリ プロジェクトを開いたときに、Azure サブスクリプションを選択するオプションが表示されないことがあります。 代わりに、ロジック アプリには、使用するもの以外の Azure サブスクリプションが開かれます。 ロジック アプリの .json ファイルを開いた後、Visual Studio は今後使用できるように、最初に選択したサブスクリプションをキャッシュするため、この動作が行われます。 この問題を解決するには、次の手順のいずれかを試してください。

• ロジック アプリの .json ファイルの名前を変更します。 サブスクリプションのキャッシュは、ファイル名に依存します。

• ソリューション内のすべてのロジック アプリの以前に選択されたサブスクリプションを削除するには、ソリューションのディレクトリにある非表示の Visual Studio 設定フォルダー (.vs) を削除します。 この場所には、サブスクリプションの情報が格納されます。

次のステップ

この記事では、Visual Studio で展開済みのロジック アプリを管理する方法について学習しました。 次に、展開に合わせてロジック アプリの定義をカスタマイズする方法を学習してください。

JSON でロジック アプリの定義を作成する