Retrieve Equipment Object Map Positions

Explanation

Use this activity to retrieve the position of an equipment object using its address fields.

Prerequisites

Map Positions should be added to the Service List for the business object type that is being defined on the Object Connections window.

System Effects

After the position of an object has been successfully retrieved or transferred, position objects will be created with a connection to the equipment objects on the Virtual Map.

Window

Retrieve Object Map Positions

Related Window Descriptions

Retrieve Object Map Positions

Procedure

1. Open the Retrieve Object Map Positions window.
2. Populate the window to obtain the list of all equipment objects or query for an existing equipment object (F3).
3. In the Populate Filter field, select All, With Addresses or Without Addresses depending on how you want to sort the populated list of equipment objects.
4. In the Import Configurations group of fields, map the segments of the equipment object address to the address elements they match using the Address 1-7 fields. For example, the Zip Code 114 51 defined on an equipment object needs to be mapped to the Postal Code part of the address. Refer to the Address Class Microsoft documentation for more details.
5. Click Retrieve Positions to retrieve the positions for the equipment objects. Note: If positions for equipment objects without addresses were attempted to be retrieved, the import of these coordinates will fail. Click Reload Failed Positions to obtain the list of equipment objects for which the position retrieval failed. Assuming the address fields were properly matched to the equipment object address, the reason for the failure of the retrieval is attributed to the address information on the object being incorrectly entered. Right click on the equipment object and view the object information. Correct the address information as necessary.