Object Type Collaboration in Anypoint DataGraph

Enabling collaboration on a Level-1 object type allows you to achieve a connected and enriched unified schema.

When you enable collaboration on a type, you allow similar types in your API schema or in other API schemas to collaborate with your type and directly add their own fields. The result is an extended list of fields and dataset, resulting in a more enriched query result for this type.

When you enable collaboration on a type, the type provides its fields to other types in the unified schema or in the local API schema, enabling you to:

  • Create links between types
    See Link Types for more information.

  • Merge types with other types
    See Merge Types for more information.

You can enable collaboration only on Level-1 object types: those directly returned from a query method. See Level-1 and Nested Types for more information.

To successfully understand the requirements for enabling collaboration, you must be familiar with the types in your API schema. See Understand the Elements in an API Schema for more information.

Default Query Method and Primary Key

To enable collaboration on a type, you must configure a default query method and a primary key for that type to access its fields.

The default query method for an object type is the method that returns a single record of that object type for which you want to enable collaboration. You can select a query method as the default only if:

  • It has one required input argument.

  • The input argument is a scalar data type (Int, Float, String, Boolean, or ID).

The primary key is one field of your object type that uniquely identifies a single record of that object type. For a field to be a primary key, it must be visible and it should be non-nullable (represented by a ! sign at the end).

For example, to enable collaboration on the Order type of the following API schema:

ordersById(id: ID!): Order
--------------------
--------------------
Order
--------------------
orderId: ID!
date: String
status: String

In this example, your default query method is ordersById, and its primary key is orderId.ordersById retrieves the Order type and uses orderId to retrieve specific information based on that ID field. Note that the data type of the default query methodโ€™s input argument ID must be the same as the data type of the primary key. In this example, both are of data type ID!.

Enable Collaboration on an Object Type

  1. In the API schema navigation, select the Level-1 object type for which you want to enable collaboration.

  2. In the Collaboration permissions pane, click Enable collaboration.

  3. Set the default query method.

    Default query method set to products by product id
  4. Click Next.

  5. Select a primary key.

    Primary key set to identifier string

Disable Collaboration for an Object Type

If you no longer want an object type to provide its fields to other types, you can disable collaboration for that type. However, if you disable collaboration on an object that is merged with another object type in the unified schema, the merge breaks and creates a conflict that you must resolve.

To disable collaboration:

  1. Click List of APIs added and select the API that contains the object type for which you want to disable collaboration.

  2. In the API schema navigation, select the object type.

  3. In the Collaboration permissions pane, clear the selection for Allow collaboration for this type (Extend this type).

  4. When prompted, confirm that you want to disable collaboration for the object type by clicking Undo merge and disable collaboration.

  5. If a conflict occurs, follow the prompts in Anypoint DataGraph to resolve it.

Was this article helpful?

๐Ÿ’™ Thanks for your feedback!

Edit on GitHub