DataArea

Is where the information that the BOD message carries is provided, in this case GetLocation. The information consists of a Verb and one or more Nouns. The verb (Get) indicates the action to be performed on the Noun (Location).

Element information

Content

• Sequence [1..1]
  1. Get [1..1]    The Get verb is to communicate to a business software component a request for an existing piece or pieces of information to be returned. The Get may be paired with most of the nouns defined in the OAGIS specification.The response to this request is the Show verb. The behavior of a BOD with a Get verb is quite predictable across the nouns it is paired with.The Get is designed to retrieval of information by using that information's primary retrieval field, or key field. The Get verb may also be used to request several documents at once. Selection Criteria:There are two types of selection capabilities for most BOD's that use the Get verb.1) The first selection capability is called Field-Based Selection. Within a Get-based Business Object Document, the first Data Type that occurs in a specific BOD structure is commonly used to provide the Field-Based Selection criteria. This is always defined within the specific BOD and is commonly the required fields for that specific Data type.The Field-Based Selection enables the requester to provide a value or values (in the case of multiple required Field Identifiers), in the required fields. Then the responding component uses those values to find and return the requested information to the originating business software component.2) The second type of selection capability for Get-based BODs is called Data Type Selection. Data Type selection enables the requester to identify which Data Types within the noun are requested to be returned in the response. The use of this capability is described for each corresponding Data Type for all BODs that use the Get verb. The Data Types are identified for retrieval within the Get instance of a BOD by including the name of the Data Type in the meta data but without any Field Identifiers or Segments identified within the Data Type. This will signify to the responding application that all of the data that corresponds to that Data Type is to be included in the response.If the Data Type is not requested, the Data Type identifier is not included in the Get request and this will signify to the responding component that the Data Type is not to be returned.
  2. Location [1..*]    The location of a thing, as captured by an address (or addresses), GPS Coordinates, and/or in relation to other locations.

Attributes

None

Used in

• Type GetLocationType (Element GetLocation)

Sample instance

<DataArea>
   <Get>
      <Expression>token</Expression>
   </Get>
   <Location>
      <ID/>
      <IDSet>
         <ID/>
      </IDSet>
      <Name/>
      <Directions/>
      <Coordinate>
         <ID/>
         <IDSet>...
         </IDSet>
         <Description/>
         <ReferenceSystemID/>
         <VerticalReferenceSystemID/>
         <VerticalMeasure>1.0</VerticalMeasure>
         <LatitudeMeasure>1.0</LatitudeMeasure>
         <LongitudeMeasure>1.0</LongitudeMeasure>
         <VerticalAccuracyMeasure>1.0</VerticalAccuracyMeasure>
         <HorizontalAccuracyMeasure>1.0</HorizontalAccuracyMeasure>
         <Extension>.......................................
         </Extension>
      </Coordinate>
      <Address>
         <ID/>
         <IDSet>...
         </IDSet>
         <Name/>
         <AttentionOfName/>
         <CareOfName/>
         <BuildingNumber/>
         <BuildingName/>
         <BlockName/>
         <StreetName/>
         <StreetTypeCode>normalizedString</StreetTypeCode>
         <Floor/>
         <Unit/>
         <StairCase/>
         <Door/>
         <PostOfficeBox/>
         <DeliveryPointID>normalizedString</DeliveryPointID>
         <PlotID>normalizedString</PlotID>
         <CityName/>
         <CitySubDivisionName/>
         <CountrySubDivisionCode>token</CountrySubDivisionCode>
         <CountryCode>token</CountryCode>
         <PostalCode>normalizedString</PostalCode>
         <Status>...
         </Status>
         <Preference>...
         </Preference>
         <GeographicalCoordinate>...
         </GeographicalCoordinate>
         <Usage>...
         </Usage>
         <Extension>.......................................
         </Extension>
      </Address>
      <Contact>
         <ID/>
         <IDSet>...
         </IDSet>
         <PersonName>...
         </PersonName>
         <RoleCode>normalizedString</RoleCode>
         <JobTitle/>
         <Responsibility/>
         <OrganizationUnitID>normalizedString</OrganizationUnitID>
         <Communication>...
         </Communication>
         <TelephoneCommunication>...
         </TelephoneCommunication>
         <EMailAddressCommunication>...
         </EMailAddressCommunication>
         <InternetAddressCommunication>...
         </InternetAddressCommunication>
         <Preference>...
         </Preference>
         <EffectiveTimePeriod>..................
         </EffectiveTimePeriod>
         <Extension>.......................................
         </Extension>
      </Contact>
      <Communication>
         <ID/>
         <IDSet>...
         </IDSet>
         <Name/>
         <ChannelCode>normalizedString</ChannelCode>
         <UseCode>normalizedString</UseCode>
         <CountryDialingCode>normalizedString</CountryDialingCode>
         <AreaDialingCode>normalizedString</AreaDialingCode>
         <DialNumber/>
         <PhoneExtension/>
         <Access/>
         <Address>...
         </Address>
         <URI>normalizedString</URI>
         <HTMLPreferredIndicator>true</HTMLPreferredIndicator>
         <Text/>
         <EffectiveTimePeriod>..................
         </EffectiveTimePeriod>
         <Preference>...
         </Preference>
         <Extension>.......................................
         </Extension>
      </Communication>
      <PostalAddress>
         <ID/>
         <IDSet>...
         </IDSet>
         <Name/>
         <AttentionOfName/>
         <CareOfName/>
         <BuildingNumber/>
         <BuildingName/>
         <BlockName/>
         <StreetName/>
         <StreetTypeCode>normalizedString</StreetTypeCode>
         <Floor/>
         <Unit/>
         <StairCase/>
         <Door/>
         <PostOfficeBox/>
         <DeliveryPointID>normalizedString</DeliveryPointID>
         <PlotID>normalizedString</PlotID>
         <CityName/>
         <CitySubDivisionName/>
         <CountrySubDivisionCode>token</CountrySubDivisionCode>
         <CountryCode>token</CountryCode>
         <PostalCode>normalizedString</PostalCode>
         <Status>...
         </Status>
         <Preference>...
         </Preference>
         <GeographicalCoordinate>...
         </GeographicalCoordinate>
         <Usage>...
         </Usage>
         <Extension>.......................................
         </Extension>
      </PostalAddress>
      <PhysicalAddress>
         <ID/>
         <IDSet>...
         </IDSet>
         <Name/>
         <AttentionOfName/>
         <CareOfName/>
         <BuildingNumber/>
         <BuildingName/>
         <BlockName/>
         <StreetName/>
         <StreetTypeCode>normalizedString</StreetTypeCode>
         <Floor/>
         <Unit/>
         <StairCase/>
         <Door/>
         <PostOfficeBox/>
         <DeliveryPointID>normalizedString</DeliveryPointID>
         <PlotID>normalizedString</PlotID>
         <CityName/>
         <CitySubDivisionName/>
         <CountrySubDivisionCode>token</CountrySubDivisionCode>
         <CountryCode>token</CountryCode>
         <PostalCode>normalizedString</PostalCode>
         <Status>...
         </Status>
         <Preference>...
         </Preference>
         <GeographicalCoordinate>...
         </GeographicalCoordinate>
         <Usage>...
         </Usage>
         <Extension>.......................................
         </Extension>
      </PhysicalAddress>
      <Description/>
      <Note/>
      <TimeZoneCode>M0100</TimeZoneCode>
      <AvailableTimePeriod>
         <InclusiveIndicator>true</InclusiveIndicator>
         <StartDateTime></StartDateTime>
         <StartTime>token</StartTime>
         <Duration>P1Y2M3DT10H</Duration>
         <EndDateTime></EndDateTime>
         <EndTime>token</EndTime>
      </AvailableTimePeriod>
      <LocationEquipmentSpecification>
         <ID/>
         <IDSet>...
         </IDSet>
         <Property>...
         </Property>
         <Extension>.......................................
         </Extension>
      </LocationEquipmentSpecification>
      <EffectiveTimePeriod>
         <InclusiveIndicator>true</InclusiveIndicator>
         <StartDateTime></StartDateTime>
         <StartTime>token</StartTime>
         <Duration>P1Y2M3DT10H</Duration>
         <EndDateTime></EndDateTime>
         <EndTime>token</EndTime>
      </EffectiveTimePeriod>
      <Extension>
         <AnyExtension>
            <!--any element-->
         </AnyExtension>
         <Amount/>
         <Code/>
         <DateTime></DateTime>
         <ID/>
         <Indicator>true</Indicator>
         <Measure/>
         <Name/>
         <Number>1.0</Number>
         <Quantity/>
         <Text/>
         <Time></Time>
         <ValueText>string</ValueText>
      </Extension>
   </Location>
</DataArea>