Jaa kautta

Fabric-ohjelmointirajapinta GraphQL-editorille

Fabric-ohjelmointirajapinta GraphQL:lle tarjoaa graafisen selaimessa olevan GraphQL-kehitysympäristön, jossa vuorovaikutteinen leikkikenttä voi luoda, testata ja nähdä GraphQL-kyselyiden ja mutaatioiden reaaliaikaiset tulokset.

Voit siirtyä editoriin avaamalla GraphQL-kohteen ohjelmointirajapinnan sen työtilasta Fabricissa ja valitsemalla portaalinäytön vasemmasta alakulmasta Kysely .

Näyttökuva, jossa näkyy Kysely-vaihtoehto Kangas-näytön vasemmassa alakulmassa.

Kirjoita ja suorita GraphQL-kyselyt suoraan Kysely-välilehdessä . Intellisense-ominaisuudet ovat käytettävissä pikanäppäimellä: CTRL + välilyönti (Windows) tai komento + välilyönti (macOS). Valitse Suorita, jos haluat suorittaa kyselyn ja noutaa tiedot tietolähteestä.

Näyttökuva ohjelmointirajapinnan muokkausnäytöstä, jossa näkyy Kysely-välilehti, joka on jaettu Suorita-, Kyselymuuttujat- ja Tulokset-ruutuihin.

Luo koodi

Kun haluttu GraphQL-toiminto on testattu ja prototyyppi, API-editori luo vakio-Python- tai Node.js koodia editorissa suoritetun kyselyn tai mutaation perusteella. Voit ajaa luodun koodin paikallisesti testaustarkoituksiin ja käyttää sen osia uudelleen sovelluskehitysprosessissa.

Tärkeä

Luotu koodi käyttää vuorovaikutteisen selaimen tunnistetietoja, ja sitä tulee käyttää vain testaustarkoituksiin. Tuotantoympäristössä rekisteröi aina sovellus Microsoft Entrassa ja käytä sen vaikutusalueita client_id . Esimerkki mallikoodista on osoitteessa Sovellusten yhdistäminen.

Aloita suorittamalla kysely, valitsemalla Luo koodi -painike ja valitsemalla kieli vastaavasti:

Kuvakaappaus API-editorin näytöstä, jossa näkyy koodin luontivaihtoehto.

Voit sitten kopioida luodun koodin ja tallentaa sen tiedostona paikalliseen kansioon. Noudata valitusta kielestä riippuen näitä yksinkertaisia ohjeita testataksesi paikallisesti:

Python

  1. Luo virtuaaliympäristö suorittamalla komento python -m venv .venv.

  2. Aktivoi juoksemalla venv.venv\Scripts\activate tai source .venv/bin/activate.

  3. Asenna tarvittava riippuvuus suorittamalla pip install azure.identity.

  4. Suorita koodi komennolla python <filename.py>.

Node.JS

  1. Luo package.json samassa kansiossa, jonka tallensit, tiedosto, jossa on seuraava sisältö:

    {
  "type": "module",
  "dependencies": {}
}

  2. Suorita npm install --save @azure/identity tai vastaava komento valitsemassasi paketinhallinnassa asentaaksesi tunnistetietokirjaston uusimman version.

  3. Suorita koodi komennolla node <filename>.js.

Kyselyjen ja mutaatioiden kehitys

Tutustu tähän lyhyeen GraphQL-malliin. Se määrittelee yhden Post tyypin, jossa on kyselyitä yksittäisen viestin lukemiseksi tai kaikkien viestien luettelemiseksi ja mutaatioita viestien luomiseksi, päivittämiseksi tai poistamiseksi, mikä tukee kaikkia CRUDL-käyttötapauksia (luo, lue, päivitä, poista, luettelo).

{
  type Post {
    id: ID!
    published: Boolean
  }

  type Query {
    getPost(id: ID!): Post
    getAllPosts: [Post]
  }

  type Mutation {
    createPost(title: String!, content: String!, author: String!): Post
    updatePost(id: ID!, title: String, content: String, author: String, published: Boolean): Post
    deletePost(id: ID!): Boolean
  }
}

Lue GraphQL:n kautta paljastetut tiedot millä tahansa rakenteessa määritetyllä kyselyllä. Kysely getPost näyttää samalta kuin tässä esimerkissä.

query MyQuery {
  getPost(id: "1234") {
    title
    content
    author
  }
}

Vastaus:

{
  "data": {
    "getPost": {
      "title": "First Post",
      "content": "This is my first post.",
      "author": "Jane Doe"
    }
  }
}

Käytä mutaatioita, kuten createPost kirjoittaaksesi tietoja ja luodaksesi viestin vaadituilla parametreilla.

mutation MyMutation {
  createPost(title: "Second post", content: "This is my second post", author: "Jane Doe", published: false) {
    id
    title
    content
    author
  }
}

Vastaus:

{
  "data": {
    "createPost": {
      "id": "5678",
      "title": "Second Post",
      "content": "This is my second post.",
      "author": "Jane Doe"
    }
  }
}

Kyselyn muuttujat

Kysely-välilehden oikealla puolella olevan Kyselymuuttujat-ruudun avulla voit välittää parametreja muuttujina kyselyihin tai mutaatioihin. Muuttujat toimivat kuten muuttujat muissa ohjelmointikielissä. Jokainen muuttuja ilmoitetaan nimellä, jota käytetään siihen tallennetun arvon käyttämiseen. Edellisen mutaatioesimerkin avulla muokkaat sitä hieman kyselymuuttujien käyttämiseksi.

mutation MyMutation ($title: String!, $content: String!, $author: String!){
  createPost(title: $title, content: $content, author: $author) {
    id
    title
    content
    author
  }
}

Määritä muuttujat ruudussa seuraavan esimerkin avulla.

{
  "id": "5678",
  "title": "Second Post",
  "content": "This is my second post.",
  "author": "Jane Doe"
}

Muuttujat tekevät mutaatiokoodista puhtaamman, helpommin luettavan, testattavan ja muokattavan.

Liittyvä sisältö

  • Last updated on