Text File Action Pack (PCK.AUTOMIC_TEXT)
This action pack contains various actions to manipulate text.
TEXT ACTION PACK v1.2.1
The actions that are contained in this action pack are preinstalled with Automic Continuous Delivery Automation.
Supported Platforms and Prerequisites
For more information about supported platforms, see compatibility matrix
This pack includes the following actions:
Common PromptSets
PromptSet: PCK.ITPA_SHARED.PRV.PROMPTSET.OVERWRITE_AGENT
|
Name |
Type |
Description |
|---|---|---|
|
Overwrite Agent &AGENT# |
ComboElement
|
Overwrites the default agent. |
|
Overwrite Login &LOGIN# |
ComboElement
|
Overwrites the default login. |
Text Add Text Action
This action adds a line at a specific position in a file.
Additional Notes:
Rollback is enabled for this action.
Input Values|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file which is used. |
|
*Add text &UC4RB_TEXT_ADD_TEXT# |
TextElement |
Text to be added. |
|
Position for add &UC4RB_TEXT_ADD_POSITION# |
RadioGroupElement (after, before) |
The text is added before or after a certain position. |
|
Search text for position &UC4RB_TEXT_SEARCH# |
TextElement |
The text to find the position. If this parameter is empty, the text is added at the beginning or at the end of the text file. |
|
Search text is a regex &UC4RB_TEXT_SEARCH_AS_REGEX# |
RadioGroupElement (NO, YES) |
This parameter defines whether a regular expression is used to find the position or not. |
|
Search position filter &UC4RB_TEXT_SEARCH_FILTER# |
RadioGroupElement (ALL, FIRST, LAST) |
If the position of the &UC4RB_TEXT_SEARCH# is found more than once, then this parameter can be used. |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding that is used in case the actual encoding cannot be detected. |
|
New line characters &UC4RB_TEXT_NEW_LINE# |
TextElement |
New line string (for example: "\r\n") to be added. |
Text tabs to blanks Action
This action replaces blanks with tabs.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
One tab to a specific number of blanks &UC4RB_TEXT_NUMBER_BLANKS# |
TextElement |
The number of blanks which are replaced by one tab. Default: 2 |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding that is used in case the actual encoding cannot be detected. |
Text count string Action
This action counts the number of occurrences of a string in a file.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
*Count string UC4RB_TEXT_COUNT_TEXT# |
TextElement | This string is counted in the file. |
|
Count string is a regex UC4RB_TEXT_COUNT_TEXT_AS_REGEX# |
RadioGroupElement (NO, YES) | This parameter defines whether a regular expression is used to find the counted text or not. |
|
Default File Encoding UC4RB_XML_ENCODING# |
TextElement | Default file encoding to be used in case the actual encoding is not detectable . |
|
Name |
Description |
|---|---|
|
&UC4RB_OUT_TEXT_COUNT_TEXT# |
Holds the number of occurrences of the string. |
Text delete text Action
This action deletes a text.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
*Delete text UC4RB_TEXT_DELETE_TEXT# |
TextElement |
This text is deleted from the file. |
|
Text is a regex UC4RB_TEXT_DELETE_TEXT_REGEX# |
RadioGroupElement (NO, YES) |
This parameter defines whether a regular expression is used to find the text to be deleted. Default: NO |
|
Delete text filter UC4RB_TEXT_DELETE_TEXT_FILTER# |
RadioGroupElement (ALL, FIRST, LAST) |
Defines which occurrences of the pattern will be deleted. Default: ALL |
|
Default File Encoding UC4RB_XML_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text merge multiple empty lines Action
This action merges multiple lines into a single one.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
Ignore white spaces &UC4RB_TEXT_IGNORE_WS# |
RadioGroupElement (NO, YES) |
If this parameter is set to yes, the line is "trimmed". Otherwise, lines with blanks or tabs are no empty lines. Default: YES |
|
Merge all empty lines &UC4RB_TEXT_REMOVE_ALL# |
RadioGroupElement (ALL, FIRST, LAST) |
This parameter defines whether the first, the last or all occurrences of empty lines are merged. There must be at least one non-empty line in between. Default: ALL |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding that is used in case the actual encoding cannot be detected. |
Text normalize new line characters Action
This action normalizes new line characters.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*File name UC4RB_TEXT_FILE_NAME# |
TextElement |
The path to the file. |
|
EOL style UC4RB_TEXT_EOL_STYLE# |
RadioGroupElement (automatic, UNIX, windows) |
This Action detects the OS of the agent and sets the correct EOL for this operating system. Default: Automatic |
|
Default File Encoding UC4RB_TEXT_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text remove blanks in a line Action
This action removes blank spaces in a line.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
*Search line &UC4RB_TEXT_SEARCH_LINE# |
TextElement |
This text is searched in the file. |
|
Search line is a regex &UC4RB_TEXT_SEARCH_LIN_AS_REGEX# |
RadioGroupElement (NO, YES) |
This parameter defines whether a regular expression is used to find the line or not. |
|
Search line filter &UC4RB_TEXT_SEARCH_LINE_FILTER# |
RadioGroupElement (ALL, FIRST, LAST) |
This parameter specifies which lines should be considered for the search. |
|
Blank position &UC4RB_TEXT_BLANK_POSITION# |
RadioGroupElement (leading, trailing, trim) |
This parameter defines the position of the blanks to be deleted. |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text remove empty lines Action
This action removes empty lines in a file.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
| Ignore white spaces
&UC4RB_TEXT_IGNORE_WS# |
RadioGroupElement (NO, YES) |
If this parameter is set to yes, the line is "trimmed". Otherwise, lines with blanks or tabs are no empty lines. Default: YES |
| Remove all empty lines
&UC4RB_TEXT_REMOVE_ALL#
|
RadioGroupElement (ALL, FIRST, LAST) |
This parameter defines whether the first, the last or all occurrences of empty lines are removed. Default: ALL |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text replace text Action
This action replaces a selected text.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
Old text &UC4RB_TEXT_OLD_TEXT# |
TextElement |
The old text to be replaced by the new text |
| New text
&UC4RB_TEXT_NEW_TEXT# |
TextElement | The new text that replaces the old one. |
|
Old text is a regex &UC4RB_TEXT_OLD_TEXT_AS_REGEX# |
RadioGroupElement (NO, YES) |
This parameter describes whether a regular expression is used to find the old text or not. |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text blanks to tabs Action
This action replaces tabs with blanks.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
Number of blanks to one tab &UC4RB_TEXT_NUMBER_BLANKS# |
TextElement |
Number of blanks to be replaced by one tab. |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text to lower text Action
This action converts a string to lower case.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
Old text &UC4RB_TEXT_OLD_TEXT# |
TextElement |
This text is searched in the file. |
|
Old text is a regex &UC4RB_TEXT_OLD_TEXT_AS_REGEX# |
RadioGroupElement (NO, YES) |
This parameter defines whether a regular expression is used to find the old text or not. |
|
To lower case filter &UC4RB_TEXT_LOWER_TEXT_FILTER# |
RadioGroupElement (NO, YES) |
Specifies which occurrences should be considered. |
|
Default File Encoding &UC4RB_XML_ENCODING#
|
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |
Text to upper string Action
This action modifies a specific string to upper case.
Additional Notes:
Rollback is disabled for this action.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
*Old text &UC4RB_TEXT_OLD_TEXT# |
TextElement |
This text is searched in the file. |
|
Old text is a regex &UC4RB_TEXT_OLD_TEXT_AS_REGEX# |
RadioGroupElement (NO, YES) |
This parameter defines whether a regular expression is used to find the old text or not. |
|
To upper case filter &UC4RB_TEXT_UPPER_TEXT_FILTER# |
RadioGroupElement (ALL, FIRST, LAST) |
Specifies which occurrences should be considered. |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding that will be used in case the actual encoding cannot be detected. |
Text wrap lines Action
This action wraps a line after a specific position.
Additional Notes:
- Rollback is disabled for this action.
- Words at the end of the line are not split in the middle.
- Very long words (longer than the line length), such as URLs will not be wrapped.
|
Name |
Type |
Description |
|---|---|---|
|
*Text file name &UC4RB_TEXT_FILE_NAME# |
TextElement |
The text file to be used. |
|
Max line length &UC4RB_TEXT_LINE_LENGTH# |
TextElement |
Every line is wrapped after this position. |
|
Default File Encoding &UC4RB_XML_ENCODING# |
TextElement |
Default file encoding to be used in case the actual encoding cannot be detected. |