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. Sie können diese Layouts entweder als Web-Werkzeug in Ihrem Portal freigeben oder als Geoverarbeitungsservice auf einer eigenständigen ArcGIS Server-Site veröffentlichen. Geoverarbeitungsservices, die das Drucken ermöglichen, werden als Druckservices bezeichnet.

Aktualisieren Sie die Layouts, die zum Standardservice PrintingTools gehören, nicht. Fügen Sie auch keine neuen Layouts hinzu, und veröffentlichen Sie diesen Service nicht erneut. Führen Sie stattdessen das Skriptwerkzeug Webkarte exportieren in ArcGIS Pro aus, und geben Sie das Ergebnis frei. 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.

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 das 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.

Hinweis:

In der Organisation muss ArcGIS Server 11.0 oder höher verwendet werden, damit in ArcGIS Pro 3.0 und höheren Versionen erstellte benutzerdefinierte Layouts unterstützt werden.

Erstellen 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. Führen Sie die folgenden Schritte aus, um dynamischen Text einzufügen:
  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 im Dropdown-Menü Dynamischer Text einfügen. Dieses befindet sich auch in der Gruppe Text des Menübandes Einfügen.
• Um ein benutzerdefiniertes Textelement einzufügen, 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).
• Ab Version 11.2 können Sie den Layouts auch Attribute und Statistiken sowie dynamische Textelemente hinzufügen.

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 ein 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 ein Layout 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 Ordner als 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.

Verwenden benutzerdefinierter Druckvorlagen im ArcGIS Enterprise-Portal

Sie können Layout-Vorlagen (.pagx) und Berichtsvorlagen (.rptt) als Portalelemente hinzufügen, die an einzelne Druckservices übergeben werden können. Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Berichtsvorlage hochzuladen:

1. Erstellen Sie eine Layout-Vorlage oder eine Berichtsvorlage in ArcGIS Pro.
2. Speichern Sie die Vorlage als PAGX- oder RPTT-Datei.
3. Melden Sie sich bei Ihrem Portal an.
4. Klicken Sie auf Inhalt.
5. Klicken Sie auf Neues Element.
6. Sie können die Vorlagendatei per Drag & Drop ablegen oder auf Ihr Gerät klicken und die Datei auswählen.

Die Vorlage kann nun über die Parameter Layout_Item_ID und Report_Item_ID an Druckservices übergeben werden.

Weitere Informationen finden Sie in den Themen Erstellen einer benutzerdefinierten Berichtsvorlage und Layout-Dateien.

Einschränkungen

Bei der Verwendung von benutzerdefinierten Druckvorlagen bestehen die folgenden Einschränkungen:

• Elemente müssen sich in dem Portal befinden, mit dem der Server für Druckservices verbunden ist. Ein in Portal A ausgeführter Druckservice kann beispielsweise nicht auf Elemente aus Portal B zugreifen.
• Die Standard-Druckservices des sofort einsatzbereiten Druckservice und von ArcGIS GIS Server unterstützen diese Funktion nicht.
• Web-Clients unterstützen diese Funktion derzeit nicht. Sie müssen stattdessen eine benutzerdefinierte JavaScript API schreiben.

Veröffentlichen eines Druckservice im ArcGIS Enterprise-Portal zum Aktivieren von Berichten

Ab Version 11.2 können Sie Druckservices aus ArcGIS Pro 3.2 oder höher veröffentlichen, um das Drucken von Berichten auf der Grundlage von Layout-Vorlagen (.pagx), Berichtsvorlagen (.rptx) oder beidem zu ermöglichen.

Berichtstypen

Über einen Druckservice können Sie drei Typen von Berichten generieren:

• Layouts mit dynamischen Textelementen: Ausgabe einer einzelnen Seite mit einer Karte und Attributen sowie Statistiken, die über dynamische Textelemente angezeigt werden.
• Berichte ohne Karten: Mehrseitige Ausgabe, die Attribute, Statistiken, Diagramme und Anlagen umfassen kann. Unterstützt nur PDF-Formate.
• Layouts mit oder ohne dynamische Textelemente und Bericht: Mehrseitige Ausgabe, die sowohl ein Layout als auch einen Bericht enthält. Unterstützt nur PDF-Formate.

Veröffentlichen eines Berichts

Führen Sie die folgenden Schritte aus, um einen Bericht zu veröffentlichen:

1. Erstellen Sie eine Vorlage für ein Layout mit dynamischen Textelementen oder eine Vorlage für einen Bericht in ArcGIS Pro.
2. Speichern Sie die Vorlage als Layout-Vorlage (.pagx) oder als Berichtsvorlage (.rptx) im Vorlagendateiordner.
3. Öffnen Sie in ArcGIS Pro das Werkzeug Webkarte exportieren.
4. Legen Sie den Parameter Layout Templates Folder auf den Vorlagendateiordner fest, in dem Sie die Vorlage gespeichert haben.
5. Führen Sie das Werkzeug "Webkarte exportieren" aus.
6. Navigieren Sie zu Toolboxes > Server Tools > Drucken, und doppelklicken Sie auf das Skriptwerkzeug Get Layout Templates Info oder Get Report Templates Info, je nachdem, ob Sie Layouts, Berichte oder beides veröffentlichen möchten.
7. Veröffentlichen Sie die Vorlagen als Druckservice.

Einschränkungen

Bei der Verwendung von Berichten bestehen die folgenden Einschränkungen:

• Die Standard-Druckservices des sofort einsatzbereiten Druckservice und von ArcGIS GIS Server unterstützen diese Funktion nicht.
• Map Viewer und ArcGIS Experience Builder unterstützen diese Funktion nicht.
• Web-Clients unterstützen diese Funktion derzeit nicht. Sie müssen stattdessen mit der JavaScript API eine benutzerdefinierte App oder ein benutzerdefiniertes Widget erstellen.

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 können 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 einen Wert für die Meldungsebene bei der Protokollierung für das Werkzeug fest.
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 das Web-Werkzeug korrekt veröffentlicht wurde.

   Das Web-Werkzeug ist in Ihrem ArcGIS Enterprise-Portal verfügbar. Der zugrunde liegende Geoverarbeitungsservice ist in ArcGIS Server Manager verfügbar.

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 können 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 einen Wert für die 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 ist in ArcGIS Server Manager verfügbar.

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 dem Ordner ein Layout hinzufügen oder 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 vorhandene Layout-Dateien (.pagx) im Ordner aktualisieren, 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.