esri_webfeaturelayer_createBranch (AutoLISP)

esri_webfeaturelayer_createBranch 函数可为指定 web 要素图层创建 web 要素图层分支版本。

语法

(esri_webfeaturelayer_createBranch flname branchName branchInfo)

参数

• flname | 字符串 | 必填 | 工程图中现有的 web 要素图层名称。
• branchName | 字符串 | 必填 | 将用于新分支版本的名称。
• branchInfo | 关联列表 | 必填 | 分支版本信息将作为点对的关联列表应用于 flname web 要素图层，如下所述：

相关标注	值类型	值描述	必填或可选
"DESCRIPTION"	string	由分支版本的创建者提供的描述文本（限 64 个字符）。	可选
"ACCESS"	string	分支版本的访问级别。 选项包含 "Public"、"Private" 和 "Protected"。	必填

示例用法

尝试为 Damage_to_Commercial_Buildings web 要素图层创建名为 SouthwestProposal 的新分支版本。

(esri_webfeaturelayer_createBranch "Damage_to_Commercial_Buildings" "SouthwestProposal" 
    (list
        (cons "DESCRIPTION" "proposed changes") 
        (cons "ACCESS" "Public")
    )
)

结果示例用法

为 Damage_to_Commercial_Buildings web 要素图层创建名为 SouthwestProposal 的新分支版本并返回分支名称：

("SouthwestProposal")

返回值

以下是可能的返回值：

• 如果成功，则该函数将返回一个列表，其中包含字符串形式的分支版本名称。
• 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后将返回一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息：(nil ( "Error" . "<message>"))。

失败的返回值

出于以下任一原因，可能出现失败的返回值：

• (nil ("Error" . "Missing required argument."))

  未提供必填参数。

• (nil ("Error" . "Service error encountered."))

  连接到 Web 服务时出现问题。

• (nil ("Error" . "Layer does not support branch versions.")

  指定图层不支持分支版本。

• (nil ("Error" . "Unable to retrieve properties from the branch version.")

  使用了无效值或发生了其他连接错误。

• (nil ("Error" . "No connected web feature layers found.")

  与 web 要素图层的网络连接丢失。

• (nil ("Error" . " Failed.")

  分支名称可能已存在。