Diese Funktion ändert die Verzweigungsversion für den angegebenen Web-Feature-Layer. Verzweigungsversionen können in der Benutzeroberfläche "Esri Inhalte" als gesperrt angezeigt werden, wenn der veröffentlichte Service als schreibgeschützt festgelegt ist oder wenn die Verzweigungsversion zu dem Zeitpunkt, an dem sie hinzugefügt wurde, nicht bearbeitet werden konnte. Wenn der Verzweigungsversions-Layer nicht ausdrücklich als schreibgeschützter Layer gekennzeichnet ist, kann er im Kontextmenü der Benutzeroberfläche "Esri Inhalte" auf den Bearbeitungszustand "Entsperrt" umgeschaltet werden. Dafür muss jedoch ein Benutzer mit den geeigneten Anmeldedaten angemeldet sein, um die Änderungen zu synchronisieren.
Syntax
(esri_webfeaturelayer_changeBranch flname branchName)
Argumente
Die folgenden Argumente sind wie folgt enthalten:
- flname | Zeichenfolge | erforderlich | Ein vorhandener Web-Feature-Layer-Name in der Zeichnung.
- branchName | Zeichenfolge | erforderlich | Ein vorhandener Verzweigungsname, der für die aktuelle Verzweigungsversion verwendet werden soll.
Beispiel für die Verwendung
Versucht, die Verzweigungsversion des Layers landowners in die Verzweigungsversion editor01.phase1 zu ändern.(esri_webfeaturelayer_changeBranch "landowners" "editor01.phase1")
Ergebnis des Beispiels für die Verwendung
Die aktuelle Verzweigungsversion des Layers landowners wird in die Verzweigungsversion editor01.phase1 geändert und gibt eine Liste mit "true" zurück:
(T)Rückgabewerte
- Bei erfolgreicher Ausführung gibt die Funktion eine Liste mit "true" zurück: (T).
- 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" . "Branch version not found."))
Der Name der Verzweigungsversion wurde nicht gefunden.
- (nil ("Error" . "Layer does not support branch versions")
Layer unterstützt keine Verzweigungsversionen.
- (nil ("Error" . "No connected web feature layers found."))
Keine verbundenen Web-Feature-Layer gefunden.