Logo
Взаимодействие с GraphQL API
Взаимодействие с GraphQL APIВыполнение массовых мутаций

Выполнение массовых мутаций

Gato GraphQL предоставляет поля «bulk»-мутаций для всех мутаций в схеме, позволяя изменять сразу несколько ресурсов.

Например, мутация createPosts (мутация для одного ресурса — createPost) создаст несколько записей:

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
    }
  }
}

Аргументы

Все массовые мутации принимают два аргумента:

  • inputs (обязательный): массив входных элементов, где каждый элемент содержит данные для изменения одного ресурса
  • stopExecutingMutationItemsOnFirstError (по умолчанию false): указывает, следует ли прекратить выполнение мутации для последующих элементов, если один из них вернул ошибку.

Все мутации выполняются в том же порядке, в котором элементы переданы в аргументе inputs.

Варианты использования

Массовые мутации открывают широкие возможности для управления сайтом WordPress.

Например, следующий GraphQL query использует createPosts для дублирования записей:

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
    }
  }
}