Skip to content

Text Fragmenter processor

Description

The Text Fragmenter breaks the input text into fragments such as sentences, newline separated parts and quotes.

Input

A block of this processor has these input variables:

  • text (string, required): the text to process.

  • options (object, optional): an object whose properties can be used to override the values of block's functional properties (see below). This is the correspondence between the properties of options and the functional properties of the block:

    Object property Corresponding functional parameter
    outputText Propagate input text to output

Block properties

Block properties can be set by editing the block.
Text Fragmenter workflow blocks have the following properties:

  • Basic properties:

    • Block name, it can be edited
    • Component version (read only)
    • Block ID (read only)

  • Functional:

    • Propagate input text to output: when turned on, the input variable text is echoed in the output JSON. Default: off.

  • Deployment:

    • Replicas: number of required instances.
    • Memory: required memory.
    • CPU: thousandths of a CPU required (for example: 1000 = 1 CPU).

  • Type Specific:

    • Timeout: execution timeout expressed in minutes (m) or seconds (s).

  • Input: these properties correspond to the input variables.
    Input properties are read-only—so only descriptive of the expected input—when the block is the first in a flow and the workflow's input has not been explicitly described. In that case the workflow's input JSON must contain keys whose name and type match those of the input variables.
    Otherwise, they are editable and must be set.

  • Output: read-only, this property is a navigable description of the structure of the output JSON.

Output and output-input mapping

The output of a Text Fragmenter block is a JSON object with the following structure:

{
    "fragments": {}
}

The fragments object has these properties:

  • strategy (string): fragmentation strategy used, for example BaseTextFragmenter. It is a troubleshooting only information.

  • positions (array): array of objects, each corresponding to the extremes of a fragment. Each object has these properties:

    • start (number): the zero-based position of the first character of the fragment in the text.
    • end (number): the zero-based position of the first character after the fragment in the text.

A Text Fragmenter block is suitable to be followed by a Language Detection block because the latter is able to accept fragments as input to make specific predictions about them as well.

For a correct functioning of the two processors in pairs:

  1. Turn on the Propagate input text to output functional property of the Text Fragmenter block.

  2. In the Language Detector block, associate input variables text and fragments to the homonymous output keys of the Text Fragmenter block.