Create Ontology objects from Gaia

Similar to how you can add data from the Ontology to a Gaia map, you can also create Ontology objects from a shape you draw, a point you drop, or a tactical graphic you configure on a map by tagging the object within a type-mapped object type which implements the Gaia Geoshape Creatable, Geopoint Creatable, or Milsym Creatable interface.

The sections below outline the end-to-end process to integrate Gaia shapes, points, and tactical graphics with the Ontology:

• Install all necessary Marketplace products.
• Implement the Gaia Geoshape Creatable interface on a supported object type backed by a restricted view.
• Implement the Gaia Geopoint Creatable interface on a supported object type backed by a restricted view.
• Implement the Gaia Milsym Creatable interface on a supported object type backed by a restricted view.
• Register your Ontology and search for your object types in Gaia.
• Draw a new shape on your map and tag it within your object type.
• Drop a new point on your map and tag it within your object type.
• Configure a tactical graphic from a shape drawn on your map and tag it within your object type.

Install prerequisite Marketplace products

Marketplace is Foundry's storefront for published data products or collections of platform resources made available for user installation. You can access Marketplace through the Search... bar or the Applications portal on your home screen.

Once you launch Marketplace, install the following products:

• Core Property Types from the Core Ontology Store, which contains core shared property types, such as an object's classification and geoshape, that can be used on multiple object types in your Ontology.
• Gaia Geoshape Creatable interface from the Gaia App Store, which describes the shape of a geospatial object type to enable consistent modeling of and interaction with other object types of the same shape.
• Gaia Geopoint Creatable interface from the Gaia App Store, which describes the position of a single point object type.
• Gaia Milsym Creatable interface from the Gaia App Store, which describes the shape of a tactical symbol.

Core Property Types from the Core Ontology Store

To install the Core Property Types product from the Core Ontology Store:

1. Search for and select Core Ontology Store using the Search stores... bar on the right side of your screen.
2. Select the Core Property Types product from the store menu.

3. Choose the Install or Install again button on the right side of your screen to launch a draft installation. You can optionally add a descriptive suffix to your installation.

4. Identify a Namespace where your installation will save. Marketplace will automatically create a new Project within the chosen Namespace.
5. Configure the product's classification and access controls under Permissions. The classification you select under Classification based access control (CBAC) defines the maximum classification for the installation.
6. Select Next.
7. Validate the Shared property list generated by the Core Property Types product, which may vary based on the product's version, before you select Next.
8. Update the automatic configurations in New versions as necessary for your use case before you select Next. Marketplace pre-configures certain products to upgrade automatically.

9. Review your product's configurations and select Install.

You can search for your newly installed and suffixed Core Property Types product using Quicksearch.

You will next install the Gaia Geoshape Creatable and Gaia Geopoint Creatable interfaces from the Gaia App Store in Marketplace.

Gaia Geoshape Creatable interface from the Gaia App Store

In Foundry, interfaces exist within your Ontology to describe an object type's shape as well as its capabilities, enabling consistent modeling and interaction between object types of a common shape. You can implement an interface on multiple object types, and interfaces may extend any number of other interfaces. Once implemented on an object type, the Gaia Geoshape Creatable interface enables you to create objects in your Ontology from shapes drawn on a Gaia map.

To install the Gaia Geoshape Creatable interface from Marketplace:

1. Navigate back to Marketplace and search for the Gaia App Store in Search stores....
2. Choose the Gaia Geoshape Creatable product.
3. Select the blue Install button on the right side of your screen to launch a draft installation. You can optionally add a descriptive suffix to your installation.
4. Identify a Namespace where your installation will save. Marketplace will automatically create a new Project within the chosen Namespace.
5. Configure the product's classification and access controls under Permissions. The classification you select under Classification based access control (CBAC) defines the maximum classification for the installation.
6. Select Next to launch the installation window's Inputs page.
7. Select the Shared properties tab under Inputs in the left panel to map shared properties from your Ontology to your new interface, such as Classification and Geoshape.

8. Map shared properties for the missing Classification and Geoshape inputs before you select Next to launch the installation window's Content page.

9. Optionally toggle on Prefix Ontology entities and insert a valid prefix. Note that your prefix may not contain certain special characters, such as parentheses or brackets.
10. Choose which Ontology schema migrations to enable on the right side of your screen. You can reference additional schema management information within the existing object edits and materializations documentation.
11. Update the automatic configurations in New versions as necessary for your use case before you select Next. Marketplace pre-configures certain products to upgrade automatically.
12. Review your interface's configurations and select Install.

Gaia Geopoint Creatable interface from the Gaia App Store

To install the Gaia Geopoint Creatable interface from Marketplace's Gaia App Store, select the Gaia Geopoint Creatable product from the store menu. Marketplace's interface installation workflows are common across different interfaces, so you can follow the same steps outlined in the Geoshape Creatable interface installation instructions above with the following distinctions:

• In the Shared properties window, you will map the following shared properties from your Ontology to the Gaia Geopoint Creatable interface:
  • Classification
  • Geopoint

Gaia Milsym Creatable interface from the Gaia App Store

Create an object type that implements the Gaia Geoshape Creatable interface

Gaia can discover object types backed by a restricted view in your Ontology after they implement the Gaia Geoshape Creatable interface. In the following sections, you will:

• Create an object type-backing restricted view.
• Create an object type and enable its integration with Gotham through type mapping.
• Configure an Action type to enable object creation in Gaia.
• Implement the Gaia Geoshape Creatable interface.

Create an object type-backing restricted view

To create an object type that can integrate with Gaia, you will first need to create a restricted view from a dataset that contains, at a minimum, the following columns:

• Name, which you will set as a string to enable a user to title their shape as an object.
• Classification, which you will set as an array to capture your object's classification.
• Geoshape, which you will set as a string for Gaia to automatically populate with your drawn object's shape.
• Map ID, which you will set as a string for Gaia to automatically populate with your drawn object's map ID.
• Object ID, which you will set as a string for Foundry to automatically populate with a unique ID for each Gaia shape you create as an object.

Select the New button in your Project to upload an existing file, such as a .csv, or use Fusion to create the dataset which backs your restricted view.

Your restricted view should contain a granular policy that restricts user access to the data contained in the view based on their classification access. Compose the granular policy as the first step in the Create '{restricted view}' window.

You can reference an example policy in JSON below.

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
  "condition": {
    "and": {
      "conditions": [
        {
          "markings": {
            "value": {
              "field": {
                "fieldName": "classification"
              },
              "type": "field"
            },
            "filters": [
              {
                "markingTypes": {
                  "markingTypes": [
                    "CBAC"
                  ]
                },
                "type": "markingTypes"
              }
            ]
          },
          "type": "markings"
        }
      ]
    },
    "type": "and"
  }
}

Create and type-map an object type

Once you configure your restricted view, launch Ontology Manager and follow the steps below to create your object type and type-map it to enable integration with Gotham:

1. Select New > Object type from the top right of your screen.
2. Select Use existing datasource and choose Select datasource to locate and Select your restricted view before choosing Next.
3. Name your object type and optionally enter a Description.
4. Set Object ID as the Primary Key and Name as the Title.
5. Ensure Classification's Property is an array of strings and Geoshape's Property is geoshape.

6. Select Create, as you will generate and configure Action types after object type creation.

With your draft object type viewable in Ontology Manager, you will next select the Classification, Geoshape, and Map ID properties as shared property types in your Ontology. Select the Properties panel beneath Overview and follow the steps below to complete the shared property type selection process:

1. Select Classification from your list of properties to launch the Property editor window on the right side of your screen.
2. Update the Base type dropdown menus to contain Marking and CBAC Marking, respectively.
3. Configure the property's Max Classification.

4. Scroll to the bottom of the window to the Shared property section to assign Classification as a shared property in the Select a shared property dropdown menu.

Repeat steps 1 and 4 above for your Geoshape and Map ID properties, as you will not need to configure their Markings or classification. Assign Map ID to the Id shared property you installed as part of the Core Property Types product.

Select the green Save button at the top of the screen to publish incremental changes to your Ontology before proceeding.

Next, you will render objects within your object type as discoverable from Gotham applications by completing the type mapping process. Select the Capabilities panel beneath Datasources and follow the steps below to type-map your object type's properties:

1. Scroll down to and toggle on Gotham Integration.
2. Select Create new object type under Object type.
3. Choose the appropriate Parent category for your object type.
4. Optionally clone your non-shared property types by selecting Create a clone of the property in Gotham to the right of each in the dropdown menu.

Ontology Manager automatically type-maps Geoshape and populates your other shared property types, such as Classification and Id, in the Property types dropdown menu to the right of each property type.

Additionally, Ontology Manager provides an optional interface to configure intrinsic values on Gotham objects derived from properties you type-map from your Ontology. Gotham's object model enables you to set property types in your Ontology that contain geotemporal data as metadata of an object in Gotham. As an example, if you create a Vessel object type in your Ontology whose object instances contain a geohash property type that records the object's location, then you can set the geohash property type as an object-level intrinsic in Gotham.

Create and configure an Action type to enable object creation in Gaia

Once the properties of your object type are configured to enable Gotham integration, you can navigate back to the Overview window in Ontology Manager. Here, you will create an Action type that enables users to create objects from shapes and configure their properties, such as Name and Category, from Gaia. Follow the steps below to configure your Action type:

1. Select New from the Action types section of your object type's Overview window to launch the Create a new action type pop-up window.

2. Select Create object under Object actions before choosing Next.
3. Select Add property to add all your existing properties to the Action type, then choose Next to configure your Action type's metadata.
4. Name your Action type, and optionally enter a description and update its default icon.
5. Search for a group or user who may execute the Action, then select Create.

Select the green Save button at the top of the screen to publish incremental changes to your Ontology before proceeding.

Next, you will configure your Action type's Rules and Parameters by following the steps below:

1. Select Rules from the left side of the screen.
2. Reconfigure the Geoshape property as a string type by selecting the arrow icon next to Configure parameter.
   • Select String from the Type dropdown menu on the right side of the screen.
   • Ensure the Disabled option is selected in the General panel so a user cannot manually configure the location of a Geoshape.

3. Select your Classification property from the Form content panel on the left side of your screen and verify that its Type is Marking.
4. Select your Id property from the Form content panel on the left side of your screen and toggle on Disabled in the General panel to ensure a user cannot manually configure your map's Id.
5. Select Back to Form and remove Object Id from Form content by selecting the X icon on the far right side of the Object Id panel. Foundry will automatically generate a unique ID for each object created from Gaia.
6. Select the green Save button at the top of your screen to save your Action type's configurations to the Ontology.

Implement the Gaia Geoshape Creatable interface

The final step in creating and configuring your object type in Ontology Manager is to implement the Gaia Geoshape Creatable interface that you previously installed from Marketplace. Navigate back to your object type's Overview page and follow the steps below to implement the interface before saving changes to your Ontology:

1. Navigate to the Interfaces window beneath Object Views on the left side of your screen.
2. Select Implement new interface and search for Gaia Geoshape Creatable before choosing Next.
3. Map your Ontology's shared property types to the object type implementing the interface by selecting Replace existing for your Geoshape property. Classification will map automatically.

4. Select Confirm to close the Implement an interface window and Save the newly configured interface to your Ontology.

Create an object type that implements the Gaia Geopoint Creatable interface

To create an object type that implements the Gaia Geopoint Creatable interface, you can follow the same steps outlined in the object type creation instructions for the Gaia Geoshape Creatable interface above with the following distinctions in each section:

• Create an object type-backing restricted view.
  • Create a Geopoint instead of Geoshape column.
• Create an object type and enable its integration with Gotham through type mapping.
  • In the object type creation window, ensure Geopoint's Property is geopoint.
  • Map Geopoint instead of Geoshape in the Property types section of the Gotham Integration panel.
• Configure an Action type to enable object creation in Gaia.
  • Ensure your Geopoint property's Type is Geohash in your Action type's Parameters window.
• Implement the Gaia Geoshape Creatable interface.
  • Search for the Gaia Geopoint Creatable instead of the Gaia Geoshape Creatable interface.
  • When mapping your Ontology's shared property types, select Replace existing for the Geopoint instead of the Geoshape property.

Create an object type that implements the Gaia Milsym Creatable interface

To create an object type that implements the Gaia Milsym Creatable interface, you can follow the same steps outlined in the object type creation instructions for the Gaia Geoshape Creatable interface above with the following distinctions in each section:

• Create an object type-backing restricted view.
  • You will only need to create Object ID, Classification, and Title columns.
• Create an object type and enable its integration with Gotham through type mapping.
  • In the object type creation window, set Object ID as the Primary key and Title as the Title.
  • Select Create a clone of the property in Gotham for the Object ID property type in the Property types section of the Gotham Integration panel. Foundry automatically maps all the object type's shared property types.

When configuring an Action type to enable object creation, select Modify or create object in the Create a new action type popup window to ensure you and other users can both create a new and modify an existing tactical graphic object. Follow the steps below to complete the Action type's remaining configuration:

1. Select Auto-generated primary key from the Or create a new object with dropdown menu.
2. Select Add property to map at least the Classification, MIL2525 Symbol Anchor Points, and SIDC properties before you select Next.

3. Enter a name for your Action type and optionally provide a Description and configure an Icon before you select Next.
4. Search for a group or user who may execute the Action, then select Create.

Select the green Save button at the top of the screen to publish incremental changes to your Ontology before proceeding.

Next, you will configure your Action type's Rules and Parameters by following the steps below:

1. Select Rules from the left side of the screen.
2. Select the arrow icon to the right of your Classification property to Configure parameter.

3. Toggle on Disabled in the General section to ensure the object created inherits its classification markings from your Gaia map.
4. Select Add under Set a parameter max classification to ensure the Action type's maximum classification matches the object type's maximum classification.

5. Select the green Save button at the top of the screen to publish the Action type to your Ontology.

• Implement the Gaia Geoshape Creatable interface.
  • Search for the Gaia Milsym Creatable instead of the Gaia Geoshape Creatable interface.
  • When mapping your Ontology's shared property types, select Replace existing for your Classification property and Create edit-only property for the others.

Register your Ontology and its types in the Gaia admin application

Now, you have object types that implement the Gaia Geoshape Creatable, Gaia Geopoint Creatable, and Gaia Milsym Creatable interfaces and contain accompanying Action types that enable a user to configure objects they create from shapes drawn, points dropped, and tactical graphics configured on a Gaia map. Next, you will register your Ontology, object types, and Action types in Gaia's admin application.

To register your Ontology, object types, and Action types, launch the Gaia admin application and follow the steps below:

1. Locate the Ontology Config panel and verify your Ontology's configuration. If your Ontology is not configured, select the toggle on the left side of the panel to set Ontology Config to overridden.
2. Enter your Ontology's RID and API name into the Ontology RID and API Name text boxes.

3. Locate the Foundry Object Creation Config panel and select Show.
4. Select Add at the bottom of your enrollment's existing object and Action type list.
5. Copy and paste the RIDs for all three object types and their supporting Action types into three separate Object type rid and Action type rid text boxes, respectively.
6. Select Preview and save in the top right ribbon.

You can access your object type's RID from the Overview window in Ontology Manager. Select the clipboard icon to copy the RID. Additionally, you can access your Action type's RID by selecting Create {object type name} in the Action types section of the Overview window. The Action type's RID can also be copied through the clipboard icon.

Next, you will launch Gotham's Gaia application to create objects from shapes you draw, points you drop, and tactical graphics you configure on a map using its Add to map menu.

Draw a new shape on your Gaia map and tag it to an object type

With your Gaia map open, select a shape to draw from the Add to map menu in the top left region of your map. When you finish drawing your shape, the Create shape window will appear in Gaia's left panel. Follow the steps below to configure your shape and save it to your Ontology as an object:

1. Select the arrow on the far right of the Tag as object (optional) panel.
2. Search for and select your object type in the Object type dropdown menu.
3. Enter a Category and Name for your object before you select Finish.

Once you save your shape as an object, it will render as a Map layer in Gaia's left panel. You can select the object's name to launch the Selection panel on the right side of your screen, where you can view its properties and customize its appearance.

You can also view your object in Foundry's Object Explorer.

Drop a new point on your Gaia map and tag it to an object type

With your Gaia map open, select a Symbol to drop as a geopoint from the Add to map menu in the top left region of your map which launches the Create symbol window in Gaia's left panel. Select anywhere on your map to drop the symbol, and Gaia will automatically populate the Coordinates input box based on your map's coordinate system preference.

Follow the steps below to configure your geopoint and save it to your Ontology as an object:

1. Optionally adjust the Bearing (mag) of your geopoint.
2. Select the arrow on the far right of the Tag as object (optional) panel.
3. Search for and select your object type in the Object type dropdown menu.
4. Enter a Title for your object before you select Finish.

You can also tag an existing annotation as an object by double-clicking its symbol on your map or hovering your cursor over the annotation's pencil icon in Map layers to launch the Edit symbol window in the left panel.

Once you save your geopoint as an object, you can interact with the new map layer and view the object in Foundry's Object Explorer in the same manner you can for a shape drawn on your map.

To learn more about the various methods you can use to add data from your Ontology to Gotham, review the existing geospatial data integration documentation.

Configure a tactical graphic on your Gaia map and tag it to an object type

With your Gaia map open, select Symbol in the Add to map menu in the top left region of your map to render the symbol Search menu. Type the name of your desired tactical graphic in the Search symbols... input box, such as Brigade Support Area.

The Create shape window will appear in Gaia's left panel, and you can follow the same shape creation instructions above to add your tactical graphic to the map and tag it to an object type.