im extractattachments
saves one or more attachments from a PTC RV&S issue
Synopsis
im extractattachments [--issue=value] [--field=field] [--asOf=[<date>|label:<label>] [--outputFile=value] [--[no|confirm]overwriteExisting] [--hostname=value] [--port=value] [--password=value] [--user=value] [(-?|--usage)] [(-g|--gui)] [(-F value|--selectionFile=value)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]] file...
Description
im extractattachments
saves one or more attachments from a PTC RV&S issue for later viewing or printing.
Options
This command takes the universal options available to im commands, as well as some general options. See the options reference page for descriptions.
• --asOf=[<date>|label:<label>]
allows you to extract attachments as of a historical date or label. For example, to extract an attachment on an issue as of a specific date, type
im extractattachments --asOf="January 8, 2007 10:00:00 AM EST" 123
If a value is not provided the attachment displays as of the server's current time. This field is optional.
• --issue=value
specifies the ID of the issue containing the attachment you want to save. This option is mandatory.
If document versioning is enabled, you can also specify versioned items. To type the ID of a versioned item, use the format Live Item ID-major.minor, for example, 184-1.2.
 |
If you are extracting an attachment from an historical item, the attachment is extracted based on the historical date and time.
|
• --outputFile=value
specifies the name of the file that the attachment is extracted to. If not specified, the name of the attachment is used as the output file.
• --field=field
specify the attachment field you want to extract from, for example, attachmenturl field=Attachments abc.txt. If not specified, the default attachment field is used.
• --[no|confirm]overwriteExisting=value
specifies whether to overwrite an existing file.
• file...
specifies the name of the attachment to save, for example, test_spec.htm. Use spaces to specify more than one file. If this option is not specified, all attachments are extracted.
|
|
If --cwd is not specified, the attachment is saved to the current working directory.
|
See Also
• Miscellaneous: options