ArcMap

Check Out File As File

Résumé

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.

Utilisation

  • L'extraction verrouille le fichier. Un fichier peut être extrait uniquement par une personne.

  • L'espace de travail de la bibliothèque de produits doit être une géodatabase.

  • Product Library Path (Chemin d’accès à la bibliothèque de produits) est le chemin qui permet d’accéder au nœud de l’arborescence de la bibliothèque de produits en question. Un chemin d'accès à la bibliothèque de produit est une chaîne délimitée par deux symboles deux points, (::) dans ce format : Nom de la solution::Nom de la classe de produit::Nom de la série::Nom du produit::Nom de l'instance::Nom AOI::Nom de fichier.

  • Pour identifier un chemin d'accès à la bibliothèque de produits, accédez à un élément dans la fenêtre Bibliothèque de produits, cliquez avec le bouton droit et sélectionnez Copier en tant que chemin. Le chemin d'accès à la bibliothèque de produits est placé dans le Presse-papiers. Vous pouvez le coller dans n'importe quel paramètre nécessitant un chemin d'accès à la bibliothèque de produits.

  • L'extraction crée une copie locale du fichier à l'emplacement indiqué par Chemin d'extraction. Chemin d'extraction doit être un dossier.

Syntaxe

arcpy.production.PLCheckOutFileAsFile(Product_Library_Workspace, Product_Library_Path, Check_Out_Path, {Overwrite_Existing_File}, {Workspace_Owner_Name})
ParamètreExplicationType de données
Product_Library_Workspace

Chemin d'accès à l'espace de travail de la bibliothèque de produits.

Workspace
Product_Library_Path

Le chemin d'accès à la bibliothèque de produits de l'élément. Cela est exprimé ainsi Nom de la solution::Nom de la classe de produit::Nom de la série::Nom du produit::Nom de l'instance::Nom AOI::Nom de fichier.

String
Check_Out_Path

Dossier destiné à contenir le fichier extrait.

Folder
Overwrite_Existing_File
(Facultatif)

Indique si le processus d'extraction remplace une copie locale du fichier si elle existe.

  • DO_NOT_OVERWRITE —Ne pas remplacer une copie locale existante du fichier. Il s’agit de l’option par défaut.
  • OVERWRITE —Remplacer une copie locale existante du fichier.
Boolean
Workspace_Owner_Name
(Facultatif)

Nom du propriétaire de la structure de la bibliothèque de produits. Définissez ce paramètre si le compte utilisateur spécifié dans Product_Library_Workspace n’est pas le propriétaire de la structure. Ceci s'applique uniquement aux bibliothèques de produits stockées dans les géodatabases d'entreprise.

String

Exemple de code

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."

Environnements

Informations de licence

  • Basic: Non
  • Standard: Requiert Production Mapping
  • Advanced: Requiert Production Mapping

Rubriques connexes