Cómo usar ExecuteMultiple para mejorar el rendimiento de la carga masiva de datos

Puede usar el mensaje ExecuteMultipleRequest para admitir escenarios de transmisión masiva de mensajes de mayor rendimiento en Dynamics 365 para la Gestión de Relaciones con el Cliente, especialmente en el caso de que la latencia de Internet pueda ser el mayor factor limitante. ExecuteMultipleRequest Acepta una colección de entrada de Message Requests, ejecuta cada una de las solicitudes de mensaje en el orden en 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 produjo. Cada solicitud de mensaje de la colección de entrada se procesa en una transacción de base de datos independiente. ExecuteMultipleRequest se ejecuta mediante el IOrganizationService método.Execute

En general, ExecuteMultipleRequest se comporta igual que si ejecutara cada solicitud de mensaje en la colección de solicitudes de entrada por separado, excepto con un mejor rendimiento. Se respeta el uso del parámetro CallerId del proxy de servicio y se aplicará a la ejecución de cada mensaje en la colección de solicitudes de entrada. Los plug-ins y las actividades de flujo de trabajo se ejecutan como cabría esperar para cada mensaje procesado.

El código personalizado en forma de complementos y actividades de flujo de trabajo personalizadas puede ejecutarse ExecuteMultipleRequest. Sin embargo, hay algunos puntos clave a tener en cuenta. Se devuelve una excepción generada por un complemento registrado sincrónico en el parámetro Fault del elemento de la colección de respuesta. Si se ejecuta un complemento dentro de una transacción de base de datos, el complemento se ExecuteMultipleRequestejecuta y se inicia una reversión de transacción, la reversión incluye cualquier cambio de datos resultante de las solicitudes ejecutadas por ExecuteMultipleRequest.

Para obtener la información más reciente sobre ExecuteMultiple, consulte Ejecutar varias solicitudes mediante el servicio de organización. Para obtener recomendaciones e instrucciones, consulte No usar tipos de solicitud por lotes en complementos y actividades de flujo de trabajo.

Aplicación de límites para solicitudes simultáneas

Existen varias restricciones relacionadas con el uso del ExecuteMultipleRequestarchivo . A continuación se describe un límite que se aplica solo a una implementación local y los otros dos (sin recursividad y tamaño máximo de lote) se documentan en Limitaciones en tiempo de ejecución de (Dataverse).

Limitación de llamadas simultáneas: para Dynamics 365 for Customer Engagement, es posible establecer un límite en el número de ejecuciones simultáneas ExecuteMultipleRequest por organización. Esto ayuda a evitar que una aplicación monopolice los recursos del servidor. Si se supera ese límite, se produce un error de "Servidor ocupado" antes de que se ejecute la primera solicitud. Esta opción no está habilitada de forma predeterminada. La configuración de implementación para este límite es ExecuteMultiplePerOrgMaxConnectionsPerServer.

Sugerencia

Para cualquier implementación de Customer Engagement, un administrador de implementaciones puede establecer o cambiar el límite máximo.

Consulte también

Leer y escribir datos y metadatos mediante el servicio web IOrganizationService
Mensajes de Microsoft.Xrm.Sdk
IOrganizationService.Execute
OrganizationRequest
OrganizationResponse
Mensajes de Microsoft.Crm.Sdk
Importar datos