Ejecución de varias solicitudes mediante el SDK para .NET

El objetivo principal de ejecutar varias solicitudes es mejorar el rendimiento en entornos de alta latencia al reducir el volumen total de datos transmitidos a través de la red.

Puede utilizar el mensaje ExecuteMultipleRequest para admitir un rendimiento superior de mensajes en masa que pasan entre escenarios de Microsoft Dataverse. ExecuteMultipleRequest acepta una colección de entrada de mensajes Requests, ejecuta cada una de las solicitudes de mensajes en el orden que aparecen en la colección de entrada y opcionalmente devuelve una colección de Responses que contiene la respuesta de cada mensaje o el error que se han producido. Cada solicitud de mensaje en la colección de entrada se procesa en una transacción independiente de la base de datos. Use el método IOrganizationService.Execute para ejecutar ExecuteMultipleRequest.

En general, ExecuteMultipleRequest se comporta de la misma manera que si ejecutara cada solicitud de mensaje en la colección de solicitudes de entrada por separado, excepto que con mejor rendimiento. El proxy de servicio respeta el uso del CallerId parámetro y lo aplica a la ejecución de cada mensaje de la colección de solicitudes de entrada. Los complementos y las actividades de flujo de trabajo se ejecutan según lo previsto para cada mensaje procesado.

Los complementos y las actividades de flujo de trabajo personalizadas pueden usar ExecuteMultipleRequest. Sin embargo, no se recomienda este enfoque. Cualquier error en el paso sincrónico debe revertir todas las operaciones de datos para mantener la integridad de los datos. Cada operación realizada dentro ExecuteMultiple debe revertirse. ExecuteMultiple también causa problemas cuando las operaciones superan la duración máxima del tiempo de espera del complemento.

Más información: No use los tipos de solicitud de lotes en las actividades de flujo de trabajo y los complementos

Ejemplo

El siguiente código de ejemplo muestra un solo ExecuteMultipleRequest que realiza varias operaciones de creación. Las opciones de ejecución en tiempo de ejecución denominada Configuración controlan el procesamiento de solicitudes y devuelven los resultados. En la sección siguiente se describen estas opciones en tiempo de ejecución.

// Create an ExecuteMultipleRequest object.
ExecuteMultipleRequest requestWithResults = new ExecuteMultipleRequest()
{
    // Assign settings that define execution behavior: continue on error, return responses. 
    Settings = new ExecuteMultipleSettings()
    {
        ContinueOnError = false,
        ReturnResponses = true
    },
    // Create an empty organization request collection.
    Requests = new OrganizationRequestCollection()
};

// Create several (local, in memory) entities in a collection. 
EntityCollection input = GetCollectionOfEntitiesToCreate();

// Add a CreateRequest for each entity to the request collection.
foreach (var entity in input.Entities)
{
    CreateRequest createRequest = new CreateRequest { Target = entity };
    requestWithResults.Requests.Add(createRequest);
}

// Execute all the requests in the request collection using a single web method call.
ExecuteMultipleResponse responseWithResults =
    (ExecuteMultipleResponse)service.Execute(requestWithResults);

// Display the results returned in the responses.
foreach (var responseItem in responseWithResults.Responses)
{
    // A valid response.
    if (responseItem.Response != null)
        DisplayResponse(requestWithResults.Requests[responseItem.RequestIndex], responseItem.Response);

    // An error has occurred.
    else if (responseItem.Fault != null)
        DisplayFault(requestWithResults.Requests[responseItem.RequestIndex], 
            responseItem.RequestIndex, responseItem.Fault);
}

Más información: Muestra: ejecutar varias solicitudes

Especificar opciones de ejecución en tiempo de ejecución

El Settings parámetro de ExecuteMultipleRequest se aplica a todas las solicitudes de la colección de solicitudes y controla el comportamiento de ejecución y los resultados devueltos.

Por ejemplo, para una colección de solicitudes que contiene seis solicitudes en las que la tercera y la quinta solicitud devuelven errores, la siguiente tabla indica qué contendría la colección de Responses.

Un parámetro RequestIndex en el elemento de respuesta indica el número de secuencia, a partir de cero, de la solicitud con la que está asociada la respuesta. En el ejemplo anterior, la tercera solicitud tiene un índice de solicitudes de 2.

Limitaciones al tiempo de ejecución

En la lista siguiente se describen las restricciones relacionadas con el uso de ExecuteMultipleRequest.

• Sin recursión Un ExecuteMultipleRequest no puede invocar otro ExecuteMultipleRequest. Si la colección de solicitudes contiene un ExecuteMultipleRequest, genera un error para ese elemento de solicitud.
• Tamaño máximo del lote Solo puede agregar un número limitado de solicitudes a una colección de solicitudes. Si supera ese límite, el sistema produce un error antes de ejecutar la primera solicitud. Un límite de 1000 solicitudes es típico, pero puede establecer esta cantidad máxima para la implementación de Dataverse.

Cómo administrar un error de tamaño de lote

¿Qué debe hacer si la colección de solicitudes de entrada supera el tamaño máximo del lote? El código no puede consultar directamente el tamaño máximo del lote a través del servicio web de implementación a menos que se ejecute en una cuenta que tenga el rol de administrador de implementación.

Afortunadamente, hay otro método que puede usar. Cuando el número de solicitudes de la colección de entrada Requests supera el tamaño máximo de lote permitido para una organización, la ExecuteMultipleRequest llamada devuelve un error. El error incluye el tamaño máximo del lote. El código puede comprobar ese valor, cambiar el tamaño de la colección de solicitudes de entrada de que modo que esté dentro del límite indicado y volver a enviar ExecuteMultipleRequest. El siguiente fragmento de código muestra parte de esta lógica.

catch (FaultException<OrganizationServiceFault> fault)
{
    // Check if the maximum batch size has been exceeded. The maximum batch size is only included in the fault if
    // the input request collection count exceeds the maximum batch size.
    if (fault.Detail.ErrorDetails.Contains("MaxBatchSize"))
    {
        int maxBatchSize = Convert.ToInt32(fault.Detail.ErrorDetails["MaxBatchSize"]);
        if (maxBatchSize < requestWithResults.Requests.Count)
        {
            // Here you could reduce the size of your request collection and re-submit the ExecuteMultiple request.
            // For this sample, that only issues a few requests per batch, we will just print out some info. However,
            // this code will never be executed because the default max batch size is 1000.
            Console.WriteLine("The input request collection contains %0 requests, which exceeds the maximum allowed (%1)",
                requestWithResults.Requests.Count, maxBatchSize);
        }
    }
    // Re-throw so Main() can process the fault.
    throw;
}

Vea también

Usar mensajes con el SDK para .NET
Usar ExecuteAsync
Usar ExecuteTransaction