此函数用于更改指定 web 要素图层的分支版本。 如果已发布服务设置为只读,或者如果在添加分支版本时,无法对其进行编辑,则分支版本可能会在 Esri Contents 用户界面中显示为锁定。 如果未专门指定为只读图层,则可以在 Esri 内容用户界面的快捷菜单中将分支版本图层切换到解锁编辑状态,但是要同步更改,将需要具有相应凭据的用户进行登录。
语法
(esri_webfeaturelayer_changeBranch flname branchName)
参数
包含以下参数:
- flname | 字符串 | 必填 | 工程图中现有的 web 要素图层名称。
- branchName | 字符串 | 必填 | 要用于当前分支版本的现有分支名称。
示例用法
尝试将 landowners 图层的分支版本更改为 editor01.phase1 分支版本。
(esri_webfeaturelayer_changeBranch "landowners" "editor01.phase1")
结果示例用法
将 landowners 图层的当前分支版本更改为 editor01.phase1 分支版本,并返回一个 true 列表:
(T)
返回值
- 如果成功,则该函数将返回一个 true 列表:(T)。
- 如果失败,则该函数将返回一个列表,其中第一个值为 nil,然后是一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息:(nil ( "Error" . "<message>"))
失败的返回值
出于以下任一原因,可能出现失败的返回值:
- (nil ("Error" . "Missing required argument."))
未提供必填参数。
- (nil ("Error" . "Branch version not found."))
未找到分支版本名称。
- (nil ("Error" . "Layer does not support branch versions")
图层不支持分支版本。
- (nil ("Error" . "No connected web feature layers found."))
未找到连接的 Web 要素图层。