描述
Checks out a file from a Product Library. This tool is similar to the Production Mapping Check Out File geoprocessing tool but returns a file instead of a string. Use this tool in ModelBuilder to chain the output file to another tool as an input parameter.
For example, in ModelBuilder, you can use this tool to check out an instance database .mdf file from a Product Library. The checked out .mdf file can be used as the MDF File Path input parameter in the Attach Database tool.
使用方法
检出操作会锁定文件。文件只能由一个人检出。
产品库工作空间必须是地理数据库。
该产品库路径为特殊“产品库”树节点的路径。此产品库路径为采用以下格式的双冒号分隔的字符串 (::):解决方案名称::产品类名称::系列名称::产品名称::实例名称::AOI 名称::文件名称。
要确定产品库路径,导航到产品库窗口中的项目,右键单击它,然后选择复制为路径。该产品库路径将被放置到剪贴板中。您可以将其粘贴到需要产品库路径的任何参数中。
检出操作在由检出路径所指定的位置处创建了一个文件的本地副本。检出路径必须是一个文件夹。
语法
arcpy.production.PLCheckOutFileAsFile(Product_Library_Workspace, Product_Library_Path, Check_Out_Path, {Overwrite_Existing_File}, {Workspace_Owner_Name})
参数 | 说明 | 数据类型 |
Product_Library_Workspace | 产品库工作空间的路径。 | Workspace |
Product_Library_Path | 项目的产品库路径。按照以下格式指定路径:解决方案名称::产品类名称::系列名称::产品名称::实例名称::AOI 名称::文件名称。 | String |
Check_Out_Path | 将包含已检出文件的文件夹。 | Folder |
Overwrite_Existing_File (可选) | 指示检出过程是否覆盖文件的本地副本(如果存在)。
| Boolean |
Workspace_Owner_Name (可选) | 产品库方案所有者名称。如果 Product_Library_Workspace 中指定的用户帐户不是方案所有者,请设置此参数。这仅适用于存储在企业级地理数据库中的产品库。 | String |
代码示例
PLCheckOutFileAsFile example (stand–alone script)
The following example demonstrates how to use the PLCheckOutFileAsFile tool.
# Name: CheckOutFile_Example.py
# Description: Checks out a file from a Product Library
# Requirements: Production Mapping extension
# import arcpy and checkout a Production Mapping license
import arcpy
arcpy.CheckOutExtension("foundation")
#Set local variables
product_library_workspace = "C:\\Data\\ProductLibrary.gdb"
product_library_itempath = "Products::Topographic Maps::QA_QC_carto_checklist.rtf"
checkout_location = "C:\\Data"
overwrite_flag = "OVERWRITE"
# create a production database
result = arcpy.PLCheckOutFileAsFile_production(product_library_workspace, product_library_itempath, checkout_location, overwrite_flag)
print result
print "Script completed successfully."
环境
许可信息
- Basic: 否
- Standard: 需要 Production Mapping
- Advanced: 需要 Production Mapping