ÃÛ¶¹ÊÓƵ

DocumentationWorkfrontWorkfront Guide

Text parser

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

You can use the Text parser tool to parse text for use in other ÃÛ¶¹ÊÓƵ Workfront Fusion scenario modules. The Text parser does not require a connection.

Access requirements

You must have the following access to use the functionality in this article:

ÃÛ¶¹ÊÓƵ Workfront plan*
Pro or higher
ÃÛ¶¹ÊÓƵ Workfront license*
Plan, Work
ÃÛ¶¹ÊÓƵ Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration, Workfront Fusion for Work Automation

Product

Current product requirement: If you have the Select or Prime ÃÛ¶¹ÊÓƵ Workfront plan, your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.

Text parser API information

The Text parser connector uses the following:

API tag
v2

Text parser modules and their fields

When you configure Text parser modules, ÃÛ¶¹ÊÓƵ Workfront Fusion displays the fields listed below. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in ÃÛ¶¹ÊÓƵ Workfront Fusion.

Transformers

Get Elements from HTML

Retrieves the desired elements from HTML code.

Continue the execution of the route even if the module finds no matches
Enable this option to ensure that the module does not stop the scenario if it returns no results.
Element type

Select the type of element you want to retrieve from the HTML code.

  • Image
  • Link
  • iFrame element(s)
HTML
Enter or map the HTML code you want to retrieve the specified element types from.

Get Elements from text

Parses elements from text based on the given pattern.

Input text
Enter or map the text you want to parse.
Pattern
Select the pattern that reflects the elements you want to parse from the text.
Ignore Duplicate Occurrences
Check this box to ignore duplicate occurrences of a text element.

HTML to Text

HTML
Enter the HTML code you want to convert to plain text.
Line break
Select the type of newline (line break).
Uppercase headings
Enable this option to convert text enclosed in the heading tags (such as <h2> </h2>) into uppercase text.

Match Pattern

The Match pattern module enables you to find and extract string elements matching a search pattern from a given text. This module uses regular expressions (also known as regex or regexp).

A regular expression is a sequence of characters in which each character is either a metacharacter, having a special meaning, or a regular character that has a literal meaning. These character and metacharacters identify a pattern that can be used to search text. For example, if you wanted to search for names, you could set up a regular expression to search for a pattern that consists of two consecutive words that begin with capital letters. Regular expressions are a powerful tool for searching and manipulating text.

A discussion of regular expressions is beyond the scope of this article. We recommend the following resources:

  • For the complete list of metacharacters, see in MDN web docs.
  • For a tutorial on how to create regular expressions, we recommend .
  • For experimenting with regular expressions, we recommend the website. Select the ECMAScript (JavaScript) FLAVOR in the left panel.
Pattern

Enter the regular expression pattern.

Example: [+-]?(\d+(\.\d+)?|\.\d+)([eE][+-]?\d+)? extracts all numerals in the provided text.

Note:

The pattern should contain at least one capture group in parenthesis (). If the pattern does not contain any capture groups, the output bundle is empty.

Global match
Enable this option to retrieve all matches in the text. Each match is output in a separate bundle. If this option is disabled, the module retrieves only the first entry.
Case sensitive
Enable this option for this module to treat text as case-sensitive.
Multiline
Enable this option to ensure that beginning and end metacharacters (^ and $) matches the beginning or end of each line, not just the very beginning or end of the whole input string.
Singleline
Enable this option to ensure that the period (.) matches newline characters (\n).
Continue the execution of the route even if the module returns no results
Enable this option to ensure that the module does not stop the scenario if it returns no results.
Text
Enter or map the text you want to match the pattern.

Replace

Searches the entered text for a specified value or regular expression and replaces the result with the new value.

Pattern
Enter the search term. You can also use a regular expression. For more details about the regular expression refer to the Match Pattern module.
New value
Enter a value that replaces the search term.
Global match
Enable this option to retrieve all matches in the text. Each match is output in a separate bundle. If this option is disabled, the module retrieves only the first entry.
Case sensitive
Enable this option for this module to treat text as case-sensitive.
Multiline
Enable this option to ensure that beginning and end metacharacters (^ and $) matches the beginning or end of each line, not just the very beginning or end of the whole input string.
Singleline
Enable this option to ensure that the period (.) matches newline characters (\n).
Text
Enter the text to be searched.

Data Scraping

Data scraping, sometimes called web scraping, data extraction, or web harvesting, is the process of collecting data from websites and storing it in your local database or spreadsheets. If you want to scrape data from a website and you are not familiar with regular expressions, you may use a data scraping tool.

If the data scraping tool provides a REST API, you can connect to it via our universal HTTP modules and Webhooks modules.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43