This carrier is a full description of a field as used and interpreted by the sync connector.
FieldMetadataInfo objects are used in 2 areas of Erp Sync:
Populate a set of configuration controls for setting up a sync connection. The connector will supply a set of
FieldMetadataInfoobjects that describe the set of configuration data needed to set up a working sync connection.
When synchronizing/sending data between SuperOffice and a sync connection, Erp Sync will need to know the details of each field on the ERP side to avoid errors related to things like data type parsing and field length overruns. The Sync Connection will supply
FieldMetadataInfoobjects for each field it supports (through the
GetAvailableActorFieldsmethod). Erp Sync will store these details locally for all fields the customer elects to use (for either sync mapping, showing in the GUI and/or setting up for default values. See section "ERP field setup").
When an ERP field is set up for use in Erp Sync, the values in the corresponding
FieldMetadataInfoobject are stored locally in the SuperOffice database.
Setting up a new connection (requires that a Connector URL has already been set up). The grey area is dynamically showing the configuration fields that the connector has indicated that it needs to define a connection.
|FieldKey||string||Internal name of the field. Used as the key in the dictionary of values.|
|DisplayName||string||Localized field name – shown in the GUI as the label for the control.|
|DisplayDescription||string||Tooltip for the field.|
|FieldType||FieldMetadataTypeInfo||String, int, decimal, etc.
Kind of field widget to use: Textbox, Number field, Password field, Dropdown list, Checkbox
|ListName||string||If the field is a reference to a named list in the Sync Connector, this property contains the name of that list.|
|DefaultValue||string||A default value for the field. The value in the widget when the configure dialog isopened in Add Connection mode.|
|MaxLength||int||Maximum length for strings, if set.
0 means no restriction. (Though sooner or later something will no doubt overflow if you pile on the gigabytes.)
|Access||FieldAccessInfo||Access restrictions on the field|
DefaultValue will vary a bit depending on the type:
- If the field is a label, text or password, then the text is used (obviously)
- If the field is an int or double, we will try to convert the string into a number. (If the conversion fails, we shall use zero or 0.00 as the default value.)
- If the field is a list, we shall try to find a list item where the fields default value matches the lists item’s
Describes the different field types that can be offered by the connector.
|Checkbox||Boolean field. Contains 0 or 1|
|Text||Standard text field|
|Password||Standard text field, but presented with
|Integer||Integer field; whole numbers only|
|List||Refers to a given list by name. The list items need to be available from the Sync Connection through the
|Label||Static text. Will not be editable in a GUI setting.|
This enum describes access restrictions and mandatory status.
|Normal||Normal field, no particular restrictions|
|Mandatory||This field is mandatory (see section "Default value setup")|
|ReadOnly||This field is read-only|