@openfed configureDescription

Definition

directive @openfed__configureDescription(
    descriptionOverride: String,
    propagate: Boolean! = true
) on ARGUMENT_DEFINITION | ENUM | ENUM_VALUE | FIELD_DEFINITION |
INPUT_FIELD_DEFINITION | INPUT_OBJECT | INTERFACE | OBJECT | SCALAR | SCHEMA | UNION

Overview

The @openfed__configureDescriptiondirective serves four main functions:

Designate a certain description that should be propagated in the federated graph.
Designate a description override that should be propagated in the federated graph.
Designate that a certain description should never be propagated in the federated graph.
Setting a description on an extension type (which usually cannot define descriptions).

Propagate a description to the federated graph

If the propagate argument is set to true (the default value), the description corresponding to the coordinates of the directive in the defining subgraph will be the description that appears for those coordinates in the federated graph.

Hide a description from the federated graph

If the propagate argument is set to false, the description corresponding to the coordinates of the directive in the defining subgraph will not be considered for description that appears for those coordinates in the federated graph.

Override a description

If the propagate argument is set to true (the default value), and the descriptionOverride argument is set to a non-empty string, that string will be the description that appears for those coordinates in the federated graph. If the propagate argument is set to false, the descriptionOverride argument will be ignored.

Composition rules

The coordinates that define the directive must define a description or provide a non-empty value to the descriptionOverride argument.
Only one instance of coordinates may define the propagate with true. Multiple such definitions will produce a composition error.
Any number of instances of coordinates may provide the propagate argument with false.

Examples

Propagating a specific description

# subgraph A
"""
A.Query description
"""
type Query @openfed__configureDescription {
  one: String!
}

# subgraph A
"""
B.Query description 1234
"""
type Query {
  two: String!
}

# federated graph
"""
A.Query description
"""
type Query {
  one: String!
  two: String!
}

Hiding a specific description

# subgraph A
"""
A.Query description
"""
type Query @openfed__configureDescription(propagate: false) {
  one: String!
}

# subgraph A
"""
B.Query description 1234
"""
type Query {
  two: String!
}

# federated graph
"""
B.Query description 1234
"""
type Query {
  one: String!
  two: String!
}

Hiding all descriptions

# subgraph A
"""
A.Query description
"""
type Query @openfed__configureDescription(propagate: false) {
  one: String!
  two: String!
}

# subgraph A
"""
B.Query description 1234
"""
type Query @openfed__configureDescription(propagate: false) {
  two: String!
}

# federated graph
type Query {
  one: String!
  two: String!
}

Setting and propagating a description on an extension type

# subgraph A
extend type Query @openfed__configureDescription(
  descriptionOverride: "A.Query extension description"
) {
  one: String!
}

# subgraph A
"""
B.Query description 1234
"""
type Query {
  two: String!
}

# federated graph
"""
A.Query extension description
"""
type Query {
  one: String!
  two: String!
}

Overriding and propagating a description

# subgraph A
"""
A.Query internal description
"""
type Query @openfed__configureDescription(
  descriptionOverride: "A.Query external description"
) {
  one: String!
}

# subgraph A
"""
B.Query description 1234
"""
type Query {
  two: String!
}

# federated graph
"""
A.Query external description
"""
type Query {
  one: String!
  two: String!
}

@link @openfed requireFetchReasons

⌘I

Getting Started

Concepts

Cosmo Connect

Cosmo ConnectRPC

Router

Studio

Control Plane

GraphQL / Federation

Deployments and Hosting

@openfed configureDescription

Definition

Overview

Propagate a description to the federated graph

Hide a description from the federated graph

Override a description

Composition rules

Examples

Propagating a specific description

Hiding a specific description

Hiding all descriptions

Setting and propagating a description on an extension type

Overriding and propagating a description

​Definition

​Overview

​Propagate a description to the federated graph

​Hide a description from the federated graph

​Override a description

​Composition rules

​Examples

​Propagating a specific description

​Hiding a specific description

​Hiding all descriptions

​Setting and propagating a description on an extension type

​Overriding and propagating a description

Definition

Overview

Propagate a description to the federated graph

Hide a description from the federated graph

Override a description

Composition rules

Examples

Propagating a specific description

Hiding a specific description

Hiding all descriptions

Setting and propagating a description on an extension type

Overriding and propagating a description