IBM Support

Configuring Inbound JSON Mapping Records for Spatial Use

General Page

Configuring inbound JSON Mapping records for Spatial use (Location records).

In order to let Spatial know which (and where) GIS attributes are to be saved in Maximo from our Feature Class and vice versa, we need to use the JSON Mapping application.
To make things shorter, we'll be showing how to make this configuration in a Maximo environment with an already configured Map Manager record. So, first of all, please make sure that you have a Map Manager record with all the basics set up (such as Map Services, Service Layers etc). There are two types of JSON Mapping records, inbound and outbound. Their names are pretty suggestive, indicating the direction of the data flow. In this example I'll be configuring an inbound JSON mapper:

1. Open your JSON Mapping application and create a new record.

image-20210326171733-22


2. Fill out the following fields:

  • Give it a name that makes it easy to identify your record later. It is good practice to name the record so you can easily identify the type of records you will be working with. I will be naming it “WATER_MAIN_INBOUND” 
  • In Map Manager, the records I am working with are configured as locations, so I'll populate the Object Structure field as ARCGISLOCATION
  • Leave the direction as Inbound.
image 9002

3. Now, in order to fill the JSON Data field, we'll need to get a query URL from our Map Service, so let's open our Map Service and get to the layer which will be mapped.

image 9003

4. Scroll down the layer's page and click Query.
image 9004

5. We just need to produce a query capable of returning at least one JSON object, which will allow our JSON Mapper to get its attribute structure. Fill out the following fields:
    a. Where: OBJECTID<10
    b. Out Fields: *

image 9005

    c. Format: JSON
    d. Leave the other fields as they are.
    e. Click the Query(GET) button.

image 9006

6. Copy the URL from your browser's address bar and paste it into the URL field of your JSON mapper and tab out of it. Notice that it will fill the JSON Data field automatically.
image 9007
7. Click Save.
image 9008
8. Go to the Properties tab.
image 9009

9. Now we'll have to drill down through the data layers until we get to the attributes, so click Map More Objects.

image 9010

10. In the Select More Objects dialog, select the LOCATIONS object.

image 9011

11. Now, click on the magnifying glass next to the Property Path field of the second line that was just created.

image 9012

12. In the Select Value dialog, select the "//features" item.

image 9013

13. We need to go down one more layer in order to get to our object attributes. So click Map More Objects again, select the LOCATIONS object and then click on the magnifying glass. Now you'll have to select the "//features/attributes" item.

image 9014

14. Your JSON Object Mapping section should now look like this:

image 9015

15. Now let's map our attributes from the JSON object to our Maximo object by clicking New Row under the "JSON Properties Mapping for Process Order 3" section (please note that you need to have the third row from the first section selected).

image 9016

16. We will add the following properties to the JSON Mapping record. When using locations records the required fields are the following:

  • PLUSSISGIS, to specify it is a GIS record.
  • PLUSSFEATURECLASS, which will the GIS Object  identification used in your Map Manager.
  • SITEID that is being used.
  • TYPE to specify which type of location is being used.
  • Location to specify the location of the storeroom.
  • Although it is not required, I will add a DESCRIPTION attribute to more easily identify the record.
     

image 9017

17. Click Save.

image 9018

18. Go to Map Manager and open your map record which contains the Layer you are configuring, then open the Service Layer which corresponds to the feature class we are mapping.

image 9019

19. Expand its line and scroll all the way down to the JSON Map Names section.

image 9020

20. So now let's put our inbound JSON mapper in the Inbound JSON Mapper Name field.

image 9021

21. Your inbound JSON mapper is created and properly configured in your Map Manager record.

[{"Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSG2D3","label":"Maximo Spatial Asset Management"},"ARM Category":[{"code":"a8m50000000CbPaAAK","label":"Industry Solutions->Maximo for Spatial Asset Management"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)"}]

Document Information

Modified date:
01 April 2021

UID

ibm16437023