Versions Compared

Version Old Version 9 New Version 10
Changes made by

Mike Ashton

Liv McCarten (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Overview

  • DDE rules can return data to the system that called the rule

  • The return data will be either:

    • A single field within the rule

    • A JSON message, created from several fields within the rule

    • A HTTP code

Example:

A rule has been created that requires Customer information to be stored. The following JSON message will be passed to the rule from a website:

Code Block
languagejson
{
  "Customer Id": 1,
  "Email Address": "ExampleOne@domain.com",
  "Customer Name": "Example One"
}

The Realtime Input will receive this JSON.

Plugin Configuration

General

Within the General tab:

The following settings can be configured:

Setting

Description

Use Single Input Field

Select this option to populate the “Output Field” with the data from another field specified in the “Input Field” selection:

In the above scenario, the data returned to the system that called the rule will be populated by a field called OutputJSON.

Build JSON From Input Field(s)

Select this option to populate the “Output Field” with the data from fields specified within the “Select Fields” tab:

In the above scenario the data returned to the system that called the rule will be populated with the fields specified i.e.:

Code Block
languagejson
{
  "CustomerID": "1",
  "CustomerName": "Joe",  
  "HomePhoneNumber": "0123456789",
  "MobilePhoneNumber": "1011121314"
}

Return HTTP Code

Select this option to return a specific HTTP Code to the system that called the rule:

If the Http Code “307 Temporary Redirect” is selected, then it is possible to return data from an “Input Field” :

This could be a status image URL, for example.

Return Static Value

Select this option to return a an HTTP Code and a static value to the system that called the rule. The “Response Content Type” should be set to “text/plain” to return a static value:

If the Realtime Output has the above configuration, the Response Body will contain the following:

Generate history

Needs to be removed as it doesn't do anything currently

Rule Priority

It is possible to specify the rule priority. The priority will subsequently , where priority can be used if a rule is called within a delivery group. The priority is then returned for each rule, showing the highest number first.
This can be used to determine which content to display, allowing the ability to show the top x results, for example. Within the Rule Priority tab:

The following settings can be configured:

Setting

Description

Use Fixed Priority

Select this option to return the priority specified in the text box:

In the above example the rule will output a priority value of 10.

Get priority from an input field

Select this option if the rule priority is specified in a field:

In the above example the rule will output a priority value from the field “PriorityScore”.

Accepting a priority score from an input field allows the priority to be dynamically populated for each row of data based on the other input fields received.