Partager via


Gérer les relations dans l’API Fabric pour GraphQL

GraphQL vous permet d’établir des relations entre les types, y compris les relations un-à-un (1:1), un-à-plusieurs (1 :N) et plusieurs-à-plusieurs (M :N).

Créer une relation un-à-un

  1. Dans le volet Explorateur de schémas , sélectionnez les points de suspension en regard d’un type, puis sélectionnez l’option Gérer les relations . L’écran Gérer les relations s’affiche.

    Capture d’écran montrant où sélectionner une nouvelle relation dans le volet Gérer les relations.

  2. Cliquez sur Nouvelle relation. Pour cet exemple, nous créons une relation un-à-un entre le type Produit et le type ProductModel, en fonction du champ ProductModelID qui existe dans les deux types. Nous sélectionnons Un à un pour la cardinalité, sélectionnez les types De et À, puis les champs De et À pour cette relation.

    Capture d’écran montrant des exemples de sélections pour les cinq champs requis pour une nouvelle relation.

Remarque

Vous pouvez sélectionner plusieurs champs dans les sélecteurs de champs De et À. Cette fonctionnalité vous permet de créer des relations qui incluent plusieurs champs.

  1. Sélectionnez Créer une relation. Votre liste de relations affiche maintenant la relation nouvellement créée.

    Capture d’écran montrant la relation nouvellement créée dans le volet Gérer les relations.

  2. Sélectionnez le X dans le coin supérieur droit pour fermer l’écran Gérer les relations .

Relations un-à-plusieurs (1:N) et plusieurs-à-plusieurs (M:N)

Pour créer une relation un-à-plusieurs (1:N), par exemple entre Produit et Commande, où chaque produit peut être associé à plusieurs commandes, sélectionnez Un à plusieurs comme cardinalité. Cette relation reflète l’idée qu’un seul produit peut être lié à plusieurs commandes, mais chaque commande est liée à un seul produit.

Pour une relation plusieurs-à-plusieurs (M:N), comme celle entre les Livres et Auteurs, dans laquelle un livre peut avoir plusieurs auteurs et un auteur peut avoir plusieurs livres, choisissez Plusieurs à plusieurs comme cardinalité. Vous devez disposer d’un type de liaison dans votre schéma pour prendre en charge ce type de relation.

La boîte de dialogue Nouvelle relation affiche un autre ensemble de sélecteurs lorsque vous sélectionnez Plusieurs-à-plusieurs comme cardinalité. Par exemple, dans Books and Author, sélectionnez un type de liaison tel que BooksAuthors et des champs tels que BookId et AuthorId comme liaison depuis et vers des champs.

Capture d’écran de la nouvelle boîte de dialogue de relation pour une relation plusieurs à plusieurs.

Considérations pour les relations plusieurs-à-plusieurs

Si votre type de liaison comporte un ou plusieurs champs qui ne sont pas référencés en tant que champs De ouÀ, l’API pour GraphQL génère automatiquement les quatre relations un-à-plusieurs suivantes :

  • Relation un-à-plusieurs du type De au type de liaison

  • Relation un-à-plusieurs du type de liaison au type De

  • Relation un-à-plusieurs du type À au type de liaison

  • Relation un-à-plusieurs du type de liaison au type À

Celles-ci vous permettent de référencer les champs non liés dans le type de liaison dans toutes les requêtes ou mutations, et de laisser les requêtes ou mutations référencer les relations dans n’importe quelle direction.

S’il n’existe aucun champ non lié dans le type de liaison, une relation plusieurs-à-plusieurs unique est créée, et les requêtes ou mutations n’ont pas besoin de référencer le type de liaison pour utiliser la relation.

Supprimer une relation

Supprimez une relation de l’écran Gérer les relations en cochant la case en regard de la relation et en sélectionnant Supprimer.