esri_webfeaturelayer_createBranch (AutoLISP)

为指定 web 要素图层创建 web 要素图层分支版本。

语法

(esri_webfeaturelayer_createBranch flname branchName branchInfo)

参数

包含以下参数：

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

相关标注	值类型	值描述
"DESCRIPTION"	string	（可选）分支版本的创建者提供的描述文本。 （64 个字符）
"ACCESS"	string	分支版本的访问级别。 选项包括：{“公共”、“私有”、“受保护”}

示例用法

尝试为 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.")

  无效值或其他一些连接错误。