Ecriture d'une requête GraphQL

Il est souvent nécessaire d'extraire des données d'événement déjà conservées de Supply Chain Intelligence Suitepour les utiliser dans votre application. Par exemple, vous avez peut-être enregistré une règle d'indicateur clé de performance, puis vous souhaitez ensuite rechercher les événements de métrique d'indicateur clé de performance afin de pouvoir les afficher sur votre tableau de bord. Dans ce tutoriel, vous allez apprendre à émettre une variété de requêtes de base pour extraire des événements de règle métier à partir des API GraphQL de Supply Chain Intelligence Suite.

Avant de commencer

  1. Si vous utilisez GraphQLpour la première fois, suivez les tutorielsgraphql.com jusqu'à ce que vous vous sentiez à l'aise avec les concepts de base de l'API GraphQL .
  2. Ajoutez l'authentification par jeton Web JSON aux en-têtes de demande HTTP. Pour plus d'informations, voir Création de jetons d'authentification.
    Remarque: Si vous ne transmettez pas cet en-tête d'authentification, les API Supply Chain Intelligence Suite renvoient une erreur 401.

A propos de cette tâche

Vous en apprendrez davantage sur les tâches suivantes:

  • Comment écrire une requête GraphQL de base.
  • Comment utiliser les services de requête de Supply Chain Intelligence Suitepour extraire un événement métier déjà conservé.
  • Comment analyser l'événement renvoyé pour l'utiliser dans votre application.

Procédure

  1. Accédez à l'éditeur visuel GraphiQL.
  2. Entrez l'exemple de requête suivant dans la partie gauche de l'éditeur. Si vous disposez d'un exemple d'ID de règle d'un autre tutoriel, remplacez l'ID ci-dessous par l'ID de votre autre règle:
    query{ 
  businessRuleEvents(
    simpleFilter: {
      rule: {
        id: "4cb28d31-4ebc-476c-8460-c79ecd8bbc12"
      }
    },
    cursorParams: {
      first: 1 #Maximum number of items to return
    }
  ){
    totalCount
    pageInfo {
      endCursor
      hasNextPage
    }
    edges {
      cursor
      object {
        eventCode
        timestampEventOccurred
        timestampEventReceived
        
      }
    }
  }
}
  3. Cliquez sur le bouton Exécuter dans la partie supérieure gauche de l'éditeur. Cette opération exécute la requête et extrait les événements métier qui sont déjà stockés pour cette règle.
    image

    La réponse affiche le résultat suivant à droite de l'éditeur:

    {
  "data": {
    "businessRuleEvents": {
      "totalCount": 39,
      "pageInfo": {
        "endCursor": "NGNiMjhkMzEtNGViYy00NzZjLTg0NjAtYzc5ZWNkOGJiYzEyX2V2ZW50ZGV0YWlscy5ldmVudHNvdXJjZS50cmFuc2FjdGlvbnR5cGVfODIwLHRlbmFudGlkXzNlMzc0NDJkLTIyNjUtNDg3ZC1hNTJmLTVlYWQxMTg5M2IxYSxtaW51dGVfMjAwOS0wOC0zMHQxODo0MF8=",
        "hasNextPage": true
      },
      "edges": [
        {
          "cursor": "NGNiMjhkMzEtNGViYy00NzZjLTg0NjAtYzc5ZWNkOGJiYzEyX2V2ZW50ZGV0YWlscy5ldmVudHNvdXJjZS50cmFuc2FjdGlvbnR5cGVfODIwLHRlbmFudGlkXzNlMzc0NDJkLTIyNjUtNDg3ZC1hNTJmLTVlYWQxMTg5M2IxYSxtaW51dGVfMjAwOS0wOC0zMHQxODo0MF8=",
          "object": {
            "eventCode": "businessEvent",
            "timestampEventOccurred": "2009-08-30T18:40:16+0000",
            "timestampEventReceived": "2019-12-05T12:07:00"
          }
        }
      ]
    }
  }
}
    Remarque: Il s'agit d'un système actif. La réponse exacte que vous voyez peut varier de la capture d'écran ci-dessus à mesure que de nouveaux événements sont constamment déclenchés.

Etape suivante

  • Vous pouvez modifier les critères et les attributs pour renvoyer et réexécuter la requête autant de fois que vous le souhaitez.
  • Extrayez la métrique du code JSON renvoyé et utilisez-la si nécessaire.