Navigation:  Actions > Microsoft > SourceSafe >

SourceSafe Action Flags Tab

Previous pageReturn to chapter overviewNext page

This tab of the SourceSafe action configures flags that apply to the command.

 

Answer No to all prompts: The user cannot interactively respond to prompts issued by the VSS command-line tool (and this would interfere with automated builds anyway), so all prompts can automatically be answered with a No or Yes response, depending on whether this field is checked or not.

 

Make local files non-checked out files writeable: Normally when getting files that are not checked out, the files are marked as read-only as a reminder that the file should be checked out before modifying.  To override this behavior and make these files writeable when getting, check this field.

 

Handling of writeable local files: Determines how to treat local files that are different than the version in SourceSafe. Replace will overwrite the local file with the version from the database -- be careful with this option since it will also overwrite any writeable files that have been modified (including those that are checked out); the VSS command-line tool doesn't distinguish between checked out and non-checked out writeable files. Skip will skip any local writeable files, and not replace with the version from the database (the action will also fail in this case since the VSS command-line tool will return a non-zero exit code). Merge will attempt to merge changes between the local and database versions of the file when getting (not recommended).

 

Set date/time of local files: Specifies the timestamp place on files that are retrieved from the database. Current will give each file the current local computer's date/time; Modification will set the date/time to match the timestamp of the file version that is retrieved (recommended), and Checkin will set the date/time to the date/time when the file was checked into SourceSafe.

 

File comparison method: Determines the file comparison method that SourceSafe uses when comparing the database file with the local file to determine if it is different and needs to be retrieved from the database. Contents compares the actual contents of the files (can be very slow); Date/Time compares only the timestamps of the two files, and Checksum compares a (usually) unique file checksum (recommended).

 

Command output to display: Determines how much output to display.  The VSS command-line tool can be rather verbose when using the All setting (when retrieving files, it lists all matching projects and files, even ones that are up-to-date and don't need to be retrieved [files that are retrieved are prefixed with Getting in the output]), and the Errors only option may be preferred in such cases.

 

Show filenames only, no projects: When performing a Checkout operation, this option can be checked to prevent each matching project from being logged.

 

Show output but do not get files: This option applies to all operations except Label, and can be useful for debugging purposes.  It will display all files that would be retrieved without actually retrieving the files onto the local computer.

 

Treat exit code of 1 as successful: Some commands return an exit code of 1 to indicate a milder sort of failure:

Running a Dir command and no items are found.
Running a Status command and at least one item is checked out.
Running a Diff and at least one file is different.

 

Normally, the action will fail in these circumstances; to cause the step to succeed instead, check this option.