ArcGIS Pro からのカスタム レイアウトを使用する印刷サービス Web ツールの共有

デフォルトの PrintingTools サービスの範囲外で ArcGIS Enterprise の印刷機能が必要な場合、ArcGIS Pro でレイアウトを作成して、Web ツールとしてポータルに共有できます。

デフォルトの PrintingTools サービスに付属するレイアウトを更新したり、新しいレイアウトの追加やこのサービスの再公開を行ったりしてはなりません。その代わりに、ArcGIS Pro で [Web マップのエクスポート (Export Web Map)] スクリプト ツールを実行して、その結果を Web マップ印刷の追加リソースとして機能する Web ツールとして共有してください。

他の Web ツールと同様に、このチュートリアルの結果は、サイン インした ArcGIS Enterprise ポータルで共有され、Web ツールの基となるジオプロセシング サービスは、指定したフェデレーション ArcGIS Server に保存されます。

このトピックは、「ArcMap での印刷用サービスの公開」に似ています。ただし、そのトピックでは ArcMap を使用して、ジオプロセシング サービスをサーバーに公開しますが、このトピックでは ArcGIS Pro を使用して、Web ツールをポータルと共有します。

カスタム レイアウトの作成

カスタム レイアウト テンプレートを作成する場合は、ArcGIS Pro で作成できます。詳細については、「ArcGIS Pro のレイアウト」をご参照ください。新しいレイアウトをフォルダーに保存します。[共有] タブの [名前を付けて保存] グループで、[レイアウト ファイル] をクリックします。または、[カタログ] ウィンドウで該当するレイアウトを右クリックして、[レイアウト ファイルとして保存] を選択します。

レイアウトを準備する際の考慮事項

ArcGIS Enterprise ポータルで使用されるレイアウトを ArcGIS Pro で作成するときは、次に示すいくつかのベスト プラクティスに従うようにしてください。

• レイアウトに複数のマップ フレームがある場合、Web ツールが使用するマップ フレームを特定し、それに WEBMAP_MAP_FRAME (大文字と小文字は区別されます) という名前を付けます。Web ツールで使用されるサービスは、そのように名付けられたマップ フレームを使用します。
• タイトル、作成者の名前などのダイナミック テキストを挿入します。ダイナミック テキストの詳細については、「ダイナミック テキストとは」 を ArcGIS Pro ドキュメントでご参照ください。それを行うには、次の手順を実行します。
  1. リボンの [挿入] タブで、[テキスト] グループの [テキスト] コマンドを選択します。
  2. 新しいテキスト エレメントを配置するレイアウト上の位置をクリックします。
  3. テキスト エレメントの [プロパティ] ページを開きます。
  4. 以下のタグのいずれかを選択したエレメントの [テキスト] プロパティに挿入します。

     titleText	<dyn type="layout" property="metadata" attribute="title" emptyStr=""/>
     authorText	<dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/>
     copyrightText	<dyn type="layout" property="metadata" attribute="credits" emptyStr=""/>

• [ダイナミック テキスト] ドロップダウンの [システム] カテゴリから [現在の時間] ダイナミック テキスト エレメントを追加することもできます。これは、[挿入] リボンの [テキスト] グループにもあります。
• カスタム テキスト エレメントを挿入する場合は、{parcel-id} など、テキスト エレメントを追加し、開き中括弧と閉じ中括弧のセット内にエレメントの名前を埋め込みます。

注意:

レイアウトに [ユーザー] ダイナミック テキストを挿入しないでください。この動的テキストには、印刷サービスに関する機密情報が読み込まれます。

ArcGIS Server へのレイアウト テンプレート フォルダーの登録

Web ツールを作成して ArcGIS Enterprise と共有するには、ArcGIS Server がレイアウト テンプレートを含むフォルダーにアクセスできる必要があります。サーバーがフォルダーにアクセスできる場合は、サーバーに登録できます。アクセスできない場合は、Web ツールの共有時にフォルダーのコンテンツを ArcGIS Pro からサーバーにコピーします。

詳しい手順については、ArcGIS Pro ヘルプの「登録済みデータ ストアの管理」をご参照ください。

Web ツールの準備と共有

準備ができたら、カスタム レイアウト テンプレートを含むフォルダーを使用して、[Web マップのエクスポート (Export Web Map)] スクリプト ツールを実行します。次に、[レイアウト テンプレート情報の取得 (Get Layout Templates Info)] スクリプト ツールを実行して、同じフォルダーを参照します。その後、Web ツールとして結果を共有します。

1. [ジオプロセシング] ウィンドウで、[Toolboxes] > [Server Tools] > [印刷] の順に選択します。
2. [Web マップのエクスポート (Export Web Map)] ツールをダブルクリックして開きます。
3. [JSON としての Web マップ] パラメーターは # のままにします。

   印刷可能な画像を取得するために、このサービスのユーザーは、このパラメーターでユーザー独自の Web マップの JSON を送信します。ArcGIS Web API、ArcGIS Enterprise アプリ テンプレート、および Web AppBuilder for ArcGIS の印刷ウィジェットは、この JSON を生成します。

4. [出力ファイル] パラメーターはそのままにします。

   このツールをサーバーに公開すると、出力がサーバー ジョブ ディレクトリに格納されます。

5. [レイアウト テンプレート フォルダー] パラメーターでは、[参照] ボタンをクリックし、レイアウトが保存されているフォルダーを参照します。

   ヒント:

   ArcGIS Enterprise にインストールされている基本レイアウトだけを参照する場合は、このパラメーターを空白のままにしておきます。

6. 必要に応じて、[レイアウト テンプレート] ドロップダウン リストからレイアウトを選択します。

   これが、ユーザーによるサービス実行時のデフォルトのレイアウトになります。

7. [実行] をクリックして、ツールを実行します。
8. [Toolboxes] > [Server Tools] > [印刷] の順に選択し、[レイアウト テンプレート情報の取得 (Get Layout Templates Info)] スクリプト ツールをダブルクリックして、これを開きます。

[レイアウト テンプレート情報の取得 (Get Layout Templates Info)] スクリプト ツールでは、[レイアウト テンプレート情報の取得] タスクを印刷サービスに追加できます。このタスクでは、レイアウト ページのサイズとマップ フレームのサイズが提供されます。また、以下のレイアウト エレメントが使用できるかどうかも表示されます。

• 凡例
• タイトル テキスト
• 著作権情報テキスト
• 作成者テキスト
• カスタム テキスト エレメント

9. ステップ 5 で [Web マップのエクスポート (Export Web Map)] ツールの実行中に指定したのと同じレイアウト テンプレート フォルダーを選択します。[実行] をクリックして、スクリプトを実行します。
10. リボンの [解析] タブで [履歴] をクリックするか、[カタログ] ウィンドウで [履歴] タブをクリックします。[Web マップのエクスポート (Export Web Map)] の結果を右クリックし、[共有] > [Web ツール] の順に選択します。

    [Web ツールとして共有] ダイアログ ボックスが表示されます。

11. [解析] オプションを使用して、考えられる問題を特定します。
12. ダイアログ ボックスの [一般] タブで、必要に応じて、[アイテムの詳細] (名前、概要、タグ) のデフォルトを置き換えます。上記のとおりにレイアウト テンプレート フォルダーをサーバーに登録した場合、[登録済みデータを参照] オプションを選択します。それ以外の場合は、[すべてのデータをコピー] を選択します。Web ツールを保存するポータル フォルダー、フェデレーション ArcGIS Server、および元のジオプロセシング サービスを保存するサーバー フォルダーを指定します。その後、この Web ツールの共有オプションを設定します。
13. [構成] タブに切り替えます。[パラメーター] セクションで、このツールの [実行モード] を指定します。ほとんどの場合、[同期] を指定します。リクエストの処理に数秒以上かかると予測される場合は、[非同期] を選択します (大きく詳細なマップの印刷など)。その後、ツールのログの [メッセージ レベル] を設定します。
14. [コンテンツ] タブに切り替えます。[ツールの追加] をクリックして、[レイアウト テンプレート情報の取得] の結果を追加します。

    実行した両ツールがこのツールに組み込まれました。

15. [共有] をクリックして、Web ツールを共有します。
16. Web ツールが正しく公開されていることを確認します。Web ツールは ArcGIS Enterprise ポータルに存在し、元のジオプロセシング サービスは ArcGIS Server Manager に存在します。

これで、ユーザーの新規 Web ツールが、ArcGIS Web API で提供される印刷ウィジェットとポータル マップ ビューアーで参照できるようになりました。Web ツールの URL は、ArcGIS Enterprise ポータルのアイテム ページから使用できます。

Web ツールは、フェデレーション ArcGIS Server サイトのカスタム サービスを活用します。このサービスを ArcGIS Enterprise ポータルの印刷サービスとして指定できます。ArcGIS Server Manager を開き、サービスを見つけます。この URL (Web マップのエクスポート タスクを含む) をコピーして、[印刷] の [ユーティリティ サービス] ダイアログ ボックスに貼り付けます。

レイアウト テンプレートの更新

レイアウト テンプレート フォルダー内のレイアウトを更新する場合、該当するワークフローは、公開前にレイアウト テンプレート フォルダーをサーバーに登録しているかどうかで決まります (上記の「ArcGIS Server へのレイアウト テンプレートの登録」セクションを参照)。新しいレイアウトをフォルダーに追加するか、既存のレイアウトを更新するかも重要です。これは、作成したジオプロセシング タスクが実行時にレイアウト テンプレート フォルダーにあったレイアウトのリストを保持するためです。

公開前にレイアウト テンプレート フォルダーをサーバーに登録している場合、これは、サーバーがユーザーのレイアウトを認識できることを意味します。フォルダー内の既存のレイアウト ファイル (*.pagx) に対して更新を行うと、変更されたレイアウトがすぐに利用可能になります。ただし、サーバーは、Web ツールを共有した後に追加される新しいレイアウトを認識しません。

したがって、次のいずれかに該当する場合には、上記のワークフローをやり直して、変更内容が ArcGIS Server ユーザーに表示されるように新しい Web ツールを共有する必要があります。

• Web ツールを共有する前にレイアウト テンプレート フォルダーをサーバーに登録していません。つまり、公開時にレイアウトがサーバーにコピーされています。
• Web ツールを共有した後、新しいレイアウト テンプレートをフォルダーに追加して、ユーザーが使用できるようにします。