Webkarte exportieren (Server Tools)

Zusammenfassung

Gibt basierend auf dem Status einer Web-App (zum Beispiel enthaltene Services, Layer-Sichtbarkeitseinstellungen und clientseitige Grafiken) ein druckbares Seitenlayout oder eine grundlegende Karte eines angegebenen Interessenbereichs zurück.

Verwendung

Die Eingabe für dieses Werkzeug ist ein Text im JSON-Format, der die Layer, Grafiken und andere Einstellungen in der Webkarte beschreibt. Die JSON-Darstellung muss entsprechend der ExportWebMap-Spezifikation strukturiert sein.
Dieses Werkzeug ist in ArcGIS Server enthalten, um Web-Services zum Drucken zu unterstützen, darunter der vorkonfigurierte Service PrintingTools. Die ArcGIS API für JavaScript verwendet den Service PrintingTools, um Images für den Kartendruck zu generieren.
Für erweiterte Druckszenarien, zum Beispiel Ersetzen von Service-Layern durch lokale Vektordaten, Erstellen von Kartensammlungen usw., sollten Sie dieses Werkzeug nicht verwenden. Verwenden Sie stattdessen die Funktion ConvertWebMapToArcGISProject im Python arcpy.mp-Modul, das im Lieferumfang von ArcGIS enthalten ist. Um ein Python-Skript für eine Web-App verfügbar zu machen, können Sie das Skript über einen ArcGIS Server-Geoverarbeitungsservice bereitstellen. Weitere Informationen finden Sie unter Drucken in Webanwendungen in der Hilfe zu ArcGIS Server.
Beim Exportformat TIFF wird eine 32-Bit-TIFF-Datei (.tiff) mit Geofunktionen und einem Alpha-Kanal generiert.
Der Ordner, der im Parameter Vorlagenordner angegeben ist, darf nicht zwei oder mehrere Dateien (.rptt und .rptx) mit identischem Namen enthalten. Damit sollen unerwünschte Ausgaben bei Druckaufträgen vermieden werden. Layout- und Berichtsvorlagen dürfen denselben Namen haben.
Wenn eine Berichtsvorlage verwendet oder angegeben wird, muss die Ausgabe im PDF-Format vorliegen.
Um einen Bericht ohne Karten vom Druckdienst zu generieren, geben Sie einen Parameterwert für Berichtsvorlage und für den Parameter **LayoutvorlageMAP_ONLY den Wert ** an.

Beschriftung	Erläuterung	Datentyp
Webkarte als JSON	Eine JSON-Repräsentation des Status der zu exportierenden Karte, wie sie in der Web-App angezeigt wird. Informationen zum Formatieren dieses Textes finden Sie im Abschnitt zur ExportWebMap-Spezifikation. Verwenden Sie zum Abrufen dieser JSON-Zeichenfolge aus der Karte ArcGIS API for JavaScript.	String
Ausgabedatei	Der Name der Ausgabedatei. Die Erweiterung der Datei hängt vom Parameterwert Format ab.	File
Format (Optional)	Gibt das Format an, in dem das Karten-Image zum Drucken bereitgestellt wird. Hinweis: Der Hintergrund der Ausgabedatei ist immer undurchsichtig. 8-Bit Portable Network Graphics (PNG8)—Das PNG-8-Format (8-Bit Portable Network Graphics) wird verwendet. Dies ist die Standardeinstellung. Portable Document Format (PDF)—Das PDF-Format (Portable Document Format) wird verwendet. 32-Bit Portable Network Graphics (PNG32)—Das PNG-32-Format (32-Bit Portable Network Graphics) wird verwendet. Joint Photographic Experts Group (JPG)—Das JPG-Format (Joint Photographic Experts Group) wird verwendet. GIF (Graphics Interchange Format)—Das GIF-Format (Graphics Interchange Format) wird verwendet. Encapsulated PostScript (EPS)—Das EPS-Format (Encapsulated PostScript) wird verwendet. Scalable Vector Graphics (SVG)—Das SVG-Format (Scalable Vector Graphics) wird verwendet. Compressed Scalable Vector Graphics (SVGZ)—Das SVGZ-Format (Compressed Scalable Vector Graphics) wird verwendet. Adobe Illustrator Exchange (AIX)—Das AIX-Format (Adobe Illustrator Exchange) wird verwendet. Tag Image File Format (TIFF)—Das TIFF-Format (Tag Image File Format) wird verwendet.	String
Vorlagenordner (Optional)	Der vollständige Pfad zum Ordner mit den Layout- oder Berichtsseiten (.pagx-, `.rptx`- und `.rptt`-Dateien), die als Vorlagen verwendet werden sollen. Das Standardverzeichnis ist `<install_directory>\Resources\ArcToolBox\Templates\ExportWebMapTemplates`.	Folder
Layout-Vorlage (Optional)	Der Name einer Vorlage aus der Liste oder das Schlüsselwort `MAP_ONLY`. Wenn `MAP_ONLY` verwendet oder eine leere Zeichenfolge übergeben wird, enthält die Ausgabekarte keine Seitenlayout-Elemente, wie zum Beispiel Titel, Legende oder Maßstabsleiste.	String
Layout-Element-ID (Optional)	Die Portal-ID (im JSON-Format) des Layout-Elements, das für Vorlagen verwendet werden soll. Verwenden Sie das Format: `{"id": "<portal-id>"}`. Wenn ein Wert angegeben wurde, hat dieser Parameter Vorrang vor dem Parameter Layout-Vorlage.	String
Berichtsvorlage (Optional)	Der Name der Berichtsvorlage. Wenn dieser Parameterwert angegeben wurde, muss der Parameter Format auf Portable Document Format (PDF) festgelegt werden. Wenn kein Wert angegeben wurde, enthält die Ausgabedatei keine Berichte.	String
Berichtselement-ID (Optional)	Die Portal-ID (im JSON-Format) des Berichtelements, das für Vorlagen verwendet werden soll. Verwenden Sie das Format: `{"id": "<portal-id>"}`. Wenn ein Wert angegeben wurde, hat dieser Parameter Vorrang vor dem Parameter Berichtsvorlage.	String

arcpy.server.ExportWebMap(Web_Map_as_JSON, Output_File, {Format}, {Layout_Templates_Folder}, {Layout_Template}, {Layout_Item_ID}, {Report_Template}, {Report_Item_ID})

Name	Erläuterung	Datentyp
Web_Map_as_JSON	Eine JSON-Repräsentation des Status der zu exportierenden Karte, wie sie in der Web-App angezeigt wird. Informationen zum Formatieren dieses Textes finden Sie im Abschnitt zur ExportWebMap-Spezifikation. Verwenden Sie zum Abrufen dieser JSON-Zeichenfolge aus der Karte ArcGIS API for JavaScript.	String
Output_File	Der Name der Ausgabedatei. Die Erweiterung der Datei hängt vom Parameterwert `Format` ab.	File
Format (Optional)	Gibt das Format an, in dem das Karten-Image zum Drucken bereitgestellt wird. Hinweis: Der Hintergrund der Ausgabedatei ist immer undurchsichtig. `PNG8`—Das PNG-8-Format (8-Bit Portable Network Graphics) wird verwendet. Dies ist die Standardeinstellung. `PDF`—Das PDF-Format (Portable Document Format) wird verwendet. `PNG32`—Das PNG-32-Format (32-Bit Portable Network Graphics) wird verwendet. `JPG`—Das JPG-Format (Joint Photographic Experts Group) wird verwendet. `GIF`—Das GIF-Format (Graphics Interchange Format) wird verwendet. `EPS`—Das EPS-Format (Encapsulated PostScript) wird verwendet. `SVG`—Das SVG-Format (Scalable Vector Graphics) wird verwendet. `SVGZ`—Das SVGZ-Format (Compressed Scalable Vector Graphics) wird verwendet. `AIX`—Das AIX-Format (Adobe Illustrator Exchange) wird verwendet. `TIFF`—Das TIFF-Format (Tag Image File Format) wird verwendet.	String
Layout_Templates_Folder (Optional)	Der vollständige Pfad zum Ordner mit den Layout- oder Berichtsseiten (.pagx-, `.rptx`- und `.rptt`-Dateien), die als Vorlagen verwendet werden sollen. Das Standardverzeichnis ist `<install_directory>\Resources\ArcToolBox\Templates\ExportWebMapTemplates`.	Folder
Layout_Template (Optional)	Der Name einer Vorlage aus der Liste oder das Schlüsselwort `MAP_ONLY`. Wenn `MAP_ONLY` verwendet oder eine leere Zeichenfolge übergeben wird, enthält die Ausgabekarte keine Seitenlayout-Elemente, wie zum Beispiel Titel, Legende oder Maßstabsleiste.	String
Layout_Item_ID (Optional)	Die Portal-ID (im JSON-Format) des Layout-Elements, das für Vorlagen verwendet werden soll. Verwenden Sie das Format: `{"id": "<portal-id>"}`. Wenn ein Wert angegeben wurde, hat dieser Parameter Vorrang vor dem Parameter `Layout_Template`.	String
Report_Template (Optional)	Der Name der Berichtsvorlage. Wenn dieser Parameterwert angegeben wurde, muss der Parameter `Format` auf `PDF` festgelegt werden. Wenn kein Wert angegeben wurde, enthält die Ausgabedatei keine Berichte.	String
Report_Item_ID (Optional)	Die Portal-ID (im JSON-Format) des Berichtelements, das für Vorlagen verwendet werden soll. Verwenden Sie das Format: `{"id": "<portal-id>"}`. Wenn ein Wert angegeben wurde, hat dieser Parameter Vorrang vor dem Parameter `Report_Template`.	String

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja