Help

Check Out File As File

Краткая информация

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)::Имя файла (Solution Name::Product Class Name::Series Name::Product Name::Instance Name::AOI Name::File Name).

  • Для определения пути к библиотеке продуктов, перейдите к элементу в окне Библиотеки продуктов, щелкните его правой кнопкой мыши и выберите Копировать как путь. Путь к библиотеке продуктов будет помещен в буфер обмена. Вы можете вставить его в любой параметр, который требует указания пути к библиотеке продуктов.

  • При проверке локальная копия файла создается в расположении, указанном в параметре Путь проверки. Путь проверки должен указывать на папку.

Синтаксис

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
(Дополнительный)

Указывает, заменяется ли локальная копия файла при откреплении, если файл уже существует.

  • DO_NOT_OVERWRITE —Не заменять существующую локальную копию файла. Это значение используется по умолчанию.
  • OVERWRITE —Заменять существующую локальную копию файла.
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."

Параметры среды

Информация о лицензиях

  • ArcGIS Desktop Basic: Нет
  • ArcGIS Desktop Standard: Требует Production Mapping
  • ArcGIS Desktop Advanced: Требует Production Mapping

Связанные разделы