im getdbfile
retrieves a workflow and document configuration file from the database
Synopsis
im getdbfile [--encoding=value] [--output=value] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-F file|--selectionFile=file)] string...
Description
im getdbfile retrieves a workflow and document configuration file from the database, such as a ViewSet or item presentation template (IPT). Although PTC recommends creating and editing ViewSets and IPTs in the GUI, you can retrieve ViewSets and IPTs from the database for manual editing. Once you are finished editing these files, you can store them in the database using the im putdbfile command.
|
|
Access to configuration files is based on permissions. An administrator with the AdminServer or DebugServer permission for workflows and documents can edit workflow and document configuration files, an administrator with the AdminServer or DebugServer permission for configuration management can edit configuration management files, and an administrator with the Windchill RV&S Server AdminServer or DebugServer permission can edit all configuration files.
|
Options
This command takes the universal options available to all
im commands, as well as some general options. See the
options reference page for descriptions.
• --encoding=value
specifies the code set to save the file in, for example, en_US (English, United States) or ja_JP (Japanese, Japan).
• --output=value
specifies the name of the file to store the output to on the local file system.
• string...
specifies the path and name of the file in the database. To display a list of files in the database, type im diag --diag=listdbfiles. For example, a valid file could be data\im\issue\templates\defect.xml, which is the IPT for the Defect type. For each IPT in Windchill RV&S, there is an XML file under data\im\issue\templates\templatename.xml, for example, im getdbfile --output=c:/defect.xml data/im/issue/templates/defect.xml.
Diagnostics
See the
diagnostics reference page for possible exit status values.
See Also
