Follow-On Topics

Related Topics

# About the Options Tab

About the Applications Platform Connector

The Applications Platform Connector tool allows communication between Applications Platform and King Task Centre. All communication uses XML. You use the Connector to map King Task Centre data to Applications Platform objects and operations — see Supported Objects.

The XML responses received back from Applications Platform can be saved to file, or passed to another King Task Centre tool for further processing. The responses can include details of the object requested, any errors, or the values of any automatically generated ID fields.

You can use the Applications Platform Connector to provide an indirect link from your Applications Platform installation to other systems that King Task Centre is connected to. For example, if you make use of the Web Portal in Applications Platform, and have your CRM system connected to King Task Centre, you can make CRM data available to the Web Portal via the Applications Platform Connector.

Click the image to view full size.

The Options tab allows you to define how errors in this step are handled at task runtime.

## Adding a New Task Step (cont.)

1. If an error occurs, you can decide whether the step should Continue processing, or terminate the step immediately (Abort Step).

1. If the step is aborted, you can choose to Continue processing onto the next step in the task, or terminate the whole task immediately (Abort Task). Allowing the task to continue allows you to use the error XML received back in a Save File step for investigation purposes, for example.

1. The Missing/NULL processing panel allows you to define how missing elements in the XML are handled. Select either:

|  | Ignore NULL fields in the input — This is default behaviour. If a mapped element is missing from the InputData XML (see Tool Output), it is not sent to Applications Platform and the data there remains the same.

|  | Set NULL fields as empty strings in the destination — If a mapped element is missing from the InputData XML, the Applications Platform Connector still includes it in the XML passed to Applications Platform but with a blank value. This effectively updates the database column in Applications Platform to a NULL value for the record.

1. The References return mode panel allows you to define how reference fields and other related information are returned by the Applications Platform API. Select either:

|  | Only ID — For the returned records, include the IDs of the lookup field or pick-list item. The ID elements are suffixed with `_id`.

|  | Only Name / Code — For the returned records, include the names of the lookup field item, or the code of the pick-list item. The XML element tabs are suffixed with `_name` or `_code` as appropriate.

|  | Both — Return both the ID, and the name or code where available.

How does this relate to my Applications Platform solution?
About Pick-Lists

Within Applications Platform, a pick-list is typically a drop-down list where the user either selects a pre-configured item, or enters text to filter the list before selection:

Pick-list items are written to the XML document as:

    <picklist_id>Value</picklist_id>
    <picklist_code>Value</picklist_code>

This image would generate the following XML:

    <country_id>1234</country_id>
    <country_code>United Kingdom</country_code>

Using this example, Only ID returns `<country_id>1234</country_id>`, and Only Name / Code returns `<country_code>United Kingdom</country_code>`.

About Lookup Fields

Lookup fields refer to integrated Applications Platform objects, where a separate modal, or Selector, linked to another object is required to choose the lookup field item:

Clicking the search button, opens the modal:

Lookup field items are written to the XML document as:

    <lookup_id>Value</lookup_id>
    <lookup_name>Value</lookup_name>

This image would generate the following XML:

    <R209209_id>9876</R209209_id>
    <R3634_name>Joe Bloggs</R3634_name>

Using this example, Only ID returns `<R209209_id>9876</R209209_id>`, and Only Name / Code returns `<R3634_name>Joe Bloggs</R3634_name>`.

1. Click OK to complete the step.

Copyright © 2018 Quadrant Software B.V. All rights reserved.