Erstellt eine Web-Feature-Layer-Verzweigungsversion für den angegebenen Web-Feature-Layer.
Syntax
(esri_webfeaturelayer_createBranch flname branchInfo)
Argumente
Die folgenden Argumente sind wie folgt enthalten:
- flname | Zeichenfolge | erforderlich | Ein vorhandener Web-Feature-Layer-Name in der Zeichnung.
- branchName | Zeichenfolge | erforderlich | Ein Name, der für die neue Verzweigungsversion verwendet werden soll.
- branchInfo | Assoziationsliste | erforderlich | Verzweigungsversionsinformationen, die auf den Web-Feature-Layer flname als Assoziationsliste von Paarlisten wie unten beschrieben angewendet wird:
| Assoziierte Bezeichnung | Wertetyp | Wertbeschreibung |
|---|---|---|
| "DESCRIPTION" | string | (Optional) Von dem Ersteller der Verzweigungsversion bereitgestellter Beschreibungstext. (64 Zeichen) |
| "ACCESS" | string | Die Zugriffsebene der Verzweigungsversion. Optionen sind unter anderem: {"Public", "Private", "Protected"} |
Beispiel für die Verwendung
Versuchen Sie, eine neue Verzweigungsversion mit der Bezeichnung SouthwestProposal für den Web-Feature-Layer Damage_to_Commercial_Buildings zu erstellen.(esri_webfeaturelayer_createBranch "Damage_to_Commercial_Buildings" "SouthwestProposal"
(list
(cons "DESCRIPTION" "proposed changes")
(cons "ACCESS" "Public")
)
)
Ergebnis des Beispiels für die Verwendung
Erstellt eine neue Verzweigungsversion mit der Bezeichnung SouthwestProposal für den Web-Feature-Layer Damage_to_Commercial_Buildings und gibt Folgendes zurück:
("SouthwestProposal")Rückgabewerte
- Wenn der Vorgang erfolgreich war, gibt die Funktion eine Liste mit dem Verzweigungsversionsnamen als Zeichenfolge zurück.
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert "Error" sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ( "Error" . "<message>"))
Rückgabewerte mit Fehlern
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "Missing required argument."))
Das erforderliche Argument wurde nicht angegeben.
- (nil ("Error" . "Service error encountered"))
Wird zurückgegeben, wenn ein Problem mit der Verbindung zum Web-Service besteht.
- (nil ("Error" . "Layer does not support branch versions")
Layer unterstützt keine Verzweigungsversionen.
- (nil ("Error" . "Unable to retrieve properties from the branch version")
Ungültige Werte oder ein anderer Verbindungsfehler.