Metadata is data that describes other data. Meta is a prefix that -- in most information technology usages -- means "an underlying definition or description." Metadata summarises basic information about data, which can make finding and working with particular instances of data easier.
The use of Metdata in FieldTwin allows you to enable DATA DRIVEN DESIGN in your pre-engineering phase when designing field layouts. Metadata allows you to build or link your own data model to your private Asset Library, the Generic library or as Virtual Assets.
This is especially useful for providing equipment and costing options while designing the field. E.g. by defining metadata your users can then select various equipment configurations with corresponding options and link them to your VendorID, WBS, cost specifications etc.
Metadata API Support¶
Everything you can do with the Meta Data Editor you can also do through the FieldAP REST API so you can programatically configure everything. You can read more about the API here in the API DOCS
You start out by defining your Metadata in the Metadata screen. You will find this in FT Admin by selecting "Metadata" as shown below:
The UI allows you to define your various metadata attributes with a wide range of data types, units, and input options for user selection on assets, layers, wells, connectors and connections. Furthermore the metadata are highly customisable, and supports dependencies, filters, tags and more.
Create New Definition¶
Press the +Create New Definition button and the following "New Meta Definition" entry section will appear in the list below and the definition panel will be shown to the right as shown below:
ID - This is the unique ID (identifier) for this metadata, and typically is used as a reference for metadata API operations. It is a Read Only value.
Definition ID - This is the metadata definition ID. After you have selected an existing ID or filled in the Name field below it, you can press the Generate button and the new ID will be created.
Name - Specify the name of your new metadata entry in this field. Do this before you press Generate.
Vendor ID - You can also assign an optional alphanumeric Vendor ID of your choosing, which can be useful for API integrations etc.
Control - Drop down list of the available data types for the new Metadata you create.
Public (For Export Purpose) - If you want the Metadata definition created here to be publicly available when exported and shared to other parties.
DefinitionId - Press this button to generate the new Definition ID for the metadata you are creating. Note! The Account Identifier must be defined first under Account Settings > General.
Control Data types¶
This setting allows you to define the data type for the metadata you are creating as well as to assign it to Group or Sub-Group.
The available data types are as follows:
|Choices||List of alphanumeric options|
|Boolean||True or False|
This is an alphanumeric text string data type:
You have the following available settings:
Default - This allows you to enter a default value e.g. a text string that describes the input you are looking for from the user.
Value is read only - Check this option if the text field should be read only e.g. no user input.
Text is multiline - Check this option if you want the text field to be comprised of multiple lines.
If multiline, number of lines to display - Enter the number of text lines you want to display.
Cost is per length - Select this option if the numerical value is to be used in a cost per length calculation e.g. cost per meter of a pipeline.
This is a numerical input field where you define a Minimum, Maximum, and a Default numerical value. You can define the Units to be used for the field. Select a Unit category first and then the available Unit type selections available will vary based on the category selected.
Unit is read-only - Check this option if the user is not allowed to change the value.
Unit Category - Select the unit category you want to use from the drop down list. Read about the available Unit Categories
Unit Type - Select the unit type you want to use from the drop down list. Read about the available Unit Categories
Default Unit Suffix - Select the default unit suffix you want to use from the drop down list. Read about the available Unit Categories
Minimum - Set the minimum numerical value allowed for the input field.
Maximum - Set the maximum numerical value allowed for the input field.
Default - Set the default numerical value to pre-populate the input field with.
Value is a cost - Check this option to have the value computed in the cost equipment module.
Value is read-only - Check this option to have the numerical input field to be read.
"Cost is per length" - Select this option if the numerical value is to be used in a cost per length calculation e.g. cost per meter of a pipeline.
This will display a horizontal slider UI element that gets defined with a minimum, maximum value and the step value of the slider You can also check the the Value is a cost option so it will get computed in the cost equipment module. And you can define the numerical value to be used in a cost per length calculation by selecting the "Cost is per length" option.
Minimum - Set the minimum numerical value for the slider range.
Maximum - Set the maximum numerical value for the slider range.
Default - Set the default numerical value for the slider control.
Step - Set the numerical step value to increase or decrease the slider control with.
Value is a cost - Check this option to have the slider value computed in the cost equipment module.
"Cost is per length" - Select this option if the slider value is to be used in a cost per length calculation e.g. cost per meter of a pipeline.
This is a list of choices you define (alphanumeric or numerical) that will be presented to he user for selection.
Entry Name - Set the name definition of your choice entry e.g. Injection.
Entry Vendor ID - Set the choice entry Vendor ID if needed.
Entry Custom Value - Use this field to specify a custom value. This can be useful if you want to associate a value with a string and fetch the number through the API to be used in e.g. simulations.
Entry Text Color - You can define a choice color to illustrate to the user if this choice is safe e.g. green or risky e.g. red.
Entry Background Color - You can define a choice background color to illustrate to the user if this choice is safe e.g. green or risky e.g. red.
Filter selection on choice - Check this option to apply a filter to the choices that will displayed, based on other selected metadata. First select the relevant metadata selection that should be used for filtering then select the option for display. If multiple options are selected it will display as soon as one condition is met.
Default - Select one of the created Choice option as the default selection.
"Can multi-select" - Check this option to allow for multiple options to be selected by the user.
"Cost is per length" - Check this option if you e.g. add meta data for a Connection, and the choice is a numerical value and then it can be used in a cost per length calculation.
This will present the user with a TRUE/FALSE checkbox with the possibility to have a "Cost per length" attached to it thats get computed in the cost equipment module. The Default checkbox indicates the default boolean state e.g. if checked the option is TRUE by default.Unset default button allows to reset the default value boolean value.
This is a meta data type that makes it possible for you to link another asset to your object. As an example you make a data type called slot 1 in a 4 slot template - you can then choose asset as data type, and in the project you link a XMT asset into the slot. Then the metadata for the XMT will also show up in your meta data editor in the project and every asset linked will then be computed in the cost equipment module.
Docking Slot - Assets (Models) supports connections with other assets (SmartModels) if they are defined as such. You can select the docking slot here if configured for this asset.
The Asset data type also has a Filters section, where you can preselect the following filters;
Type - Select the asset type from the list which is comprised of; vessel, structure, virtual, submerged, and onshore.
Sub type - Select the asset sub type from the list which is comprised of; SPS, piping, Host, rig, other, umbilical, SPP, vessel, and installation aids.
Category - Select the asset category from the list which is comprised of; XMT, ITS & Template Structures, Riser & Riser Base, Valve, Pipeline and Pipeline Assets, Hosts, Onshore Facility, Terminal, Manifold, Rig, Wellhead, Subsea Distribution, Subsea Processing, Vessel, TBE, Cover, Anchors, Mattress, Controls, Pipeline Crossing Support, Pointer/Link holders, and Host.
Sub Category - Select a sub category from the list if one is defined.
Default - Select the default asset type from the list for this Metadata definition.
"Cost is per length" - Check this option if you have a numerical value for the defined asset metadata and then it can be used in a cost per length calculation.
This is a meta data type that makes it possible for you to link another connection to your object. Typical usage is when defining Bundles or Pipe in Pipe. You then link the category you wish the user to be able to add into the carrier pipe
Category - Select the connection category from the list which is comprised of; Umbilical, Production, Water Injection, Gas Injection, Gas Lift, Electrical Lead, Hydraulic Lead, MEG, Methanol, Fiber Optic Lead, Service Line, Cable, Power Cable, Bundle, Mooring, and Pigging.
Connections - Select the connection allowed connection type from the list which is comprised of; Umbilical, Oil Production, Water Injection, Gas Injection, Gas Lift, Electrical Lead, Hydraulic Lead, and MEG.
Default - Select the default connection type from the list for this Metadata definition.
"Cost is per length" - Check this option if you have a numerical value for the defined connection metadata and then it can be used in a cost per length calculation.
Allows you to place a button with the text specified in the Caption field into the Meta data editor. You can then assign an URL in the Action URL field that typically invokes a call to an external service/server for launching a simulation, calculation, or some other operation with your own or 3rd party software.
Caption - Enter the text for the button text.
Action URL - Enter the URL that will be invoked when pressing the button with any parameters that are defined as follows:
The action URL can be comprised of the following parameters:
|%subProject%||Sub project ID|
|%id%||Selected element id (the one the metaData is linked to)|
|%type%||Selected element type ('stagedAsset', 'connector', 'connection')|
Example : https://myserver/query/%account%/%project%
"Cost is per length" - Check this option if you have a numerical value associated with the action and then it can be used in a cost per length calculation.
This data type allows you to create a table layout for user data entry.
+Add Header - Click this button to create a new table column.
Header Name - Enter your column name in this field.
Header Vendor ID - Enter an optional VendorID in this field.
Text Alignment - Select how you want the text aligned from the list; default, left, center, and right.
Text Wrap - Check this option if you want the text to wrap in the column.
Remove - Click this button to delete an entry.
Up and Down arrows - Use these arrows to arrange the order of the column headers.
"Cost is per length" - Check this option if you have a numerical value associated with the table entry and then it can be used in a cost per length calculation.
This section allows you to add logic to the metadata configuration.
+Add a Condition - Press this button to add a condition, and the input area will be expanded.
The Select a dependency drop down list will show all the metadata you have defined so you can select the one you want. Then select if the condition should be Equal or Not Equal to the values or options you have defined for the metadata. Use the Add a condition button again to create multiple conditions.
Remove Condition - Press the trashcan to remove the created condition.
Filtering of metadata definitions using tags, If you have a long list of metadata definitions, you can now filter by tags.
Grouping Metadata allows you to assigns sets of metadata to an asset, connection etc in one operation. Click on Add new Metadata Group in order to create a new metadata group then select the definitions to make up the group.