将项目添加至目录数据集 (数据管理)

摘要

用于将工作空间项目和图层（例如地理数据库数据集、栅格图层、要素图层、镶嵌图层和其他项目）添加到现有目录数据集。

使用情况

• 此工具将从本地或网络共享文件夹和工作空间添加项目。 要将活动门户中的门户项目添加到目录数据集，请使用将门户项目添加至目录数据集工具。

• 指定目标目录数据集后，可以应用过滤器以仅从由输入项目参数值指定的工作空间添加某些项目类型。

• 添加到目录数据集的项目必须为允许的项目类型。 当使用输入项目参数指定一个或多个工作空间时，将仅从该工作空间添加允许的项目类型。

• 如果为输入项目参数指定单个项目（例如 shapefile、.dwg 文件或要素类），则输入项目类型参数值将不会阻止将这些项目包含在数据集中。

• 要将项目添加到在 ArcGIS Pro 3.1 中创建的目录数据集中，必须使用升级数据集工具对数据集进行升级。

• 输入项参数支持地图服务 URL 作为输入。

• 无法将场景图层包单独指定为输入项目参数值，但如果其位于指定的文件夹或工作空间中，则可以将其添加到数据集。

• 已添加到目录数据集的项目必须具有范围。

• 要从目录数据集中删除一个或多个项目，请打开数据集的属性表并删除记录。

参数

对话框

标注	说明	数据类型
目标目录数据集	项目将添加到的目录数据集。	Catalog Layer
输入项目	将其中的项目添加到目录数据集的工作空间项目、图层和文件。 工作空间可以为文件夹、文件地理数据库、要素数据集、企业级数据库或来自服务器连接的服务。	Workspace; Feature Layer; Image Service; Raster Layer; Mosaic Layer; LAS Dataset Layer; Layer File; CAD Drawing Dataset; ServerConnection; BIM File Workspace
输入项目类型 (可选)	指定将从任何输入工作空间添加到目录数据集的项目类型。 将默认添加所有受支持的项目类型。 BIM 文件—将添加 BIM 文件工作空间。 BIM 楼层平面图—将添加 BIM 文件楼层平面图。 CAD 数据集—将添加 CAD 工程图。 要素类—将添加要素类。 要素服务—将添加要素服务。 影像服务—将添加影像服务。 LAS 数据集—将添加 LAS 数据集。 LAS 文件—将添加 LAS 文件。 图层文件—将添加图层文件。 地图服务—将添加地图服务。 镶嵌数据集—将添加镶嵌数据集。 栅格图层—将添加栅格数据集。 场景图层包—将添加场景图层包。	String
包括子文件夹 (可选)	指定是否将递归搜索在输入项目参数值中指定的文件夹或工作空间的内容并将其添加至目录数据集。 此参数不适用于文件地理数据库或企业级地理数据库。 选中 - 将递归搜索文件夹或工作空间的内容并将其添加至目录数据集。 这是默认设置。 未选中 - 将不会递归搜索文件夹或工作空间的内容并将其添加至目录数据集。	Boolean
覆盖区类型 (可选)	指定参考项目的覆盖区将为全图范围，还是代表所有要素最小凸多边形的凸包。 包络矩形—覆盖区将为覆盖参考项目全图范围的矩形。 这是默认设置。 凸包—覆盖区将为封闭来自参考项目的所有要素的凸包。	String

派生输出

标注	说明	数据类型
输出目录数据集	已更新的目录数据集。	Catalog Layer

Python

arcpy.management.AddItemsToCatalogDataset(target_catalog_dataset, input_items, {input_item_types}, {include_subfolders}, {footprint_type})

名称	说明	数据类型
target_catalog_dataset	项目将添加到的目录数据集。	Catalog Layer
input_items [input_items,...]	将其中的项目添加到目录数据集的工作空间项目、图层和文件。 工作空间可以为文件夹、文件地理数据库、要素数据集、企业级数据库或来自服务器连接的服务。	Workspace; Feature Layer; Image Service; Raster Layer; Mosaic Layer; LAS Dataset Layer; Layer File; CAD Drawing Dataset; ServerConnection; BIM File Workspace
input_item_types [input_item_types,...] (可选)	指定将从任何输入工作空间添加到目录数据集的项目类型。 将默认添加所有受支持的项目类型。 BIM_FILE_WORKSPACE—将添加 BIM 文件工作空间。 BIM_FILE_FLOORPLAN—将添加 BIM 文件楼层平面图。 CAD_DRAWING—将添加 CAD 工程图。 FEATURE_CLASS—将添加要素类。 FEATURE_SERVICE—将添加要素服务。 IMAGE_SERVICE—将添加影像服务。 LAS_DATASET—将添加 LAS 数据集。 LAS_FILE—将添加 LAS 文件。 LAYER_FILE—将添加图层文件。 MAP_SERVICE—将添加地图服务。 MOSAIC_DATASET—将添加镶嵌数据集。 RASTER_DATASET—将添加栅格数据集。 SCENE_LAYER_PACKAGE—将添加场景图层包。	String
include_subfolders (可选)	指定是否将递归搜索在 input_items 参数值中指定的文件夹或工作空间的内容并将其添加至目录数据集。 此设置不适用于文件地理数据库或企业级地理数据库。 INCLUDE_SUBFOLDERS—将递归搜索文件夹或工作空间的内容并将其添加至目录数据集。 这是默认设置。 NOT_INCLUDE_SUBFOLDERS—将不会递归搜索文件夹或工作空间的内容并将其添加至目录数据集。	Boolean
footprint_type (可选)	指定参考项目的覆盖区将为全图范围，还是代表所有要素最小凸多边形的凸包。 ENVELOPE—覆盖区将为覆盖参考项目全图范围的矩形。 这是默认设置。 CONVEX_HULL—覆盖区将为封闭来自参考项目的所有要素的凸包。	String

派生输出

名称	说明	数据类型
out_catalog_dataset	已更新的目录数据集。	Catalog Layer

代码示例

AddItemsToCatalogDataset 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 AddItemsToCatalogDataset 函数。

import arcpy
arcpy.env.workspace = "C:/Dataspace/WhereMyCatalogLayerIs.gdb"
arcpy.management.AddItemsToCatalogDataset("MyCatalogDataset", ["AllMyFeatures.gdb", "AllMyRasters.gdb"], 
                                        ["FEATURE_CLASS", "RASTER_DATASET"], "INCLUDE_SUBFOLDERS", "ENVELOPE")

环境

地理变换, 范围

特殊情况

范围

如果此环境设置为输入的交集或输入的并集选项，则将忽略此环境。