Add metadata to a changeset

The DNAChangeset (dnachangeset) command line tool allows you to add a field with text to an existing changeset.

Note: Metadata can be added or appended to open changesets only. You must have write privileges to the changeset you want to add metadata to or an error will be displayed.

To add metadata to a changeset

1. On the desktop, double-click the Windows PowerShell for DNA shortcut.

   Windows PowerShell for DNA opens.

2. Execute the following commands:

   set-silo RealTime

   dnachangeset metadata --type <type> --changeset <changeset id> --add <value text> [--name <element name>]

   Where:

   • --type <type> is mandatory for each command and describes a valid changeset type (for example, –-type display).

     Note: A combination of changesets can be packaged together in the same package file. Currently, only RealTime database (RTDB) (realtime) and display type changesets are supported by the DNAChangeset tool.

   • --changeset <changeset id> is the identification number of the changeset to which the metadata will be added (for example, an input of 3 would assign the metadata to changeset 3).

   • --add <value text> is the text to be added to the provided metadata element (for example, –-add "My changeset comment").

     Note: If the changeset already contains a metadata element, the text is appended to a list of any pre-existing text.

   • --name <element name> is the name of the metadata element to store text under (for example, –-name "release notes").

     Note: If the name is not provided, the text will be stored under a default metadata element named comments.