Es kann vorkommen, dass Sie neben dem PrintingTools-Service, der in ArcGIS Enterprise enthalten ist, zusätzliche Services für das Drucken aus Webanwendungen benötigen. Sie könnten z. B. einen Service erstellen und ihn so konfigurieren, dass er auf Ihren eigenen Ordner für Karten-Layouts verweist. Sie können auch einen frei verfügbaren Service veröffentlichen und einen erweiterten Service gegen eine Gebühr zur Verfügung stellen.
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. Wenn Sie einen eigenen Druckservice erstellen möchten, müssen Sie einen Geoverarbeitungsservice mit dem Werkzeug Webkarte exportieren veröffentlichen.
Unter Freigeben eines Druckservice als Web-Werkzeug mit benutzerdefinierten Layouts aus ArcGIS Pro können Sie den entsprechenden Workflow dieses Tutorials in ArcGIS Pro sehen.
Registrieren des Ordners für Layout-Vorlagen bei ArcGIS Server
Sie werden mit einem Ordner mit ArcMap-Dokumenten (.mxd) arbeiten, den Sie mit unterschiedlichen Layouts, die zum Drucken von Webkarten verwendet werden sollen, vorbereitet haben. Dies ist der Ordner für Layout-Vorlagen.
Wenn sich der Ordner für Layout-Vorlagen derzeit auf dem Server befindet oder für den Server zugänglich ist, sollten Sie den Ordner mit ArcGIS Server bei ArcGIS Desktop registrieren.
Unternehmen Sie nichts, wenn Sie den Ordner für Layout-Vorlagen nicht auf dem Server oder an einem Ort ablegen können, der für den Server zugänglich ist. Der Ordner für Layout-Vorlagen wird auf den Server kopiert, wenn Sie den Service veröffentlichen, sodass der Server die Ordner anzeigen kann. Diese Option ist zwar leichter zu konfigurieren, aber zukünftig sind mehr Schritte erforderlich, um die Layout-Vorlagen zu aktualisieren.
Vorbereiten und Veröffentlichen des Service
Der erste Schritt bei der Veröffentlichung ist, das Werkzeug Webkarte exportieren mit den Standardwerten auszuführen, die Sie für den Service verwenden möchten. Danach führen Sie das Skriptwerkzeug Layout-Vorlageninformationen abrufen aus. Anschließend veröffentlichen Sie die Ergebnisse als Geoverarbeitungsservice.
- Navigieren Sie auf der Registerkarte Geoverarbeitung zu Toolboxes > Server Tools > Drucken.
- Doppelklicken Sie auf das Werkzeug Webkarte exportieren, um es zu öffnen.
- Lassen Sie den Parameter Webkarte als JSON leer.
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 legen diese JSON-Datei im Hintergrund an.
- Übernehmen Sie für den Parameter Ausgabedatei den Standardwert. Wenn Sie dieses Werkzeug auf dem Server veröffentlichen, wird die Ausgabe im Server-Auftragsverzeichnis gespeichert.
- Geben Sie den Parameter Layout-Vorlagenordner an, indem Sie auf die Schaltfläche "Durchsuchen" klicken und zum Ordner navigieren, 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.
- Legen Sie optional den Parameter Layout-Vorlage fest, indem Sie eines der Layouts aus der Dropdown-Liste auswählen. Dies ist das Standardlayout, wenn Benutzer den Service ausführen.
- Klicken Sie in ArcMap auf OK, um das Werkzeug auszuführen.
- Navigieren Sie in Toolboxes > Server Tools > Drucken zum Skriptwerkzeug Layout-Vorlageninformationen abrufen und öffnen Sie es.
- Legende
- Titeltext
- Copyright-Text
- Autortext
- Benutzerdefinierte Textelemente
- Wählen Sie den gleichen Layout-Vorlagenordner, den Sie bei der Ausführung des Werkzeugs Webkarte exportieren in Schritt 5 angegeben haben, und klicken Sie auf OK, um das Skript auszuführen.
- Klicken Sie auf Geoverarbeitung > Ergebnisse, um das Fenster Ergebnisse anzuzeigen.
- Blenden Sie Aktuelle Sitzung ein, klicken Sie mit der rechten Maustaste auf das Ergebnis Webkarte exportieren, und klicken Sie auf Freigeben als > Geoverarbeitungsservice.
- Wählen Sie Service veröffentlichen, und klicken Sie auf Weiter.
- Wählen Sie eine ArcGIS-Server-Verbindung aus (oder klicken Sie auf die entsprechende Schaltfläche, um eine neue Verbindung hinzuzufügen), und klicken Sie auf Weiter.
- Wählen Sie den Ordner aus, in dem der Service gespeichert werden soll. Sie können den Service nicht in den bestehenden Ordnern "System" oder "Utilities" veröffentlichen. Sie müssen Ihren eigenen Ordner oder den Stammordner verwenden. Klicken Sie auf Fortfahren. Sie sehen nun den Service-Editor, in dem Sie vor dem Veröffentlichen weitere Vorbereitungen treffen können, z. B. verfügbare Parameteroptionen für den Service festlegen.
- Klicken Sie auf Parameter, und stellen Sie sicher, dass der Ausführungsmodus des Service auf Synchron festgelegt ist. Sie können alternativ Asynchron auswählen, wenn Sie davon ausgehen, dass die Anforderungen länger als einige Sekunden dauern. Im ArcGIS Enterprise-Portal verwendete Druckservices müssen Synchron sein.
- Klicken Sie auf jeden dieser Parameter, und prüfen Sie die festgelegten Standardwerte. Wenn Sie die Standardwerte ändern möchten, müssen Sie zum Dialogfeld des Werkzeugs Webkarte exportieren zurückkehren und die Werte dort festlegen, wie Sie dies in den vorherigen Schritten in diesem Lernprogramm getan haben. Sie können einen Parameter für Endbenutzer vollständig ausblenden und diese dazu zwingen, den Standardwert zu verwenden. Setzen Sie dazu den Eingabemodus des Parameters auf Konstanter Wert.
Vorsicht:
Aufgrund einer bekannten Einschränkung des Werkzeugs Webkarte exportieren können Sie die für Endbenutzer verfügbaren Parameteroptionen nicht filtern.
- Klicken Sie auf Ergebnis hinzufügen, und fügen Sie das aus der Ausführung des Skriptwerkzeugs erhaltene Ergebnis Layout-Vorlageninformationen abrufen hinzu.
- Klicken Sie auf Freigeben, um den Service zu veröffentlichen.
Wenn Sie eine Warnung erhalten, dass Daten auf den Server kopiert werden, klicken Sie auf OK. Dadurch wird nur das standardmäßige Ausgabebild kopiert, das keine erhebliche Datenmenge aufweist.
- Stellen Sie sicher, dass der Service korrekt veröffentlicht wurde, indem Sie in Manager oder im Services-Verzeichnis zum Service navigieren.
Mit dem Skriptwerkzeug Layout-Vorlageninformationen abrufen können Sie den Task Layout-Vorlageninformationen abrufen zu Druckservices 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:
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 mit dem ArcGIS Enterprise-Portal zu verwenden, kopieren Sie diese URL zusammen mit dem Task "Webkarte exportieren", und fügen Sie dies zum 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 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 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 Veröffentlichen des Service hinzufügen, sind jedoch dem Server nicht bekannt.
Entsprechend müssen Sie, wenn eine der folgenden Bedingungen erfüllt ist, ein Überschreiben des Service durchführen, damit Ihre Änderungen für Ihre ArcGIS Server-Benutzer verfügbar sind:
- Sie haben vor dem Veröffentlichen Ihres benutzerdefinierten Druckservice 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 Veröffentlichen Ihres benutzerdefinierten Druckservice eine neue Layout-Vorlage zum Ordner hinzufügen und für Ihre Benutzer verfügbar machen.
Überschreiben und erneutes Veröffentlichen Ihres benutzerdefinierten Druckservice
Führen Sie die folgenden Schritte aus, um den Service zu überschreiben und Ihre Aktualisierungen verfügbar zu machen:
- Öffnen Sie in ArcMap das Werkzeug Webkarte exportieren, und führen Sie es, wie im vorherigen Abschnitt beschrieben, mit den gewünschten Standardwerten aus.
- Klicken Sie mit der rechten Maustaste auf das Geoverarbeitungsergebnis, und wählen Sie Freigeben als > Geoverarbeitungsservice aus.
- Wählen Sie die Option Vorhandenen Service überschreiben aus, und klicken Sie auf Weiter.
- Klicken Sie auf den Namen des Service, den Sie überschreiben möchten, und klicken Sie auf Weiter.
Hinweis:
Dies sollte nicht der Standard-PrintingTools-Service sein, sondern ein von Ihnen veröffentlichter benutzerdefinierter Druckservice.
- Stellen Sie im Service-Editor sicher, dass alle Serviceeigenschaften wie gewünscht festgelegt wurden (standardmäßig sollten die Eigenschaften verwendet werden, die Sie bei der ursprünglichen Veröffentlichung des Service ausgewählt haben), und klicken Sie auf Veröffentlichen.
Die von Ihnen ausgewählten Optionen überschreiben alle Optionen, die bei der erstmaligen Veröffentlichung festgelegt wurden. Der Ordner für Layout-Vorlagen (einschließlich Ihrer Aktualisierungen) wird auf den Server kopiert und ersetzt den Ordner für Layout-Vorlagen, der dort bei der erstmaligen Veröffentlichung des Service abgelegt wurde.
Überlegungen zur Vorbereitung von ArcMap-Druckservices für die Verwendung mit ArcGIS Enterprise
Sie sollten verschiedene Empfehlungen befolgen, wenn Sie Layouts in ArcMap erstellen, die in einem ArcGIS Enterprise-Portal verwendet werden sollen:
- Fügen Sie einen Titel ein, und lassen Sie den Titeltext leer, damit das Textfeld beim Drucken mit dem Namen der Portal-Webkarten gefüllt wird. Nicht gespeicherte Webkarten werden mit dem Titel Eigene Karte gedruckt.
- Fügen Sie den dynamischen Text Autor ein, um den Namen des Benutzers zu drucken.
- Fügen Sie den dynamischen Text Aktuelles Datum ein, um das Datum anzuzeigen, an dem die Karte gedruckt wurde.
- Fügen Sie den dynamischen Text Aktuelle Uhrzeit ein, um die Uhrzeit anzuzeigen, zu der die Karte gedruckt wurde.
Vorsicht:
Fügen Sie nicht den dynamischen Text Benutzername in das Layout ein. Dieser dynamische Text wird mit vertraulichen Informationen zum Druckservice gefüllt.
Weitere Informationen zum Erstellen effektiver Seiten-Layouts finden Sie unter Kurzer Überblick über Seitenlayouts.