Die Funktion esri_webfeaturelayer_changeBranch ändert die Verzweigungsversion für den angegebenen Web-Feature-Layer. Verzweigungsversionen können in der Bedienoberflä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 Bedienoberfläche Esri Inhalte auf den Bearbeitungszustand "Entsperrt" umgeschaltet werden. Dafür muss jedoch ein Benutzer mit den geeigneten Anmeldeinformationen angemeldet sein, um die Änderungen zu synchronisieren.
Syntax
(esri_webfeaturelayer_changeBranch flname branchName)
Argumente
Die folgenden Argumente sind 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
Ändern der Verzweigungsversion des Layers landowners in die Verzweigungsversion editor01.phase1.(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
Folgende Werte sind mögliche 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. Zudem 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")
Der Layer unterstützt keine Verzweigungsversionen.
- (nil ("Error" . "No connected web feature layers found."))
Es wurden keine verbundenen Web-Feature-Layer gefunden.
Weitere Informationen
(esri_webfeaturelayer_branchInfo): Ruft die Versionsinformationen der Verzweigung des Web-Feature-Layers für den angegebenen Web-Feature-Layer als Assoziationsliste ab.
(esri_webfeaturelayer_createBranch): Erstellt eine Web-Feature-Layer-Verzweigungsversion für den angegebenen Web-Feature-Layer.
(esri_webfeaturelayer_branchNames): Ruft eine Liste von Verzweigungsversionsnamen von dem Server ab.
(esri_webfeaturelayer_deleteBranch): Löscht eine Verzweigungsversion aus dem angegebenen Web-Feature-Layer.
(esri_webfeaturelayer_createBranch): Erstellt eine Web-Feature-Layer-Verzweigungsversion für den angegebenen Web-Feature-Layer.