Updated Mar 12 Nikolina Cofek Edit Share Pimcore Requestador Configuration: Steps for Action and Field Mapping

After the AI endpoint has been configured and the Requestador action has been created, the next step is to configure how Pimcore uses that action and verify that the integration works correctly.

Pimcore Requestador Configuration defines how Pimcore fields are passed to a Requestador action and how the response is written back to Pimcore.

A mapping configuration connects:

• a Requestador action

• a Pimcore class

• input parameter mappings

• response field mappings

The purpose of the mapping is to ensure that Requestador receives the correct source values and that the returned output is written to the correct Pimcore fields.

Depending on the use case, a configuration can be created in two ways:

• Non-batched Mapping Configuration

• Batched Mapping Configuration

The correct option depends on whether the action processes one logical mapping set at a time or multiple grouped mappings within a single configuration.

A Pimcore Requestador mapping usually contains the following elements:

Action selection: Defines which Requestador action should be called.

Class selection: Defines for which Pimcore class the configuration is valid.

Configuration metadata: Includes internal management values such as:

• title

• group

• batch mode setting

Input mappings

Define how Requestador action parameters are populated.

Typical mapping types include:

• Pimcore field

• fixed value

• language value

Response mappings

Define how the fields returned by Requestador are written back into Pimcore.

The mapping flow works as follows:

1. Pimcore reads configured source values

2. source values are mapped to Requestador action parameters

3. Requestador executes the selected action

4. Requestador returns structured output

5. returned fields are mapped back into Pimcore target fields

This structure is the same for both batched and non-batched mode. The main difference is whether the configuration contains one mapping set or multiple grouped mapping sets.

Requestador for Pimcore supports two main mapping modes:

Non-batched mapping: Use this when one configuration contains one logical set of input and output mappings.

Batched mapping: Use this when one configuration contains multiple grouped mappings, typically for repeated or multilingual processing.

• each action you want to use in Pimcore usually requires its own configuration

• input and output field names must match the actual structure expected by the Requestador action

• if localized Pimcore fields are used, ensure the correct language is selected