此函数基于一个或多个指定的有效文档要素图层创建托管要素图层。 指定文档要素图层定义和要素将从工程图中移除,在当前工程区域中生成的要素将添加至工程图的新 web 要素图层的相应 AutoCAD 图层上。 以下是用法要求和行为:
- 用户必须登录指定组织并具有有权创建或发布数据的用户角色。
- 将根据指定文档要素图层创建包含一个或多个要素图层的单个托管要素图层项目。
- 如果成功,则每个文档要素图层将替换为基于新托管要素图层的 web 要素图层。
- 与所有 web 要素图层一样,将在工程图会话中重新绘制当前工程区域中包含的要素实体。
- 生成的要素几何仅具有托管要素图层的功能,这可能更改几何,例如细化曲线。
- 如果您尚未登录到组织,则系统将提示您输入用户名和密码。
语法
(esri_featurelayer_share sname flnames url [host_settings])
参数
- sname | 字符串 | 必填 | 新托管要素图层名称。 此名称将截短为 90 个字符。
- flnames | 字符串 | 必填 | 要共享的文档要素图层名称的逗号分隔字符串。
- url | 字符串 | 必填 | 将在其中创建托管要素图层项目的 ArcGIS Online 或 ArcGIS Enterprise 组织的 URL。
- host_settings | 关联列表 | 可选 | 点对形式的可选设置列表,用于限制字段和返回相应默认值。
相关标注 值类型 值描述 必填/可选 "Description" string
正在创建的新托管要素图层的描述。
可选
"TAGS" string
包含新要素图层的描述性标签逗号分隔列表的单一字符串。
可选
"Folder" string
将在其中创建新托管要素图层的文件名的名称。
可选
"ShareWithEveryone" 布尔
指定是否与所有人共享新托管要素图层的 true T 或 false nil 值。
可选
"ShareWithOrg" 布尔
指定是否与组织成员共享新要素图层的 true T 或 false nil 值。
可选
"DisableEditorTracking" 布尔
指定是否将在新要素图层上禁用编辑者追踪的 true T 或 false nil 值。
可选
"DefaultZ" 双精度
不支持编辑 z 值的编辑应用程序中新要素的默认 z 值。 在不支持编辑 z 值的 ArcGIS for AutoCAD 中进行编辑时,不会应该该值。
可选
"GroupsToShareWith" string
包含要与之共享的组织群组名称逗号分隔列表的单一字符串。
可选
示例用法
尝试在名为 New Construction 的新托管要素图层项目中将 Sample_Points 和 Service_Lines 文档要素图层共享为托管要素图层:
(esri_featurelayer_share "New_Construction" "Sample_Points,Service_Lines" "https://www.arcgis.com"
(list
(cons "Tags" "tag1,tag2")
(cons "Description" "Owner")
(cons "Folder" "String")
(cons "ShareWithEveryone" nil)
(cons "ShareWithOrg" T)
(cons "DisableEditorTracking" nil)
(cons "DefaultZ" 0)
(cons "GroupsToShareWith" "group1,group2")
)
)
结果示例用法
在名为 New Construction 的新托管要素图层项目中将 Sample_Points 和 Service_Lines 文档要素图层共享为托管要素图层。 将向命令行报告一系列状态消息。 向工程图添加 web 要素图层,并在工程区域内重新绘制实体,并且该函数返回一个 true 列表:
(T)
返回值
以下是可能的返回值:
- 如果成功,则该函数将返回一个 true 列表:(T)
- 如果失败,则该函数将返回一个列表,其中第一个值为 nil,然后是一个包含键值 "Error" 的关联列表以及字符串形式的关联错误消息:(nil ("Error" . "<message>"))。
失败的返回值
出于以下任一原因,可能出现失败的返回值:
- (nil ("Error" . "Document feature layer not found."))
指定的要素图层值不是工程图中的有效要素图层。
- (nil ("Error" . "Invalid URL"))
提供的 URL 无效。
- (nil ("Error" . "Missing required argument."))
未提供其中一个必填参数。
- (nil ("Error" . "Only unique feature layers can be specified."))
同一文档要素图层包含多次。
- (nil ("Error" . "User does not have the sufficient capabilities to share as a Web Feature Layer."))
没有足够的权限。 组织帐户需要至少为发布者角色。
- (nil ("Error" . "Service name is invalid or already exists."))
提供的服务名称无效或已存在。
- (nil ("Error" . "Incorrect user name or password."))
确认可通过 web 访问 ArcGIS Online 或 ArcGIS Enterprise 的 URL。
- (nil ("Error" . "An error occured"))
在连接和发布中检测到各种可能的问题。
- (nil ("Error" . "No coordinate system set"))
必须为工程图分配坐标系。
- (nil ("Error" . "One or more layers were not shareable."))
指定的一个或多个图层无法共享。 例如,如果它们不是注记或多面体,则实体无法打开(已锁定 AutoCAD 图层)。