expectheader

Check if the header contains the expected field names, and raise an error if issues are found.

This guide explains how to configure the expectheader instruction. To learn about another instruction, go back to the Available custom script instructions overview.

Introduction

Use the expectheader instruction to check if the table header contains the field names you expect in the table. If there are any additional or missing field names in the header, or the field names in the header are not in the expected order, the enrichment raises an error.

Creating a custom script enrichment using the expectheader instruction

To create and configure a custom script using the expectheader instruction, follow these steps:

  1. Create a custom script enrichment.

  2. In the Instructions step, select the expectheader instruction.

  3. To configure the custom script instruction, fill in the following fields. Required fields are marked with an asterisk (*).

Fieldnames

Enter the names of the fields in the order in which you expect to find them in the header.

Subtable

Enter the name for a subtable that you want to use within this custom script.

A subtable is a temporary table that only exists for this custom script. You can apply additional instructions within the same custom script to the subtable. However, the subtable cannot be used in any other custom scripts.

If a subtable does not exist for the current custom script, the enrichment is applied to the data extract, and the enriched data is output into the subtable. If the subtable already exists for the custom script, the subtable is used as the input for the enrichment and optionally as the output.