Base64 Field Encoder

The Base64 Field Encoder encodes binary data using Base64. Use the processor to encode binary data that must be sent over channels that expect ASCII data.

For example, you can use Base64 encoding to embed image data directly in HTML source code. When you encode the data, you prevent characters such as “<” and “>” from being interpreted as tags.

When you configure Base64 Field Encoder, you specify the byte array fields to encode and the target byte array fields to pass the encoded values to. You can also specify that the processor encode the data so that it can be safely sent in a URL.

Configuring a Base64 Field Encoder Processor

Configure a Base64 Field Encoder to encode binary data using Base64.

  1. In the Properties panel, on the General tab, configure the following properties:
    General Property Description
    Name Stage name.
    Description Optional description.
    Required Fields Fields that must include data for the record to be passed into the stage.
    Tip: You might include fields that the stage uses.

    Records that do not include all required fields are processed based on the error handling configured for the pipeline.
    Preconditions Conditions that must evaluate to TRUE to allow a record to enter the stage for processing. Click Add to create additional preconditions.

    Records that do not meet all preconditions are processed based on the error handling configured for the stage.
    On Record Error Error record handling for the stage:
    • Discard - Discards the record.
    • Send to Error - Sends the record to the pipeline for error handling.
    • Stop Pipeline - Stops the pipeline.
  2. On the Base64 tab, configure the following properties:
    Base64 Field Encoder Property Description
    Fields to Encode

    One or more byte array fields to encode. Select the fields that you want to encode and the corresponding target fields.

    For the target field, you can specify the same field as the original field to replace the original data with the encoded data. Or you can specify another existing field or a new field. If the field does not exist, Base64 Field Encoder creates the field.

    Using simple or bulk edit mode, click Add Another to add a field.

    URL Safe Specifies whether to encode the field so that it can be safely sent in a URL. For example, when selected, Base64 Field Encoder ensures that the encoded data does not contain a forward slash (/) because it is a URL reserved character.