Webkarte exportieren (Server)

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-Repräsentation 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 for 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 ArcGIS Server-Hilfe.

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

Parameter

BeschriftungErläuterungDatentyp
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. Die ArcGIS API for JavaScript ermöglicht den Abruf dieser JSON-Zeichenfolge aus der Karte.

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.

  • 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.
Hinweis:

Der Hintergrund der Ausgabedatei ist immer undurchsichtig.

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 dieser Parameter nicht angegeben wurde, enthält die Ausgabedatei keine Berichte.

String
ID des Berichtselements
(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.management.ExportWebMap(Web_Map_as_JSON, Output_File, {Format}, {Layout_Templates_Folder}, {Layout_Template}, {Layout_Item_ID}, {Report_Template}, {Report_Item_ID})
NameErläuterungDatentyp
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. Die ArcGIS API for JavaScript ermöglicht den Abruf dieser JSON-Zeichenfolge aus der Karte.

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.

  • PNG8Das PNG-8-Format (8-Bit Portable Network Graphics) wird verwendet. Dies ist die Standardeinstellung.
  • PDFDas PDF-Format (Portable Document Format) wird verwendet.
  • PNG32Das PNG-32-Format (32-Bit Portable Network Graphics) wird verwendet.
  • JPGDas JPG-Format (Joint Photographic Experts Group) wird verwendet.
  • GIFDas GIF-Format (Graphics Interchange Format) wird verwendet.
  • EPSDas EPS-Format (Encapsulated PostScript) wird verwendet.
  • SVGDas SVG-Format (Scalable Vector Graphics) wird verwendet.
  • SVGZDas SVGZ-Format (Compressed Scalable Vector Graphics) wird verwendet.
  • AIXDas AIX-Format (Adobe Illustrator Exchange) wird verwendet.
  • TIFFDas TIFF-Format (Tag Image File Format) wird verwendet.
Hinweis:

Der Hintergrund der Ausgabedatei ist immer undurchsichtig.

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 dieser Parameter nicht 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.