Freigeben benutzerdefinierter Layouts für den Druck aus ArcGIS Pro

Wenn Sie in ArcGIS Enterprise Druckfunktionen außerhalb des Bereichs des Standard-PrintingTools-Service benötigen, können Sie benutzerdefinierte Layouts in ArcGIS Pro erstellen, die Ihren Anforderungen entsprechen. Sie können diese Layouts entweder als Webwerkzeug in Ihrem Portal freigeben, oder als Geoverarbeitungsservice auf Ihrer eigenständigen ArcGIS Server-Site veröffentlichen (sofern Sie eine verwenden). Geoverarbeitungsservices, die das Drucken ermöglichen, werden als Druckservices bezeichnet.

Die Layouts, die zum Standardservice PrintingTools gehören, sollten Sie nicht aktualisieren. Sie sollten auch keine neuen Layouts hinzufügen und diesen Service auch nicht veröffentlichen. Sie sollten stattdessen das Skriptwerkzeug Webkarte exportieren in ArcGIS Pro ausführen und das Ergebnis freigeben. Dieses kann dann als zusätzliche Ressource für das Drucken von Webkarten dienen.

Wenn Sie ein Web-Werkzeug im Portal freigeben, wird das Ergebnis dieses Lernprogramms in dem ArcGIS Enterprise-Portal, bei dem Sie angemeldet sind, freigegeben. Der Druckservice, der dem Web-Werkzeug zugrunde liegt, wird dabei auf dem von Ihnen festgelegten verbundenen ArcGIS Server gespeichert.

Wenn Sie mit einer eigenständige Server-Site arbeiten, verfügen Sie am Ende dieses Lernprogramms über einen Druckservice, der auf dem Werkzeug "Webkarte exportieren" bzw. Layout-Vorlageninformationen abrufen basiert, das Sie in ArcGIS Pro ausführen.

Das vorliegende Thema ähnelt dem Thema Veröffentlichen eines Druckservice mit benutzerdefinierten Layouts aus ArcMap. Dort wird jedoch ArcMap zum Veröffentlichen eines Druckservice auf dem Server verwendet, wobei es sich um einen eigenständigen oder einen mit einem Portal verbundenen Server handeln kann. In diesem Thema wird ArcGIS Pro verwendet, um entweder ein Webwerkzeug im Portal freizugeben oder einen Druckservice auf einem eigenständigen Server zu veröffentlichen.

Erstellen eines benutzerdefinierten Layouts

Eine benutzerdefinierte Layout-Vorlage können Sie in ArcGIS Pro erstellen. Weitere Informationen finden Sie unter Layouts in ArcGIS Pro. Speichern Sie Ihr neues Layout in einem Ordner: Klicken Sie auf der Registerkarte Freigeben in der Gruppe Speichern unter auf Layout-Datei. Klicken Sie alternativ im Bereich Katalog mit der rechten Maustaste auf das Layout, und wählen Sie Als Layout-Datei speichern aus.

Überlegungen zur Vorbereitung von Layouts

Sie sollten verschiedene Empfehlungen befolgen, wenn Sie Layouts in ArcGIS Pro erstellen, die in einem ArcGIS Enterprise-Portal verwendet werden sollen:

• Wenn in Ihrem Layout mehrere Kartenrahmen vorhanden sind, dann identifizieren Sie den Kartenrahmen, den das Web-Werkzeug verwenden soll, und geben Sie ihm den Namen WEBMAP_MAP_FRAME (Groß-/Kleinschreibung wird beachtet). Der Druckservice verwendet den Kartenrahmen mit diesem Namen.
• Fügen Sie dynamischen Text ein, z. B. Titel und Name des Autors. Weitere Informationen zu dynamischem Text finden Sie unter Was ist dynamischer Text? in der ArcGIS Pro-Dokumentation. Gehen Sie hierzu wie folgt vor:
  1. Wählen Sie auf der Registerkarte Einfügen des Menübandes den Befehl Text in der Gruppe Text aus.
  2. Klicken Sie auf eine Stelle im Layout, um das neue Textelement zu positionieren.
  3. Öffnen Sie die Seite Eigenschaften für das Textelement.
  4. Fügen Sie in der Eigenschaft Text des ausgewählten Elements eines der folgenden Tags ein:

     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=""/>

     Hinweis:

     Sie können für jedes Textelement nur ein Tag für dynamischen Text hinzufügen.

• Sie können auch das dynamische Textelement Aktuelle Uhrzeit aus der Kategorie System in der Dropdown-Liste Dynamischer Text einfügen. Dieses befindet sich auch in der Gruppe Text des Menübandes Einfügen.
• Wenn Sie ein benutzerdefiniertes Textelement einfügen möchten, dann fügen Sie ein Textelement hinzu und schließen Sie den Namen des Elements in geschweifte Klammern ein, wie zum Beispiel {parcel-id}.
• Wenn Sie eine Maßstabsleiste einfügen, empfiehlt es sich, dass Sie die Option Am Mittelpunkt berechnen auswählen, mit der der Kartenmaßstab anhand des Mittelpunkts des Kartenrahmens und nicht einer Position entlang des Äquators berechnet wird. Diese Option empfiehlt sich nicht für den Maßstabstext (z. B. 1:3.000).

Vorsicht:

Fügen Sie nicht den dynamischen Text Benutzer in das Layout ein. Dieser dynamische Text wird mit vertraulichen Informationen zum Druckservice gefüllt.

Registrieren des Ordners für Layout-Vorlagen bei ArcGIS Server

Der Ordner, der Ihre Layout-Vorlagen enthält, muss für den ArcGIS Server (entweder ein Server, der mit Ihrem Portal verbunden ist, oder Ihr eigenständiger Server) zugänglich sein. Wenn der Ordner für den Server zugänglich ist, können Sie ihn beim Server registrieren. Andernfalls müssen Sie den Inhalt dieses Ordners aus ArcGIS Pro auf den Server kopieren, wenn Sie Ihr Web-Werkzeug freigeben oder Ihren Druckservice veröffentlichen.

Weitere Anweisungen finden Sie in der ArcGIS Pro-Hilfe unter Verwalten von registrierten Data Stores.

Vorbereiten der benutzerdefinierten Werkzeuge

Führen Sie das Skriptwerkzeug "Webkarte exportieren" mit dem Ordner, in dem sich Ihre benutzerdefinierten Layout-Vorlagen befinden, aus. Führen Sie danach das Skriptwerkzeug "Layout-Vorlageninformationen abrufen" mit demselben Ordner aus.

1. Navigieren Sie im Bereich Geoverarbeitung zu Toolboxes > Server Tools > Drucken.
2. Doppelklicken Sie auf das Werkzeug Webkarte exportieren, um es zu öffnen.
3. Lassen Sie den Parameter Webkarte als JSON mit dem Wert # unverändert.

   Benutzer dieses Service müssen für diesen Parameter ihre eigene Webkarten-JSON-Datei senden, um druckbare Bilder zu erhalten. Die Druck-Widgets in den ArcGIS-Web-APIs, ArcGIS Enterprise-App-Vorlagen und ArcGIS Web AppBuilder generieren diesen JSON-Code.

4. Lassen Sie den Parameter Ausgabedatei unverändert.

   Wenn Sie dieses Werkzeug auf dem Server veröffentlichen, wird die Ausgabe im Server-Auftragsverzeichnis gespeichert.

5. Klicken Sie im Parameter Layout-Vorlagenordner auf die Schaltfläche "Durchsuchen", und navigieren Sie zu dem Ordner, in dem Ihre Layouts gespeichert sind.

   Tipp:

   Wenn Sie nur die mit ArcGIS Enterprise installierten, einfachen Layouts referenzieren möchten, lassen Sie diesen Parameter leer.

6. In der Dropdown-Liste Layout-Vorlage können Sie zusätzlich eine Vorlage auswählen.

   Dies ist das Standardlayout, wenn Benutzer den Service ausführen.

7. Klicken Sie auf Ausführen, um das Werkzeug auszuführen.
8. Navigieren Sie zu Toolboxes > Server Tools > Drucken, und doppelklicken Sie auf das Skriptwerkzeug Get Layout Templates Info, um es zu öffnen.

Mit dem Skriptwerkzeug Layout-Vorlageninformationen abrufen können Sie Druckservices den Task "Layout-Vorlageninformationen abrufen" hinzufügen. Mit diesem Task werden die Größe der Layout-Seite und die Größe des Datenrahmens abgerufen. Außerdem zeigt er an, ob die folgenden Layout-Elemente verfügbar sind:

• Legende
• Titeltext
• Copyright-Text
• Autortext
• Benutzerdefinierte Textelemente

9. Wählen Sie den gleichen Layout-Vorlagenordner, den Sie bei der Ausführung des Werkzeugs Webkarte exportieren in Schritt 5 angegeben haben. Klicken Sie auf Ausführen, um das Skript auszuführen.

Nachdem Sie nun die beiden Geoverarbeitungswerkzeuge für Ihre benutzerdefinierten Layouts ausgeführt haben, können Sie die Ergebnisse in ArcGIS Enterprise freigeben. Der als nächstes durchzuführende Workflow ist davon abhängig, ob Sie ein ArcGIS Enterprise-Portal (mit einem oder mehreren Verbundserver-Sites) oder eine eigenständige Server-Site verwenden.

Freigeben eines Web-Werkzeugs zum Drucken im ArcGIS Enterprise-Portal

Wenn Sie ein ArcGIS Enterprise-Portal verwenden, führen Sie die folgenden Schritte aus, um die Ergebnisse des Geoverarbeitungswerkzeugs als Web-Werkzeug im Portal freizugeben:

1. Klicken Sie auf der Registerkarte Analyse des Menübandes auf Verlauf oder klicken Sie auf die Registerkarte Verlauf im Bereich Katalog. Klicken Sie mit der rechten Maustaste auf das Ergebnis Webkarte exportieren und wählen Sie Freigeben als > Web-Werkzeug.

   Das Dialogfeld Als Web-Werkzeug freigeben wird angezeigt.

2. Verwenden Sie die Option Analysieren, um mögliche Probleme zu identifizieren.
3. Ersetzen Sie auf der Registerkarte Allgemein des Dialogfeldes die Standardeinstellungen in Elementdetails (Name, Zusammenfassung und Tags) nach Bedarf. Wenn Sie den Ordner für Layout-Vorlagen, wie oben beschrieben, beim Server registriert haben, dann wählen Sie die Option Registrierte Daten referenzieren. Andernfalls müssen Sie Alle Daten kopieren wählen. Legen Sie den Portal-Ordner, in dem das Web-Werkzeug gespeichert werden soll, und die eingebundene ArcGIS Server-Site und den Server-Ordner, in dem der zugrunde liegende Geoverarbeitungsservice gespeichert werden soll, fest. Legen Sie dann die Freigabeoptionen für dieses Web-Werkzeug fest.
4. Wechseln Sie zur Registerkarte Konfiguration. Geben Sie einen Ausführungsmodus für das Werkzeug im Abschnitt Parameter an. In den meisten Fällen müssen Sie Synchron wählen. Asynchron sollten Sie wählen, wenn Sie davon ausgehen, dass die Anforderungen länger als einige Sekunden dauern (zum Beispiel beim Drucken einer großen, detaillierten Karte). Legen Sie dann eine Meldungsebene bei der Protokollierung für das Werkzeug fest.

   Hinweis:

   Druckservices, bei denen der Ausführungsmodus auf Asynchron festgelegt ist, können nicht in ArcGIS Web AppBuilder-Apps verwendet werden.

5. Wechseln Sie zur Registerkarte Inhalt. Klicken Sie auf Werkzeug hinzufügen, und fügen Sie das Ergebnis Layout-Vorlageninformationen abrufen hinzu.

   Beide von Ihnen ausgeführte Werkzeuge sind jetzt in dieses Web-Werkzeug integriert.

6. Klicken Sie auf Freigeben, um das Web-Werkzeug freizugeben.
7. Überprüfen Sie, ob Ihr Web-Werkzeug korrekt veröffentlicht wurde. Es sollte in Ihrem ArcGIS Enterprise-Portal verfügbar sein. Der zugrunde liegende Geoverarbeitungsservice sollte in ArcGIS Server Manager verfügbar sein.

Ihr neues Web-Werkzeug kann nun in den Druck-Widgets, die von den ArcGIS-Web-APIs angeboten werden, sowie im Map Viewer des Portals referenziert werden. Die URL für das Web-Werkzeug ist auf dessen Elementseite im ArcGIS Enterprise-Portal verfügbar.

Das Web-Werkzeug wird durch einen benutzerdefinierten Druckservice in Ihrer verbundenen ArcGIS Server-Site unterstützt. Diesen Service können Sie als Druckservice Ihres ArcGIS Enterprise-Portals festlegen. Öffnen Sie ArcGIS Server Manager und suchen Sie den Service. Kopieren Sie dessen URL zusammen mit dem Task "Webkarte exportieren" in die Zwischenablage und fügen Sie dies zum Drucken im Dialogfeld Utility-Services ein.

Veröffentlichen eines Druckservice auf einem eigenständigen Server

Wenn Sie mit einer eigenständigen ArcGIS Server-Site der Version 10.6 oder höher arbeiten, können Sie mithilfe der folgenden Schritte einen Druckservice über ArcGIS Pro auf dem Server veröffentlichen.

1. Fügen Sie der ArcGIS Server-Site eine Administratorverbindung hinzu. Damit Geoverarbeitungsservices auf dem eigenständigen Server veröffentlicht werden können, muss es sich bei der Verbindung um eine Administratorverbindung handeln.
2. Klicken Sie im Bereich Katalog mit der rechten Maustaste auf die Serververbindung, und wählen Sie Veröffentlichen aus. Verwenden Sie die Option Geoverarbeitungsservice, um das Fenster Ausgewählte(s) Verlaufselement(e) zu öffnen. Wählen Sie das Element Webkarte exportieren aus der Liste aus, um das Fenster Geoverarbeitungsservice veröffentlichen zu öffnen.
3. Verwenden Sie die Option Analysieren, um mögliche Probleme zu identifizieren.
4. Ersetzen Sie auf der Registerkarte Allgemein des Dialogfeldes die Standardeinstellungen in Elementdetails (Name, Zusammenfassung und Tags) nach Bedarf. Wenn Sie den Ordner für Layout-Vorlagen, wie oben beschrieben, beim Server registriert haben, dann wählen Sie die Option Registrierte Daten referenzieren. Andernfalls müssen Sie Alle Daten kopieren wählen. Legen Sie den Serverordner fest, in dem der zugrunde liegende Geoverarbeitungsservice gespeichert werden soll. Legen Sie dann die Freigabeoptionen für dieses Web-Werkzeug fest.
5. Wechseln Sie zur Registerkarte Konfiguration. Geben Sie einen Ausführungsmodus für das Werkzeug im Abschnitt Parameter an. In den meisten Fällen müssen Sie Synchron wählen. Asynchron sollten Sie wählen, wenn Sie davon ausgehen, dass die Anforderungen an den Druckservice länger als einige Sekunden dauern (zum Beispiel beim Drucken einer großen, detaillierten Karte). Legen Sie dann eine Meldungsebene bei der Protokollierung für das Werkzeug fest.
6. Wechseln Sie zur Registerkarte Inhalt. Klicken Sie auf Werkzeug hinzufügen, und fügen Sie das Ergebnis Layout-Vorlageninformationen abrufen hinzu.

   Die beiden von Ihnen ausgeführten Werkzeuge sind jetzt in diesen Druckservice integriert.

7. Klicken Sie auf Veröffentlichen, um die Veröffentlichung des Druckservice zu beginnen.
8. Überprüfen Sie, ob Ihr Druckservice korrekt veröffentlicht wurde. Er sollte in ArcGIS Server Manager zur Verfügung stehen.

Der neue Service kann nun in den Druck-Widgets, die von den ArcGIS-Web-APIs angeboten werden, referenziert werden. Die URL für den Druckservice befindet sich im ArcGIS-Server-Services-Verzeichnis.

Um den benutzerdefinierten Druckservice bei einem ArcGIS Enterprise-Portal zu registrieren, kopieren Sie diese URL zusammen mit dem Task "Webkarte exportieren", und fügen Sie dies unter Drucken in das Dialogfeld Utility-Services ein. Beachten Sie, dass das Portal nur eine URL akzeptiert, die HTTPS für den Druck-Utility-Service verwendet.

Aktualisieren der Layout-Vorlagen

Wenn Sie die Layouts im Ordner für Layout-Vorlagen aktualisieren möchten, hängt der geeignete Workflow davon ab, ob Sie den Ordner für Layout-Vorlagen vor der Freigabe beim Server registriert haben (siehe Abschnitt "Registrieren der Layout-Vorlagen bei ArcGIS Server"). Zu berücksichtigen ist auch, ob Sie ein neues Layout zum Ordner hinzufügen oder lediglich ein vorhandenes Layout aktualisieren möchten. Der Grund dafür ist, dass der von Ihnen erstellte Geoverarbeitungs-Task eine Liste der Layouts führt, die zur Ausführungszeit in Ihrem Ordner für Layout-Vorlagen sind.

Wenn Sie vor der Freigabe den Ordner für Layout-Vorlagen beim Server registriert haben, bedeutet dies, dass der Server die Vorlagen anzeigen kann. Wenn Sie Aktualisierungen an vorhandenen Layout-Dateien (.pagx) im Ordner vornehmen, stehen die geänderten Layouts sofort zur Verfügung. Neue Layouts, die Sie nach dem Freigeben hinzufügen, sind dem Server jedoch nicht bekannt.

Entsprechend müssen Sie, wenn eine der folgenden Bedingungen zutrifft, den obigen Workflow wiederholen und ein neues Web-Werkzeug bzw. einen neuen Druckservice freigeben, damit Ihre Änderungen für die ArcGIS Server-Benutzer verfügbar sind:

• Sie haben vor dem Freigeben des Web-Werkzeugs bzw. Druckservice den Ordner für Layout-Vorlagen nicht beim Server registriert. Die Layouts wurden somit zum Zeitpunkt der Veröffentlichung auf den Server kopiert.
• Sie möchten dem Ordner nach der Freigabe des Web-Werkzeugs bzw. Druckservice eine neue Layout-Vorlage hinzufügen und diese für andere Benutzer verfügbar machen.