From e024d4621685c2d319ba4abb627bf8d788fe2721 Mon Sep 17 00:00:00 2001 From: Adrian Velonis Date: Thu, 10 Aug 2023 06:45:19 -0500 Subject: [PATCH] PD-3637: revisions --- .../attributes/change-types/change-type-dbms.flsnp | 2 +- .../attributes/cli/cli-cmd-changeset-author.flsnp | 2 +- .../def/attributes/cli/cli-cmd-force-replace.flsnp | 2 +- .../def/attributes/cli/cli-cmd-set-as.flsnp | 2 +- .../text/command-set-contexts-set-labels.flsnp | 6 +++--- Project/ConditionTagSets/parameter-dbms.flcts | 13 +++++++++++++ 6 files changed, 20 insertions(+), 7 deletions(-) create mode 100644 Project/ConditionTagSets/parameter-dbms.flcts diff --git a/Content/Z_Resources/Snippets/def/attributes/change-types/change-type-dbms.flsnp b/Content/Z_Resources/Snippets/def/attributes/change-types/change-type-dbms.flsnp index 062314cc4..791f5cead 100644 --- a/Content/Z_Resources/Snippets/def/attributes/change-types/change-type-dbms.flsnp +++ b/Content/Z_Resources/Snippets/def/attributes/change-types/change-type-dbms.flsnp @@ -3,6 +3,6 @@ -

Specifies which database type(s) a is to be used for. See valid database type names on [%=General.Liquibase%] Database Tutorials. Separate multiple databases with commas. Specify that a is not applicable to a particular database type by prefixing with !. The keywords all and none are also available.

+

Specifies which database type(s) a is to be used for. See valid database type names on [%=General.Liquibase%] Database Tutorials. Separate multiple databases with commas. Specify that a is not applicable to a particular database type by prefixing with !. The keywords all and none are also available.

\ No newline at end of file diff --git a/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-changeset-author.flsnp b/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-changeset-author.flsnp index 11d356f0b..a0389abf1 100644 --- a/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-changeset-author.flsnp +++ b/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-changeset-author.flsnp @@ -3,6 +3,6 @@ -

The name of the author for the .

+

The name of the author for the . Supports * as a wildcard.

\ No newline at end of file diff --git a/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-force-replace.flsnp b/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-force-replace.flsnp index e12a20df6..8bd2d43f3 100644 --- a/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-force-replace.flsnp +++ b/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-force-replace.flsnp @@ -3,6 +3,6 @@ -

If true, replace any existing contexts/labels with the new ones rather than appending them to the list. Default: false.

+

If true, replace any existing contexts/labels with the new ones rather than appending them to the list. If you specify --force-replace without a value, sets it to true. Default: false.

\ No newline at end of file diff --git a/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-set-as.flsnp b/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-set-as.flsnp index 1ba882e29..a7b19c281 100644 --- a/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-set-as.flsnp +++ b/Content/Z_Resources/Snippets/def/attributes/cli/cli-cmd-set-as.flsnp @@ -3,6 +3,6 @@ -

Specifies the context(s)/label(s) to apply to the s you select. Case-insensitive. Separate multiple values with commas. If you use a space between multiple values, you must surround the entire string with quotes. Otherwise, quotes are optional. For example, --set-as=dev, --set-as="dev", --set-as=dev,test, --set-as="dev,test", and --set-as="dev, test" are all valid. User-supplied regular expressions are not supported, but you can use * to represent any value.

+

Specifies the context(s)/label(s) to apply to the s you select. Case-insensitive. Separate multiple values with commas (equivalent to OR) or the AND operator. If you use a space between multiple values, you must surround the entire string with quotes. Otherwise, quotes are optional. For example, --set-as=dev, --set-as=(\!dev and test) or qa, and --set-as="dev, test" are all valid. User-supplied regular expressions are not supported, but you can use * as a wildcard.

\ No newline at end of file diff --git a/Content/Z_Resources/Snippets/text/command-set-contexts-set-labels.flsnp b/Content/Z_Resources/Snippets/text/command-set-contexts-set-labels.flsnp index 61ef921b8..3dd2929c9 100644 --- a/Content/Z_Resources/Snippets/text/command-set-contexts-set-labels.flsnp +++ b/Content/Z_Resources/Snippets/text/command-set-contexts-set-labels.flsnp @@ -5,7 +5,7 @@

The set-contextsset-labels command set or replace contextslabels on your s using your command line. This is an alternative to setting contextslabels directly in your . You can use these contextslabels to specify which s to deploy in a later update.

-

The command works with any valid . You can choose which s to target by specifying a author, ID, path, or an existing context or label filter. It is available in 4.23.1+.

+

The command works with any SQL, XML, YAML, or JSON . It also works with s specified with the include or includeAll tags. You can choose which s to target by specifying a author, ID, path, or an existing context or label filter. set-contextsset-labels is available in 4.23.1+.

Uses

If you need to apply contextslabels to many s, manually inserting them into your is slow and can lead to errors. Instead, use set-contextsset-labels to quickly add or replace contextslabels in bulk.

By default, appends any contextslabels you specify with set-contextsset-labels to the list of contextslabels already on your s. However, if you set --force-replace to true, drops existing contextslabels before adding the new ones.

@@ -102,7 +102,7 @@ --dbms - + Optional @@ -185,7 +185,7 @@

When successful, the set-contextsset-labels command produces the following output:

* Changelog file 'changelog.xml' modified successfully.
 Liquibase command 'set-contexts' was executed successfully.
* Changelog file 'changelog.xml' modified successfully.
 Liquibase command 'set-labels' was executed successfully.
-

The output may also contain the following string when you specify the dbms argument:

Mismatched dbms for changeset 'createPrimaryTable::Liquibase Pro User::changelog.xml'
+

If you specify an invalid value for the dbms argument:

Mismatched dbms for changeset 'createPrimaryTable::Liquibase Pro User::changelog.xml'

When there is an ignored :

Ignoring changeset 'createSecondaryTable::Liquibase Pro User::changelog.xml'

When there is nothing to modify:

* Changelog file 'changelog.xml' was not modified.

Related links

diff --git a/Project/ConditionTagSets/parameter-dbms.flcts b/Project/ConditionTagSets/parameter-dbms.flcts new file mode 100644 index 000000000..da93dcba5 --- /dev/null +++ b/Project/ConditionTagSets/parameter-dbms.flcts @@ -0,0 +1,13 @@ + + + + + \ No newline at end of file