ISV ソリューションの使用

[アーティクル]
05/27/2024

ISV ソリューションをインストールして使用するには、次のガイドラインに従います。

ISV ソリューションをインストールする

Azure portal から Azure Data Manager for Agriculture のインスタンスをインストールしたら、インスタンスの左側にある [設定] -> [ソリューション] タブに移動します。アプリケーション管理者のアクセス許可があることを確認します。
[追加] を選択して、インストールに使用できるソリューションのリストを表示します。任意のソリューションを選び、それに対して [追加] ボタンを選択します。

Note

ソリューションにプライベートプランしかない場合は、[お問い合わせ] ボタンが表示され、ソリューションの Marketplace ページに移動できます。

プランの選択ウィンドウに移動し、次の入力を行う必要があります。
1. [承認] ボタンを選択して、ソリューションのインストールに必要なアプリをソリューションプロバイダーが作成することに同意します。
2. オブジェクト ID。オブジェクト ID を見つけるには、こちらを参照してください
3. 選択したプランを選択する
[ご契約条件] チェックボックスをオンにし、[追加] を選択します。
このソリューションは Data Manager for Agriculture インスタンスにデプロイされ、ロールの割り当てはバックエンドで処理されます。

インストールされているソリューションを編集する

インストールされているソリューションを編集するには、[ソリューション] ページの [ソリューション] に対して編集アイコンを選択します。プランを変更するためのプランの選択ペインにリダイレクトされます。プライベートプランを使用したソリューションの場合は、Azure Marketplace にリダイレクトされます。そこから、[お問い合わせ] をクリックして ISV パートナーに連絡できます。

インストールされているソリューションを削除する

インストールされているソリューションを削除するには、[ソリューション] ページの [ソリューション] に対して削除アイコンを選択し、ポップアップで同じ内容を確認します。プライベートプランを使用したソリューションの場合は、Azure Marketplace にリダイレクトされます。そこから、[お問い合わせ] をクリックして ISV パートナーに連絡できます。

ISV ソリューションを使用する

ISV ソリューションをインストールしたら、次の手順に従って、アプリケーションから API 呼び出しを行う方法を理解します。統合 (要求/応答) は、API を介して非同期的に行われます。

新しい要求を作成し、ISV パートナーソリューションから応答を取得する方法の概要を示します。

ISV API のアクセスフローを示すスクリーンショット。

必要なパラメータ (ジョブ ID、ファームの詳細など) を使用して PUT 要求の API 呼び出しを行います。
- Data Manager API は、この要求を受信して認証します。要求が無効な場合は、エラーコードが返されます。
要求が有効な場合、Data Manager は ISV パートナーソリューション API への PUT 要求を作成します。
その後、ISV ソリューションは、処理に必要な Data Manager 内の気象サービスに GET 要求を行います。
ISV ソリューションは要求の処理を完了し、Data Manager に応答を送信します。
- この要求の送信時にエラーが発生した場合は、構成とパラメーターの確認が必要になる可能性があります。問題を解決できない場合は、サポートチケットを作成してお問い合わせください。
次に、ジョブ ID を使用して Data Manager を呼び出し、最終的な応答を取得します。
- ISV ソリューションによって要求処理が完了すると、分析情報の応答が返されます。
- 要求処理がまだ進行中の場合は、"処理を実行中" というメッセージが表示されます

すべての要求/応答が正常に処理されると、要求の状態はクローズされます。要求の最終的な出力は、Data Manager for Agriculture に格納されます。定義済みのしきい値内で要求を送信していることを確認する必要があります。

ソリューションのオブジェクト ID を識別する

Azure portal の [エンタープライズアプリケーション] ページに移動します。
[ソリューションプランの選択] ウィンドウで説明されている [アプリケーション ID] を使用し、アプリケーションをフィルター処理します。
[オブジェクト ID] をコピーします

次のステップ

API のテストはここで行います。

次の方法で共有