CLI Reference > Configuration Management Commands > si addmemberfromarchive
si addmemberfromarchive
adds a member from a server archive
si addmemberfromarchive [--archive=value] [--[no]createSubprojects] [--[no]defer] [--[no|confirm]includeFormers] [--include=file:pattern,dir:pattern...] [--exclude=file:pattern,dir:pattern...] [--cpid=ID|--changePackageId=ID] [--[no|confirm]closeCP] [--issueId=value] [--[no]failOnAmbiguousProject] [--devpath=value] [-P|--project=value] [-r|--revision=value] [-S|--sandbox=value] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-Ffile|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] nonmember...
si addmemberfromarchive adds members from server archives.
The si addmemberfromarchive command can be used for the following:
Add previously dropped members without requiring a Sandbox working file, while preserving the member history.
From the Sandbox directory, for example, and assuming the three specified members have just been mistakenly dropped, the following command will re-add them:
si addmemberfromarchive label.c button.c panel.c
Add a member that shares the history of another existing member, where the source member can be located in another project from the added member.
From the Sandbox directory, for example, the following command will add a member named largeLabel.c that shares the history with all members already linked to the specified archive location.
si addmemberfromarchive --archive=/anotherproject/label.c largeLabel.c
Note the following about the command:
can be deferred when performed from a Sandbox
may be part of change package review (displayed as pending members in the project)
supports multiple selection of archives using the wizard
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
a non-default archive location (the specified archive must exist on the server). To add several members with non-default archive locations in one operation, use the GUI wizard (si addmemberfromarchive -g ).
specifies the revision at which the member is to be added. This must be an existing revision in the archive. By default, the member is added at the latest revision on the main branch.
controls whether to create subprojects for each subdirectory encountered when adding members. This option is commonly used where you anticipate working with a large directory structure, because multiple subprojects are easier to manage than many subdirectories within one project. For example, specifying:
si addmemberfromarchive --createSubprojects --description="Button Application" \buttons\activebutton.c
creates a subproject for the \buttons directory and adds the file activebutton.c. Without the --createSubprojects option, the file and its path simply would be added to the project in the current directory.
controls whether to delay the add member from archive operation in the project until the deferred operation is submitted. The operation in the Sandbox still takes place immediately.
If the change package reviews are mandatory, specify the --defer option to create a pending entry for this operation at the time of change package submission. If the --defer option is not specified, Windchill RV&S creates the pending entry at the completion of this operation. When a deferred import member operation is submitted as part of a review, a pending member is created For more information, see the Windchill RV&S Help Center.
controls whether to include former members. Former members are members that have been dropped but whose working files still reside in the Sandbox directory.
specifies a file that contains a glob pattern for excluding members.
specifies a file that contains a glob pattern for including members.
closes the change package after command completion.
identifies non-members to add; use spaces to specify more than one non-member.
See the diagnostics reference page for possible exit status values.
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si add, si ci, si co, si cpissues, si createcp, si drop, si lock, si viewcps
Miscellaneous: ACL, diagnostics, options, preferences