ccollab admin batch

Applies to Collaborator 14.5, last modified on April 09, 2024

Description

Use the ccollab admin batch command to process multiple commands with one connection.

Command Line Syntax

ccollab [global-options] admin batch <commands-file> [--continue-on-failure]

Command Options

Option

Required?

Description

<commands-file>

Yes

File containing commands in XML format, or "-" to read from STDIN

--continue-on-failure

No

Whether to continue processing other commands if an error happens during command execution.

Remarks

  • Running multiple commands in batch form ensures that the 'last' review and defect variables stay consistent, even if there are multiple concurrent invocations of the client. It is also easier to encode non-ASCII characters in XML.
  • Global Options specified in the XML override the current Global Options.
  • Command options should be given without the leading double-dash. Both option and argument values are given as text values inside elements. For option and argument elements that can accept multiple values, specify a new element for each value.
  • Run ccollab help batch-xml for the full XML Schema accepted by this command. See full XML Schema (CTRL + click, or CMD + click to open in new window).

Example XML file

<batch-commands>

    <global-options>

        <no-browser/>

        <non-interactive/>

    </global-options>

    <addchanges>

        <upload-comment>These are my latest changes!</upload-comment>

        <review>new</review>

        <file-spec>.</file-spec>

    </addchanges>

    <addfiles>

        <review>last</review>

        <file-path>checklist.txt</file-path>

        <file-path>foo/bar.java</file-path>

        <file-path>biz/buzz.java</file-path>

    </addfiles>

    <browse>

        <review>last</review>

    </browse>

</batch-commands>

See Also

ccollab

Highlight search results