How to handle special characters

If you pass a command to a command-line tool, such as ARIS Cloud Controller, special characters used in names, passwords, or user names may cause issues.

When passing commands directly as a command line parameter, you must be careful when escaping strings in your command, for example, double-quote-delimited parameters. The operating system command shell will consume the double quotes, leaving your string parameter un-escaped. So please escape the quote characters and special characters.

Examples

If you issue the command in command mode, for example:

set remote.repository.url="http://something.com/repo"

You must enter:

acc.bat -h localhost -u <user name> -pwd <remoteAccessPassword> set remote.repository.url=\"http://something.com/repo\"

If you enter:

acc.bat -h localhost -u <user name> -pwd <remoteAccessPassword> set remote.repository.url="http://something.com/repo"

ACC will return an error message, for example:

line 1:52 mismatched character '<EOF>' expecting '\n'

Invalid or erroneous command "set remote.repository.url=http://something.com/repo ": line 1:30 extraneous input ':' expecting EOF

Use "help" to display a list of available commands.

This also affects passwords and names containing special characters. If you try to back up your tenants using the following command, make sure to escape the quote characters and the special character & used in the password User&12345.

If your username or password includes any special character, add a backslash (\) before the character for ACC to process the special character as a string. That is, if there is an ampersand (&), in your password, add a backslash before the ampersand.

./acc.bat -h localhost -u Clous -pwd g3h31m -p 18011 -c ../generated.apptypes.cfg backup tenant default username=\"admin\" password=\"User\&12345\"