Verwenden verfügbarer WMS-Service-Eigenschaften

In diesem Thema werden die verfügbaren Eigenschaften erläutert, wenn Sie für WMS-Services eine vom System generierte Capabilities-Datei verwenden.

Aufrufen der WMS-Service-Eigenschaften in Manager

Sie können die Eigenschaften eines WMS-Service in ArcGIS Server Manager ausfüllen oder ändern. Führen Sie hierzu die folgenden Schritte aus:

1. Öffnen Sie Manager, und melden Sie sich an. Falls Sie Hilfe zu diesem Schritt benötigen, finden Sie weitere Informationen unter Anmelden bei Manager.
2. Klicken Sie auf Services > Services verwalten.
3. Suchen Sie den Service im Modul Services verwalten, und klicken Sie auf Bearbeiten. Wenn der Service nicht in der Liste angezeigt wird, befindet er sich möglicherweise in einem Unterordner des Ordners Site (Stammverzeichnis).
4. Klicken Sie im Modul Bearbeiten auf Funktionen.
5. Klicken Sie in der Liste der Funktionen auf WMS, und stellen Sie sicher, dass WMS ausgewählt ist.
6. Wählen Sie in der Liste WMS-Konfiguration die Option Service-Eigenschaften unten eingeben aus.
7. Übernehmen Sie die WMS-Service-Eigenschaften, oder ändern Sie sie.
8. Klicken Sie auf Speichern und neu starten. Die Änderungen am Service werden sofort übernommen.

WMS-Service-Eigenschaften

In der folgenden Tabelle werden die für WMS-Services verfügbaren Eigenschaften aufgeführt und beschrieben:

Eigenschaft	Beschreibung
Name	Der Typ des OGC-Service. Diese Eigenschaft wird automatisch von ArcGIS Server aufgefüllt und sollte nicht geändert werden.
Titel	Der Name des Karten- oder Bild-Service, der zur Erstellung des WMS-Service verwendet wurde. Diese Eigenschaft wird automatisch von ArcGIS Server aufgefüllt und sollte nicht geändert werden.
Kurzfassung	Eine Beschreibung mit zusätzlichen Informationen zum WMS-Service. Beispiel: WMS service maintained by Acme Corporation. Contact: [e-mail]. High-quality map showing eagle nests and possible nesting locations.
Schlagwörter	Eine Liste mit Schlüsselwörtern oder Ausdrücken, die den WMS-Service beschreiben und die Katalogsuche erleichtern. Beispiel: map, bird, eagle, nest, site
Online-Ressource	Die OnlineResource-Eigenschaft gibt die URL des WMS-Service an. Das Feld ist erforderlich, damit ein WMS-Client ordnungsgemäß mit dem WMS-Service kommuniziert. Diese Eigenschaft wird automatisch von ArcGIS Server aufgefüllt und sollte nicht geändert werden.
Kontaktperson	Die primäre Kontaktperson für den WMS-Service. Beispiel: John Smith
Kontaktposition	Die Position der Kontaktperson für den WMS-Service. Beispiel: IT Analyst
Kontaktorganisation	Die Organisation, von der der WMS-Service erstellt wurde. Beispiel: NASA
Adresstyp	Der Adresstyp, der von der Organisation verwendet wird, von der der WMS-Service erstellt wurde. Beispiel: postal
Adresse	Die Adresse der Organisation, von der der WMS-Service erstellt wurde. Beispiel: 380 New York Street
City	Der Ort, in dem sich die Organisation befindet, von der der WMS-Service erstellt wurde. Beispiel: Redlands
StateorProvince	Das Bundesland, in dem sich die Organisation befindet, von der der WMS-Service erstellt wurde. Beispiel: California
Postleitzahl	Die Postleitzahl der Organisation, von der der WMS-Service erstellt wurde. Beispiel: 92373
Land	Das Land, in dem sich die Organisation befindet, von der der WMS-Service erstellt wurde. Beispiel: USA
Kontakt-Telefonnummer	Die Telefonnummer, unter der die primäre Kontaktperson für den WMS-Service erreicht werden kann. Beispiel: [phone]
Kontakt-Faxnummer	Die Faxnummer, unter der die primäre Kontaktperson für den WMS-Service erreicht werden kann. Beispiel: [phone]
Kontakt-E-Mail-Adresse	Die E-Mail-Adresse, unter der die primäre Kontaktperson für den WMS-Service erreicht werden kann. Beispiel: [e-mail]
Kosten	Text, der die Gebühren für den Zugriff auf den WMS-Service angibt. Beispiel: none
Zugriffsbeschränkungen	Text, in dem die Einschränkungen und rechtlichen Voraussetzungen für den Zugriff auf den und das Verwenden des WMS-Service beschrieben werden. For internal use only. Do not distribute.
SLD-Pfad oder -URL	Mit SLDs können Sie mehrere Styles für jeden WMS-Layer veröffentlichen. Wenn Sie eine SLD-Datei an den aktuellen WMS-Service binden, müssen Sie als Eigenschaft für die URL oder den SLD-Pfad die URL, den UNC-Pfad oder den physischen Speicherort einer SLD-XML-Datei eingeben. Der Speicherort muss für das ArcGIS Server-Konto zugänglich sein, damit die SLD-XML-Datei vom ArcGIS Server ordnungsgemäß gelesen werden kann. Weitere Informationen zu SLDs finden Sie unter Verwenden von Styled-Layer-Deskriptoren mit WMS-Services.
Zusätzliche Raumbezugsysteme	Diese Eigenschaft kann zum Hinzufügen von Raumbezugssystemen zu WMS-Services verwendet werden. Standardmäßig verzeichnen WMS-Services nur zwei Raumbezugssysteme: EPSG:4326 (oder CSR:84 für WMS 1.3.0) und den Raumbezug des Kartenservice, auf dem WMS aktiviert ist. Um zusätzliche Raumbezugssysteme zu erfassen, trennen Sie die Raumbezugssysteme durch ein Komma (,). Beispiel: EPSG:4267,EPSG:4269,EPSG:102113. Der EPSG-Namespace (z. B. EPSG) und die EPSG-ID (z. B. 4267) müssen durch einen Doppelpunkt (:) getrennt angegeben werden oder der Raumbezug wird vom Server ignoriert.
Benutzerdefinierte Raumbezugssysteme	Die listCustomCRS-Eigenschaft ermöglicht die Definition einer benutzerdefinierten Projektion oder eines Well-Known Text (WKT)-Formats einer Projektion in einem WMS-Service. Dies bedeutet, dass Publisher und Anwender des WMS folgende Schritte ausführen können: Zuweisen von IDs zu benutzerdefinierten Projektionen und deren Bereitstellung über die WMS-Capabilities-Datei. Überschreiben einer vorhandenen Projektion mit einer WKT-Zeichenfolge. Anfordern einer Karte in einer bestimmten Projektion durch direkte Festlegung des Well-Known Texts.
Toleranz ermitteln (Pixel)	Mit dieser Eigenschaft können Sie eine Toleranz (in Pixel) definieren, in der die Operation GetFeatureInfo beim Klicken auf den Bildschirm Feature-Informationen an den Client zurückgibt. Wenn Sie beispielsweise eine Pixeltoleranz von 10 für WMS festlegen, werden die Informationen so lange an den Client zurückgegeben, wie innerhalb von 10 Pixeln eines Features auf dem Bildschirm geklickt wird.
Layer-Namen aus dem Kartendokument verwenden	Diese Option ist standardmäßig deaktiviert. Das bedeutet, dass die Layer im WMS-Service mit nullbasierten Ganzzahlwerten dargestellt werden, die ihre Position im Inhaltsverzeichnis (von oben nach unten) angeben. Ab Version 10.8 gibt es keine Beschränkungen hinsichtlich der Zeichen, die in einem Layer-Namen verwendet werden können, und der WMS-Server generiert bei Bedarf eine eindeutige Kennung für den Namen. Hinweis: Der vom Server zugewiesene Name wirkt sich nicht auf den Titel aus. Der WMS-Server weist einen eindeutigen Namen zu, wobei Zeichen (durch einen Unterstrich) ersetzt werden und ein numerisches Suffix hinzugefügt wird. Dies trifft in den folgenden Fällen zu: Eine Karte enthält mindestens zwei Layer mit demselben Namen. Ein Layer-Name beginnt mit einer Ziffer. Ein Layer-Name enthält Leerzeichen oder Sonderzeichen, unter anderem: ?,&,=,+,`,#,%,^,{},[],<>,,,|," Hinweis: Das Suffix ist ein berechneter Wert, der auf der Originalzeichenfolge basiert, also kein Zufallswert ist. Daher bleibt er unverändert, solange der Layer-Name nicht geändert wird. Wenn zum Beispiel zwei Layer mit den Namen Layer "1" und Layer [1] vorhanden sind, werden beide in Layer__1_ konvertiert. Um die beiden Layer zu unterscheiden, wird in einem solchen Fall der geänderten Zeichenfolge eine eindeutige Zahl als Suffix hinzugefügt. In diesem Beispiel würden die geänderten Layer-Namen Layer__1_1234 und Layer__1_1256 lauten.
Neuausrichtung der Karte basierend auf Breite und Höhe erzwingen	Diese Eigenschaft bestimmt, ob die Karte neu ausgerichtet wird. Diese Option ist standardmäßig deaktiviert. Das bedeutet, dass die Pixel, die den Kartenbereich darstellen, gestreckt werden, um in die von WMS-Clients angeforderte Höhe und Breite zu passen. Wenn diese Option aktiviert ist, bleibt das Höhen- und Breitenverhältnis der Pixel bestehen. Wenn eine Karte in voller Ausdehnung angefordert wird, füllt sie möglicherweise nicht den gesamten Anzeigebereich aus.
Zuweisen einer Namenskennung für einen Layer	Standardmäßig wird durch WMS-Services kein <Name> für Gruppen-Layer zugewiesen. Mit der Eigenschaft namedLayersMode können Sie steuern, auf welche Weise Layern in einem WMS-Service eine Namenskennung zugewiesen wird. Wird die Eigenschaft auf allLayers festgelegt, wird sowohl für Gruppen-Layer als auch für die entsprechenden Sublayer eine Namenskennung zugewiesen. Wird subLayers festgelegt oder die Eigenschaft nicht definiert, so wird eine Namenskennung nur für die Sublayer eines Gruppen-Layers zugewiesen. Das bedeutet, dass ein Gruppen-Layer von Clients nicht in eine GetMap-Anforderung einbezogen werden kann. Stattdessen müssen die einzelnen Sublayer innerhalb des Gruppen-Layers angegeben werden.

Festlegen von Eigenschaften im Administratorverzeichnis

Die meisten Eigenschaften können mit ArcGIS Server Manager konfiguriert werden. Kann eine Eigenschaft nicht mithilfe von Manager geändert werden, so kann sie unter Verwendung des ArcGIS Server-Administratorverzeichnisses geändert oder hinzugefügt werden.

Führen Sie die folgenden Schritte aus, um Eigenschaften über das Verzeichnis zu bearbeiten:

1. Öffnen Sie das Administratorverzeichnis in einem Browser, und melden Sie sich an. Die URL zu dem Verzeichnis lautet in der Regel https://gisserver.domain.com:6443/arcgis/admin/.
2. Klicken Sie auf Services.
3. Klicken Sie auf der Seite Ordner auf den Namen des WMS-fähigen Kartenservice, den Sie bearbeiten möchten. Wenn der Service nicht in der Liste angezeigt wird, befindet er sich möglicherweise in einem Unterordner des Stammordners.
4. Führen Sie auf der Seite des Service einen Bildlauf bis zum unteren Rand aus, und klicken Sie auf edit.
5. Suchen Sie im Dialogfeld Service-Eigenschaften den Abschnitt "typeName": "WMSServer".
6. Fügen Sie im Abschnitt properties die Eigenschaften hinzu, und geben Sie die gewünschten Parameter an. Beispiel:

   "properties": {
      "name": "SampleWorldCities",
      "title": "WMS",
      "abstract": "",
      "keyword": "",
      "onlineResource": "",
      "contactPerson": "",
      "contactPosition": "",
      "contactOrganization": "",
      "address": "",
      "addressType": "",
      "city": "",
      "stateOrProvince": "",
      "postCode": "",
      "country": "",
      "contactVoiceTelephone": "",
      "contactFacsimileTelephone": "",
      "contactElectronicMailAddress": "",
      "fees": "",
      "accessConstraints": "",
   
      "customGetCapabilities": "false",
      "pathToCustomGetCapabilitiesFiles": "",
   
      "pathToCustomSLDFile": "",
      "listSupportedCRS": "",
      "listCustomCRS": "",
      "identifyToleranceInPixel": "10",
      "inheritLayerNames": "false",
      "reaspect": "true",
      "namedLayersMode": "subLayers",
   }

7. Klicken Sie auf Änderungen speichern.

Die Eigenschaften werden Ihrem WMS hinzugefügt.

Sonderzeichen in Service-Eigenschaften

Die folgenden Zeichen dürfen in Service-Eigenschaften nicht enthalten sein: &, <, >, ", '. Wenn Sie eines dieser Zeichen verwenden müssen, müssen Sie die entsprechende Escapesequenz aus der folgenden Tabelle ersetzen:

Zeichen	Zeichenersatz
&	&
<	&lt;
>	&gt;
"	&quot;
'	&apos;

Verwenden von externen Capabilities-Dateien mit WMS-Services

Jeder WMS-Service macht Metadaten auf Service-Ebene durch seine Capabilities-Datei verfügbar. Die Capabilities-Datei ist die XML-Antwort, die Clients empfangen, wenn sie eine GetCapabilities-Anforderung an den Service übermitteln. Durch das Konfigurieren externer Capabilities-Dateien haben Sie folgende Möglichkeiten:

• Hinzufügen von Service-Metadaten
• Hinzufügen von Layer-Metadaten
• Anpassen der Legendeninformation für jeden Layer

Um externe Capabilities-Dateien mit WMS-Services zu verwenden, müssen Sie die Dateien erstellen und für die Verwendung mit Ihren WMS-Services konfigurieren. In den nachstehenden Abschnitten wird dieser Vorgang beschrieben.

Hinweis:

Bei der Verwendung externer Capabilities-Dateien für den WMS-Service sind Sie für das Überprüfen der Capabilities-Dateien in Bezug auf das DTD- oder XML-Schema von OGC zuständig. Sie sind auch für die gesamte Synchronisierung zwischen den Capabilities-Dateien und dem Quellkartendokument zuständig, über die der WMS-Service veröffentlicht wird.

Erstellen externer Capabilities-Dateien

Um einen WMS-Service zur Verwendung externer Capabilities-Dateien zu konfigurieren, müssen Sie mindestens eine WMS-Capabilities-Datei bereithalten. Sie können die Datei von Grund auf neu erstellen, aber es ist oft einfacher, eine vom System generierte Capabilities-Datei als Vorlage zu verwenden.

Standardmäßig werden die vom System generierten Capabilities-Dateien bei jedem Senden einer WMS-Anforderung GetCapabilities an den Service erstellt. Um eine vom System generierte Capabilities-Datei als Vorlage zu verwenden, müssen Sie die GetCapabilities-Anforderung manuell senden und die Antwort als XML speichern. Wenn der WMS-Service verschiedene Versionen des WMS-Protokolls unterstützen soll – z. B. 1.0.0, 1.1.0, 1.1.1 und 1.3.0 – muss jeweils eine Capabilities-Datei für jede WMS-Version vorhanden sein.

Führen Sie die folgenden Schritte aus, um externe Capabilities-Dateien für den WMS-Service zu erstellen:

1. Falls noch nicht geschehen, veröffentlichen Sie einen Karten- oder Image-Service und aktivieren die WMS-Funktion. Weitere Informationen finden Sie unter WMS-Services.
2. Geben Sie die URL des WMS-Service in einem Webbrowser ein. Die URL weist das folgende Format auf:

   https://gisserver.domain.com:6443/arcgis/services/folder/service/service type(can be MapServer or ImageServer)/WMSServer

3. Hängen Sie ?service=wms&request=GetCapabilities&version=1.0.0 an das Ende der Service-URL an, und drücken Sie die Eingabetaste. Bei der im Browser angezeigten XML handelt es sich um die WMS-Capabilities-Datei der Version 1.0.0 für Ihren Service.
4. Speichern Sie die Ergebnisse als .xml-Datei. Der Dateiname muss dem Format <Präfix><WMS-Version>.xml entsprechen. Wenn Sie beispielsweise die .xml-Ergebnisdatei einer GetCapabilities-Anforderung für WMS, Version 1.0.0, speichern, müssen Sie die Datei mit einem einheitlichen Präfix versehen (z. B. Roads), gefolgt von der dreistelligen WMS-Versionsnummer (100). Die resultierende Datei heißt Roads100.xml.
5. Wiederholen Sie die Schritte 3 und 4 für jede zu unterstützende WMS-Version, zum Beispiel 1.1.0, 1.1.1 oder 1.3.0.
6. Konfigurieren Sie die Metadateninformationen für die WMS-Layer in jeder Capabilities-Datei und passen Sie sie an.
7. Verschieben Sie alle Capabilities-Dateien in einen allgemeinen Ordner, auf den über eine HTTP zugegriffen werden kann. In der Regel ist das ein virtuelles Verzeichnis auf dem Webserver Ihrer Organisation.

Konfigurieren eines WMS-Service zur Verwendung externer Capabilities-Dateien in ArcGIS Server Manager

Um den WMS-Service für die Verwendung externer Capabilities-Dateien zu konfigurieren, müssen Sie den WMS-Service so aktualisieren, dass er die URL Ihrer Capabilities-Dateien in ArcGIS Server Manager referenziert.

1. Starten Sie ArcGIS Server Manager, und melden Sie sich als ArcGIS Server-Administrator an. Falls Sie Hilfe zu diesem Schritt benötigen, finden Sie weitere Informationen unter Anmelden bei ArcGIS Server Manager.
2. Klicken Sie auf Services > Services verwalten.
3. Suchen Sie den Service im Modul Services verwalten, und klicken Sie auf Bearbeiten. Wenn der Service nicht in der Liste angezeigt wird, befindet er sich möglicherweise in einem Unterordner des Ordners Site (Stammverzeichnis).
4. Klicken Sie im Modul Bearbeiten auf Funktionen.
5. Klicken Sie in der Liste der Funktionen auf WMS.
6. Wählen Sie in der Liste WMS-Konfiguration die Option Externe Capabilities-Dateien verwenden aus.
7. Geben Sie im Textfeld Speicherort und Präfix angeben die URL des Ordners mit den Capabilities-Dateien zusammen mit dem allgemeinen Präfix, den Sie für die Dateien verwendet haben, ein. Lautet die URL des Ordners, der Ihre Dateien enthält, beispielsweise https://webserver.domain.com/arcgis/WMS/services und Sie haben Roads als einheitliches Präfix verwendet, müssen Sie im Textfeld Speicherort und Präfix angeben die folgende URL eingeben: https://webserver.domain.com/arcgis/WMS/services/Roads.
8. Klicken Sie auf Speichern und neu starten.