モデルを公開すると、カスタム Web ツールとして実行可能なホスト ツール アイテムが作成されます。
モデルを公開するために必要な手順は次のとおりです:
- モデルを作成します。
- Web ツールで構成可能にする入力に対し、変数を追加します。
- 変数をモデル パラメーターとして設定します。
- パラメーターを管理して、カスタム Web ツールでの表示をカスタマイズします。
- モデルを実行して保存します。
- モデルを公開します。
ライセンス要件
モデルを公開するには、ModelBuilder を使用するためのライセンスと構成に加え、[Web ツールの公開] 権限が必要です。
変数をモデル パラメーターとして設定する
モデル パラメーターとして設定された変数は、モデルをカスタム Web ツールとして公開して開いたときにツール パラメーターとして表示され、モデルの作成時とは異なるデータまたは値を指定できます。
出力ホスト データ変数はモデル パラメーターとして自動的に設定されるのに対し、入力データ変数と値変数は手動でパラメーターとして設定する必要があります。 出力中間データ変数はモデル パラメーターとして設定することはできません。
入力データ変数と値変数をモデル パラメーターとして設定するには、次の手順に従います:
- 必要に応じて、モデルを開き、データ ツールと変数を追加する手順を実行します。
- 必要に応じて、解析セッションに接続します。
- 変数エレメントをクリックして選択します。
選択した変数の上にエレメント ツールバーが表示されます。
- [パラメーターの追加または削除]
をクリックします。変数がモデル パラメーターとして設定されたことを意味するパラメーター アイコン
が変数に表示されます。
必要な変数がモデル パラメーターとして設定されたので、Web ツール パラメーターを管理できるようになりました。
Web ツール パラメーターの管理
[Web ツール パラメーターの管理] ウィンドウは、カスタム Web ツールのパラメーターを並べ替えたり、設定を更新するために使用されます。
Web ツール パラメーターを管理するには、次の手順に従います:
- データ、ツール、変数、モデル パラメーターを含むモデルを作成または開く手順を実行します。
- 必要に応じて、解析セッションに接続します。
- アクション ツールバーで [Web ツール パラメーターの管理]
をクリックします。[Web ツール パラメーターの管理] ウィンドウが表示されます。 モデルのパラメーターは、追加された順に表示されます。 各パラメーターには名前とエイリアスが付いています。 エイリアスは [パラメーター ラベル] 設定にリンクされています。
注意:
[Web ツール パラメーターの管理] ウィンドウでは、パラメーターの追加や削除は行えません。 パラメーターの追加と削除については、「変数をモデル パラメーターとして設定する」をご参照ください。
- パラメーターをクリックして展開します。
- 必要に応じ、以下の設定を更新します:
- [パラメーター ラベル] - ツール パラメーターの短いラベル。 このテキストは、カスタム Web ツールのツール ウィンドウにパラメーター名として表示されます。 ラベルは簡潔で、パラメーターの目的を説明し、平易な言葉で記述される必要があります。
- [ポップアップ ヘルプ テキスト] - ツール パラメーターの短い説明。 このテキストは、カスタム Web ツールのツール ウィンドウのパラメーターの横にあるヘルプ ボタン
をクリックすると表示されます。 パラメーターの機能の説明、異なる値がツールの結果に与える影響、サポートされている入力、およびデフォルト値を必要に応じて含めます。 - [必須] - ツールの検証と実行に対し、パラメーターが必須であるかどうかを示します。 モデル パラメーターが 1 つ以上の必須ツール パラメーターに接続されている場合、この値はオンになり、編集することはできません。 接続されているツール パラメーターがすべて任意である場合、モデル パラメーターをオンにしてパラメーターを必須にするか、オフにしてパラメーターを任意にできます。 パラメーターを必須にすると、Web ツールを実行する前に、ユーザーによる入力が求められます。
- [データ タイプ] - パラメーターと互換性のある入力を示します。 この値は変数のデータ タイプに基づくもので、変更することはできません。
- [フィルター] - 範囲を指定したり、パラメーターに指定可能な入力値やデータを制限します。 オプションは、次に示すように、データ タイプによって異なります:
- Double - 最小値と最大値。
- フィーチャ レイヤー - 使用可能なフィーチャ タイプ (マルチポイント、ポイント、ライン、ポリゴン) のリスト。
- Integer - 最小値と最大値。
- String - 個別値のリスト。
- [デフォルト値を含む] - ツール パラメーターにデフォルト値があるかどうかを指定します。 オンの場合、パラメーターでは変数値に基づくデフォルト値を使用します。 オフの場合、パラメーターはデフォルトで空になります。 デフォルト値を使用すると、ユーザーの入力をガイドでき、パラメーターを手動で更新する必要がないため、Web ツールが簡素化されます。 この設定は、使用可能な値のメニュー (単位など) があるパラメーターや、同じ入力値が更新の必要なく頻繁に使用されることが想定されるパラメーターで使用する必要があります。 ほとんどのテキスト、数値、またはフィーチャ レイヤーの入力では、デフォルト値は適切ではありません。
- [デフォルト値] - ツール パラメーターのデフォルト値を示します。 デフォルト値を変更するには、モデル ダイアグラムの変数値を更新します。 デフォルト値は、ほとんどのケースで正確または望ましい結果をもたらす値である必要があります。 この設定は、[デフォルト値を含む] が有効になっている場合にのみ使用できます。
- 折りたたむには、パラメーターをクリックします。
- 残りの各パラメーターに対し、上記の 3 つの手順を繰り返します。
また、必要に応じてパラメーターの順序を変更することもできます。
- パラメーター名の横の [再配置]
をクリックし、パラメーターを別の位置にドラッグします。または、[再配置] をクリックして、メニューからオプションを選択する方法もあります。 パラメーターの位置に応じ、オプションには [上に移動]、[下に移動]、[最上位へ移動]、[最下位へ移動] があります。
- [保存] をクリックします。
Web ツール パラメーターの設定が保存され、[Web ツール パラメーターの管理] ウィンドウが閉じます。 これで、モデルを公開する準備ができました。
モデルの公開
モデルを公開すると、カスタム Web ツールとして共有および実行が可能なツール アイテムが作成されます。
モデルを公開するには、次の手順を実行します。
- データ、ツール、変数、パラメーターを含むモデルを作成または開く手順を実行します。
- 必要に応じて、解析セッションに接続します。
- まだモデルを実行していない場合は、実行します。
モデルを実行することで、Web ツールが正常に実行されるかどうかを確認できます。
モデルを公開する前に Web ツールをプレビューし、正しい Web ツール パラメーターが設定されていることを確認します。
- モデルを保存します。
公開されている Web ツールは保存済みの解析モデル アイテムに基づきます。 モデルは実行して保存した後、公開できるようになります。 モデルに対して変更を加えた場合、再度実行して保存する必要があります。
- モデル ツールバーの [Web ツールのプレビュー]
をクリックします。[解析] ウィンドウに Web ツールのプレビューが表示されます。 Web ツールに変更を加える必要がある場合は、パラメーターの設定と管理のワークフローに戻ります。 [Web ツールのプレビュー] を再度クリックしてプレビューを更新します。
Web ツールで必要なすべてのパラメーターと構成がプレビューに表示されたら、モデルを公開できます。
- モデル ツールバーの [公開]
をクリックします。[Web ツールとして公開] ウィンドウが表示されます。 公開要件を満たしていない場合は、残りの要件を確認し、[Web ツールの公開] ウィンドウを閉じ、すべての要件を満たしてからこのワークフローに戻ります。
- 新しいアイテムに対し、次の手順を実行します。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
- アイテムを説明するタグとサマリーを入力します。
- [公開] をクリックします。
モデルが公開され、ツール アイテムが作成されます。
- [Web ツール アイテムを開く] をクリックしてツール アイテムの詳細を開くか、[Web ツールとして公開] ウィンドウを閉じます。
カスタム Web ツールは [ツール] ウィンドウで [カスタム Web ツールを開く] をクリックして開くことができます。 詳細ページから、組織やグループとツール アイテムを共有することもできます。
注意:
ツール アイテムをパブリックに共有することはできません。
公開の要件
解析モデルを Web ツールとして公開できるようにするには、次のすべての要件を満たしている必要があります。
ユーザーの公開権限
解析モデルを Web ツールとして公開するには、ユーザー アカウントがライセンス要件を満たしている必要があります。 アカウントがライセンス要件を満たしていない場合、[公開] ボタンは使用できません。
ユーザー アカウントの権限を更新するには、組織の管理者にお問い合わせください。
モデルが Web ツールの公開をサポート
1 つの解析モデル アイテムにつき Web ツールを 1 つだけ公開できます。 したがって、解析モデルがすでに公開されて Web ツールが作成されている場合、[公開] ボタンはオフになります。
解析モデルを公開するにはそのモデルに対する編集権限も必要です。つまり、そのモデルの所有者か、その解析モデルがホストされている組織の管理者でなければなりません。 共有されたモデルのコピーを作成して公開可能にすることができます。
すでに公開されているか自分に共有されているモデルのコピーを作成するには、次の手順を実行します:
- モデル ツールバーで [名前を付けて保存] をクリックします。
- 新しいアイテムに対し、次の手順を実行します。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
- アイテムを説明するタグとサマリーを入力します。
- [保存] をクリックします。
新しい解析モデルが作成され、表示専用モードで開きます。 そのモデルをアクティブ化し、必要に応じて変更を加えてから、公開して Web ツールを作成できるようになりました。
ホスト出力の作成
解析モデルを Web ツールとして公開するには、解析モデルでホスト フィーチャ レイヤーまたはテーブル レイヤー出力が作成される必要があります。 デフォルトでは、モデルにツールを追加すると、ホスト出力ではなく中間出力が必ず作成されます。
この要件を満たすため、いずれかのツールの [結果レイヤー] パラメーターが [ホスト レイヤーの作成] または [既存のレイヤーを上書き] に設定されていることを確認します。 モデルまたは Web ツールを実行すると、ホスト出力はモデル パラメーターとして設定され、Web マップに追加されます。 モデル内の最後のツールなど、解析の結果として表示したい出力用にホスト レイヤーが作成される必要があります。 最適な結果を得るには、モデル内の 1 つのツールにだけホスト出力を作成してください。
Web ツール パラメーターの管理
Web ツール パラメーターのエラーは、[Web ツール パラメーターの管理] ウィンドウで解決する必要があります。
モデルを公開する前に、次のエラーと警告を解決しておく必要があります:
- モデル パラメーターのデフォルト値とフィルター値の間に互換性がない - モデル パラメーターのデフォルト値は変数パラメーターに基づいており、フィルター値は [Web ツール パラメーターの管理] ウィンドウで設定されています。 デフォルト値とフィルター値の間に互換性がない場合 (フィルター値が 1 ～ 10 の数値でデフォルト値が 11 など)、エラーが発生します。 このエラーを解決するには、[Web ツール パラメーターの管理] ウィンドウでフィルター値を更新するか、変数値を変更してデフォルトのパラメーター値を更新します。
モデルの実行
Web ツールが正しく機能することを確認するため、モデルを Web ツールとして公開する前に、モデル全体が正常に実行されている必要があります。 正常に実行された後でモデルに追加の変更を加えた場合、ツールを再度実行しなければ公開可能になりません。
モデルの変更を保存
正常に実行されたら、モデルを保存する必要があります。 公開されている Web ツールは保存済みの解析モデル アイテムに基づきます。 モデルに対する変更が保存されていない場合、公開可能になりません。