如何在Python中正确提取ArcPro地图系列页面名称并批量处理

核心问题：页面名称取值错误 #

你当前代码中ms.pageNameField.name获取的是字段的名称（含表名），而非当前页面对应的File_Name字段的实际值，这才导致每次创建的文件夹都是同一个名字（比如NameTextData.File_Name）。正确的做法是通过地图系列的pageRow属性获取当前页面对应的属性行，再提取目标字段的值。

修正后的完整脚本 #

import arcpy
import os

# 加载当前ArcGIS项目
aprx = arcpy.mp.ArcGISProject("CURRENT")
# 获取第一个布局（确保是带地图系列的布局）
layout = aprx.listLayouts()[0]
ms = layout.mapSeries
# 设置输出根路径（替换为你的实际路径）
output_root = r"C:\Your\Output\Root\Path"

# 遍历所有地图系列页面
for page_num in range(1, ms.pageCount + 1):
    ms.currentPageNumber = page_num
    # 获取当前页面对应的属性行，提取File_Name字段的实际值
    page_name = ms.pageRow.File_Name  # 兼容旧版本也可使用ms.pageRow.getValue("File_Name")
    
    # 构建当前页面的输出文件夹路径
    page_folder = os.path.join(output_root, page_name)
    
    # 检查文件夹是否存在，不存在则创建
    if not os.path.exists(page_folder):
        arcpy.CreateFolder_management(output_root, page_name)
    
    # 导出布局到对应文件夹（这里以PNG为例，可根据需求更换格式）
    export_path = os.path.join(page_folder, f"{page_name}.png")
    # 导出参数可按需调整（分辨率、是否仅导出地图框等）
    layout.exportToPNG(export_path, resolution=300)

print("批量导出完成！")

关键优化点说明 #

• 正确获取页面名称：使用ms.pageRow.File_Name直接读取当前页面关联属性表中File_Name字段的实际值，而非字段名。
• 路径统一管理：用output_root变量统一管理输出根路径，避免硬编码重复路径，提高可维护性。
• 文件夹存在性检查：添加os.path.exists(page_folder)判断，避免因文件夹已存在导致的创建错误。
• 灵活导出格式：示例中使用exportToPNG，你可根据需求替换为exportToPDF、exportToJPEG等ArcPy布局导出方法，调整对应参数即可。
• 命名规范：导出文件以页面名称命名，确保每个文件与文件夹对应，便于查找。

额外注意事项 #

• 确保地图系列的「页面名称字段」已正确设置为File_Name（可在ArcPro界面的地图系列设置中确认）。
• 如果File_Name字段存在特殊字符（如空格、斜杠等），建议先做清洗处理（比如替换为下划线），避免路径错误。
• 若导出数量较大，可考虑添加进度提示或异常捕获，提升脚本稳定性。

内容的提问来源于stack exchange，提问作者VoidJerk