New Data Source screen (Data Entities)

Configures an entity in AgilePoint NX Data Entities for your data source.

Figure: How do you want to set up your entity? screen

How do you want to set up your entity? Screen

Background and Setup

Prerequisites

How to Start

  1. Click App Builder.

    Click App Builder
  2. On the App Builder Home screen, click All Apps.

    Click All Apps
  3. On the All Apps screen, on an app, click Edit Edit icon.

    Click Edit
  4. On the App Details screen, click Add New Add New icon > Data Source.

    Click Data Source
  5. On the Please select data source type screen, select Data Entities.

    Select Data Entities
  6. Click Next.

How do you want to set up your entity? > Configuration tab

Configures how to collect data from Data Entities for your app or process.

Figure: How do you want to set up your entity? > Configuration tab

How do you want to set up your entity Configuration tab

Fields

Field NameDefinition

Data Source Name
Description:
Specifies a name for the data source.
Allowed Values:
One line of text (a string).

Not Accepted:

  • Spaces
Default Value:
None
Accepts Variables:
No
Example:
Refer to:

Custom Entities Only
Description:
Specifies whether to show only custom entities in the Primary Entity Name list.
Allowed Values:
  • Selected - Shows only the custom entities in the Primary Entity Name list.
  • Deselected - Shows both standard entities and custom entities in the Primary Entity Name list.
Default Value:
Deselected
Accepts Variables:
No

Primary Entity
Description:
Specifies the AgilePoint NX entity from which your process to collect data.
Allowed Values:
The AgilePoint NX entity from the list.
Default Value:
None
Accepts Variables:
No
Example:
Refer to:

Save Data In Data Entities
Description:
Saves the application data in AgilePoint Data Entities.
Allowed Values:
  • Selected - Saves the data in the Data Entities database, in addition to the AgilePoint NX workflow database.
  • Deselected - Does not save the data in the Data Entities database.
Default Value:
Selected

Save A Copy Of Data In AgilePoint NX
Description:
Specifies whether to save the data in the AgilePoint NX workflow database.

When you select this field, you can deselect Autosave data in AgilePoint Data Entities field, and save the data only in the workflow database.

Allowed Values:
  • Selected - Saves the data in the AgilePoint NX workflow database, in addition to the Data Entities database.
  • Deselected - Saves the data in the Data Entities database, but not in the AgilePoint NX workflow database.
Default Value:
Deselected

How do you want to set up your entity? > Fields tab

Specifies the entity fields from entity.

Figure: How do you want to set up your entity? > Fields tab

How do you want to set up your entity Fields tab

Prerequisites

Fields

Field NameDefinition

Show Internal Fields
Description:
Specifies whether to show the internal names of default entity fields from AgilePoint Data Entities.
Allowed Values:
  • Selected - Shows the internal names of default entity fields.
  • Deselected - Does not show default entity fields.
Default Value:
Deselected

Check box
Description:
Specifies the fields to use in your process.
Allowed Values:
  • Selected - Your process contains the field.
  • Deselected - The field does not show on your process.
Default Value:
Selected

Display Name
Description:
Shows the fields associated with an entity.
Allowed Values:
Read only.

Data Type
Description:
Shows the data type of a field.
Allowed Values:
Read only.

Required
Description:
Specifies whether the field is required.
Allowed Values:
Read only.

Unique
Description:
Shows whether a duplicate value is permitted in the field.
Allowed Values:
Read only.

Configure Reference Entity Configure Reference Entity icon
Opens this Screen:
Reference Entity Configuration screen
To Open this Field:
Function of this Screen:
Changes the field for the reference entity.
Limitations:

The Configure Reference Entity option is available in these releases:

Reference Entity Configuration screen

Changes the field for the reference entity.

Figure: Reference Entity Configuration screen

Reference Entity Configuration screen

Prerequisites

Good to Know

  • Changes on this screen affect the results of lookups.

Fields

Field NameDefinition

Reference Entity
Description:
Shows the reference entity whose field to change.
Allowed Values:
Read only.

Name
Description:
Specifies the field to change for the reference entity.
Allowed Values:
A field from the list.
Default Value:
The primary field field.

Value
Description:
Shows the internal name of the primary field.
Allowed Values:
Read only.

How do you want to set up your entity? > Related Entity tab

Specifies related entity to use in app or process.

Figure: How do you want to set up your entity? > Related Entity tab

How do you want to set up your entity Related Entity tab

Prerequisites

Fields

Field NameDefinition

Show Internal Fields
Description:
Specifies whether to show the internal names of default entity fields from AgilePoint Data Entities.
Allowed Values:
  • Selected - Shows the internal names of default entity fields.
  • Deselected - Does not show default entity fields.
Default Value:
Deselected

Check box
Description:
Specifies the related entities and their associated fields to use in your process.
Allowed Values:
  • Selected - The process contains the related entities and their assoicated fields.
  • Deselected - The process does not use the related entities.
Default Value:
Deselected

Display Name
Description:
Shows the related entities that have relationships with the primary entity.
Allowed Values:
Read only.

Data Type
Description:
Shows the data type of a field.
Allowed Values:
Read only.

Required
Description:
Specifies whether the field is required.
Allowed Values:
Read only.

Unique
Description:
Shows whether a duplicate value is permitted in the field.
Allowed Values:
Read only.