...
| Info |
|---|
If you use single quotes in a terminal environment, text the variables in double quotes converts environment variable references are converted to their value but it does not convert single quoted text, if you use single quotes, the variables are not converted to their value. |
SOLUTION
Follow the examples in the Quotations-Usage table, to ensure that you use the correct quotations for the environment.
When required, adopt the special character parameter.
Quotation Usage Table
...
ENVIRONMENTS AND SPECIFIC CASES
...
ENVIRONMENTS AND SPECIFIC CASES | EXAMPLE |
|---|---|
Windows Command Terminal | Use embedded double quotes within a double-quoted string. “-a addComment --comment ““This is an example of a double quoted string inside a double quote”” “ |
LINUX and MAC/OS terminals | LINUX quotes are used. -common “ -a addComment --comment \ ”This is an example of a double quoted string \ ” ” |
RUN CLI Actions | Use the same syntax as on the Windows terminal “-a addComment --comment ““This is an example of a double quoted string inside a double quote”” “ |
Comma Separated Parameters | For parameters that allow entry of a comma separated list of values, the values that contain a comma must be enclosed in single quotes. Embedded single quotes within a quoted string must be doubled. --custom “ 'first:a,b,c' second: x” |
Run Scripts | Action in run scripts do not accept single quotes, hence use the same syntax as on the Windows terminal run: “-a addComment --comment ““This is an example of a double quoted string inside a double quote”” “ |
Text Fields | Text fields may support the automatic conversion of " \n " (blanks are significant) to be replaced with a new line character. --description "A multi-line text field: \n # line 1 \n # line 2" |
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Give the special parameter a specific substitute character. The substitute character is replaced with the real character after all other parsing occurs. --parameter abc, def#ghi To treat def and ghi as separate values, # must be replaced with a comma. |
The choice of what special characters to use depends on the content so that you do not have context to avoid conflicts with intended content.
...
Position | Character | Character name | Suggested alternative | Usage |
|---|---|---|---|---|
1 | , | comma |
| Some parameters use comma separated lists. |
2 | : | colon | # | Some parameters use colon separated values. |
3 | @ | at sign |
| Replacement variables syntax: @...@. |
4 | ' | single quote |
| Used in separated lists to cover cases where content contains separator. |
5 | " | double quote | ~ | Parameters containing blanks. |
6 | ^ | caret |
| Substitution double quote indicator: ^^...^^. See ACLI-673 for details. |
A blank in any position is ignored (no alternative provided).
...