Get Local Copy (Production Mapping)
Summary
Gets a local copy of a file stored inside the Product Library. It allows you to view or edit a file without exclusively locking the file in a Product Library. Changes made to the local copy are not tracked in the Product Library.
A Product Library stores information and data required for cartographic and digital data production in a geodatabase. Esri Mapping and Charting solutions store business rules, documents, and spatial information inside a Product Library.
Usage
The Product Library Workspace must be a geodatabase.
The file must be contained within the Product Library.
The Copy Location must be a folder on the user’s local computer.
The Product Library Path to the Item is the path to the particular Product Library tree node. A product library path is a double colon-delimited string (::) in this format: Solution Name::Product Class Name::Series Name::Product Name::Instance Name::AOI Name::File Name.
Syntax
| Parameter | Explanation | Data Type |
product_library_workspace |
Path to the product library workspace. | Workspace |
product_library_itempath |
The path to the product library level that contains the files you want to view. This is specified as Solution Name::Product Class Name::Series Name::Product Name::Instance Name::AOI Name::File Name. | String |
copy_location |
The folder where the file will be copied to. Any existing local copies of the file will be overwritten. | Folder |
product_library_ownername (Optional) | Product Library schema owner name. Set this parameter if the user account specified in product_library_workspace is not the schema owner. This applies only to Product Libraries stored in enterprise geodatabases. | String |
Code Sample
The following stand-alone script demonstrates how to use the PLGetLocalCopy tool.
# Name: GetLocalCopy_Example.py
# Description: Creates a local, editable copy of a file in 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"
copy_location = "C:\\Data"
# create a production database
arcpy.PLGetLocalCopy_production(product_library_workspace, product_library_itempath, copy_location)
print "Script completed successfully."
# Check in the extension
arcpy.CheckInExtension("foundation")