CLI Reference > Server Administration Commands > integrity getdbfile
 
integrity getdbfile
retrieves a configuration file from the database
Synopsis
integrity 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
integrity getdbfile retrieves a 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 integrity 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 Integrity Lifecycle Manager Server AdminServer or DebugServer permission can edit all configuration files.
Options
This command takes the universal options available to all integrity 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 si diag --diag=listdbfiles or 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 Integrity Lifecycle Manager, there is an XML file under data\im\issue\templates\templatename.xml, for example, integrity getdbfile --outputfile=c:/defect.xml data/im/issue/templates/defect.xml.
Diagnostics
See the diagnostics reference page for possible exit status values.
See Also
Commands: integrity putdbfile
Miscellaneous: ACL, diagnostics, options, preferences