See also: Business objects and attributes.
Input forms for orders can be created with the form designer (see Form designer).
Orders can contain attributes of the following types:
Text attributes
Numerical attributes
Date attributes
Indicator attributes
Reference attributes
Free enumerations
Company attributes
Address attributes
Order header
Additionally, the following specific elements are available in the form designer for orders:
Section | Element | Type | Content |
|---|---|---|---|
Order | ID | Unique numeric ID of the order within Lobster Data Platform / Orchestration; automatically assigned upon creation of the order, therefore the element should be defined as inactive or read-only | |
Order type | Defined via the dynamic enumeration Order type | ||
International commercial term | Defined via the dynamic enumeration Incoterms | ||
Service type | Defined via the dynamic enumeration Service type | ||
Mode of transport | Defined via the dynamic enumeration Mode of transport | ||
Number of packages | Numeric value for the number of packages | ||
Working state | Defined via the dynamic enumeration Working state | ||
Line items | Line items of the order as configured (see following sections) | ||
Delivery instruction attributes | Delivery instruction attribute | Defined via the dynamic enumeration Delivery instruction; multiple elements of the enumeration can be assigned to the same order, by selecting a delivery instruction type per Combobox; depending on configuration per type (in dynamic enumerations) a Text field is available for input details. Restrictions for permitted combinations of delivery instructions can be controlled by Delivery instruction combinations | |
Elements per Delivery instruction | Elements of the dynamic enumeration Delivery instruction can also be added as individual elements in a form. The type of Delivery instruction appears as a label of a Column layout container with a Text field that is visible depending on configuration in the enumeration. Delivery instructions that are explicitly included in a form are automatically created, when the order is saved | ||
Packaging summary attribute | Elements per Type of packaging | For each element of the dynamic enumeration Type of packaging, a packaging summary attribute is available.The provided Column layout container features a Text field to indicate calculated results (see Sum packaging (Order)) |
Order line items
On the level of line items of an order, i.e. inside an order line item element, the following specific content is available:
Section | Element | Type | Content |
|---|---|---|---|
Order line item | Line item no. | Systematic line item number of the current line item; automatically assigned on create/update with hierarchical structure (see Line item type) | |
Parent line item no. | Systematic line item number of the parent line item; automatically assigned on create/update with hierarchical structure (see Line item type) | ||
Referenced line item | Element picks reference from the current line item to a line item of another Line item type (e.g. from Line item type 'Default' to Line item type 'Service') within the same order; when the element is added to a form, the target Line item type and level (starting from 0) must be specified | ||
Number of packages | Numeric value for the number of packages; also used as input for calculating packaging summaries per Type of packaging on position level (see Sum packaging (Order)) | ||
Aggregated number of packages | Numeric value for the aggregation of packages in sub line items (as a product of 'Number of packages' of the sub line item x 'Number of packages' of the parent line item)(see Calculate aggregate number of packages (Order)) | ||
Type of packaging | Defined by the dynamic enumeration Type of packaging; required input for calculation of packaging summaries per Type of packaging (see Sum packaging (Order)) | ||
Product search | ExpandableSearch â–º product | Search (Combobox) for product selection with an expandable section for product data (see also section 'product search' below). â–ºNOTEâ—„ Includes the element 'Product', which therefore cannot be selected separately | |
Product | Row layout â–º product | Row layout container for attributes or Products, including Dangerous goods (see below). â–ºNOTEâ—„ Not available if 'Product search' is in use | |
Line items | Repeatable element â–º Order line items | Sub line items of the current line item, which may in turn contain further sub line items. Line items may be cascaded to build an hierarchy of arbitrary depth, reflecting in the systematically assigned 'Line item no.' values | |
Aggregate numeric attribute | Elements per Numeric types | For each element of the dynamic enumeration Numeric types an aggregate numeric attribute is available; by default the provided Column layout container contains a Text field for the numeric value and a Combobox for the applicable unit;optionally, another numeric Text field 'Aggregate value' is available, to populate with calculated values by Calculate attributes down (Order); | |
Barcode attribute | Barcode attribute | For each order line item multiple barcodes can be assigned as elements of a plural typed attribute (see Plural attributes). Each element provides a Column layout container with Text field 'Barcode' and a Text field 'Barcode reference'; Text field 'Barcode' may be populated automatically by Generate barcodes (Order) via Number range; | |
Linked line item | Elements per (applicable) Linked line item type | An order line item may specify one outbound link for each Linked line item type configured with a source line item type of 'Order line item'. Each link is represented by a Column layout container containing one Combobox to specify the business object to link to an another for one of its line items. Additionally, a button 'Link line items' can be added. (see also Working with 'Linked line items') |
Product data (within order line item)
Definition of a 'Product Search':
The selection box allows for the editing of service configuration.
Since the product search always returns product entities, no Joins for the Label Expression can be formed.
To access product attributes, the ta function (TypedAttribute function) can be used.
This example refers to the short description:
{$ta(de.lobster.scm.base.product.attributes.ProductDescription,de,shortDescription)}
In so doing, indicate the attribute's class, as well as the language (the name from the enumeration Locale) and the member (shortDescription) of the class.
'ProductDescription' has the members 'shortDescription' and 'longDescription'.
Product data
Products may feature typed attributes of the following types:
Text attributes
Numerical attributes
Indicator attributes
Free enumerations
The following elements are specific for product data:
Section | Element | Type | Content |
|---|---|---|---|
Product | Add to product catalog | Button | Standard procedure for adding the current product to an existing product catalog |
Product ID | Product ID | Multiple 'Product IDs' can be assigned to the same product, as long as they are linked to a unique combination of Product ID context and Product ID type. For each 'Product ID' Text field this combination must be specified when it is added to a form;there is no repeatable element to handle 'Product ID' entries across types. â–ºNOTEâ—„ There is no check to ensure an added combination of Product ID context and Product ID type is unique in the form. If the same combination is linked to more than one Text field, all will show the same value (at least after saving). | |
Product description | Short description [ <Locale> ](one element per Locale) | Single line of text for locale specific product description | |
Long description [ <Locale> ](one element per Locale) | Potentially multi-line text for locale specific product description | ||
Price attribute | Price attribute featuring the following details:
| Multiple price attributes can be assigned to the same product, provided a unique combination of Price context, Country and Currency is specified. For each Column layout container added to a form this combination must be specified;there is no repeatable element to handle price attributes across types; â–ºNOTEâ—„ In contrast to 'Product ID', there is a check if a combination of Price context, Country and Currency is unique within a form.Each price attribute features Text field elements for 'Net value', 'Gross value' and 'Base value' as well as Combobox elements for 'Base unit' and Tax rate | |
Dangerous goods attribute | Dangerous goods attribute (see below) | Multiple dangerous goods attributes can be assigned for the same product, featuring specific attributes (see below) and references to Dangerous goods master data; |
Dangerous goods data
For Dangerous goods attributes the following elements are available:
Section | Element | Type | Content |
|---|---|---|---|
Dangerous goods attribute | Dangerous substance | Configurable search for Dangerous goods (see NOTE below) | |
Dangerous substance expandable | Configurable search for Dangerous goods including expandable container to indicate dangerous substance details | ||
Dangerous substance select | Button | Opens an overview of Dangerous goods for selection of dangerous substances | |
Dangerous substance label | Indicates the 'Name' of a dangerous substance as a label | ||
Inner quantity value | Numeric value for inner quantity | ||
Inner quantity unit | Inner quantity unit | ||
Outer quantity value | Numeric value for outer quantity | ||
Outer quantity unit | Outer quantity unit | ||
NEQ value | Numeric value for NEQ (net explosives quantity) | ||
NEQ unit | Unit of NEQ (net explosives quantity) | ||
Limited quantity | Flag value | ||
Quantity outer packaging | Numeric value for outer packaging quantity | ||
Quantity inner packaging | Numeric value for inner packaging quantity | ||
Inner packaging | Selection for inner packaging (see Dangerous goods packaging type) | ||
Hazard-inducing substance | Selection for Dangerous substance | ||
Hazard-inducing substance text | Plain text for hazard-inducing substance | ||
Recovery package | Flag value | ||
Recovery pressure vessel | Flag value | ||
Dangerous for environment | Flag value | ||
Outer packaging | Configurable search for outer packaging (see Dangerous goods package) |
â–ºNOTEâ—„ Combobox 'Dangerous substance' must be included into a form, when 'Dangerous substance select' (Button) and 'Dangerous substance label' are used. The Combobox may be defined as 'invisible', however.