Compartilhar via

Xrm.WebApi.online.executeMultiple (referência da API do cliente)

Execute uma coleção de operações de ação, função ou CRUD.

Observação

Esse método tem suporte apenas para o modo online (Xrm.WebApi.online).

Se você quiser executar várias solicitações em uma transação, deverá passar um conjunto de alterações como um parâmetro para esse método. Os conjuntos de alterações representam uma coleção de operações executadas em uma transação. Você também pode passar solicitações individuais e conjuntos de alterações juntos como parâmetros para esse método.

Observação

  • Você não pode incluir operações de leitura (recuperar, recuperar várias e funções de API Web) como parte de um conjunto de alterações; isso é de acordo com as especificações do OData v4.
  • As solicitações podem conter até 1.000 solicitações individuais e não podem conter outros lotes. Mais informações: executar operações em lote.

Sintaxe

Execute várias solicitações:

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Execute várias solicitações em uma transação:

Nesse caso, req1e req2req3 são executados em uma transação.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Execute uma combinação de solicitações individuais e várias solicitações em uma transação:

Nesse caso, req1e req2req3 são executados na transação, mas req4 são req5 executados individualmente.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Parâmetros

Nome Tipo Obrigatório Description
requests Matriz de objetos Yes Uma matriz de um dos seguintes tipos:

Objetos em que cada objeto é uma ação, uma função ou uma solicitação CRUD que você deseja executar no ponto de extremidade da API Web. Cada objeto expõe um método getMetadata que permite definir os metadados para a ação, função ou solicitação CRUD que você deseja executar. O método execute aceita esse tipo de parâmetro.

Conjunto de alterações (uma matriz de objetos), em que cada objeto no conjunto de alterações é explicado anteriormente. Nesse caso, todos os objetos de solicitação especificados no conjunto de alterações são executados em uma transação.

Encontre exemplos de solicitação na seção Sintaxe.
successCallback Função Não Uma função a ser chamada quando a operação é executada com êxito. Uma matriz de objetos de resposta é passada para a função. Consulte o valor retornado
errorCallback Função Não Uma função a ser chamada quando a operação falhar. Um objeto com as seguintes propriedades é passado:
- errorCode:Número. O código de erro como um número decimal positivo. Por exemplo, o código de erro documentado como 0x80040333 será retornado como 2147746611.
- message:Corda. Uma mensagem de erro descrevendo o problema.

Valor de retorno

Com êxito, retorna uma promessa que contém uma matriz de objetos para o successCallback. Os objetos têm estas propriedades:

Nome Tipo Obrigatório Description
json Prometer Não Corpo da resposta no formato JSON.
text Prometer Não Corpo da resposta em formato de texto sem formatação.
headers Object Yes Cabeçalhos de resposta.
ok booleano Yes Indica se a solicitação foi bem-sucedida.
status Número Yes Valor numérico no código de status de resposta. Por exemplo: 200
statusText String Yes Descrição do código de status de resposta. Por exemplo: OK
type String Yes Tipo de resposta. Os valores são: a cadeia de caracteres vazia (padrão), arraybuffer, , , documente jsontext. blob
url String Yes Solicitar URL da ação, função ou solicitação CRUD que foi enviada para o ponto de extremidade da API Web.

Xrm.WebApi

  • Last updated on