pull

Pulls changes from Jira server to the local repository. This by default includes creation of new scenarios from unlinked test cases (create) and changing scenarios of linked test cases (change).

See more details about the command in the Pulling Test Case changes to local scenarios article.

Options

In addition the the options listed here, all common command line options can also be used.

Option	Description	Default
--tagFilter	A local test case condition of scenarios that should be included in the current synchronization (e.g. @current_sprint and @done). See Filters and scopes for details.	not filtered by tags
--sourceFileFilter	A local test case condition with source file predicates (glob patterns) of files that should be included in the current synchronization (e.g. Folder1/**/*.feature). See Filters and scopes for details.	not filtered by feature files
--createOnly	If specified, the command will create new scenarios for the unlinked Test Cases only and the existing scenarios will not be modified. This setting automatically enables the 'enableCreatingScenariosForNewTestCases' pull setting.	false
--force	If specified, SpecSync changes scenarios even if there is no remote change and the scenario was not modified locally.	false

The Creating new scenarios from Test Cases feature and the related --createOnly option is planned for a future version of SpecSync for Jira. Please check the Roadmap for details.

Examples

Pulls remote changes from Jira using the configured settings in the specsync.json configuration file:

dotnet specsync pull

Pulls remote changes using the specified Personal Access Token (PAT) for authentication:

dotnet specsync pull --user 52yny...........................nycsetda

Pulls remote changes related to the scenarios tagged with @ordering and @backend:

dotnet specsync pull --tagFilter "@ordering and @backend"

Pulls unlinked Test Cases to new scenarios but ignores changed Test Cases:

dotnet specsync pull --createOnly

Command line reference