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

摘要

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

使用情况

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

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

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

• 如果为输入项目参数指定了单个项目（例如 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; TIN Layer
输入项目类型 (可选)	指定将从任意输入工作空间添加至目录数据集的项目类型。 默认情况下，将添加所有受支持的项目类型。 BIM 文件—将添加 BIM 文件工作空间。 BIM 楼层平面图—将添加 BIM 文件楼层平面图。 CAD 数据集—将添加 CAD 工程图。 要素类—将添加要素类。 要素服务—将添加要素服务。 影像服务—将添加影像服务。 LAS 数据集—将添加 LAS 数据集。 LAS 文件—将添加 LAS 文件。 图层文件—将添加图层文件。 地图服务—将添加地图服务。 镶嵌数据集—将添加镶嵌数据集。 栅格图层—将添加栅格数据集。 场景图层包—将添加场景图层包。 TIN 数据集—将添加 TIN 数据集。	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; TIN Layer
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—将添加场景图层包。 TIN—将添加 TIN 数据集。	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")

环境

地理变换, 范围

特殊情况

范围

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