{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Table of Contents","description":"Accelerate E&P application development and protect your innovation by consuming our Data and Domain APIs / Platform APIs.","lang":"en-US","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"table-of-contents","__idx":0},"children":["Table of Contents ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"TOC"},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#introduction"},"children":["Introduction"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#concepts"},"children":["Concepts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#operationTypes"},"children":["Operation types "]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#operationConditions"},"children":["Operation conditions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#usecases"},"children":["Use cases"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#copy_copy_substr_usecases"},"children":["COPY and COPY_SUBSTRUCTURE operations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#constant_usecases"},"children":["CONSTANT operation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#array_usecases"},"children":["Array operations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#concatenate_usecases"},"children":["CONCATENATE operation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#aggregate_usecases"},"children":["AGGREGATE, COPY_ARRAY_INDEX, CONDITIONAL_PRIORITY operations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#relationship_and_relatonship_array_usecases"},"children":["RELATIONSHIP and RELATIONSHIP_ARRAY operations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#reference_lookup_usecases"},"children":["REFERENCE_LOOKUP operation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#lookup_by_query_usecases"},"children":["LOOKUP_BY_QUERY operation"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#operation_roperties"},"children":["Mapping operation properties"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#mapping_service_operations"},"children":["Mapping service operations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-mapping"},"children":["Create mapping definition"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#sample"},"children":["Sample mapping definition"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-all-mapping"},"children":["Get All Created Mapping Definitions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-specific-mapping"},"children":["Get a specific mapping definition by ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#update-specific-mapping"},"children":["Update a specific mapping definition"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#delete-specific-mapping"},"children":["Delete a specific mapping definition"]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#api-specs"},"children":["API specifications"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":1},"children":["Introduction ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"introduction"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mapping service enables centralized governance and management of mapping definitions. In general, there could be many formats or structures for the same entity depending on its source.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Although this schema flexibility allows for better data preservation, it makes it more difficult for other applications and workflows to consume this raw ingested data. It requires them to know all available raw structures in advance before data can be consumed.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"This issue is minimized by the use of a standard structure, called the \"Well Known Structure\" (WKS). WKS is a standard and known format that can be used by any application or workflow with only the information about this one structure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order for the ingested raw data to be converted into WKS, you must create a mapping definition. Mapping definitions carry the details of structural transformations of user data into WKS.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The transformations are performed by the WKS Transformation service; the WKS Transformation service is the direct consumer of mapping definitions in the system."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mapping service enables users to define these mapping definitions. It provides an API to create, update, and obtain previously created mapping definitions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a mapping definition from a given source schema to a target (WKS) schema is available, the newly ingested and updated records that conform to the source schema are transformed into the target (WKS) schema data using these definitions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transformation operations for a record, for example from raw to a WKS, happen in the sequential order of the operations provided in a mapping file. It is important that you place the operations in the mapping file in the correct order."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"concepts","__idx":2},"children":["Concepts ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"concepts"},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Source schema"]},": Refers to the original structural representation of the data that is ingested."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Target schema"]},": Refers to the WKS schema to which the original data will be transformed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping definition"]},": Contains mapping identity information and a list of mapped attributes from the original schema to the target schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping definition kind"]},": Like the schema for an entity, a mapping definition also has a schema. The kind of the mapping definition uniquely defines the schema of the mapping definition.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For example, mapping kind '",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},":mapping:mapping:1.2.3' defines the mapping schema from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]}," as having a major version of 1, a minor version of 2, and a patch version of 3.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The mapping schema kind is '",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},".mapping:mapping:1.0.0' in the current Mapping service, and you cannot modify the mapping definition schema kind."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping definition versions"]},": They are immutable. If an existing mapping definition is updated using the PUT API, a newer version is created. The latest mapping definition version is used by default."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping definition uniqueness"]},": The mapping definition is unique for a given major version of a source and target schema pair. A mapping definition is uniquely identified by the mapping identity information which includes:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mapping authority"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mapping Kind"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Source schema details (sourceAuthority : sourceSource : sourceEntity : sourceMajorVersion)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Target schema details (targetAuthority : targetSource : targetEntity : targetMajorVersion)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping definition scope"]},": Mapping definitions defined using the Mapping service have a scope value INTERNAL.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["INTERNAL"]},": A mapping definition with an INTERNAL scope is defined in a specific data partition and is available only to the users of that data partition."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping identifier"]},": This unique string value is used to identify each mapping operation within the mapping list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mapping operation"]},": Declares how and from where the value for a given target property name is populated during WKS transformation. It is this collection of operations that maps the source raw data to target WKS data."," ","The following tables describe the attributes of the operation and how to use them."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operation-types","__idx":3},"children":["Operation types ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"operationTypes"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mapping service currently supports the following mapping operation types:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation type"},"children":["Operation type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["COPY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Copies simple attributes or a single element of an array to a target array element."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["COPY_SUBSTRUCTURE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Copies an entire substructure from the source property into the target property given that the source property is a json substructure ."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RELATIONSHIP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supports linkage of a related target record to a related parentRecord during the transformation.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," A raw record, called a parentRecord, maintains relationships with one or more other records, called a relatedRecord, using attributes such as \"x-osdu-relationship\" in the schema. Target records generated from such a parentRecord hold the relationship with the targetrRecords of the relatedRecord."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RELATIONSHIP_ARRAY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to define a relationship based on an entire array or list of source properties."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CONSTANT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supports copying a static constant value to the target attribute."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AGGREGATE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to define sub operations that need to be aggregated as a single logical entity.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Aggregate operations can be used for the following use cases: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," -Ensures the handling of complex constructs as a logical entity. Examples: vertical measurements, geo contexts, spatial location. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," -Gives the user the flexibility to define various mappings together to ensure the completeness of the logical entity. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," -Supports conditions to ensure the sanctity of the logical entity. Supported condition types are: ifAnyExists, ifAllExists, ifNotExists, and equals."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CONCATENATE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Concatenates multiple values. This is the use case where multiple values from the source property will be concatenated by using an operator. There are no limitations for the operator. It can be anything, such as \"-\" or \"+\", used to compute another value in the target property.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Example: The two source properties, UWI and UBHI, will compute one value in the target property WellboreId. Well head is identified by UWI and all sidetrack wellbores have a UBHI ID. So each wellbore ID can be defined by concatenating UWI+UBHI."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["COPY_ARRAY_INDEX"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Copies the value of \"#\" in the target property. The target property captures the index value of the object. \"#\" indicates the index of the array where the object will be copied."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CONDITIONAL_PRIORITY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This container operation holds sub operations with different conditions and priorities. The conditions are evaluated on the basis of the priority of the operations.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The operations are evaluated from highest priority to the lowest priority. When any of the operations succeed, all the rest of the operations with descending priority are not evaluated further.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Example: The operation with priority=1 is computed first. If it succeeds, then the operations with a lower priority are not computed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["REFERENCE_LOOKUP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to transform OSDU reference data attributes. The operation searches the reference data catalogs based on the provided search parameters and then copies the retrieved reference data value to the target."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LOOKUP_BY_QUERY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to perform a lookup against master data/reference data type relationship attributes. The operation copies the retrieved reference/master data value to the target based on the search criteria provided in the mappings."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operation-conditions","__idx":4},"children":["Operation conditions ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"operationConditions"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mapping service provides the following conditions that you can combine with mapping operations to support the sanctity of complex logical entities:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Condition"},"children":["Condition"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["equals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to validate the equality of a specific value and the value of the included source or target attributes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ifAnyExists"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to validate the existence of any one of the included source or target attributes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ifAllExists"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to validate the existence of all the included source or target attributes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ifNotExists"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to validate the non existence of all the included source or target attributes."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-points-to-note-while-creating-a-mapping-definition","__idx":5},"children":["Key points to note while creating a mapping definition:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only the AND operation is allowed to be used with conditions, such as ifAllExists, ifAnyExists, ifNotExists, and equals and not the OR operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[]"]}," Denotes array operations. An operation that contains empty square brackets is not a valid operation. Only inegers, '*', and '#' are allowed inside square brackets [].",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[n]"]}," Denotes the nth index of an array, such as 1,2, or 3. This is usefule for COPY and RELATIONSHIP operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[*]"]}," Denotes all indexes of the array. This is useful for COPY, RELATIONSHIP, and RELATIONSHIP_ARRAY operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[#]"]}," Denotes any index of the array. The new index is calculated and appended to the array if it exists. If an array does not exist, it will be created. This is useful for operations that are combined with the AGGREGATE operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[?]"]}," Denotes the specific index of the array from which the value should be copied. The operation always evaluates to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}," value which will be the index of the array object (source or target array object)."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["@"]}," Indicates that the value of the attribute mentioned in the \"value\" parameter should be considered from the source or target record. For example: \"value\": \"@sourceProperty:data.wellHeadProjected.elevationFromMsl.unitKey\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["label"]}," When using a REFERENCE_LOOKUP operation or LOOKUP_BY_QUERY operation for transformation, The looked-up value can be stored in a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}," and can be called multiple times during the transformation of the given record. This avoids multiple search calls and optimizes transformation performance. Note that the scope of the label-value is limited to the current record transformation by the WKS Service."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["isCaseInsensitiveExactMatch"]}," Case Insensitive Exact Match refers to the comparison that ignores the distinction between uppercase and lowercase letters. In order to perform transformation using LOOKUP_BY_QUERY operation for related reference and master data, the flexibility to perform case sensitive/insensitive lookup is required. The data manager can make a choice while doing the configuration. Adding the attribute ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isCaseInsensitiveExactMatch"]}," in the mapping configuration enables a case-insensitive exact match lookup."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example of a source to target record transformation using a relevant mapping file explains all the previously mentioned operations and conditions as per their actual use:"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" Source record "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"," ","\"data\": {"," ","\"country\": \"US\","," ","\"name\": \"Newton 2-31-Lat-1\","," ","\"state\": \"Arizona\","," ","\"NameAliases\": ["," ","{"," ","\"AliasName\": \"Example AliasName One\","," ","\"AliasNameTypeID\": \"namespace:reference-data--AliasNameType:RegulatoryIdentifier:\","," ","\"DefinitionOrganisationID\": \"namespace:master-data--Organisation:SomeUniqueOrganisationID:\","," ","\"EffectiveDateTime\": \"2020-02-13T09:13:15.55Z\","," ","\"TerminationDateTime\": \"2020-02-13T09:13:15.55Z\""," ","},"," ","{"," ","\"AliasName\": \"Example AliasName Two\","," ","\"AliasNameTypeID\": \"namespace:reference-data--AliasNameType:RegulatoryIdentifier:\","," ","\"DefinitionOrganisationID\": \"namespace:master-data--Organisation:SomeUniqueOrganisationID:\","," ","\"EffectiveDateTime\": \"2019-07-24T05:12:11.55Z\","," ","\"TerminationDateTime\": \"2020-09-11T03:12:11.55Z\""," ","}"," ","],"," ","\"Measurements\": ["," ","{"," ","\"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\","," ","\"TerminationDateTime\": \"2020-02-13T09:13:15.55Z\""," ","},"," ","{"," ","\"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\","," ","\"TerminationDateTime\": \"2020-02-13T09:13:15.55Z\""," ","}"," ","],"," ","\"well\": {"," ","\"id\": \"namespace:master-data--Well:6c60ceb0-3521-57b7-9bd8-e1d7c9f6623\","," ","\"name\": \"Newton 2-31-Lat-1\""," ","},"," ","\"TrajectoryTypeID\": \"namespace:reference-data--WellboreTrajectoryType:Vertical:\","," ","\"ResourceHostRegionIDs\": ["," ","\"namespace:reference-data--OSDURegion:AWSEastUSA:\","," ","\"namespace:reference-data--OSDURegion:AWSWestUSA:\""," ","],"," ","\"LogSets\": ["," ","\"namespace:logSet:1ab6e370c6dd4e269243cf05b4ec5a14\","," ","\"namespace:logSet:2fg4e260c8dd4e169240cf15b4ec6b36\""," ","],"," ","\"totalDepthMd\": {"," ","\"value\": 34,"," ","\"unitKey\": \"m\""," ","},"," ","\"elevationReference\": {"," ","\"elevationFromMsl\": {"," ","\"value\": 30,"," ","\"unitKey\": \"ft\""," ","},"," ","\"name\": \"KB\""," ","},"," ","\"locationWGS84\": {"," ","\"features\": ["," ","{"," ","\"geometry\": {"," ","\"coordinates\": ["," ","-88.249008,"," ","65.93041"," ","],"," ","\"type\": \"Point\""," ","},"," ","\"properties\": {"," ","\"name\":  \"Raw Record\""," ","},"," ","\"type\": \"Feature\""," ","}"," ","],"," ","\"type\": \"FeatureCollection\""," ","},"," ","\"wellHeadProjected\": {"," ","\"crsKey\": \"GCS_WGS_1984\","," ","\"x\": -12.5399,"," ","\"y\": 35.4635,"," ","\"elevationFromMsl\": {"," ","\"value\": 421.11,"," ","\"unitKey\": \"m\""," ","}"," ","},"," ","\"wellHeadWgs84\": {"," ","\"latitude\": -14.5399,"," ","\"longitude\": 31.4635"," ","}"," ","},"," ","\"meta\": ["," ","{"," ","\"kind\": \"CRS\","," ","\"name\": \"GCS_WGS_1984\","," ","\"persistableReference\": \"{\"wkt\":\"GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433],AUTHORITY[\"EPSG\",4326]]\",\"ver\":\"PE_10_3_1\",\"name\":\"GCS_WGS_1984\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"4326\"},\"type\":\"LBC\"}\","," ","\"propertyNames\": ["," ","\"wellHeadProjected.x\","," ","\"wellHeadProjected.y\","," ","\"wellHeadWgs84.latitude\","," ","\"wellHeadWgs84.longitude\""," ","]"," ","},"," ","{"," ","\"kind\": \"Unit\","," ","\"name\": \"m\","," ","\"persistableReference\": \"{\"scaleOffset\":{\"scale\":1.0,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"L\",\"type\":\"UM\"},\"type\":\"USO\"}\","," ","\"propertyNames\": ["," ","\"wellHeadProjected.elevationFromMsl.value\","," ","\"totalDepthMd.value\""," ","]"," ","},"," ","{"," ","\"kind\": \"Unit\","," ","\"name\": \"ft\","," ","\"persistableReference\": \"{\"scaleOffset\":{\"scale\":0.3048,\"offset\":0.0},\"symbol\":\"ft\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}\","," ","\"propertyNames\": ["," ","\"elevationReference.elevationFromMsl.value\""," ","]"," ","}"," ","],"," ","\"kind\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},":petrel:wellbore:1.0.6\","," ","\"acl\": {"," ","\"viewers\": ["," ","\"<acl_viewers>\""," ","],"," ","\"owners\": ["," ","\"<acl_owners>\""," ","]"," ","},"," ","\"legal\": {"," ","\"legaltags\": ["," ","\"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<legaltags>"]},"\""," ","],"," ","\"otherRelevantDataCountries\": ["," ","\"US\""," ","]"," ","}"," ","}"]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" Mapping file "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"," ","\"mappingIdentity\": {"," ","\"authority\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},"\","," ","\"sourceSchema\": {"," ","\"authority\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},"\","," ","\"source\": \"petrel\","," ","\"entityType\": \"wellbore\","," ","\"schemaVersionMajor\": 1"," ","},"," ","\"targetSchema\": {"," ","\"authority\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},"\","," ","\"source\": \"wks\","," ","\"entityType\": \"wellbore\","," ","\"schemaVersionMajor\": 1"," ","}"," ","},"," ","\"mappings\": ["," ","{"," ","\"identifier\": \"name\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY \","," ","\"sourceProperty\": \"data.name\","," ","\"targetProperty\": \"data.WellName\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"country\","," ","\"operations\": ["," ","{"," ","\"type\": \"CONCATENATE\","," ","\"operator\": \"-\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.country\""," ","},"," ","{"," ","\"sourceProperty\": \"data.state\""," ","}"," ","],"," ","\"targetProperty\": \"data.Country\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"Measurements.EffectiveTimestamp\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.Measurements[",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["].EffectiveTimestamp\","," ","\"targetProperty\": \"data.Measurements["]},"].EffectiveDateTime\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"NameAliases\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.NameAliases[1]\","," ","\"targetProperty\": \"data.NameAliases[0]\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"locationWGS84\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY_SUBSTRUCTURE\","," ","\"sourceProperty\": \"data.locationWGS84\","," ","\"targetProperty\": \"data.locationWGS84\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"WellandTrajectoryTypeId\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP\","," ","\"sourceProperty\": \"data.well.id\","," ","\"targetProperty\": \"data.WellID\""," ","},"," ","{"," ","\"type\": \"RELATIONSHIP\","," ","\"sourceProperty\": \"data.TrajectoryTypeID\","," ","\"targetProperty\": \"data.TrajectoryTypeID\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"ResourceHostRegionIDs\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP_ARRAY\","," ","\"sourceProperty\": \"data.ResourceHostRegionIDs[",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["]\","," ","\"targetProperty\": \"data.ResourceHostRegionIDs["]},"]\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"LogSet\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP\","," ","\"sourceProperty\": \"data.LogSets[1]\","," ","\"targetProperty\": \"data.LogSet.ids[0]\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"data.elevationReference.name\","," ","\"operations\": ["," ","{"," ","\"type\": \"AGGREGATE\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY_ARRAY_INDEX\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.elevationReference.name\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.elevationReference.elevationFromMsl.value\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.elevationReference.elevationFromMsl.unitKey\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\""," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV:\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAllExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.elevationReference.name\""," ","},"," ","{"," ","\"sourceProperty\": \"data.elevationReference.elevationFromMsl.value\""," ","},"," ","{"," ","\"sourceProperty\": \"data.elevationReference.elevationFromMsl.unitKey\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONDITIONAL_PRIORITY\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourcProperty\": \"data.name\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\","," ","\"priority\": 1,"," ","\"andCondition\": ["," ","{"," ","\"type\": \"equals\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.name\","," ","\"value\": \"KB\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Test Value\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\","," ","\"priority\": 2"," ","}"," ","]"," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"data.totalDepthMd.value\","," ","\"operations\": ["," ","{"," ","\"type\": \"AGGREGATE\","," ","\"operations\": ["," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Total Depth MD\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\""," ","},"," ","{"," ","\"type\": \"COPY_ARRAY_INDEX\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.totalDepthMd.value\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"equals\","," ","\"attributes\": ["," ","{"," ","\"value\": \"ft\","," ","\"sourceProperty\": \"data.totalDepthMd.unitKey\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.totalDepthMd.unitKey\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\""," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:MD:\","," ","\"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAnyExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.totalDepthMd.value\""," ","},"," ","{"," ","\"sourceProperty\": \"data.totalDepthMd.unitKey\""," ","}"," ","]"," ","}"," ","]"," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"data.SpatialLocation\","," ","\"operations\": ["," ","{"," ","\"type\": \"AGGREGATE\","," ","\"operations\": ["," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"{{NAMESPACE}}:reference-data--SpatialGeometryType:Point:0\","," ","\"targetProperty\": \"data.SpatialLocation.SpatialGeometryTypeID\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAllExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.x\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.y\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"{{NAMESPACE}}:reference-data--SpatialGeometryType:Point:0\","," ","\"targetProperty\": \"data.SpatialLocation.SpatialGeometryTypeID\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAllExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.elevationFromMsl.value\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadProjected.crsKey\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.CoordinateReferenceSystemID\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadProjected.x\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.coordinates[0]\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadProjected.y\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.coordinates[1]\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.coordinates[2]\""," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Point\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAllExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.x\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.y\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Point\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAllExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.elevationFromMsl.value\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Feature\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAnyExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.x\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.y\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"FeatureCollection\","," ","\"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAnyExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.x\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.y\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\","," ","\"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].geometry.coordinates[0]\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\","," ","\"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].geometry.coordinates[1]\""," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Point\","," ","\"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].geometry.type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAllExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"Feature\","," ","\"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAnyExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\""," ","}"," ","]"," ","}"," ","]"," ","},"," ","{"," ","\"type\": \"CONSTANT\","," ","\"value\": \"FeatureCollection\","," ","\"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.type\","," ","\"andCondition\": ["," ","{"," ","\"type\": \"ifAnyExists\","," ","\"attributes\": ["," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\""," ","},"," ","{"," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\""," ","}"," ","]"," ","}"," ","]"," ","}"," ","]"," ","}"," ","]"," ","}"," ","]"," ","}"]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" Target record "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"," ","\"data\": {"," ","\"WellName\": \"Newton 2-31-Lat-1\","," ","\"Country\": \"US-Arizona\","," ","\"NameAliases\": ["," ","{"," ","\"AliasName\": \"Example AliasName Two\","," ","\"AliasNameTypeID\": \"namespace:reference-data--AliasNameType:RegulatoryIdentifier:\","," ","\"DefinitionOrganisationID\": \"namespace:master-data--Organisation:SomeUniqueOrganisationID:\","," ","\"EffectiveDateTime\": \"2019-07-24T05:12:11.55Z\","," ","\"TerminationDateTime\": \"2020-09-11T03:12:11.55Z\""," ","}"," ","],"," ","\"Measurements\": ["," ","{"," ","\"EffectiveDateTime\": \"2020-02-13T09:13:15.55Z\""," ","},"," ","{"," ","\"EffectiveDateTime\": \"2020-02-13T09:13:15.55Z\""," ","}"," ","],"," ","\"WellID\": \"namespace:master-data--Well:6c60ceb0-3521-57b7-9bd8-e1d7c9f6623\","," ","\"TrajectoryTypeID\": \"namespace:reference-data--WellboreTrajectoryType:Vertical:\","," ","\"ResourceHostRegionIDs\": ["," ","\"namespace:reference-data--OSDURegion:AWSEastUSA:\","," ","\"namespace:reference-data--OSDURegion:AWSWestUSA:\""," ","],"," ","\"LogSets\":"," ","{"," ","\"ids\":"," ","["," ","\"namespace:logSet:2fg4e260c8dd4e169240cf15b4ec6b36\""," ","]"," ","},"," ","\"VerticalMeasurements\": ["," ","{"," ","\"VerticalMeasurementID\": 0,"," ","\"VerticalMeasurement\": 30,"," ","\"VerticalMeasurementTypeID\": \"KB\","," ","\"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV:\","," ","\"VerticalMeasurementUnitOfMeasureID\": \"ft\","," ","\"VerticalCRSID\": \"KB\""," ","},"," ","{"," ","\"VerticalMeasurementID\": 1,"," ","\"VerticalMeasurementTypeID\": \"Total Depth MD\","," ","\"VerticalMeasurement\": 34,"," ","\"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:MD:\","," ","\"VerticalMeasurementUnitOfMeasureID\": \"m\""," ","}"," ","],"," ","\"locationWGS84\": {"," ","\"features\": ["," ","{"," ","\"geometry\": {"," ","\"coordinates\": ["," ","-88.249008,"," ","65.93041"," ","],"," ","\"type\": \"Point\""," ","},"," ","\"properties\": {"," ","\"name\":  \"Raw Record\""," ","},"," ","\"type\": \"Feature\""," ","}"," ","],"," ","\"type\": \"FeatureCollection\""," ","},"," ","\"SpatialLocation\": {"," ","\"AsIngestedCoordinates\": {"," ","\"type\": \"FeatureCollection\","," ","\"CoordinateReferenceSystemID\": \"GCS_WGS_1984\","," ","\"SpatialGeometryTypeID\": \"{{NAMESPACE}}:reference-data--SpatialGeometryType:Point:0\","," ","\"persistableReferenceCrs\": \"{\"wkt\":\"GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433],AUTHORITY[\"EPSG\",4326]]\",\"ver\":\"PE_10_3_1\",\"name\":\"GCS_WGS_1984\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"4326\"},\"type\":\"LBC\"}\","," ","\"features\": ["," ","{"," ","\"type\": \"Feature\","," ","\"geometry\": {"," ","\"type\": \"Point\","," ","\"coordinates\": ["," ","-12.5399,"," ","35.4635,"," ","421.11"," ","]"," ","}"," ","}"," ","]"," ","},"," ","\"Wgs84Coordinates\": {"," ","\"type\": \"FeatureCollection\","," ","\"features\": ["," ","{"," ","\"type\": \"Feature\","," ","\"geometry\": {"," ","\"type\": \"Point\","," ","\"coordinates\": ["," ","-14.5399,"," ","31.4635"," ","]"," ","}"," ","}"," ","]"," ","}"," ","}"," ","},"," ","\"meta\": ["," ","{"," ","\"kind\": \"CRS\","," ","\"name\": \"GCS_WGS_1984\","," ","\"persistableReference\": \"{\"wkt\":\"GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433],AUTHORITY[\"EPSG\",4326]]\",\"ver\":\"PE_10_3_1\",\"name\":\"GCS_WGS_1984\",\"authCode\":{\"auth\":\"EPSG\",\"code\":\"4326\"},\"type\":\"LBC\"}\","," ","\"propertyNames\": ["," ","\"SpatialLocation.Wgs84Coordinates\""," ","]"," ","},"," ","{"," ","\"kind\": \"Unit\","," ","\"name\": \"ft\","," ","\"persistableReference\": \"{\"scaleOffset\":{\"scale\":0.3048,\"offset\":0.0},\"symbol\":\"ft\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}\","," ","\"propertyNames\": ["," ","\"VerticalMeasurements[0].VerticalMeasurement\""," ","]"," ","},"," ","{"," ","\"kind\": \"Unit\","," ","\"name\": \"m\","," ","\"persistableReference\": \"{\"scaleOffset\":{\"scale\":0.3048,\"offset\":0.0},\"symbol\":\"m\",\"baseMeasurement\":{\"ancestry\":\"Length\",\"type\":\"UM\"},\"type\":\"USO\"}\","," ","\"propertyNames\": ["," ","\"VerticalMeasurements[1].VerticalMeasurement\""," ","]"," ","}"," ","],"," ","\"kind\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},":wks:wellbore:1.0.6\","," ","\"acl\": {"," ","\"viewers\": ["," ","\"<acl_viewers>\""," ","],"," ","\"owners\": ["," ","\"<acl_owners>\""," ","]"," ","},"," ","\"legal\": {"," ","\"legaltags\": ["," ","\"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<legaltags>"]},"\""," ","],"," ","\"otherRelevantDataCountries\": ["," ","\"US\""," ","]"," ","}"," ","}"]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":6},"children":["Use cases ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"copy-and-copy_substructure-operations","__idx":7},"children":["COPY and COPY_SUBSTRUCTURE operations ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"copy_copy_substr_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The COPY operation supports the copying of simple attributes or a single element of an array to a target array element."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-1-copy-operation---mapping-elements-of-array","__idx":8},"children":["Use case 1: COPY operation - Mapping elements of array"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example an attribute in an array element is mapped to a target array element. This renaming must be applied to all the indexes of the array. The size of the array in the target record remains the same as in the raw source record."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"Measurements\": [\n      {\n        \"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\"\n      },\n      {\n        \"EffectiveTimestamp\": \"2019-11-10T11:15:40.55Z\"\n      }\n    ]\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":[" \n{\n  \"mappings\": [{\n    \"identifier\": \"data.Measurements.EffectiveTimestamp\",\n    \"operations\": [\n      {\n        \"type\": \"COPY\",\n        \"sourceProperty\": \"data.Measurements[*].EffectiveTimestamp\",\n        \"targetProperty\": \"data.VerticalMeasurements[*].EffectiveDateTime\"\n      }\n    ]\n  }]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\" : [ \n      {\n      \"EffectiveDateTime\" : \"2020-02-13T09:13:15.55Z\"\n      }, \n      {\n      \"EffectiveDateTime\" : \"2019-11-10T11:15:40.55Z\"\n      } \n    ]\n  }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-2-copy-operation---complete-array-mapping","__idx":9},"children":["Use case 2: COPY operation - Complete array mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, a complete array element is mapped to a target array. This mapping changes only the name of the array. The index attributes are copied as it is from RAW to WKS record. The size of the WKS target record remains the same as it is in the raw source record."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n  \"data\": {\n    \"Measurements\": [\n      {\n        \"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\",\n        \"TerminationDateTime\": \"2022-11-10T11:15:40.55Z\"\n      },\n      {\n        \"EffectiveTimestamp\": \"2019-11-20T09:15:15.55Z\",\n        \"TerminationDateTime\": \"2022-11-10T11:15:40.55Z\"\n      }\n    ]\n  }\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n  \"mappings\": [{\n    \"identifier\": \"data.Measurements\",\n    \"operations\": [\n      {\n        \"type\": \"COPY\",\n        \"sourceProperty\": \"data.Measurements[*]\",\n        \"targetProperty\": \"data.VerticalMeasurements[*]\"\n      }\n    ]\n  }]\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n\"data\": {\n    \"VerticalMeasurements\" : [ \n      {\n        \"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\",\n        \"TerminationDateTime\": \"2022-11-10T11:15:40.55Z\"\n      },\n      {\n        \"EffectiveTimestamp\": \"2019-11-20T09:15:15.55Z\",\n        \"TerminationDateTime\": \"2022-11-10T11:15:40.55Z\"\n      } \n    ]\n  }\n}\n```\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-3-copy_substructure-operation---entire-substructure-mapping","__idx":10},"children":["Use case 3: COPY_SUBSTRUCTURE operation - Entire substructure mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The COPY_SUBSTRUCTURE operation is used to copy an entire substructure from the source property into the target property, given that the source property is a json substructure."," ","In the following example, the whole substructure of sourceProperty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LOCATION_WGS84"]}," is copied as it is to the targetProperty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locationWGS84"]},"."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n  \"data\": {\n    \"LOCATION_WGS84\": {\n      \"features\": [\n        {\n          \"geometry\": {\n            \"coordinates\": [\n              -88.249008,\n              65.93041\n            ],\n            \"type\": \"Point\"\n          },\n          \"properties\": {\n             \"name\": \"Raw Record\"\n          },\n          \"type\": \"Feature\"\n        }\n     ],\n     \"type\": \"FeatureCollection\"\n    }\n  }\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n  \"mappings\": [{\n    \"identifier\": \"locationWGS84\",\n     \"operations\": [\n       {\n         \"type\": \"COPY_SUBSTRUCTURE\",\n         \"sourceProperty\": \"data.LOCATION_WGS84\",\n         \"targetProperty\": \"data.locationWGS84\"\n       }\n     ]\n  }]\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n\"data\": {\n    \"locationWGS84\": {\n      \"features\": [\n        {\n          \"geometry\": {\n            \"coordinates\": [\n              -88.249008,\n              65.93041\n            ],\n            \"type\": \"Point\"\n          },\n          \"properties\": {\n            \"name\":  \"Raw Record\"\n          },\n          \"type\": \"Feature\"\n        }\n    ],\n    \"type\": \"FeatureCollection\"\n    }\n  }\n}\n```\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"copy-operation-with-arrayindex-use-cases","__idx":11},"children":["COPY operation with arrayIndex use cases ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"copy_with_arrayIndex"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The COPY operation with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," property is an operation that copies the value of a specific array index to an object in the target array.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The arrayIndex schema provides a condition that is used to evaluate from which index in the array the value should be copied. When the condition is met, the value will be copied.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"It works with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[?]"]}," array type used to denote the specific index of the array from which the value should be copied. The operation always evaluates to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}," value which is the index of the array object.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," attribute in the operation has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetProperty"]}," defined, then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}," indicates the index of the target object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," is computed on the complete array object. So, the pre-requisite is that the array object mapping (AGGREGATE operations) is already provided before the COPY operation with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"copy-operation-with-arrayindex---example-1","__idx":12},"children":["COPY operation with arrayIndex - Example 1"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Used outside AGGREGATE new attribute outside the array will be created, and the value will be copied there.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"In the following example when all three AGGREGATE operations are complete, the COPY operation with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," is evaluated."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\""]}," will be copied to the target ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.DefaultVerticalMeasurementID"]}," in a newly created attribute, only if the condition in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," is evaluated. This condition returns an array index value."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]},", you should define the condition that will help evaluate the array index ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[?]"]}," from which the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID"]}," should be taken for a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COPY"]}," operation."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The condition returns the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array index(?)"]}," where the value in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"targetProperty\": \"data.VerticalMeasurements[?].VerticalMeasurementID\""]}," is equal to the value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Measured_From"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Now that the value of arrayIndex (?) is evaluated, the COPY operation can evaluate the value to copy using the following statement:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"type\": \"COPY\",\n\"targetProperty\": \"data.DefaultVerticalMeasurementID\",\n\"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\""]}," will be copied to a new attribute called ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DefaultVerticalMeasurementID"]}," outside the vertical measurement array."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," condition evaluates to the zeroth index in the array. Then a new attribute, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DefaultVerticalMeasurementID"]},", is created with the value copied from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VerticalMeasurementID"]}," from the zeroth index."]}]}]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n  \"data\": {\n     \"ELEV_RT\": 42.51,\n      \"MD_TD\": 2790.0,\n      \"TVD_TD\": 2543.27\n  }\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n    \"mappings\": [\n        {\n            \"identifier\": \"data.VerticalMeasurements\",\n            \"operations\": [\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"Measured_From\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.ELEV_RT\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--VerticalMeasurementType:RT:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--VerticalMeasurementPath:ELEV:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\"\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"TD-Original\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.MD_TD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--VerticalMeasurementType:TD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--VerticalMeasurementPath:MD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition_id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"TVD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVD_TD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--VerticalMeasurementType:TD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition_id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition_id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"COPY\",\n                    \"targetProperty\": \"data.DefaultVerticalMeasurementID\",\n                    \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                    \"arrayIndex\": {\n                        \"targetProperty\": \"data.VerticalMeasurements[?].VerticalMeasurementID\",\n                        \"value\": \"Measured_From\"\n                    }\n                }\n            ]\n        }\n    ]\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n    \"data\": {\n        \"VerticalMeasurements\": [\n            {\n                \"VerticalMeasurementID\": \"Measured_From\",\n                \"VerticalMeasurement\": 42.51,\n                \"VerticalMeasurementTypeID\": \"partition_id:reference-data--VerticalMeasurementType:RT:\",\n                \"VerticalMeasurementPathID\": \"partition_id:reference-data--VerticalMeasurementPath:ELEV:\",\n                \"VerticalMeasurementUnitOfMeasureID\": \"partition_id:reference-data--UnitOfMeasure:m:\",\n                \"VerticalCRSID\": \"partition_id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n            }, \n            {\n                \"VerticalMeasurementID\": \"TD-Original\",\n                \"VerticalMeasurement\": 2790.0,\n                \"VerticalMeasurementTypeID\": \"partition_id:reference-data--VerticalMeasurementType:TD:\",\n                \"VerticalMeasurementPathID\": \"partition_id:reference-data--VerticalMeasurementPath:MD:\",\n                \"VerticalMeasurementUnitOfMeasureID\": \"partition_id:reference-data--UnitOfMeasure:m:\",\n                \"VerticalReferenceID\": \"Measured_From\"\n            }, \n            {\n                \"VerticalMeasurementID\": \"TVD\",\n                \"VerticalMeasurement\": 2543.27,\n                \"VerticalMeasurementTypeID\": \"partition_id:reference-data--VerticalMeasurementType:TD:\",\n                \"VerticalMeasurementPathID\": \"partition_id:reference-data--VerticalMeasurementPath:TVD:\",\n                \"VerticalMeasurementUnitOfMeasureID\": \"partition_id:reference-data--UnitOfMeasure:m:\",\n                \"VerticalReferenceID\": \"Measured_From\"\n            }\n        ],\n        \"DefaultVerticalMeasurementID\": \"Measured_From\"\n    }\n}\n```\n"]}]}]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"copy-operation-with-arrayindex---example-2","__idx":13},"children":["COPY operation with arrayIndex - Example 2"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example the COPY operation with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," inside the last AGGREGATE operation is pointing to the element that has the ReferenceID property and not a VerticalCRSID."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\""]}," is copied to the target ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.VerticalMeasurements[#].VerticalReferenceID"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," in the last object in the target array only if the condition in the arrayIndex is evaluated. This condition returns an array index value."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]},", you should define the condition that will help evaluate the array index ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[?]"]}," from which the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID"]}," should be used for a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COPY"]}," operation."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The condition returns the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["array index(?)"]}," where the value in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"targetProperty\": \"data.VerticalMeasurements[?].VerticalMeasurementTypeID\""]}," is equal to the value ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partition-id:reference-data--VerticalMeasurementType:DL:"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Now that the value of arrayIndex (?) is evaluated, the COPY operation can evaluate the value to copy using the following statement:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"type\": \"COPY\",\n\"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n\"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\"\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\""]}," is copied to the last element in the vertical measurement array in a new attribute called ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VerticalReferenceID"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arrayIndex"]}," condition in the last AGGREGATE operation evaluates to the second index in the array. Then the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VerticalReferenceID"]}," property is created in the last object with the value copied from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VerticalMeasurementID"]}," from the second index."]}]}]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{"style":{"width":"33%"}},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n  \"data\": {\n    \"ELEV_MSL\": 0,\n    \"ELEV_DL\": 25.0,\n    \"TVD_MLS\": 76.5,\n    \"TVDVRS_TD\": 1300.0,\n    \"TVDZDP_TD\": 1325.0\n  }\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```\n{\n    \"mappings\": [\n        {\n            \"identifier\": \"data.VerticalMeasurements\",\n            \"operations\": [\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"MSL EPSG:5714\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.ELEV_MSL\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:MSL:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\"\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"DF 25 m\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.ELEV_DL\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:DL:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"SF 76.5 m\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVD_MLS\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:MLS:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"TD TVDVRS\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVDVRS_TD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"TD TVDZDP\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVDZDP_TD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalMeasurementTypeID\",\n                                \"value\": \"partition-id:reference-data--VerticalMeasurementType:DL:\"\n                            },\n                            \"andCondition\": [\n                                {\n                                    \"type\": \"ifNotExists\",\n                                    \"attributes\": [\n                                        {\n                                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\"\n                                        }\n                                    ]\n                                }\n                            ]\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n\t\"VerticalMeasurements\": [\n        {\n            \"VerticalMeasurementID\": \"MSL EPSG:5714\",\n            \"VerticalMeasurement\": 0,\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:MSL:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n            \"VerticalCRSID\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n        }, \n        {\n            \"VerticalMeasurementID\": \"DF 25 m\",\n            \"VerticalMeasurement\": 25.0,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:DL:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n            \"VerticalReferenceID\": \"MSL EPSG:5714\"\n        }, \n        {\n            \"VerticalMeasurementID\": \"SF 76.5 m\",\n            \"VerticalMeasurement\": 76.5,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:MLS:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n            \"VerticalReferenceID\": \"MSL EPSG:5714\"\n        }, \n        {\n            \"VerticalMeasurementID\": \"TD TVDVRS\",\n            \"VerticalMeasurement\": 1300.0,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n            \"VerticalReferenceID\": \"MSL EPSG:5714\"\n        }, \n        {\n            \"VerticalMeasurementID\": \"TD TVDZDP\",\n            \"VerticalMeasurement\": 1325.0,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n            \"VerticalReferenceID\": \"DF 25 m\"\n        }\n    ]\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"constant-operation","__idx":14},"children":["CONSTANT operation ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"constant_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the CONSTANT operation to copy a static constant value to the target attribute."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-4-constant-operation","__idx":15},"children":["Use case 4: CONSTANT operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetProperty"]}," is a constant provided in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}," attribute. No data is taken from the raw record. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["valueType"]}," is an optional attribute to define the type of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]},". Supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["valuetypes"]}," are - integer, float, string, boolean."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"UWI\": \"FQ2129\",\n    \"UBHI\": \"0\"\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": {\n    \"identfier\": \"Constants_LookUp_VerticalMeasurementPathID\",\n    \"operations\": [\n      {\n        \"type\": \"CONSTANT\",\n        \"value\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:MD:\",\n        \"targetProperty\": \"data.VerticalMeasurements[0].VerticalMeasurementPathID\"\n      },\n      {\n        \"type\": \"CONSTANT\",\n        \"value\": \"Total Depth MD\",\n        \"targetProperty\": \"data.VerticalMeasurements[1].VerticalMeasurementID\"\n      },\n      {\n        \"type\": \"CONSTANT\",\n        \"value\": \"123\",\n        \"valueType\": \"integer\"\n        \"targetProperty\": \"data.VerticalMeasurements[2].VerticalMeasurement\"\n      },\n      {\n        \"type\": \"CONSTANT\",\n        \"value\": \"2020-02-13T09:13:15.55Z\",\n        \"valueType\": \"string\"\n        \"targetProperty\": \"data.VerticalMeasurements[3].EffectiveTimestamp\"\n      }\n    ]\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\": [\n      {\n        \"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:MD:\"\n      },\n      {\n        \"VerticalMeasurementID\": \"Total Depth MD\"\n      },\n      {\n        \"VerticalMeasurement\": 123\n      },\n      {\n        \"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\"\n      }\n    ]\n  }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"array-operations","__idx":16},"children":["Array operations  ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"array_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Operations that include square brackets [] in target or source property attribute is an array operation. An operation that contains empty square brackets is not a valid operation. Only integers, '*', and '#' are allowed inside the square brackets []."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[n]"]}," Denotes the nth index of an array, such as 1,2, or 3. This is usefule for COPY and RELATIONSHIP operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[*]"]}," Denotes all indexes of the array. This is useful for COPY, RELATIONSHIP, and RELATIONSHIP_ARRAY operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[#]"]}," Denotes any index of the array. The new index is calculated and appended to the array if it exists. If an array does not exist, it will be created. This is useful for operations that are combined with the AGGREGATE operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["[?]"]}," Denotes the specific index of the array from which the value should be copied. The operation always evaluates to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}," value which will be the index of the array object (source or target array object)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-5-absolute-index-of-an-array-mapping","__idx":17},"children":["Use case 5: Absolute index of an array mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, a particular index of an attribute is mapped to a target. The size of the array depends on the specific mapping provided. For this use case, the array in target record will be 1 because only one index element mapping is provided."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"Measurements\": [\n      {\n        \"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\"\n      }\n    ]\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [{\n    \"identifier\": \"data.Measurements.EffectiveTimestamp\",\n    \"operations\": [\n      {\n        \"type\": \"COPY\",\n        \"sourceProperty\": \"data.Measurements[0].EffectiveTimestamp\",\n        \"targetProperty\": \"data.VerticalMeasurements[0].EffectiveDateTime\"\n      }\n    ]\n  }]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\": [\n      {\n        \"EffectiveDateTime\": \"2020-02-13T09:13:15.55Z\"\n      }\n    ]\n  }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-6-constants-for-absolute-index","__idx":18},"children":["Use case 6: Constants for absolute index"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, constant values are mapped to the target record's VerticalMeasurementPathID and VerticalMeasurementID attributes."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"Measurements\": [\n      {\n        \"VerticalMeasurementID\": \"Example VerticalMeasurementID\",\n        \"EffectiveTimestamp\": \"2020-02-13T09:13:15.55Z\",\n        \"VerticalMeasurement\": 12345.6,\n        \"TerminationDateTime\": \"2020-02-13T09:13:15.55Z\"\n      }\n    ]\n  }\n}      \n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["  \n{\n  \"mappings\": [{\n    \"identifier\": \"Constants_LookUp_VerticalMeasurementPathID\",\n    \"operations\": [\n      {\n        \"type\": \"CONSTANT\",\n        \"value\": \"datapartitionId:reference-data--VerticalMeasurementPath:MD:\",\n        \"targetProperty\": \"data.VerticalMeasurements[0].VerticalMeasurementPathID\"\n      },\n      {\n        \"type\": \"CONSTANT\",\n        \"value\": \"Total Depth MD\",\n        \"targetProperty\": \"data.VerticalMeasurements[1].VerticalMeasurementID\"\n      }\n    ]\n  }]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\": [\n      {\n        \"VerticalMeasurementPathID\": \"datapartitionId:reference-data--VerticalMeasurementPath:MD:\"\n      },\n      {\n        \"VerticalMeasurementID\": \"Total Depth MD\"\n      }\n    ]\n  }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-7-simple-attribute-to-array","__idx":19},"children":["Use case 7: Simple attribute to array"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this example, a simple attribute is mapped to a specific index of an array. Because this is a very specific use case to map a simple attribute to an array element, the size of the array would remain \"1\" as one mapping is provided in the example below."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"totalDepthMd\": {\n      \"value\": 34,\n      \"unitKey\": \"m\"\n    }\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [{\n    \"identifier\": \"SimpleAttribute_VerticalMeasurementID\",\n    \"operations\": [\n      {\n        \"type\": \"COPY\",\n        \"sourceProperty\": \"data.totalDepthMd.value\",\n        \"targetProperty\": \"data.VerticalMeasurements[0].VerticalMeasurement\"\n      }\n    ]\n  }]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\": [\n      {\n        \"VerticalMeasurement\": 34\n      }\n    ]\n  }\n}\n    "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-8-array-of-objects-to-an-array-of-values-of-any-type","__idx":20},"children":["Use case 8: Array of objects to an array of values of any type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Marker Name"]}," attribute from each object of Markers array is mapped to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Formation Name"]}," array in target property."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"Wellbore Name\": \"Ahuroa-4\",\n    \"Name\": \"Marker1\",\n    \"Markers\": [\n      {\n        \"Marker Name\": \"Check1\",\n        \"Marker Type\": \"Biostratigraphy\"\n      },\n      {\n        \"Top Depth\": \"2700\",\n        \"Marker Name\": \"Check2\",\n        \"Marker Type\": \"Biostratigraphy\"\n      },\n      {\n        \"Top Depth\": \"3230\",\n        \"Marker Name\": \"Check3\",\n        \"Marker Type\": \"Biostratigraphy\"\n      },\n      {\n        \"Top Depth\": \"3244\",\n        \"Marker Name\": \"Check4\",\n        \"Marker Type\": \"Biostratigraphy\"\n      },\n      {\n        \"Top Depth\": \"3300\",\n        \"Marker Name\": \"Check5\",\n        \"Marker Type\": \"Biostratigraphy\"\n      }\n    ]\n",{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["}"," "]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [\n    {\n      \"identifier\": \"data.Markers.MarkerName\",\n      \"operations\": [\n                {\n                    \"type\": \"COPY\",\n                    \"sourceProperty\": \"data.Markers[*].Marker Name\",\n                    \"targetProperty\": \"data.TargetMarkers.Formation Name[*]\"\n                }\n            ]\n    }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n     \"data\": {\n        \"TargetMarkers\": {\n            \"Formation Name\": [\n                \"Check1\",\n                \"Check2\",\n                \"Check3\",\n                \"Check4\",\n                \"Check5\"\n            ]\n        }\n    }\n}\n    "]}]}]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"concatenate-operation","__idx":21},"children":["CONCATENATE operation ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"concatenate_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The CONCATENATE operation concatenates multiple values. This is useful when multiple values from the source property need to be concatenated to compute another value using an operator.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Operators such as \"-\" or \"+\", can be used to compute another value in the target property."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-9-concatenate-operation","__idx":22},"children":["Use case 9: CONCATENATE operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the values from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceProperty"]}," attribute are concatenated using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operator"]}," attribute to the target property."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"UWI\": \"FQ2129\",\n    \"UBHI\": \"0431\"\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [{\n     \"identifier\": \"data.WellboreId\",\n     \"operations\": [\n       {\n         \"type\": \"CONCATENATE\",\n         \"operator\": \"-\",\n         \"attributes\": [\n           {\n             \"sourceProperty\": \"data.UWI\"\n           },\n           {\n             \"sourceProperty\": \"data.UBHI\"\n           }\n         ],\n         \"targetProperty\": \"data.WellboreId\"\n       }\n     ]\n    }]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"WellboreId\": \"FQ2129-0431\"\n  }\n}\n      "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"aggregate-copy_array_index-conditional_priority-operations","__idx":23},"children":["AGGREGATE, COPY_ARRAY_INDEX, CONDITIONAL_PRIORITY operations ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"aggregate_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Used to define sub operations that need to be aggregated as a single logical entity.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Aggregate operations can be used for the following use cases:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensures the handling of complex constructs as a logical entity. Examples: vertical measurements, geo contexts, spatial location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gives the user the flexibility to define various mappings together to ensure the completeness of the logical entity."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supports conditions to ensure the sanctity of the logical entity. Supported condition types are: ifAnyExists, ifAllExists, ifNotExists, and equals."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-10-aggregate-operations","__idx":24},"children":["Use case 10: AGGREGATE operations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is a mapping operation used to aggregate a set of sub operations as a single logical entity to apply to data.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"This example illustrates the application of AGGREGATE with regards to elevation measurement data."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"In the below example, andCondition will evaluate if any of the attributes \"data.totalDepthMd.value\" OR \"data.totalDepthMd.unitKey\" exists in the raw record , then the value of array element \"data.VerticalMeasurements[#].VerticalMeasurementPathID\" will be \"ABC:reference-data--VerticalMeasurementPath:MD:\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note"]},": The value of hash (#) in target path for all child operations within a parent AGGREGATE operation, is evaluated once and used for all child operations ensuring that all aggregagated operation are copied at the same index of the array in the transformed record."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"totalDepthMd\": {\n      \"value\": 34,\n      \"unitKey\": \"m\"\n    },\n    \"elevationReference\": {\n      \"elevationFromMsl\": {\n        \"value\": 30,\n        \"unitKey\": \"ft\"\n      },\n      \"name\": \"KB\"\n    }\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [\n    {\n      \"identifier\": \"data.totalDepthMd.value\",\n      \"operations\": [\n        {\n          \"type\": \"AGGREGATE\",\n          \"operations\": [\n            {\n              \"type\": \"CONSTANT\",\n              \"value\": \"Total Depth MD\",\n              \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n            },\n            {\n              \"type\": \"COPY\",\n              \"sourceProperty\": \"data.totalDepthMd.value\",\n              \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n            },\n            {\n              \"type\": \"COPY\",\n              \"sourceProperty\": \"data.totalDepthMd.unitKey\",\n              \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n            },\n            {\n              \"type\": \"CONSTANT\",\n              \"value\": \"ABC:reference-data--VerticalMeasurementPath:MD:\",\n              \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\",\n              \"andCondition\": [\n                {\n                  \"type\": \"ifAnyExists\",\n                  \"attributes\": [\n                    {\n                      \"sourceProperty\": \"data.totalDepthMd.value\"\n                    },\n                    {\n                      \"sourceProperty\": \"data.totalDepthMd.unitKey\"\n                    }\n                  ]\n                }\n              ]\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\" : [ {\n      \"VerticalMeasurementTypeID\" : \"Total Depth MD\",\n      \"VerticalMeasurement\" : 34,\n      \"VerticalMeasurementUnitOfMeasureID\" : \"m\",\n      \"VerticalMeasurementPathID\" : \"ABC:reference-data--VerticalMeasurementPath:MD:\"\n    }\n}\n        "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-11-aggregate-operations---spatial-location","__idx":25},"children":["Use case 11: AGGREGATE operations - SPATIAL LOCATION"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example illustrates the application of the AGGREGATE operation with regards to spatial location data."," ","We provide an example usage of the \"equals\" condition based on the operation in the following aggregate operation. This means that the operation will execute only if the equals condition is validated."," ","If there is a hash (#) index in the sourceProperty path with the \"equals\" condition, then all the indexes are validated by the equality check, and if a match is found, that index value is used in place of the hash(#) in the sourceProperty of the operation."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"wellHeadProjected\": {\n      \"crsKey\": \"GCS_WGS_1984\",\n      \"x\": -12.5399,\n      \"y\": 35.4635,\n      \"elevationFromMsl\": {\n        \"value\": 421.11,\n        \"unitKey\": \"m\"\n      }\n    },\n    \"wellHeadWgs84\": {\n      \"latitude\": -14.5399,\n      \"longitude\": 31.4635\n    }\n  },\n  \"meta\": [\n    {\n      \"kind\": \"CRS\",\n      \"name\": \"GCS_WGS_1984\",\n      \"persistableReference\": \"{\\\"wkt\\\":\\\"GEOGCS[\\\"GCS_WGS_1984\\\",\n            DATUM[\\\"D_WGS_1984\\\",SPHEROID[\\\"WGS_1984\\\",6378137.0,\n            298.257223563]],PRIMEM[\\\"Greenwich\\\",0.0],UNIT[\\\"Degree\\\",\n            0.0174532925199433],AUTHORITY[\\\"EPSG\\\",4326]]\\\",\n            \\\"ver\\\":\\\"PE_10_3_1\\\",\\\"name\\\":\\\"GCS_WGS_1984\\\",\n            \\\"authCode\\\" :{\\\"auth\\\":\\\"EPSG\\\",\n            \\\"code\\\":\\\"4326\\\"},\\\"type\\\":\\\"LBC\\\"}\",\n      \"propertyNames\": [\n        \"wellHeadProjected.x\",\n        \"wellHeadProjected.y\",\n        \"wellHeadProjected.elevationFromMsl.value\",\n        \"wellHeadWgs84.latitude\",\n        \"wellHeadWgs84.longitude\"\n      ]\n    },\n    {\n      \"kind\": \"Unit\",\n      \"name\": \"m\",\n      \"persistableReference\": \"{\\\"scaleOffset\\\":{\\\"scale\\\":1.0,\n            \\\"offset\\\":0.0},\\\"symbol\\\":\\\"m\\\",\\\"baseMeasurement\\\":\n            {\\\"ancestry\\\":\\\"L\\\",\\\"type\\\":\\\"UM\\\"},\\\"type\\\":\\\"USO\\\"}\",\n      \"propertyNames\": [\n        \"wellHeadProjected.x\",\n        \"wellHeadProjected.y\",\n        \"wellHeadProjected.elevationFromMsl.value\",\n        \"wellHeadWgs84.latitude\",\n        \"wellHeadWgs84.longitude\"\n      ]\n    }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [\n    {\n    \"identifier\": \"data.SpatialLocation\",\n    \"operations\": [\n      {\n        \"type\": \"AGGREGATE\",\n        \"operations\": [\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"{{NAMESPACE}}:reference-data--SpatialGeometryType:Point:0\",\n            \"targetProperty\": \"data.SpatialLocation.SpatialGeometryTypeID\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAllExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.x\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.y\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"{{NAMESPACE}}:reference-data--SpatialGeometryType:Point:0\",\n            \"targetProperty\": \"data.SpatialLocation.SpatialGeometryTypeID\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAllExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.latitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.longitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.elevationFromMsl.value\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.wellHeadProjected.crsKey\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.CoordinateReferenceSystemID\"\n          },\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.wellHeadProjected.x\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.coordinates[0]\"\n          },\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.wellHeadProjected.y\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.coordinates[1]\"\n          },\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.coordinates[2]\"\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"Point\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAllExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.x\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.y\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"Point\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].geometry.type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAllExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.latitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.longitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.elevationFromMsl.value\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"Feature\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.features[#].type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAnyExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.x\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.y\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"FeatureCollection\",\n            \"targetProperty\": \"data.SpatialLocation.AsIngestedCoordinates.type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAnyExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.x\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.y\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadProjected.elevationFromMsl.value\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.wellHeadWgs84.longitude\",\n            \"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].geometry.coordinates[0]\"\n          },\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.wellHeadWgs84.latitude\",\n            \"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].geometry.coordinates[1]\"\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"Point\",\n            \"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].geometry.type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAllExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.latitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.longitude\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"Feature\",\n            \"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.features[#].type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAnyExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.latitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.longitude\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"FeatureCollection\",\n            \"targetProperty\": \"data.SpatialLocation.Wgs84Coordinates.type\",\n            \"andCondition\": [\n              {\n                \"type\": \"ifAnyExists\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.latitude\"\n                  },\n                  {\n                    \"sourceProperty\": \"data.wellHeadWgs84.longitude\"\n                  }\n                ]\n              }\n            ]\n          }\n        ]\n      }\n    ]\n   }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"data\": {\n        \"SpatialLocation\": {\n            \"SpatialGeometryTypeID\": \"{{NAMESPACE}}:reference-data--SpatialGeometryType:Point:0\",\n            \"AsIngestedCoordinates\": {\n                \"CoordinateReferenceSystemID\": \"GCS_WGS_1984\",\n                \"features\": [\n                    {\n                        \"geometry\": {\n                            \"coordinates\": [\n                                -12.5399,\n                                35.4635,\n                                421.11\n                            ],\n                            \"type\": \"Point\"\n                        },\n                        \"type\": \"Feature\"\n                    }\n                ],\n                \"type\": \"FeatureCollection\"\n            },\n            \"Wgs84Coordinates\": {\n                \"features\": [\n                    {\n                        \"geometry\": {\n                            \"coordinates\": [\n                                31.4635,\n                                -14.5399\n                            ],\n                            \"type\": \"Point\"\n                        },\n                        \"type\": \"Feature\"\n                    }\n                ],\n                \"type\": \"FeatureCollection\"\n            }\n        }\n    }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-12-copy_array_index-operation","__idx":26},"children":["Use case 12: COPY_ARRAY_INDEX operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copies the value of \"#\" in the target property. The target property captures the index value of the object. \"#\" indicates the index of the array where the object will be copied."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"copy_array_index-operation","__idx":27},"children":["COPY_ARRAY_INDEX operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example, a new attribute, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VerticalMeasurementID"]},", is added to the target WKS record that captures the array index of the object."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"ELEV_MSL\": 0,\n    \"ELEV_DL\": 25.0,\n    \"TVD_MLS\": 76.5,\n    \"TVDVRS_TD\": 1300.0,\n    \"TVDZDP_TD\": 1325.0\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"mappings\": [\n        {\n            \"identifier\": \"data.VerticalMeasurements\",\n            \"operations\": [\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"COPY_ARRAY_INDEX\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.ELEV_MSL\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:MSL:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\"\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"COPY_ARRAY_INDEX\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.ELEV_DL\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:DL:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"COPY_ARRAY_INDEX\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVD_MLS\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:MLS:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"COPY_ARRAY_INDEX\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVDVRS_TD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n                                \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n                            }\n                        }\n                    ]\n                },\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"COPY_ARRAY_INDEX\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"sourceProperty\": \"data.TVDZDP_TD\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\"\n                        },\n                        {\n                            \"type\": \"COPY\",\n                            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n                            \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                            \"arrayIndex\": {\n                                \"targetProperty\": \"data.VerticalMeasurements[?].VerticalMeasurementTypeID\",\n                                \"value\": \"partition-id:reference-data--VerticalMeasurementType:DL:\"\n                            }\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n\t\"VerticalMeasurements\": [\n        {\n            \"VerticalMeasurementID\": 0,\n            \"VerticalMeasurement\": 0,\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:MSL:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n            \"VerticalCRSID\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n        }, \n        {\n            \"VerticalMeasurementID\": 1,\n            \"VerticalMeasurement\": 25.0,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:DL:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:ELEV:\",\n            \"VerticalReferenceID\": 0\n        }, \n        {\n            \"VerticalMeasurementID\": 2,\n            \"VerticalMeasurement\": 76.5,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:MLS:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n            \"VerticalReferenceID\": 0\n        }, \n        {\n            \"VerticalMeasurementID\": 3,\n            \"VerticalMeasurement\": 1300.0,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n            \"VerticalReferenceID\": 0\n        }, \n        {\n            \"VerticalMeasurementID\": 4,\n            \"VerticalMeasurement\": 1325.0,\n            \"VerticalMeasurementUnitOfMeasureID\": \"partition-id:reference-data--UnitOfMeasure:m:\",\n            \"VerticalMeasurementTypeID\": \"partition-id:reference-data--VerticalMeasurementType:TD:\",\n            \"VerticalMeasurementPathID\": \"partition-id:reference-data--VerticalMeasurementPath:TVD:\",\n            \"VerticalReferenceID\": 1\n        }\n    ]\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-13--conditional_priority-operation","__idx":28},"children":["Use case 13:  CONDITIONAL_PRIORITY operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example illustrates the application of the AGGREGATE operation with the CONDITIONAL_PRIORITY sub operation.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"CONDITIONAL_PRIORITY is a container operation that holds sub operations with different conditions and priorities.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The conditions are evaluated on the basis of the priority of the operations. The operations are evaluated from highest priority to the lowest priority. When any of the operations succeed, all the rest of the operations with descending priority are not evaluated further."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"conditional_priority-operation-example-1","__idx":29},"children":["CONDITIONAL_PRIORITY operation example 1"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example, if data.WEL_ELEVATION_REF equals \"KB\", then COPY data.WEL_ELEVATION_REF to VerticalCRSID, else add a constant value to VerticalCRSID.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If operation with priority 1 is true, the rest will not be evaluated. If priority 1 is false, the operation with priority 2 is evaluated."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"name\": \"MIDLAND FARMS EAST\",\n    \"elevationReference\": \"KB\",\n    \"unit\": \"FT\",\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [{\n      \"identifier\": \"data.VerticalMeasurements1\",\n      \"operations\": [\n        {\n          \"type\": \"AGGREGATE\",\n          \"operations\": [\n            {\n              \"type\": \"CONDITIONAL_PRIORITY\",\n              \"operations\": [\n                {\n                  \"type\": \"COPY\",\n                  \"sourcProperty\": \"data.elevationReference\",\n                  \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\",\n                  \"priority\": 1,\n                  \"andCondition\": [\n                    {\n                      \"type\": \"equals\",\n                      \"attributes\": [\n                        {\n                          \"sourceProperty\": \"data.elevationReference\",\n                          \"value\": \"KB\"\n                        }\n                      ]\n                    }\n                  ]\n                },\n                {\n                  \"type\": \"CONSTANT\",\n                  \"value\": \"Test Value\",\n                  \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\",\n                  \"priority\": 2\n                }\n              ]\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\": [\n        {\n            \"VerticalCRSID\": \"KB\"\n        }\n    ]\n  }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"conditional_priority-operation-example-2","__idx":30},"children":["CONDITIONAL_PRIORITY operation example 2"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following example, if attr1 exists || attr2 equals \"test\", then COPY attr1 to target_attr, else if attr3 exists, then COPY attr3 to target_attr.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If the operation with priority 1 (If attr1 exists) is true, the rest will not be evaluated. If priority 1 is false, the operation with priority 2 (attr2 equals \"test\") is evaluated. If priority 2 is also false, then operation with priority 3 (if attr3 exists) is evaluated."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"attr3\": \"value\",\n    \"attr4\": \"testValue\",\n    \"attr5\": \"testValueValue\"\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"50%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [{\n       \"identifier\": \"data.VerticalMeasurements\",\n       \"operations\": [\n           {\n               \"type\": \"AGGREGATE\",\n               \"operations\": [\n                   {\n                       \"type\": \"CONDITIONAL_PRIORITY\",\n                       \"operations\": [\n                           {\n                               \"type\": \"COPY\",\n                               \"sourceProperty\": \"data.attr1\",\n                               \"targetProperty\": \"data.VerticalMeasurements[#].target_attr\",\n                               \"priority\": 1,\n                               \"andCondition\": [\n                                   {\n                                       \"type\": \"ifAnyExists\",\n                                       \"attributes\": [\n                                           {\n                                               \"sourceProperty\": \"data.attr1\"\n                                           }\n                                       ]\n                                   }\n                               ]\n                           },\n                           {\n                               \"type\": \"COPY\",\n                               \"sourceProperty\": \"data.attr1\",\n                               \"targetProperty\": \"data.VerticalMeasurements[#].target_attr\",\n                               \"priority\": 2,\n                               \"andCondition\": [\n                                   {\n                                       \"type\": \"equals\",\n                                       \"attributes\": [\n                                           {\n                                               \"sourceProperty\": \"data.attr2\",\n                                               \"value\": \"test\"\n                                           }\n                                       ]\n                                   }\n                               ]\n                           },\n                           {\n                               \"type\": \"COPY\",\n                               \"sourceProperty\": \"data.attr3\",\n                               \"targetProperty\": \"data.VerticalMeasurements[#].target_attr\",\n                               \"priority\": 3,\n                               \"andCondition\": [\n                                   {\n                                       \"type\": \"ifAnyExists\",\n                                       \"attributes\": [\n                                           {\n                                               \"sourceProperty\": \"data.attr3\"\n                                           }\n                                       ]\n                                   }\n                               ]\n                           }\n                       ]\n                   },\n                   {\n                       \"type\": \"COPY\",\n                       \"sourceProperty\": \"data.attr4\",\n                       \"targetProperty\": \"data.VerticalMeasurements[#].target_attr1\"\n                   },\n                   {\n                       \"type\": \"COPY\",\n                       \"sourceProperty\": \"data.attr5\",\n                       \"targetProperty\": \"data.VerticalMeasurements[#].target_attr2\"\n                   }\n               ]\n           }\n       ]\n    }]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"VerticalMeasurements\": [\n        {\n            \"target_attr\": \"value\",\n            \"target_attr1\": \"testValue\",\n            \"target_attr2\": \"testValueValue\"\n        }\n    ]\n  }\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"relationship-and-relationship_array-operations","__idx":31},"children":["RELATIONSHIP and RELATIONSHIP_ARRAY operations ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"relationship_and_relatonship_array_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section provides some use cases related to the RELATIONSHIP and RELATIONSHIP_ARRAY operations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-14-simple-to-simple-attribute-mapping-in-a-relationship","__idx":32},"children":["Use case 14: Simple to simple attribute mapping in a relationship"]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Use Cases"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID mentioned in the \"WellID\" attribute of the raw record does not exist, \nthen the targetrecord will still contain that record ID in the\n\"WellID\" attribute as it is.\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"},"rowSpan":"4"},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":[" \n{\n \"type\": \"RELATIONSHIP\",\n \"sourceProperty\": \"data.WellID\",\n \"targetProperty\": \"data.WellID\"\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": \n  {\n    \"WellID\": \"slb-osdu-prod-des-prod-testing:well:89bc3631d56740d899e7cc8fa69d2ee6\"\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\t\n{\n\"data\": \n{\n\"WellID\": \"slb-osdu-prod-des-prod-testing:well:89bc3631d56740d899e7cc8fa69d2ee6\"\n}\n}\n"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen record ID mentioned in the \"WellID\" attribute of the raw record exists, \nbut the equivalent WKS ID of this record does not exist, then the \nthe target record will contain the generated WKS ID \nappended with \":\". This denotes the latest \nversion of the generated WKS record. Note that only the record ID of \nthis WKS record is generated and not the actual WKS record. \nThe actual WKS record will also have the same record ID whenever \nit is generated by the WKS service.\n    "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": \n  {\n    \"WellID\": \"slb-osdu-prod-des-prod-testing:wellbore:b5bdf34863e84a12a7347110d4164b4a:1628051435348558\"\n  }\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": \n  {\n    \"WellID\": \"$GENERATED_WKS_RECORD_ID:\"\n  }\n}\n    "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID mentioned in the \"WellID\" attribute of a raw record exists \nand the equivalent WKS ID of this record ID also exists, then\nthe target record will contain the equivalent WKS ID appended with \nthe equivalent WKS version.\n    "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["    \n{\n  \"data\": \n  {\n    \"WellID\": \"slb-osdu-prod-des-prod-testing:wellbore:techlog-\n    C9536975-92FC-462D-8288-8CC9408B0027--\n    C6452ED2-528C-4B1B-BA24-06DE2158465B\n    :1622040982279528\"\n  }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"," ","\"data\":"," ","{"," ","\"WellID\": \"slb-osdu-prod-des-prod-testing:wellbore:wks-"," ","9f934e460e823c13ffec05964ecc860a4f27eec3.slb.wks.wellbore.1"," ",":1622106262273254\""," ","}"," ","}"," "]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-15-array-to-array-attribute-mapping-in-a-relationship","__idx":33},"children":["Use case 15: Array to array attribute mapping in a relationship"]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Use Case"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record IDs in the \"ResourceHostRegionIDs\" attribute of a raw record do not exist, \nthen the target record will still contain these record IDs as it is in the \n\"ResourceHostRegionIDs\" attribute.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"type\": \"RELATIONSHIP_ARRAY\",\n  \"sourceProperty\": \"data.ResourceHostRegionIDs[*]\",\n  \"targetProperty\": \"data.ResourceHostRegionIDs[*]\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": {\n  \"ResourceHostRegionIDs\": [\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:1615982504113772\",\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:2515222514254785\"\n    ]\n }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": {\n  \"ResourceHostRegionIDs\": [\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:1615982504113772\",\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:2515222514254785\"\n    ]\n }\n}\n      "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record IDs mentioned in the \"ResourceHostRegionIDs\" attribute of a raw record exist \nbut the equivalent WKS ID of these record IDs do not exist, then the \nthe target record will contain the generated WKS \nIDs appended with \":\". This denotes the latest \nversion of the generated WKS record. Note that only the record ID of \nthis WKS record will be generated and not the actual WKS record. \nThe actual WKS record will also have the same record ID when\nit is generated by the WKS service.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"type\": \"RELATIONSHIP_ARRAY\",\n  \"sourceProperty\": \"data.ResourceHostRegionIDs[*]\",\n  \"targetProperty\": \"data.ResourceHostRegionIDs[*]\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": {\n  \"ResourceHostRegionIDs\": [\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:1615982504113772\",\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:2515222514254785\"\n    ]\n }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":[" \t\n{\n \"data\": {\n  ResourceHostRegionIDs\": [\n      \"$GENERATED_WKS_ID:\",\n      \"$GENERATED_WKS_ID:\"\n    ]\n }\n}\n      "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record IDs in the \"ResourceHostRegionIDs\" attribute of a raw record exist \nand the equivalent WKS ID of these record IDs also exist, then\nthe target record will contain the equivalent WKS ID appended with \nthe equivalent WKS version.\n    "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"type\": \"RELATIONSHIP_ARRAY\",\n  \"sourceProperty\": \"data.ResourceHostRegionIDs[*]\",\n  \"targetProperty\": \"data.ResourceHostRegionIDs[*]\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n   \"ResourceHostRegionIDs\": [\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:1615982504113772\",\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:2515222514254785\"\n    ]\n  }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["  \t\n{\n  \"data\": {\n    \"ResourceHostRegionIDs\": [\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:wks-\n    9f934e460e823c13ffec05964ecc860a4f27eec3.slb.wks.wellbore.1\n    :1622106262273254\",\n    \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:wks-\n    7f349e450e823c13ffec05964ecc860a4f17eec3.slb.wks.wellbore.1\n    :1221106362223151\"\n    ]\n  }\n}\n    "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-16-simple-to-array-attribute-mapping-in-relationship","__idx":34},"children":["Use Case 16: Simple to array attribute mapping in RELATIONSHIP"]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Use Case"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID in the \"data.relationships.well.id\" of a raw record does not exist, \nthen the target record will still contain that record ID as it is at \ndata.relationships.well.ids[0].\n     "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"type\": \"RELATIONSHIP\",\n \"sourceProperty\": \"data.relationships.well.id\",\n \"targetProperty\": \"data.relationships.well.ids[0]\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": \n {\n  \"relationships\": \n  {\n   \"well\": \n   {\n    \"id\": \"slb-osdu-prod-des-prod-testing:well:89bc3631d56740d899e7cc8fa69d2ee6\",\n    \"name\": \"North Dakota Well\"\n   }\n  }\n }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["    \t\n{\n \"data\": \n {\n  \"relationships\": \n  {\n   \"well\": \n   {\n    \"ids\": [\n     \"slb-osdu-prod-des-prod-testing:well:89bc3631d56740d899e7cc8fa69d2ee6\"\n    ]\n   }\n  }\n }\n}\n      "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID in the \"RegionID\" attribute of a raw record exists \nbut the equivalent WKS ID of the record does not exist, then the \nthe target record will contain the generated WKS \nID appended with \":\". This denotes the latest \nversion of the generated WKS record. Note that only the record ID for \nthis WKS record is generated and not the actual WKS record. \nThe actual WKS record will also have the same record ID whenever \nit is generated by the WKS service.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["  \n{\n  \"type\": \"RELATIONSHIP\",\n  \"sourceProperty\": \"data.RegionID\",\n  \"targetProperty\": \"data.ResourceHostRegionIDs[0]\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": \n  {\n    \"RegionID\": \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:161598250411377\"\n  }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": \n {\n  ResourceHostRegionIDs\": [\n      \"$GENERATED_WKS_RECORD_ID:\"\n    ]\n }\n}\n      "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID in the \"RegionID\" attribute of raw record exists \nand the equivalent WKS ID also exists, then the \nthe target record will contain the equivalent WKS ID appended with \nthe equivalent WKS version.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["  \n{\n  \"type\": \"RELATIONSHIP\",\n  \"sourceProperty\": \"data.RegionID\",\n  \"targetProperty\": \"data.ResourceHostRegionIDs[0]\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"RegionID\": \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:AWSEastUSA:161598250411377\"\n  }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["    \t\n{\n \"data\": {\n  ResourceHostRegionIDs\": [\n      \"slb-osdu-prod-des-prod-testing:reference-data--OSDURegion:wks-\n    9f934e460e823c13ffec05964ecc860a4f27eec3.slb.wks.wellbore.1\n    :1622106262273254\"\n    ]\n }\n}\n      "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-17-array-attribute-to-simple-attribute-in-relationship","__idx":35},"children":["Use Case 17: Array attribute to simple attribute in RELATIONSHIP"]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Use cases"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":[" \nWhen the record ID in data.relationships.well.ids[0] of a raw record does not exist, \nthen the target Record will still contain that record ID as it is in \n\"WellID\" attribute.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":[" \n{\n \"type\": \"RELATIONSHIP\",\n \"sourceProperty\": \"data.relationships.well.ids[0]\",\n \"targetProperty\": \"data.WellID\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": {\n  \"relationships\": {\n   \"well\": {\n    \"ids\": [\n     \"slb-osdu-prod-des-prod-testing:well:89bc3631d56740d899e7cc8fa69d2ee6\"\n    ]\n   }\n  }\n }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["   \t\n{\n\"data\": {\n\"WellID\": \"slb-osdu-prod-des-prod-testing:well:89bc3631d56740d899e7cc8fa69d2ee6\"\n}\n}\n}\n      "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID in the \"BasinIDs\" attribute of a raw record exists \nbut the equivalent WKS ID does not exist, then the target record will \ncontain the generated WKS ID appended with \":\". This denotes the latest \nversion of generated WKS record. Note that only the record ID of \nthis WKS record is generated and not the actual WKS record. \nThe actual WKS record will also have the same record ID whenever \nit is generated by the WKS service.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"type\": \"RELATIONSHIP\",\n \"sourceProperty\": \"data.BasinIDs[0]\",\n \"targetProperty\": \"data.WellID\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": {\n   \"BasinIDs\":[\n     \"slb-osdu-prod-des-prod-testing:master-data--Basin:74ft4512f50710d812e7cd8aa54d3ee8\"\n    ]\n }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["   \t\n{\n  \"data\": {\n    \"BasinID\": \"$GENERATED_WKS_RECORD_ID:\"\n  }\n}\n      "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\nWhen the record ID in the \"WellID\" attribute of a raw record exists \nand the equivalent WKS ID of this record also exists, then\nthe target record will contain the equivalent WKS ID appended with \nthe equivalent WKS version.\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"type\": \"RELATIONSHIP\",\n \"sourceProperty\": \"data.InitialOperators[0]\",\n \"targetProperty\": \"data.InitialOperatorID\"\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n \"data\": {\n   \"InitialOperators\":[\n     \"slb-osdu-prod-des-prod-testing:master-data--Organisation:74ft4512f50710d812e7cd8aa54d3ee8:1628051435348558\"\n    ]\n }\n}\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n    \"InitialOperatorID\": \"slb-osdu-prod-des-prod-testing:master-data--Organisation:wks-\n    9f934e460e823c13ffec05964ecc860a4f27eec3.slb.wks.wellbore.1\n    :1622106262273254\"\n  }\n}\n      "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-18-use-of-the-hash--in-relationship-operation","__idx":36},"children":["Use Case 18: Use of the hash (#) in relationship operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The RELATIONSHIP operation can also be used under an AGGREGATE operation using the # whose value will be evaluated dynamically."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information on how # is evaluated for AGGREGATE, refer to AGGREGATE section. (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#aggregate_usecases"},"children":["AGGREGATE, COPY_ARRAY_INDEX, CONDITIONAL_PRIORITY operations"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When # is used for relationship transformations, the value of # is provided by the target aggregated array."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following combinations are supported:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["#"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetProperty"]}," only"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["#"]}," in both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceProperty"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetProperty"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"case1--only-in-the-target-property","__idx":37},"children":["Case1: # only in the target property"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The transformation behavior for relationship operator given related data id, remains as described before"," ","Here data contains two arrays with related data ids i.e. 'data.relationships.Block.ids' and 'data.relationships.Quadrant.ids',"," ","Each related data id needs to be transformed as per \"RELATIONSHIP\" Operation."," ","The 'related data id' at 'data.relationships.Block.ids[0]' will be transformed and assigned to available index position of target GeoContexts[] array's to GeoPoliticalEntityID"," ","and the constant value will be assigned to same index position of target GeoContexts[] array's to GeoTypeID."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n  [\n  {\n      \"identifier\": \"Quadrant\",\n      \"operations\": [\n        {\n          \"type\": \"AGGREGATE\",\n          \"operations\": [\n            {\n              \"type\": \"RELATIONSHIP\",\n              \"sourceProperty\": \"data.relationships.Quadrant.ids[0]\",\n              \"targetProperty\": \"data.GeoContexts[#].GeoPoliticalEntityID\"\n            },\n            {\n              \"type\": \"CONSTANT\",\n              \"value\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Quadrant:\",\n              \"targetProperty\": \"data.GeoContexts[#].GeoTypeID\",\n              \"andCondition\": [\n                {\n                  \"type\": \"ifAnyExists\",\n                  \"attributes\": [\n                    {\n                      \"sourceProperty\": \"data.relationships.Quadrant.ids[0]\"\n                    }\n                  ]\n                }\n              ]\n            }\n          ]\n        }\n      ]\n    },\n    {\n      \"identifier\": \"Block\",\n      \"operations\": [\n        {\n          \"type\": \"AGGREGATE\",\n          \"operations\": [\n            {\n              \"type\": \"RELATIONSHIP\",\n              \"sourceProperty\": \"data.relationships.Block.ids[0]\",\n              \"targetProperty\": \"data.GeoContexts[#].GeoPoliticalEntityID\"\n            },\n            {\n              \"type\": \"CONSTANT\",\n              \"value\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Block:\",\n              \"targetProperty\": \"data.GeoContexts[#].GeoTypeID\",\n              \"andCondition\": [\n                {\n                  \"type\": \"ifAnyExists\",\n                  \"attributes\": [\n                    {\n                      \"sourceProperty\": \"data.relationships.Block.ids[0]\"\n                    }\n                  ]\n                }\n              ]\n            }\n          ]\n        }\n      ]\n    }\n  ]\n  "]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n    \"data\": {\n        \"relationships.Block.ids\": [\n          \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:Q08_BlockID:\"\n        ],\n      \"relationships.Quadrant.ids\": [\n          \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:N_Quadrant:\"\n        ]\n\t}\n  "]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n            \"GeoContexts\": [\n          {\n            \"GeoPoliticalEntityID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:N_Quadrant:\",\n            \"GeoTypeID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Quadrant:\",\n          },\n          {\n            \"GeoPoliticalEntityID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:Q08_BlockID:\",\n            \"GeoTypeID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Block:\",\n          }\n      ]\n    }\n}\n  "]}]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"case2--in-both-the-source-and-target-property","__idx":38},"children":["Case2: # in both the source and target property"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The transformation behavior for a relationship operator, given related data ID, remains as described before."," ","When '#' is used in both the source and target properties as shown in this example: '#' helps compute the next available array index position in the target where the transformed related data object ID will be assigned,"," ","and same index position will be used while reading the related ID to be transformed from the source array. So, the target array '#' value determined the array index value for the source array."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Here, the first AGGREGATE operation is creating data.GeoContexts[] and adding \"GeoPoliticalEntityID\" and \"GeoTypeID\" at the 0th index of the GeoContext[] array after transforming the source data available at the data.relationships.Quadrant.ids[0] index. Note the array index '0' in data.relationships.Quadrant.ids[0] is used as per '#' evaluated for the target GeoContext[] array."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["During execution of the second AGGREGATE operation, the # value will be incremented by the count of 1. As the 0th element in data.GeoContexts[] is already present,"," ","it will increment the # value to 1 and then \"GeoPoliticalEntityID\" and \"GeoTypeID\" are added to the 1st index after transforming the source data available at data.relationships.Quadrant.ids[1] index."," ","Note that the array index '1' in data.relationships.Quadrant.ids[1] is used as per '#' evaluated for target GeoContext[] array."]}]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n  [\n        {\n            \"identifier\": \"Block\",\n            \"operations\": [\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"RELATIONSHIP\",\n                            \"sourceProperty\": \"data.relationships.Block.ids[#]\",\n                            \"targetProperty\": \"data.GeoContexts[#].GeoPoliticalEntityID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Quadrant:\",\n                            \"targetProperty\": \"data.GeoContexts[#].GeoTypeID\",\n                            \"andCondition\": [\n                                {\n                                    \"type\": \"ifAnyExists\",\n                                    \"attributes\": [\n                                        {\n                                            \"sourceProperty\": \"data.relationships.Block.ids[0]\"\n                                        }\n                                    ]\n                                }\n                            ]\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"identifier\": \"Quadrant\",\n            \"operations\": [\n                {\n                    \"type\": \"AGGREGATE\",\n                    \"operations\": [\n                        {\n                            \"type\": \"RELATIONSHIP\",\n                            \"sourceProperty\": \"data.relationships.Quadrant.ids[#]\",\n                            \"targetProperty\": \"data.GeoContexts[#].GeoPoliticalEntityID\"\n                        },\n                        {\n                            \"type\": \"CONSTANT\",\n                            \"value\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Block:\",\n                            \"targetProperty\": \"data.GeoContexts[#].GeoTypeID\",\n                            \"andCondition\": [\n                                {\n                                    \"type\": \"ifAnyExists\",\n                                    \"attributes\": [\n                                        {\n                                            \"sourceProperty\": \"data.relationships.Quadrant.ids[0]\"\n                                        }\n                                    ]\n                                }\n                            ]\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n  "]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n  \"data\": {\n            \"relationships\":{\n                \"Block\":{\n                    \"ids\":[\n                        \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:Q08_BlockID:\"\n                    ]\n                },\n                \"Quadrant\":{\n                    \"ids\":[\n                        \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:N_Quadrant:\",\n                    ]\n                }\n            }\n        }\n  "]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"data\": {\n        \"GeoContexts\": [\n            {\n                \"GeoPoliticalEntityID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":master-data--GeoPoliticalEntity:Q08_BlockID:\",\n                \"GeoTypeID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Quadrant:\"\n            },\n            {\n                \"GeoTypeID\": \"",{"$$mdtype":"Tag","name":"namespace","attributes":{},"children":[":reference-data--GeoPoliticalEntityType:Block:\"\n            }\n        ]\n    }\n}\n  "]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reference_lookup-operation","__idx":39},"children":["REFERENCE_LOOKUP operation ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"reference_lookup_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The operation searches the reference data catalogs based on the provided search parameters and copies the retrieved reference data value to the target. The use cases that follow are related to REFERENCE_LOOKUP operation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-19","__idx":40},"children":["Use Case 19:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the value of the attribute to search is passed using the sourceProperty path and a constant in the mapping."," ","Here, VerticalMeasurementTypeID is populated by searching for the Reference Data ID from the VerticalMeasurementType catalog for the code provided in the 'ALIAS_NAME' source attribute."," ","VerticalMeasurementPathID is populated by searching for the Reference Data ID for the constant \"Elevation\" from the VerticalMeasurementPath catalog."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [\n    {\n        \"identifier\": \"data.VerticalMeasurements\",\n        \"operations\": [\n            {\n                \"type\": \"AGGREGATE\",\n                \"operations\": [\n                    {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                            \"queryParam\": {\n                                \"Code\": \"@sourceProperty:data.ALIAS_NAME\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    },\n                    {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementPath:1.0.0\",\n                            \"queryParam\": {\n                                    \"Name\": \"Elevation\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    }\n                ]\n            }\n        ]\n    }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n        \"data\": {\n            \"ELEVATION\": 4900,\n            \"API\": \"Z001\",\n            \"REFERENCE_ELEVATION\": 3000,\n            \"ELEVATION_REFERENCE\": \"KellyBushing\",\n            \"UWI\": \"Z001\",\n            \"WEL_ELEVATION_REF\": \"GR\",\n            \"ALIAS_NAME\": \"GL\"\n        }\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"data\": {\n        \"VerticalMeasurements\": [\n            {\n                \"VerticalMeasurementTypeID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementType:GroundLevel:\",\n                \"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV:\"\n            }\n        ]\n    },\n    \"meta\": null\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-20-reference_lookup-with-label","__idx":41},"children":["Use case 20: REFERENCE_LOOKUP with label"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the REFERENCE_LOOKUP operation is used in two ways:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inside AGGREGATE: This operation is used to look up the ID of VerticalMeasurementPath and VerticalMeasurementType in each measurement array element (kelly bushing and ground level measurements)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["With label: In this case the reference catalog based look up value (ID, code, name, etc.) is stored in a label and referred to later as shown for assigning VerticalMeasurementUnitOfMeasureID and DefaultVerticalMeasurementID."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: The looked up value is stored in the label and can be called multiple times during the transformation of the given record. The scope of the label-value is limited to the record transformation."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [{\n        \"identifier\": \"referenceID_elevation_ref\",\n        \"operations\": [{\n                \"type\": \"REFERENCE_LOOKUP\",\n                \"label\": \"RDVID_elevation_ref\",\n                \"query\": {\n                    \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                    \"queryParam\": {\n                        \"Code\": \"@sourceProperty:data.ELEVATION_REFERENCE\"\n                    },\n                    \"returnedField\": \"id\"\n                }\n            }\n        ]\n    }, {\n        \"identifier\": \"referenceID_UOM\",\n        \"operations\": [{\n                \"type\": \"REFERENCE_LOOKUP\",\n                \"label\": \"label_UOM\",\n                \"query\": {\n                    \"kind\": \"osdu:wks:reference-data--VerticalMeasurementUnitOfMeasure:1.0.0\",\n                    \"queryParam\": {\n                        \"Code\": \"@sourceProperty:data.UNIT\"\n                    },\n                    \"returnedField\": \"id\"\n                }\n            }\n        ]\n    }, {\n        \"identifier\": \"data.VerticalMeasurements\",\n        \"operations\": [{\n                \"type\": \"AGGREGATE\",\n                \"operations\": [{\n                        \"type\": \"COPY_ARRAY_INDEX\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                    }, {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementPath:1.0.0\",\n                            \"queryParam\": {\n                                \"Name\": \"Elevation\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    }, {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                            \"queryParam\": {\n                                \"Code\": \"@sourceProperty:data.ELEVATION_REFERENCE\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    }, {\n                        \"type\": \"COPY\",\n                        \"sourceProperty\": \"data.REFERENCE_ELEVATION\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                    }, {\n                        \"type\": \"COPY\",\n                        \"value\": \"@label:label_UOM\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                    }\n                ]\n            }\n        ],\n        \"andCondition\": [{\n                \"type\": \"ifAllExists\",\n                \"attributes\": [{\n                        \"sourceProperty\": \"data.REFERENCE_ELEVATION\"\n                    }\n                ]\n            }\n        ]\n    }, {\n        \"identifier\": \"data.VerticalMeasurement\",\n        \"operations\": [{\n                \"type\": \"AGGREGATE\",\n                \"operations\": [{\n                        \"type\": \"COPY_ARRAY_INDEX\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementID\"\n                    }, {\n                        \"type\": \"COPY\",\n                        \"sourceProperty\": \"data.GROUND_ELEVATION\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurement\"\n                    }, {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                            \"queryParam\": {\n                                \"Code\": \"GroundLevel\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    }, {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementPath:1.0.0\",\n                            \"queryParam\": {\n                                \"Name\": \"Elevation\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    }, {\n                        \"type\": \"COPY\",\n                        \"value\": \"@label:label_UOM\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementUnitOfMeasureID\"\n                    }\n                ]\n            }\n        ]\n    }, {\n        \"identifier\": \"data.DefaultVerticalMeasurementID\",\n        \"operations\": [{\n                \"type\": \"COPY\",\n                \"targetProperty\": \"data.DefaultVerticalMeasurementID \",\n                \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n                \"arrayIndex\": {\n                    \"targetProperty\": \"data.VerticalMeasurements[?].VerticalMeasurementTypeID\",\n                    \"value\": \"@label:RDVID_elevation_ref\"\n                }\n            }\n        ]\n    }\n]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n        \"data\": {\n            \"UNIT\": \"FT\",\n            \"ELEVATION_REFERENCE\": \"KellyBushing\",\n            \"REFERENCE_ELEVATION\": 2990,\n            \"GROUND_ELEVATION\": 4000\n        }\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"data\": {\n        \"VerticalMeasurements\": [{\n                \"VerticalMeasurementID\": 0,\n\t\t\t\t\"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV\",\n                \"VerticalMeasurementTypeID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementType:KellyBushing:\",\n                \"VerticalMeasurement\": 2990,\n\t\t\t\t\"VerticalMeasurementUnitOfMeasureID\": \"{{NAMESPACE}}:reference-data--UnitOfMeasure:FT\" \n            }, {\n                \"VerticalMeasurementID\": 1,\n                \"VerticalMeasurement\": 4000,\n                \"VerticalMeasurementTypeID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementType:GroundLevel:\",\n\t\t\t\t\"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV\",\n\t\t\t\t\"VerticalMeasurementUnitOfMeasureID\": \"{{NAMESPACE}}:reference-data--UnitOfMeasure:FT\"\n            }\n        ],\n        \"DefaultVerticalMeasurementID \": 0\n    },\n    \"meta\": null\n}\n        "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-21-reference_lookup-with-multiple-query-parameters","__idx":42},"children":["Use Case 21: REFERENCE_LOOKUP with multiple query parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In cases where a single query parameter may not be able to uniquely resolve a reference data value, you can look up the reference data using multiple query filters. The Reference Lookup operator allows you to specify multiple query parameters that is \"ANDed\" together to lookup the reference data values."," ","Following example shows:"," ","The DefaultVerticalMeasurementID is populated by searching for the Reference Data ID from the VerticalMeasurementType catalog for the code provided in the 'WEL_ELEVATION_REF' source attribute AND the AliasName provided in the 'ALIAS_NAME' attribute and the constant value 'GRL'."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n  \"mappings\": [\n    {\n        \"identifier\": \"data.VerticalMeasurements\",\n        \"operations\": [\n            {\n                \"type\": \"AGGREGATE\",\n                \"operations\": [\n                    {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementTypeID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                            \"queryParam\": {\n                                \"Code\": \"@sourceProperty:data.ELEVATION_REFERENCE\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    },\n                    {\n                        \"type\": \"REFERENCE_LOOKUP\",\n                        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\",\n                        \"query\": {\n                            \"kind\": \"osdu:wks:reference-data--VerticalMeasurementPath:1.0.0\",\n                            \"queryParam\": {\n                                    \"Name\": \"Elevation\"\n                            },\n                            \"returnedField\": \"id\"\n                        }\n                    }\n                ]\n            }\n        ]\n    },\n    {\n        \"identifier\": \"referenceID_elevation_ref0\",\n        \"operations\": [\n            {\n                \"type\": \"REFERENCE_LOOKUP\",\n                \"targetProperty\": \"data.DefaultVerticalMeasurementID\",\n                \"query\": {\n                    \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                    \"queryParam\": {\n                        \"Code\": \"@sourceProperty:data.WEL_ELEVATION_REF\",\n                        \"AliasName\": [\n                            \"@sourceProperty:data.ALIAS_NAME\",\n                            \"GRL\"\n                        ]\n                    },\n                    \"returnedField\": \"id\"\n                }\n            }\n        ]\n    }\n  ]\n}\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n        \"data\": {\n            \"ELEVATION_REFERENCE\": \"KellyBushing\",\n            \"WEL_ELEVATION_REF\": \"GroundLevel\",\n            \"ALIAS_NAME\": \"GL\"\n        }\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"25%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"data\": {\n        \"VerticalMeasurements\": [\n            {\n                \"VerticalMeasurementTypeID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementType:KellyBushing:\",\n                \"VerticalMeasurementPathID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV:\"\n            }\n        ],\n        \"DefaultVerticalMeasurementID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementType:GroundLevel:\"\n    },\n    \"meta\": null\n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"lookup_by_query-operation","__idx":43},"children":["LOOKUP_BY_QUERY operation ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"lookup_by_query_usecases"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This single operation gives the user the ability to lookup for either master data or reference data.- Below mentioned are some use cases related to LOOKUP_BY_QUERY operation:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-22","__idx":44},"children":["Use Case 22:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the user wants to perform a lookup against master data/reference data type relationship attributes, user can use this operation as shown. Here a user needs to provide the search criteria based on which lookup is to be done for related master/reference data. A query using raw record input c=value can also be formed using {{@sourceProperty:data.RAW_ATTRIBUTE_NAME}}. Here, KickOffWellbore in the transformed WKS would be populated based on below 3 criterias:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Where  FacilityID is a constant value, FPSO-09-Aug-22-B2 AND"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Where AliasNameTypeID is a constant value, \"{{NAMESPACE}}:reference-data--AliasNameType:RegulatoryIdentifier\" for the given AliasName which would be populated using the name attribute from the raw record AND"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Where AliasNameTypeID is a constant value, \"{{NAMESPACE}}:reference-data--AliasNameType:Wellbore Number\" for the given AliasName, \"wellbore-12A\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Here {{NAMESPACE}} is only placeholder which will be replaced, others is part of syntax"]}]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n[\n    {\n        \"identifier\": \"LOOKUP_on_MasterData\",\n        \"operations\": [\n            {\n                \"type\": \"LOOKUP_BY_QUERY\",\n                \"targetProperty\": \"data.WellID\",\n                \"lookup\": {\n                    \"kind\": \"osdu:wks:master-data--Wellbore:1.0.0\",\n                    \"query\": \"data.FacilityID:\\\"FPSO-09-Aug-22-B2\\\" AND nested(data.NameAliases, (AliasName:\\\"{{@sourceProperty:data.name}}\\\" AND AliasNameTypeID:\\\"{{NAMESPACE}}:reference-data--AliasNameType:RegulatoryIdentifier\\\")) AND nested(data.NameAliases, (AliasName:\\\"wellbore-12A\\\" AND AliasNameTypeID:\\\"{{NAMESPACE}}:reference-data--AliasNameType:Wellbore Number\\\"))\",\n                    \"returnedField\": \"id\"\n                }\n            }\n        ]\n    }\n]\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n        \"data\": {\n            \"name\": \"Ex_Name\"\n        }\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"data\": {\n             \"WellID\": \"namespace:master-data--Organisation:1e2ab9dd60364ae697e34ef24b228d2b:\"\n    } \n}\n"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-23-lookup-for-attributes-that-are-of-reference-and-master-data-type-","__idx":45},"children":["Use Case 23: Lookup for attributes that are of Reference AND master data type :"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As per OSDU documentation, Organization is both a reference and master entity. Hence, user can use DefinitionOrganisationID attribute of the NameAlias block to refer either to master data or reference data. By this mapping, user can first lookup against master data using the query in the lookup block but if queried Organization value was not found in master data, then user can perform a lookup against reference data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the first LOOKUP_BY_QUERY operation succeeds, label ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["masterLookupIdOfOrganisation"]}," gets assigned the looked-up value and DefinitionOrganizationID gets a value from master data type 'Organization'."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the first LOOKUP_BY_QUERY fails, label ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["masterLookupIdOfOrganisation"]}," gets assigned a null value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The second LOOKUP_BY_QUERY has an 'andCondition' that ensures that this query is evaluated only if label ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["masterLookupIdOfOrganisation"]}," is a null value, meaning first query had failed and DefinitionOrganizationID is not assigned a value from master data catalog."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the second LOOKUP_By_QUERY gets evaluated, DefinitionOrganizationID gets a value from the Reference data type 'Organization'."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping Definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw Record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target Record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n[\n    {\n        \"identifier\": \"LOOKUP_on_MasterData\",\n        \"operations\": [\n            {\n                \"type\": \"LOOKUP_BY_QUERY\",\n                \"targetProperty\": \"data.NameAlias[#].DefinitionOrganisationID\",\n                \"label\": \"masterLookupIdOfOrganisation\",\n                \"lookup\": {\n                    \"kind\": \"osdu:wks:reference-data--OrganisationType:1.0.0\",\n                    \"query\": \"nested(data.NameAliases, (AliasName:\\\"{{@sourceProperty:data.Company}}\\\" AND AliasNameTypeID:\\\"{{NAMESPACE}}:reference-data--AliasNameType:IndustryName:\\\")) AND nested(data.NameAliases, (AliasName:\\\"1234\\\" AND AliasNameTypeID:\\\"{{NAMESPACE}}:reference-data--AliasNameType:Industry Code\\\"))\",\n                    \"returnedField\": \"id\"\n                }\n            },\n            {\n                \"type\": \"LOOKUP_BY_QUERY\",\n                \"targetProperty\": \"data.NameAlias[#].DefinitionOrganisationID\",\n                \"lookup\": {\n                    \"kind\": \"osdu:wks:reference-data--OrganisationType:1.0.0\",\n                    \"query\": \"data.Name:{{@sourceProperty:data.Company}}\",\n                    \"returnedField\": \"id\"\n                },\n                \"andCondition\": [\n                {\n                  \"type\": \"equals\",\n                  \"attributes\": [\n                    {\n                      \"label:masterLookupIdOfOrganisation\",\n                      \"value\" : \"\"\n                    }\n                  ]\n                }\n              ]\n            }  \n        ]\n    }\n]\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n          \"data\": {\n            \"Company\": \"Ex_organization name\"\n        }\n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n{\n    \"data\": {\n        \"NameAliases\": [\n            {\n                \"DefinitionOrganisationID\": \"{{NAMESPACE}}:master-data--Organisation:SomeUniqueOrganisationID:\"\n            }\n        ]\n    } \n}\n        "]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"use-case-24-lookup-for-attributes-that-are-reference-or-master-data-types-with-case-insensitive-exact-match","__idx":46},"children":["Use Case 24: Lookup for attributes that are reference or master data types with case-insensitive exact match:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the example below, as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isCaseInsensitiveExactMatch"]}," attribute is set to true, a case-insensitive exact match search is executed. For instance, if a record contains the Code as either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Groundlevel"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GROUNDLEVEL"]},", the corresponding record ID is retrieved, without considering the letter case."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," If there are multiple records that have Code as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Groundlevel"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GROUNDLEVEL"]},", the operation is skipped."]},{"$$mdtype":"Tag","name":"table","attributes":{"style":{"width":"100%","tableLayout":"fixed","borderCollapse":"collapse"}},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Mapping Definition"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Raw Record"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Target Record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n```      \n[\n    {\n        \"identifier\": \"LOOKUP_on_MasterData\",\n        \"operations\": [\n            {\n                \"type\": \"LOOKUP_BY_QUERY\",\n                \"targetProperty\": \"data.DefaultVerticalMeasurementID\",\n                \"lookup\": {\n                    \"kind\": \"osdu:wks:reference-data--VerticalMeasurementType:1.0.0\",\n                    \"query\": \"data.Code:\\\"{{@sourceProperty:data.WEL_ELEVATION_REF}}\\\"\",\n                    \"returnedField\": \"id\",\n                    \"isCaseInsensitiveExactMatch\": true\n                },\n            }\n        ]\n    }\n]\n```\n"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n      ```\n          \"data\": {\n            \"WEL_ELEVATION_REF\": \"GroundLevel\"\n        }\n      ```  \n      "]}]},{"$$mdtype":"Tag","name":"td","attributes":{"valign":"top","style":{"width":"33%","padding":"5px","border":"1px solid #ccc"}},"children":[{"$$mdtype":"Tag","name":"pre","attributes":{"style":{"margin":"0","whiteSpace":"pre-wrap","wordBreak":"break-word"}},"children":["\n      ```\n{\n    \"data\": {\n        \"DefaultVerticalMeasurementID\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementType:GroundLevel:\"\n        } \n}\n```\n        "]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To use the exact match query to search records based on a precise value please refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/core-service/tutorial/search-service"},"children":["Search Service Tutorial"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".keyword"]}," in query and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isCaseInsensitiveExactMatch"]}," in the operation is not allowed. Either a case-sensitive exact match with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".keyword"]}," in query or a case-insensitive exact match lookup with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isCaseInsensitiveExactMatch"]}," in the operation can be used."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mapping-operation-properties","__idx":47},"children":["Mapping operation properties ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"operation_roperties"},"children":[]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" Mapping operation properties "]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute name"},"children":["Attribute name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to the type of operation to perform. For a list of supported operation types, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/data-workspace/apis/osdu-mapping-service"},"children":["Operation Types"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["sourceProperty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to the source schema property name where the value is obtained."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["targetProperty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to the target schema property name to which the data will be transformed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to define a value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["andCondition"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of AndCondition schema"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used to define conditions when complex operations are bundled together. For more information, see the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AndConditions schema properties"]}," table."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["attributes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of Attributes schema"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to the Attributes used to specify how and from where the value will be taken. For more information, see the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Attributes schema properties"]}," table."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["priority"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to operations like \"CONDITIONAL_PRIORITY\" which are containers and can be evaluated like an if else block. The \"CONDITIONAL_PRIORITY\" operation uses the 'priority' attribute to define the order of execution.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," An operation with priority=1 is computed first. If it succeeds, then the operations with a lower priority are not computed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["operator"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to the property used to specify how to concatenate multiple values. If operator=\"-\", the concatenated value will be \"concatenated-value\"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["arrayIndex"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object of attributes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Used with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COPY"]}," operation to provide a condition that is used to evaluate an index in the array from which a value should be copied. For detailed information, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/data-workspace/apis/osdu-mapping-service"},"children":["COPY operation with arrayIndex"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["operations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of operation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refers to operations like AGGREGATE which are like containers and contain a bundle of other operations which are evaluated together to maintain the sanctity of the logical entity."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" AndCondition schema properties "]},"\nUsed to define conditions when complex operations which are bundled together under AGGREGATE to define a logical construct.\n",{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute N\\name"},"children":["Attribute N\\name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This denotes the type of conditions. For list of supported condition types see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#operationConditions"},"children":["Operation Conditions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["attributes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of attributes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the list of attributes on which the conditions hold."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example of AndCondition schema:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"  {\n     \"type\": \"CONSTANT\",\n     \"value\": \"{{NAMESPACE}}:reference-data--VerticalMeasurementPath:ELEV:\",\n     \"targetProperty\": \"data.VerticalMeasurements[#].VerticalMeasurementPathID\",\n     \"andCondition\": [\n       {\n         \"type\": \"ifAllExists\",\n         \"attributes\": [\n           {\n             \"sourceProperty\": \"data.elevationReference.name\"\n           },\n           {\n             \"sourceProperty\": \"data.elevationReference.elevationFromMsl.value\"\n           },\n           {\n             \"sourceProperty\": \"data.elevationReference.elevationFromMsl.unitKey\"\n           }\n         ]\n       }\n     ]\n   }\n"},"children":[]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" Attributes schema properties "]},"\n`Attributes` are used to specify how and from where the value will be taken. They are used in the `AndConditions` schema or with the `CONCATENATE` operation.\n",{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute name"},"children":["Attribute name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["sourceProperty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Denotes the source property for which the condition holds good."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["targetProperty"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Denotes the target property for which the condition holds good."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required when used in the andCondition schema and is of type \"equals\" or in the arrayIndex schema."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This denotes the value of the attribute or indicates the attribute name for which the value needs to be looked up."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example of Attributes schema in the CONCATENATE operation:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"  {\n    \"mappings\": [\n      {\n        \"identifier\": \"data.WellboreId\",\n        \"operations\": [\n          {\n            \"type\": \"CONCATENATE\",\n            \"operator\": \"-\",\n            \"attributes\": [\n              {\n                \"sourceProperty\": \"data.UWI\"\n              },\n              {\n                \"sourceProperty\": \"data.UBHI\"\n              }\n            ],\n            \"targetProperty\": \"data.WellboreId\"\n          }\n        ]\n      }\n    ]\n  }\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/data-workspace/apis/osdu-mapping-service"},"children":["CONCATENATE operation example"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example of Attributes schema in andCondition and is of type \"equals\":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"  {\n    \"mappings\": [\n      {\n        \"type\": \"CONDITIONAL_PRIORITY\",\n        \"operations\": [\n          {\n            \"type\": \"COPY\",\n            \"sourcProperty\": \"data.name\",\n            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\",\n            \"priority\": 1,\n            \"andCondition\": [\n              {\n                \"type\": \"equals\",\n                \"attributes\": [\n                  {\n                    \"sourceProperty\": \"data.name\",\n                    \"value\": \"KB\"\n                  }\n                ]\n              }\n            ]\n          },\n          {\n            \"type\": \"CONSTANT\",\n            \"value\": \"Test Value\",\n            \"targetProperty\": \"data.VerticalMeasurements[#].VerticalCRSID\",\n            \"priority\": 2\n          }\n        ]\n      }\n    ]\n  }\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example of Attributes schema in arrayIndex:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"  {\n    \"mappings\": [\n      {\n        \"type\": \"COPY\",\n        \"targetProperty\": \"data.VerticalMeasurements[#].VerticalReferenceID\",\n        \"value\": \"@targetProperty:data.VerticalMeasurements[?].VerticalMeasurementID\",\n        \"arrayIndex\": {\n          \"targetProperty\": \"data.VerticalMeasurements[?].VerticalCRSID\",\n          \"value\": \"partition-id:reference-data--CoordinateReferenceSystem:VerticalCRS::EPSG::5714:\"\n        }\n      }\n    ]\n  }\n"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mapping-service-operations","__idx":48},"children":["Mapping service operations ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"mapping_service_operations"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mapping service supports the following operations using different endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["###A) Create mapping definition ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"create-mapping"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create a mapping definition using the POST /mappings endpoint as listed in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/data-workspace/apis/osdu-mapping-service"},"children":["API Reference"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sample-mapping-definition-request","__idx":49},"children":["Sample mapping definition request ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"sample"},"children":[]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"mappingIdentity\": {\n    \"authority\": \"`<authority>`\",\n    \"sourceSchema\": {\n      \"authority\": \"`<authority>`\",\n      \"source\": \"petrel\",\n      \"entityType\": \"wellbore\",\n      \"schemaVersionMajor\": 1\n    },\n    \"targetSchema\": {\n      \"authority\": \"`<authority>`\",\n      \"source\": \"wks\",\n      \"entityType\": \"wellbore\",\n      \"schemaVersionMajor\": 1\n    }\n  },\n  \"mappings\": [\n    {\n      \"identifier\": \"locationWGS84\",\n      \"operations\": [\n        {\n          \"type\": \"COPY_SUBSTRUCTURE\",\n          \"sourceProperty\": \"data.locationWGS84\",\n          \"targetProperty\": \"data.locationWGS84\"\n        }\n      ]\n    },\n    {\n      \"identifier\": \"dlLatLongWGS84\",\n      \"operations\": [\n            {\n              \"type\": \"COPY\",\n              \"sourceProperty\": \"data.wellHeadWgs84.latitude\",\n              \"targetProperty\": \"data.dlLatLongWGS84.latitude\"\n            },\n            {\n              \"type\": \"COPY\",\n              \"sourceProperty\": \"data.wellHeadWgs84.longitude\",\n              \"targetProperty\": \"data.dlLatLongWGS84.longitude\"\n            }\n          ]\n    },\n    {\n      \"identifier\": \"WellandDefinitiveTrajectory\",\n      \"operations\": [\n        {\n          \"type\": \"RELATIONSHIP\",\n          \"sourceProperty\": \"data.WellID\",\n          \"targetProperty\": \"data.WellID\"\n        },\n        {\n          \"type\": \"RELATIONSHIP\",\n          \"sourceProperty\": \"data.TrajectoryTypeID\",\n          \"targetProperty\": \"data.TrajectoryTypeID\"\n        }\n      ]\n    },\n    {\n      \"identifier\": \"NameAliases\",\n        \"operations\": [\n          {\n            \"type\": \"COPY\",\n            \"sourceProperty\": \"data.NameAliases[1]\",\n            \"targetProperty\": \"data.NameAliases[0]\"\n          }\n        ]\n    },\n    {\n      \"identifier\": \"ResourceHostRegionIDs\",\n      \"operations\": [\n        {\n          \"type\": \"RELATIONSHIP_ARRAY\",\n          \"sourceProperty\": \"data.ResourceHostRegionIDs[*]\",\n          \"targetProperty\": \"data.ResourceHostRegionIDs[*]\"\n        }\n      ]\n    }\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sample-create-mapping-definition","__idx":50},"children":["Sample create mapping definition ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"sample response"},"children":[]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"`<authority>`:mapping:71e2198321093812w812e9\",\n  \"version\": \"4567891234\",\n  \"mappingIdentity\": {\n    \"authority\": \"`<authority>`\",\n    \"sourceSchema\": {\n      \"authority\": \"`<authority>`\",\n      \"source\": \"petrel\",\n      \"entityType\": \"wellbore\",\n      \"schemaVersionMajor\": 1\n    },\n    \"targetSchema\": {\n      \"authority\": \"`<authority>`\",\n      \"source\": \"wks\",\n      \"entityType\": \"wellbore\",\n      \"schemaVersionMajor\": 1\n    }\n  },\n  \"createdBy\": \"user@abc.com\",\n  \"dateCreated\": 2018-03-20T09:12:28Z,\n  \"scope\": \"INTERNAL\",\n  \"kind\": \"`<authority>`:mapping:mapping:1.0.0\",\n  \"mappingSchemaVersionMajor\": 1,\n  \"mappingSchemaVersionMinor\": 0,\n  \"mappingSchemaVersionPatch\": 0\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["###B) Get all created mapping definitions ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"get-all-mapping"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can get all the created mappings for a specific data partition using the GET /mappings endpoint based on the following parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use"},"children":["Use"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Datatype"},"children":["Datatype"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required (Yes/No)"},"children":["Required (Yes/No)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["scope"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Defines the scope of the created mapping definitions.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Possible value: INTERNAL ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The current implementation only supports getting the INTERNAL mapping definition."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["INTERNAL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["limit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Limits the count of the mapping definitions being fetched."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["20"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If not given, then 50 is the default limit value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["offset"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skips the first few numbers of the mapping definitions while getting it. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," For example, if any data partition has 100 INTERNAL mapping definitions,",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," and you want to view only the last 30 mapping definitions,",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," then you can set offset the value to 70."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["50"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If not given, then 0(zero) is the default offset value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["sourceSchemaKind"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gets the mapping definitions of a specific source."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["osdu:petrel:wellbore:2.0.0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If not given, then all mapping definitions present for the specific",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"data-partition are returned in response irrespective",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"of the sourceSchemaKind."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["###C) Get a specific mapping definition by ID ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"get-specific-mapping"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can get a specific mapping definition using the GET /mappings/{id} endpoint based on the ID of the created mapping definition.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Example mapping definition ID: \"slb-osdu-prod-des-prod-testing:mapping:5384f51d-26df-41e4-a46f-955893628cdd\"."]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Response of a Get specific mapping definition API "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["{"," ","\"mappingInfo\": {"," ","\"id\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},":mapping:71e2198321093812w812e9\","," ","\"version\": 1621788286530,"," ","\"mappingIdentity\": {"," ","\"authority\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},"\","," ","\"sourceSchema\": {"," ","\"authority\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},"\","," ","\"source\": \"petrel\","," ","\"entityType\": \"wellbore\","," ","\"schemaVersionMajor\": 1"," ","},"," ","\"targetSchema\": {"," ","\"authority\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},"\","," ","\"source\": \"wks\","," ","\"entityType\": \"wellbore\","," ","\"schemaVersionMajor\": 1"," ","}"," ","},"," ","\"createdBy\": \"user@abc.com\","," ","\"dateCreated\": \"2018-03-20T09:12:28Z\","," ","\"scope\": \"INTERNAL\","," ","\"kind\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},":mapping:mapping:1.0.0\","," ","\"mappingSchemaMajorVersion\": 1,"," ","\"mappingSchemaMinorVersion\": 0,"," ","\"mappingSchemaPatchVersion\": 0,"," ","\"filelocation\": \"osdu-wks-mappings\","," ","\"fileName\": \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<authority>"]},":mapping:71e2198321093812w812e9:1621788286530.json\","," ","},"," ","\"mappings\": ["," ","{"," ","\"identifier\": \"locationWGS84\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY_SUBSTRUCTURE\","," ","\"sourceProperty\": \"data.locationWGS84\","," ","\"targetProperty\": \"data.locationWGS84\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"dlLatLongWGS84\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\","," ","\"targetProperty\": \"data.dlLatLongWGS84.latitude\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\","," ","\"targetProperty\": \"data.dlLatLongWGS84.longitude\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"WellandDefinitiveTrajectory\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP\","," ","\"sourceProperty\": \"data.WellID\","," ","\"targetProperty\": \"data.WellID\""," ","},"," ","{"," ","\"type\": \"RELATIONSHIP\","," ","\"sourceProperty\": \"data.TrajectoryTypeID\","," ","\"targetProperty\": \"data.TrajectoryTypeID\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"NameAliases\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.NameAliases[1]\","," ","\"targetProperty\": \"data.NameAliases[0]\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"ResourceHostRegionIDs\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP_ARRAY\","," ","\"sourceProperty\": \"data.ResourceHostRegionIDs[",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["]\","," ","\"targetProperty\": \"data.ResourceHostRegionIDs["]},"]\""," ","}"," ","]"," ","}"," ","]"," ","}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The response contains the \"filelocation\" and \"fileName\" attributes, which tell you the loacation of the mapping file. The WKS service uses this actual mapping file to identify the source and target attributes and the mapping operations between them."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["###D) Update a specific mapping definition ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"update-specific-mapping"},"children":[]}," ","You can update a specific mapping definition using the PUT /mappings/{id} API by using the ID of the created mapping definition and the requested body as shown in the following example."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":[" Sample request to update a mapping definition "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["["," ","{"," ","\"identifier\": \"locationWGS84\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY_SUBSTRUCTURE\","," ","\"sourceProperty\": \"data.locationWGS84\","," ","\"targetProperty\": \"data.locationWGS84\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"dlLatLongWGS84\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadWgs84.latitude\","," ","\"targetProperty\": \"data.latitude\""," ","},"," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.wellHeadWgs84.longitude\","," ","\"targetProperty\": \"data.longitude\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"TrajectoryType\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP\","," ","\"sourceProperty\": \"data.TrajectoryTypeID\","," ","\"targetProperty\": \"data.TrajectoryTypeID\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"NameAliases\","," ","\"operations\": ["," ","{"," ","\"type\": \"COPY\","," ","\"sourceProperty\": \"data.NameAliases[1]\","," ","\"targetProperty\": \"data.NameAliases[0]\""," ","}"," ","]"," ","},"," ","{"," ","\"identifier\": \"ResourceHostRegionIDs\","," ","\"operations\": ["," ","{"," ","\"type\": \"RELATIONSHIP_ARRAY\","," ","\"sourceProperty\": \"data.ResourceHostRegionIDs[",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["]\","," ","\"targetProperty\": \"data.ResourceHostRegionIDs["]},"]\""," ","},"," ","{"," ","\"type\": \"RELATIONSHIP_ARRAY\","," ","\"sourceProperty\": \"data.tieInWellbore.ids[",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["]\","," ","\"targetProperty\": \"data.ResourceHostRegionIDs["]},"]\""," ","}"," ","]"," ","}"," ","]"]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Note:"]}," In an update operation, the identifiers and attributes that are present in the mapping[] parameter of the created mapping definition file are replaced with those that are listed in the request body."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here, the update operation generates a new version of the same mapping ID, and when you try to get the mapping, the mapping definition ID with latest version is returned in response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["###E) Delete a specific mapping definition ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"delete-specific-mapping"},"children":[]}," ","You can delete a mapping definition using the DELETE/mappings/{id} endpoint as listed in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/data-workspace/apis/osdu-mapping-service"},"children":["API Reference"]},"."," ","You must be a member of users.datalake.admins."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example mapping definition ID: \"slb-osdu-prod-des-prod-testing:mapping:5384f51d-26df-41e4-a46f-955893628cdd\"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":51},"children":["Prerequisites ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"prerequisites"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-roles","__idx":52},"children":["Required roles ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"required-roles"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mapping service requires that users have dedicated roles in order to use it. Users must be a member of  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["users.datalake.editors"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["users.datalake.admins"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["users.datalake.ops"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to service roles, users must be a member of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["users.datalake.viewers"]}," to access the data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To delete the mapping, users must be a member of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["users.datalake.admins"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-headers","__idx":53},"children":["Required headers ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"required-headers"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While sending a request to the Mapping service, you need 2 mandatory http request headers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"slb-partition-id","__idx":54},"children":["slb-partition-id"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["slb-partition-id"]}," enables read and write operations to the appropriate data partition."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"slb-partition-id: `<authority>`\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"authorization","__idx":55},"children":["Authorization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All APIs require an authenticated user token in the authorization header of the HTTP call."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzIOFDJSosdfjsdoifjSDFOSDSDF\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-specifications","__idx":56},"children":["API specifications ",{"$$mdtype":"Tag","name":"a","attributes":{"name":"api-specs"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All available Mapping service APIs are listed in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/solutions/data-workspace/apis/osdu-mapping-service"},"children":["API Reference"]},"."]}]},"headings":[{"value":"Table of Contents","id":"table-of-contents","depth":2},{"value":"Introduction","id":"introduction","depth":2},{"value":"Concepts","id":"concepts","depth":2},{"value":"Operation types","id":"operation-types","depth":2},{"value":"Operation conditions","id":"operation-conditions","depth":2},{"value":"Key points to note while creating a mapping definition:","id":"key-points-to-note-while-creating-a-mapping-definition","depth":2},{"value":"Use cases","id":"use-cases","depth":2},{"value":"COPY and COPY_SUBSTRUCTURE operations","id":"copy-and-copy_substructure-operations","depth":3},{"value":"Use case 1: COPY operation - Mapping elements of array","id":"use-case-1-copy-operation---mapping-elements-of-array","depth":4},{"value":"Use case 2: COPY operation - Complete array mapping","id":"use-case-2-copy-operation---complete-array-mapping","depth":4},{"value":"Use case 3: COPY_SUBSTRUCTURE operation - Entire substructure mapping","id":"use-case-3-copy_substructure-operation---entire-substructure-mapping","depth":4},{"value":"COPY operation with arrayIndex use cases","id":"copy-operation-with-arrayindex-use-cases","depth":3},{"value":"COPY operation with arrayIndex - Example 1","id":"copy-operation-with-arrayindex---example-1","depth":4},{"value":"COPY operation with arrayIndex - Example 2","id":"copy-operation-with-arrayindex---example-2","depth":4},{"value":"CONSTANT operation","id":"constant-operation","depth":3},{"value":"Use case 4: CONSTANT operation","id":"use-case-4-constant-operation","depth":4},{"value":"Array operations","id":"array-operations","depth":3},{"value":"Use case 5: Absolute index of an array mapping","id":"use-case-5-absolute-index-of-an-array-mapping","depth":4},{"value":"Use case 6: Constants for absolute index","id":"use-case-6-constants-for-absolute-index","depth":4},{"value":"Use case 7: Simple attribute to array","id":"use-case-7-simple-attribute-to-array","depth":4},{"value":"Use case 8: Array of objects to an array of values of any type","id":"use-case-8-array-of-objects-to-an-array-of-values-of-any-type","depth":4},{"value":"CONCATENATE operation","id":"concatenate-operation","depth":3},{"value":"Use case 9: CONCATENATE operation","id":"use-case-9-concatenate-operation","depth":4},{"value":"AGGREGATE, COPY_ARRAY_INDEX, CONDITIONAL_PRIORITY operations","id":"aggregate-copy_array_index-conditional_priority-operations","depth":3},{"value":"Use case 10: AGGREGATE operations","id":"use-case-10-aggregate-operations","depth":4},{"value":"Use case 11: AGGREGATE operations - SPATIAL LOCATION","id":"use-case-11-aggregate-operations---spatial-location","depth":4},{"value":"Use case 12: COPY_ARRAY_INDEX operation","id":"use-case-12-copy_array_index-operation","depth":4},{"value":"COPY_ARRAY_INDEX operation","id":"copy_array_index-operation","depth":4},{"value":"Use case 13:  CONDITIONAL_PRIORITY operation","id":"use-case-13--conditional_priority-operation","depth":4},{"value":"CONDITIONAL_PRIORITY operation example 1","id":"conditional_priority-operation-example-1","depth":4},{"value":"CONDITIONAL_PRIORITY operation example 2","id":"conditional_priority-operation-example-2","depth":4},{"value":"RELATIONSHIP and RELATIONSHIP_ARRAY operations","id":"relationship-and-relationship_array-operations","depth":3},{"value":"Use case 14: Simple to simple attribute mapping in a relationship","id":"use-case-14-simple-to-simple-attribute-mapping-in-a-relationship","depth":4},{"value":"Use case 15: Array to array attribute mapping in a relationship","id":"use-case-15-array-to-array-attribute-mapping-in-a-relationship","depth":4},{"value":"Use Case 16: Simple to array attribute mapping in RELATIONSHIP","id":"use-case-16-simple-to-array-attribute-mapping-in-relationship","depth":4},{"value":"Use Case 17: Array attribute to simple attribute in RELATIONSHIP","id":"use-case-17-array-attribute-to-simple-attribute-in-relationship","depth":4},{"value":"Use Case 18: Use of the hash (#) in relationship operation","id":"use-case-18-use-of-the-hash--in-relationship-operation","depth":4},{"value":"Case1: # only in the target property","id":"case1--only-in-the-target-property","depth":3},{"value":"Case2: # in both the source and target property","id":"case2--in-both-the-source-and-target-property","depth":3},{"value":"REFERENCE_LOOKUP operation","id":"reference_lookup-operation","depth":3},{"value":"Use Case 19:","id":"use-case-19","depth":4},{"value":"Use case 20: REFERENCE_LOOKUP with label","id":"use-case-20-reference_lookup-with-label","depth":4},{"value":"Use Case 21: REFERENCE_LOOKUP with multiple query parameters","id":"use-case-21-reference_lookup-with-multiple-query-parameters","depth":4},{"value":"LOOKUP_BY_QUERY operation","id":"lookup_by_query-operation","depth":3},{"value":"Use Case 22:","id":"use-case-22","depth":4},{"value":"Use Case 23: Lookup for attributes that are of Reference AND master data type :","id":"use-case-23-lookup-for-attributes-that-are-of-reference-and-master-data-type-","depth":4},{"value":"Use Case 24: Lookup for attributes that are reference or master data types with case-insensitive exact match:","id":"use-case-24-lookup-for-attributes-that-are-reference-or-master-data-types-with-case-insensitive-exact-match","depth":4},{"value":"Mapping operation properties","id":"mapping-operation-properties","depth":3},{"value":"Mapping service operations","id":"mapping-service-operations","depth":2},{"value":"Sample mapping definition request","id":"sample-mapping-definition-request","depth":2},{"value":"Sample create mapping definition","id":"sample-create-mapping-definition","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Required roles","id":"required-roles","depth":3},{"value":"Required headers","id":"required-headers","depth":3},{"value":"slb-partition-id","id":"slb-partition-id","depth":5},{"value":"Authorization","id":"authorization","depth":5},{"value":"API specifications","id":"api-specifications","depth":2}],"frontmatter":{"seo":{"title":"Table of Contents"}},"lastModified":"2025-10-30T09:33:28.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/solutions/data-workspace/tutorial/mapping-service","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}