Skip To Content

Freigeben eines Druckservice als Web-Werkzeug mit benutzerdefinierten Layouts aus ArcGIS Pro

Wenn Sie in ArcGIS Enterprise Druckfunktionen außerhalb des Bereichs des Standard-PrintingTools-Service benötigen, können Sie Layouts in ArcGIS Pro erstellen und in Ihrem Portal als Web-Werkzeug freigeben.

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 als Web-Werkzeug freigeben. Dieses kann dann als zusätzliche Ressource für das Drucken von Webkarten dienen.

Wie bei jedem anderen Web-Werkzeug wird das Ergebnis dieses Lernprogramms in dem ArcGIS Enterprise-Portal, bei dem Sie angemeldet sind, freigegeben, und der Geoverarbeitungsservice, der dem Web-Werkzeug zugrunde liegt, wird auf dem von Ihnen festgelegten eingebundenen ArcGIS Server gespeichert.

Das vorliegende Thema ähnelt dem Thema Veröffentlichen zusätzlicher Services zum Drucken in ArcMap. In jenem Thema wird jedoch ArcMap zum Veröffentlichen eines Geoverarbeitungsservice auf Ihrem Server verwendet, während im vorliegenden Thema ArcGIS Pro zum Freigeben eines Web-Werkzeugs mit Ihrem Portal verwendet wird.

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 Service, der dem Web-Werkzeug zugrunde liegt, verwendet dann 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=""/>
  • 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}.
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

Damit das Web-Werkzeug mit ArcGIS Enterprise erstellt und freigegeben werden kann, muss der Ordner mit Ihren Layout-Vorlagen für ArcGIS 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 das Web-Werkzeug freigeben.

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

Vorbereiten und Freigeben des Web-Werkzeugs

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. Geben Sie dann die Ergebnisse als Web-Werkzeug frei.

  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 Web AppBuilder for ArcGIS 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 Layout-Vorlageninformationen abrufen, um es zu öffnen.
  9. 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

  10. 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.
  11. 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.

  12. Verwenden Sie die Option Analysieren, um mögliche Probleme zu identifizieren.
  13. 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.
  14. 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.
  15. 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.

  16. Klicken Sie auf Freigeben, um das Web-Werkzeug freizugeben.
  17. Ü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 Service in Ihrer eingebundenen 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.

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 Veröffentlichung 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 dem Veröffentlichen Ihren 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 des Web-Werkzeugs hinzufügen, sind jedoch dem Server nicht bekannt.

Entsprechend müssen Sie, wenn eine der folgenden Bedingungen erfüllt ist, den obigen Workflow wiederholen und ein neues Web-Werkzeug freigeben, damit Ihre Änderungen für Ihre ArcGIS Server-Benutzer verfügbar sind:

  • Sie haben vor dem Freigeben des Web-Werkzeugs Ihren Ordner für Layout-Vorlagen nicht beim Server registriert, das heißt, die Layouts wurden zum Zeitpunkt der Veröffentlichung auf den Server kopiert.
  • Sie möchten nach dem Freigeben des Web-Werkzeugs eine neue Layout-Vorlage zum Ordner hinzufügen und für Ihre Benutzer verfügbar machen.