Logo
Interakcja z API GraphQL
Interakcja z API GraphQLWykonywanie mutations masowych

Wykonywanie mutations masowych

Gato GraphQL dostarcza pola mutation "bulk" dla wszystkich mutations w schemacie, umożliwiając mutowanie wielu zasobów jednocześnie.

Na przykład mutation createPosts (mutation dla pojedynczego zasobu to createPost) utworzy wiele postów:

mutation CreatePosts {
  createPosts(inputs: [
    {
      title: "First post"
      contentAs: {
        html: "This is the content for the first post"
      }
    },
    {
      title: "Second post"
      contentAs: {
        html: "Here is another content, for another post"
      }
      excerpt: "The cup is within reach"
    },
    {
      title: "Third post"
      contentAs: {
        html: "This is yet another piece of content"
      },
      authorBy: {
        id: 1
      },
      status: draft
    }
  ]) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    post {
      id
      title
      content
      excerpt
      author {
        name
      }
      status
    }
  }
}

Argumenty

Wszystkie mutations masowe przyjmują dwa argumenty:

  • inputs (wymagany): Tablica elementów wejściowych, gdzie każdy element zawiera dane do mutowania jednego zasobu
  • stopExecutingMutationItemsOnFirstError (domyślnie false): Określa, czy w przypadku gdy którykolwiek z elementów wejściowych spowoduje błąd, wykonywanie mutation na kolejnych elementach powinno zostać przerwane.

Wszystkie mutations są wykonywane w tej samej kolejności, w jakiej zostały podane w argumencie inputs.

Przypadki użycia

Mutations masowe otwierają nowe możliwości zarządzania naszą witryną WordPress.

Na przykład poniższe query GraphQL używa createPosts do duplikowania postów:

query ExportPostData
{
  postsToDuplicate: posts {
    rawTitle
    rawContent
    rawExcerpt
    postInput: _echo(value: {
      title: $__rawTitle
      contentAs: {
        html: $__rawContent
      },
      excerpt: $__rawExcerpt
    })
      @export(as: "postInputs", type: LIST)
      @remove
  }
}
 
mutation CreatePosts
  @depends(on: "ExportPostData")
{
  createPosts(inputs: $postInputs) {
    status
    errors {
      __typename
      ...on ErrorPayload {
        message
      }
    }
    post {
      id
      title
      content
      excerpt
    }
  }
}