Skip to content
Book a demo

Connect documentation

All documentation
Documentation

skipuntil

On this page

Remove rows from the data extract until a certain value is found.

Introduction

Use the skipuntil instruction to remove rows from a data extract until a given value is found. You can choose to include or exclude this value from the data extract.

Creating a custom script transformation using the skipuntil instruction

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

  1. Create a custom script transformation.

  2. In the Instruction step, select the skipuntil instruction.

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

Prefix*

Enter the value to which the transformation will skip. All the rows above the row containing this value are removed from the data extract.

Fieldname

Enter the name of the column that contains the value to which the transformation will skip.

Yield Match

Select this option to keep the row that contains the Prefix value.

Strict

Select this option to raise an error if a field could not be found during the transformation. Leave this field unselected to continue with the transformation if a field is not found.

Keep Header

Select this option to keep the header of the data extract.

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 transformation 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 transformation and optionally as the output.

Example

Transformation configuration

Prefix*

Brand

Fieldname

Ad Group

Yield Match

Select this field.

Keep Header

Select this field.

Data table before transformation

Scroll horizontally to see the full table.

Campaign

Ad Group

Clicks

Brand

media

7

Brand

ecommerce

3

Dashboard

Brand

18

Brand

ecommerce

4

Dashboard

media|social

5

Dashboard

media

11

Data table after transformation

Scroll horizontally to see the full table.

Campaign

Ad Group

Clicks

Dashboard

Brand

18

Brand

ecommerce

4

Dashboard

media|social

5

Dashboard

media

11