Solucionar problemas de plug-ins do Dataverse
Este artigo contém informações sobre erros que podem ocorrer durante a execução do plug-in ou erros do Dataverse relacionados a plug-ins e como evitá-los ou corrigi-los.
Erro "A conversão de tempo não pôde ser concluída"
Código de Erro: -2147220956
Mensagem de erro: a conversão não pôde ser concluída porque o DataTime fornecido não tinha a propriedade Kind definida corretamente. Por exemplo, quando a propriedade Kind é DateTimeKind.Local, o fuso horário de origem deve ser TimeZoneInfo.Local.
Esse erro pode ocorrer durante uma TimeZoneInfo.ConvertTimeToUtc(DateTime, TimeZoneInfo) chamada no código plug-in para converter um DateTime valor no fuso horário de Santiago ou Volgogrado em UTC (Horário Universal Coordenado).
Esse erro é causado por uma limitação conhecida do produto e, atualmente, não há solução alternativa.
Para obter mais informações, consulte Especificar configurações de fuso horário para um usuário.
Erro "Processo do Trabalho da Caixa de Areia falhou"
Código de erro: -2147204723
Mensagem de erro: a execução do plug-in falhou porque o processo do Trabalho da Caixa de Areia falhou. Normalmente, isso ocorre devido a um erro no código de plug-in.
Esse erro significa simplesmente que o processo de trabalho que executa o código de plug-in falhou. Seu plug-in pode ser o motivo do acidente, mas também pode ser outro plug-in em execução simultaneamente para sua organização. Como o processo falhou, não podemos extrair mais informações específicas sobre por que ele falhou. Mas depois de examinar dados dos despejos de falha após o fato, descobrimos que esse erro geralmente ocorre devido a um dos quatro motivos:
- Exceção sem tratamento no plug-in
- Usar threads para fazer fila funciona sem tentativa/captura no delegado de thread
- Erro de estouro de pilha no plug-in
- O processo de trabalho atinge o limite de memória
Exceção sem tratamento no plug-in
Ao gravar um plug-in, você deve tentar antecipar quais operações podem falhar e envolvê-las em um bloco de captura de tentativa. Quando ocorrer um erro, você deve usar a InvalidPluginExecutionException classe para encerrar a operação com um erro significativo para o usuário.
Para obter mais informações, consulte Manipular exceções em plug-ins.
Um cenário comum para essa exceção é ao usar o método HttpClient.SendAsync ou HttpClient.GetAsync . Esses métodos HttpClient são operações assíncronas que retornam uma Tarefa. Para trabalhar em um plug-in em que o código precisa ser síncrono, as pessoas podem usar o TResult> da Tarefa<. Propriedade Result. Quando ocorre um erro, Result retorna um AggregateException. Um AggregateException consolida várias falhas em uma única exceção, o que pode ser difícil de manipular. Um design melhor é usar o TResult> de Tarefa<. GetAwaiter(). GetResult() porque propaga os resultados como o erro específico que causou a falha.
O exemplo a seguir mostra a maneira correta de gerenciar a exceção e uma chamada de saída usando o método HttpClient.GetAsync . Esse plug-in tenta obter o texto de resposta de um conjunto de Uri na configuração não seguro para uma etapa registrada para ele.
using Microsoft.Xrm.Sdk;
using System;
using System.Net.Http;
namespace ErrorRepro
{
public class AsyncError : IPlugin
{
private readonly string webAddress;
public AsyncError(string unsecureConfig)
{
if (string.IsNullOrEmpty(unsecureConfig)) {
throw new InvalidPluginExecutionException("The ErrorRepro.AsyncError plug-in requires that a Url be set in the unsecure configuration for the step registration.");
}
webAddress = unsecureConfig;
}
public void Execute(IServiceProvider serviceProvider)
{
ITracingService tracingService =
(ITracingService)serviceProvider.GetService(typeof(ITracingService));
tracingService.Trace($"Starting ErrorRepro.AsyncError");
tracingService.Trace($"Sending web request to {webAddress}");
try
{
string responseText = GetWebResponse(webAddress, tracingService);
tracingService.Trace($"Result: {responseText.Substring(0, 100)}");
}
catch (Exception ex)
{
tracingService.Trace($"Error: ErrorRepro.AsyncError {ex.Message}");
throw new InvalidPluginExecutionException(ex.Message);
}
tracingService.Trace($"Ending ErrorRepro.AsyncError");
}
//Gets the text response of an outbound web service call
public string GetWebResponse(string webAddress, ITracingService tracingService)
{
try
{
using (HttpClient client = new HttpClient())
{
client.Timeout = TimeSpan.FromMilliseconds(15000); //15 seconds
client.DefaultRequestHeaders.ConnectionClose = true; //Set KeepAlive to false
HttpResponseMessage response = client.GetAsync(webAddress).GetAwaiter().GetResult(); //Make sure it is synchronous
response.EnsureSuccessStatusCode();
tracingService.Trace($"ErrorRepro.AsyncError.GetWebResponse succeeded.");
string responseContent = response.Content.ReadAsStringAsync().GetAwaiter().GetResult(); //Make sure it is synchronous
tracingService.Trace($"ErrorRepro.AsyncError.GetWebResponse responseContent parsed successfully.");
return responseContent;
}
}
catch (Exception ex)
{
//Capture the inner exception message if it exists.
// It should have a more specific detail.
string innerExceptionMessage = string.Empty;
if (ex.InnerException != null) {
innerExceptionMessage = ex.InnerException.Message;
}
tracingService.Trace($"Error in ErrorRepro.AsyncError : {ex.Message} InnerException: {innerExceptionMessage}");
if (!string.IsNullOrEmpty(innerExceptionMessage))
{
throw new Exception($"A call to an external web service failed. {innerExceptionMessage}", ex);
}
throw new Exception("A call to an external web service failed.", ex);
}
}
}
}
Usar threads para fazer fila funciona sem tentativa/captura no delegado de thread
Você não deve usar padrões de execução paralelos em plug-ins. Esse anti-padrão é chamado no artigo de prática recomendada: não use a execução paralela dentro de plug-ins e atividades de fluxo de trabalho. O uso desses padrões pode causar problemas ao gerenciar a transação em um plug-in síncrono. No entanto, outro motivo para não usar esses padrões é que qualquer trabalho feito fora de um try/catch bloco em um delegado de thread pode travar o processo de trabalho.
Importante
Quando o processo de trabalho falhar, a execução do plug-in e de outros plug-ins em execução nesse processo será encerrada. Isso inclui plug-ins que você não possui ou mantém.
Application Insights para o resgate
No passado, a obtenção do rastreamento de pilha ou outras informações de execução para exceções de plug-in não tratadas do processo de trabalho acidentado era impossível. No entanto, o Dataverse agora oferece suporte para falhas de execução de log no Application Insights. Para habilitar essa função, você pode vincular o Application Insights ao ambiente em que o plug-in está registrado. Depois de vinculado, o registro em log de falhas de plug-in ocorre automaticamente.
Para obter mais informações, confira Exportar dados para o Application Insights.
Depois que um ambiente do Application Insights tiver sido vinculado, os seguintes dados de uma falha no processo de trabalho estarão disponíveis para solucionar problemas do problema.
Para navegar até o relatório de falha no Application Insights, siga estas etapas:
- Vincule o Application Insights ao seu ambiente.
- Aguarde até que uma exceção de plug-in resulte no erro de falha do processo de trabalho.
- No centro de administração do Power Platform, navegue até o Application Insights.
- Na página Application Insights, selecione Falhas no painel esquerdo.
- Na página Falhas , selecione Exceções.
- Em ID do Problema de Exceção, na lista Geral , selecione Microsoft.PowerPlatform.Dataverse.Plugin.PluginWorkerCrashException.
- No lado direito da página, em Geral, selecione PluginWorkerCrashException. Agora você verá os detalhes de todas as exceções registradas de falha do processo de trabalho.
- Pesquisa e selecione a exceção desejada no painel esquerdo e o relatório de detalhes da exceção será exibido no lado direito da página (consulte a captura de tela anterior para obter um exemplo).
- Para acessar o rastreamento de pilha, expanda CrashDetails no relatório.
Erro de estouro de pilha no plug-in
Esse tipo de erro ocorre com mais frequência logo após fazer algumas alterações no código de plug-in. Algumas pessoas usam seu próprio conjunto de classes base para simplificar sua experiência de desenvolvimento. Às vezes, esses erros se originam de alterações nas classes base das quais um plug-in específico depende.
Por exemplo, uma chamada recursiva sem uma condição de término ou uma condição de término, que não abrange todos os cenários, pode fazer com que esse erro ocorra. Para obter mais informações, confira Observações da classe > StackOverflowException.
Você deve examinar todas as alterações de código que foram aplicadas recentemente para o plug-in e qualquer outro código do qual o código plug-in depende.
Exemplo
O código plug-in a seguir causa uma StackOverflowException devido a uma chamada recursiva sem limites. Apesar do uso do rastreamento e da tentativa de capturar o erro, o rastreamento e o erro não são retornados porque o processo de trabalho que os processaria foi encerrado.
using Microsoft.Xrm.Sdk;
using System;
namespace ErrorRepro
{
public class SOError : IPlugin
{
public void Execute(IServiceProvider serviceProvider)
{
ITracingService tracingService =
(ITracingService)serviceProvider.GetService(typeof(ITracingService));
tracingService.Trace($"Starting ErrorRepro.SOError");
try
{
tracingService.Trace($"Calling RecursiveMethodWithNoLimit to trigger StackOverflow error.");
RecursiveMethodWithNoLimit(tracingService); //StackOverflowException occurs here.
}
catch (Exception ex)
{
//This trace will not be written
tracingService.Trace($"Error in ErrorRepro.SOError {ex.Message}");
//This error will never be thrown
throw new InvalidPluginExecutionException($"Error in ErrorRepro.SOError. {ex.Message}");
}
//This trace will never be written
tracingService.Trace($"Ending ErrorRepro.SOError");
}
public static void RecursiveMethodWithNoLimit(ITracingService tracingService)
{
tracingService.Trace($"Starting ErrorRepro.SOError.RecursiveMethodWithNoLimit");
RecursiveMethodWithNoLimit(tracingService);
tracingService.Trace($"Ending ErrorRepro.SOError.RecursiveMethodWithNoLimit");
}
}
}
Em uma etapa de plug-in síncrona, o código plug-in mostrado anteriormente retorna o seguinte erro na API Web quando a solicitação é configurada para incluir detalhes adicionais com erros.
{
"error": {
"code": "0x8004418d",
"message": "The plug-in execution failed because the Sandbox Worker process crashed. This is typically due to an error in the plug-in code.\r\nSystem.ServiceModel.CommunicationException: The server did not provide a meaningful reply; this might be caused by a contract mismatch, a premature session shutdown or an internal server error.\r\n at Microsoft.Crm.Sandbox.SandboxWorkerProcess.Execute(SandboxCallInfo callInfo, SandboxPluginExecutionContext requestContext, Guid pluginAssemblyId, Int32 sourceHash, String assemblyName, Guid pluginTypeId, String pluginTypeName, String pluginConfiguration, String pluginSecureConfig, Boolean returnTraceInfo, Int64& wcfExecInMs, Int64& initializeInMs, Int64& trackCallInMs, Int64& trackGoodReturnInMs, Int64& waitInMs, Int64& taskStartDelay) +0x330: Microsoft Dynamics CRM has experienced an error. Reference number for administrators or support: #8503641A",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionSourceKey": "Plugin/ErrorRepro.SOError, ErrorRepro, Version=1.0.0.0, Culture=neutral, PublicKeyToken=c2bee3e550ec0851",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiStepKey": "d5958631-b87e-eb11-a812-000d3a4f50a7",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiDepthKey": "1",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiActivityIdKey": "a3028bda-73c2-4eef-bcb5-157c5a4c323e",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiPluginSolutionNameKey": "Active",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiStepSolutionNameKey": "Active",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionCategory": "SystemFailure",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionMesageName": "SandboxWorkerNotAvailable",
"@Microsoft.PowerApps.CDS.ErrorDetails.ApiExceptionHttpStatusCode": "500",
"@Microsoft.PowerApps.CDS.HelpLink": "http://go.microsoft.com/fwlink/?LinkID=398563&error=Microsoft.Crm.CrmException%3a8004418d&client=platform",
"@Microsoft.PowerApps.CDS.TraceText": "\r\n[ErrorRepro: ErrorRepro.SOError]\r\n[d5958631-b87e-eb11-a812-000d3a4f50a7: ErrorRepro.SOError: Create of account]\r\n\r\n",
"@Microsoft.PowerApps.CDS.InnerError.Message": "The plug-in execution failed because the Sandbox Worker process crashed. This is typically due to an error in the plug-in code.\r\nSystem.ServiceModel.CommunicationException: The server did not provide a meaningful reply; this might be caused by a contract mismatch, a premature session shutdown or an internal server error.\r\n at Microsoft.Crm.Sandbox.SandboxWorkerProcess.Execute(SandboxCallInfo callInfo, SandboxPluginExecutionContext requestContext, Guid pluginAssemblyId, Int32 sourceHash, String assemblyName, Guid pluginTypeId, String pluginTypeName, String pluginConfiguration, String pluginSecureConfig, Boolean returnTraceInfo, Int64& wcfExecInMs, Int64& initializeInMs, Int64& trackCallInMs, Int64& trackGoodReturnInMs, Int64& waitInMs, Int64& taskStartDelay) +0x330: Microsoft Dynamics CRM has experienced an error. Reference number for administrators or support: #8503641A"
}
}
O seguinte mostra como esse erro é registrado no Tracelog de plug-in:
Unhandled exception:
Exception type: System.ServiceModel.FaultException`1[Microsoft.Xrm.Sdk.OrganizationServiceFault]
Message: The plug-in execution failed because the Sandbox Worker process crashed. This is typically due to an error in the plug-in code.
System.ServiceModel.CommunicationException: The server did not provide a meaningful reply; this might be caused by a contract mismatch, a premature session shutdown or an internal server error.
at Microsoft.Crm.Sandbox.SandboxWorkerProcess.Execute(SandboxCallInfo callInfo, SandboxPluginExecutionContext requestContext, Guid pluginAssemblyId, Int32 sourceHash, String assemblyName, Guid pluginTypeId, String pluginTypeName, String pluginConfiguration, String pluginSecureConfig, Boolean returnTraceInfo, Int64& wcfExecInMs, Int64& initializeInMs, Int64& trackCallInMs, Int64& trackGoodReturnInMs, Int64& waitInMs, Int64& taskStartDelay) +0x330: Microsoft Dynamics CRM has experienced an error. Reference number for administrators or support: #4BC22433Detail:
<OrganizationServiceFault xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/xrm/2011/Contracts">
<ActivityId>48c5818e-4912-42f0-b1b6-e3bbe7ae013d</ActivityId>
<ErrorCode>-2147204723</ErrorCode>
<ErrorDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic" />
<HelpLink i:nil="true" />
<Message>The plug-in execution failed because the Sandbox Worker process crashed. This is typically due to an error in the plug-in code.
System.ServiceModel.CommunicationException: The server did not provide a meaningful reply; this might be caused by a contract mismatch, a premature session shutdown or an internal server error.
at Microsoft.Crm.Sandbox.SandboxWorkerProcess.Execute(SandboxCallInfo callInfo, SandboxPluginExecutionContext requestContext, Guid pluginAssemblyId, Int32 sourceHash, String assemblyName, Guid pluginTypeId, String pluginTypeName, String pluginConfiguration, String pluginSecureConfig, Boolean returnTraceInfo, Int64& wcfExecInMs, Int64& initializeInMs, Int64& trackCallInMs, Int64& trackGoodReturnInMs, Int64& waitInMs, Int64& taskStartDelay) +0x330: Microsoft Dynamics CRM has experienced an error. Reference number for administrators or support: #4BC22433</Message>
<Timestamp>2021-03-06T22:14:22.0629638Z</Timestamp>
<ExceptionRetriable>false</ExceptionRetriable>
<ExceptionSource>WorkerCommunication</ExceptionSource>
<InnerFault i:nil="true" />
<OriginalException>System.ServiceModel.CommunicationException: The server did not provide a meaningful reply; this might be caused by a contract mismatch, a premature session shutdown or an internal server error.
Server stack trace:
at System.ServiceModel.Channels.ServiceChannel.Call(String action, Boolean oneway, ProxyOperationRuntime operation, Object[] ins, Object[] outs, TimeSpan timeout)
at System.ServiceModel.Channels.ServiceChannelProxy.InvokeService(IMethodCallMessage methodCall, ProxyOperationRuntime operation)
at System.ServiceModel.Channels.ServiceChannelProxy.Invoke(IMessage message)
Exception rethrown at [0]:
at Microsoft.Crm.Sandbox.SandboxWorkerProcess.Execute(SandboxCallInfo callInfo, SandboxPluginExecutionContext requestContext, Guid pluginAssemblyId, Int32 sourceHash, String assemblyName, Guid pluginTypeId, String pluginTypeName, String pluginConfiguration, String pluginSecureConfig, Boolean returnTraceInfo, Int64& wcfExecInMs, Int64& initializeInMs, Int64& trackCallInMs, Int64& trackGoodReturnInMs, Int64& waitInMs, Int64& taskStartDelay)</OriginalException>
<TraceText i:nil="true" />
</OrganizationServiceFault>
O processo de trabalho atinge o limite de memória
Cada processo de trabalho tem uma quantidade finita de memória. Há condições em que várias operações simultâneas que incluem grandes quantidades de dados podem exceder a memória disponível e fazer com que o trabalho do processo falhe.
RecuperarMultipla com dados de arquivo
O cenário comum, nesse caso, é quando um plug-in é executado para uma RetrieveMultiple operação em que a solicitação inclui dados de arquivo. Por exemplo, ao recuperar emails que incluem anexos de arquivo. A quantidade de dados que podem ser retornados em uma consulta como essa é imprevisível porque qualquer email pode estar relacionado a qualquer número de anexos de arquivo, e os anexos podem variar de tamanho.
Quando várias solicitações de natureza semelhante estão sendo executadas simultaneamente, a quantidade de memória necessária torna-se grande. Se a quantidade de memória exceder o limite, o processo falhará. A chave para evitar essa situação é limitar RetrieveMultiple consultas que incluem entidades com anexos de arquivo relacionados. Recupere os registros usando RetrieveMultiple, mas recupere todos os arquivos relacionados conforme necessário usando operações individuais Retrieve .
Vazamentos de Memória
Um cenário menos comum é onde o código no plug-in está vazando memória. Essa situação pode ocorrer quando o plug-in não é escrito como sem estado, o que é outra prática recomendada. Para obter mais informações, consulte Desenvolver implementações do Plug-in como sem estado. Quando o plug-in não é sem estado e há uma tentativa de adicionar continuamente dados a uma propriedade com estado como uma matriz, a quantidade de dados aumenta até o ponto em que ele usa toda a memória disponível.
Erros de transação
Há dois tipos comuns de erros relacionados a transações:
Código de Erro: -2146893812
Mensagem de erro: o código ISV reduziu a contagem de transações abertas. Os plug-ins personalizados não devem capturar exceções de chamadas do OrganizationService e continuar o processamento.
Código de Erro: -2147220911
Mensagem de erro: não há nenhuma transação ativa. Esse erro geralmente é causado por plug-ins personalizados que ignoram erros de chamadas de serviço e continuam o processamento.
Observação
O erro superior foi adicionado mais recentemente. Ela deve ocorrer imediatamente e no contexto do plug-in que contém o problema. O erro inferior ainda pode ocorrer em circunstâncias diferentes, normalmente envolvendo atividades personalizadas de fluxo de trabalho. Pode ser devido a problemas em outro plug-in.
Sempre que ocorre um erro relacionado a uma operação de dados em um plug-in síncrono, a transação de toda a operação é encerrada.
Para obter mais informações, consulte Design de Personalização Escalonável no Microsoft Dataverse.
Uma causa comum é que um desenvolvedor acredita que pode tentar executar uma operação que possa ter êxito, para que eles encerrem essa operação em um try/catch bloco e tentem engolir o erro quando ele falhar.
Embora esse padrão possa funcionar para um aplicativo cliente, dentro da execução de um plug-in, qualquer falha na operação de dados resulta na reversão de toda a transação. Você não pode engolir o erro, portanto, você deve ter certeza de sempre retornar um InvalidPluginExecutionException.
Erro "Erro do sql: tempo limite de execução expirado"
Código de Erro: -2147204783
Mensagem de erro: erro do SQL: 'Tempo limite de execução expirou. O período limite decorrido antes da conclusão da operação ou o servidor não está respondendo.
Motivo
Há uma grande variedade de razões pelas quais um erro de tempo limite do SQL pode ocorrer. Três deles são descritos aqui:
Bloqueio
A causa mais comum para um erro de tempo limite do SQL é que a operação está aguardando recursos bloqueados por outra transação SQL. O erro é o resultado do Dataverse que protege a integridade dos dados e de solicitações de longa execução que afetam o desempenho dos usuários.
O bloqueio pode ser devido a outras operações simultâneas. Seu código pode funcionar bem isoladamente em um ambiente de teste e ainda ser suscetível a condições que só ocorrem quando vários usuários estão iniciando a lógica em seu plug-in.
Ao escrever plug-ins, é essencial entender como criar personalizações escalonáveis. Para obter mais informações, consulte Design de Personalização Escalonável no Dataverse.
Operações em cascata
Determinadas ações que você faz no plug-in, como atribuir ou excluir um registro, podem iniciar operações em cascata em registros relacionados. Essas ações podem aplicar bloqueios em registros relacionados, fazendo com que as operações de dados subsequentes sejam bloqueadas, o que, por sua vez, pode levar a um tempo limite de SQL.
Você deve considerar o possível impacto dessas operações em cascata em operações de dados em seu plug-in. Para obter mais informações, consulte Comportamento de relação de tabela.
Como esses comportamentos podem ser configurados de forma diferente entre ambientes, o comportamento pode ser difícil de reproduzir, a menos que os ambientes sejam configurados da mesma maneira.
Índices em novas tabelas
Se o plug-in estiver executando operações usando uma tabela ou coluna que foi criada recentemente, alguns recursos SQL do Azure para gerenciar índices podem fazer a diferença após alguns dias.
Erros devido a privilégios de usuário
Em um aplicativo cliente, você pode desabilitar comandos que os usuários não têm permissão para executar. Dentro de um plug-in, você não tem essa capacidade. Seu código pode incluir alguma automação que o usuário de chamada não tem os privilégios a serem executados.
Você pode registrar o plug-in para ser executado no contexto de um usuário conhecido por ter os privilégios corretos definindo o valor Executar no Contexto do Usuário para esse usuário. Ou você pode executar a operação se passando por outro usuário. Para saber mais, veja:
Erro ao executar no contexto de um usuário desabilitado
Quando um plug-in é executado no contexto de um usuário desabilitado, o seguinte erro é retornado:
Mensagem de erro: System.ServiceModel.FaultException'1[Microsoft.Xrm.Sdk.OrganizationServiceFault]: O usuário com SystemUserId=<User-ID> em OrganizationContext=<Context> está desabilitado. Usuários desabilitados não podem acessar o sistema. Considere habilitar esse usuário. Além disso, os usuários serão desabilitados se não tiverem uma licença atribuída a eles.
Para solucionar esse erro, você pode executar uma consulta para localizar as etapas registradas no usuário desabilitado, bem como o plug-in associado e SdkMessage os detalhes.
https://<env-url>/api/data/v9.2/sdkmessageprocessingsteps
?$filter=_impersonatinguserid_value eq '<disabled-userId-from-error>'&
$expand=plugintypeid($select=name,friendlyname,assemblyname;
$expand=pluginassemblyid($select=solutionid,name,isolationmode)),sdkmessageid($select=solutionid,name)&
$select=solutionid,name,stage,_impersonatinguserid_value,mode
Erro "Tamanho da mensagem excedido ao enviar contexto ao Sandbox"
Código de Erro: -2147220970
Mensagem de erro: o tamanho da mensagem excedeu ao enviar contexto para a Área restrita. Tamanho da mensagem: ### Mb
Esse erro ocorre quando uma carga de mensagem é maior que 116,85 MB e um plug-in é registrado para a mensagem. A mensagem de erro inclui o tamanho da carga que causou esse erro.
O limite ajuda a garantir que os usuários que executam aplicativos não possam interferir uns com os outros com base em restrições de recurso. O limite ajuda a fornecer um nível de proteção contra cargas de mensagens extraordinariamente grandes que ameaçam as características de disponibilidade e desempenho da plataforma Dataverse.
116,85 MB são grandes o suficiente para que seja raro encontrar esse caso. A situação mais provável em que esse caso pode ocorrer é quando você recupera um registro com vários registros relacionados que incluem arquivos binários grandes.
Se você receber esse erro, poderá:
- Remova o plug-in da mensagem. Se não houver plug-ins registrados para a mensagem, a operação será concluída sem um erro.
- Se o erro estiver ocorrendo em um cliente personalizado, você poderá modificar o código para que ele não tente executar o trabalho em uma única operação. Em vez disso, escreva código para recuperar os dados em partes menores.
Erro "A chave determinada não estava presente no dicionário"
O Dataverse usa frequentemente classes derivadas da classe abstrata DataCollection<TKey,TValue> que representa uma coleção de chaves e valores. Por exemplo, com plug-ins, a IExecutionContextpropriedade .InputParameters é derivada ParameterCollection da DataCollection<TKey,TValue> classe. Essas classes são essencialmente objetos de dicionário em que você acessa um valor específico usando o nome da chave.
Códigos de erro
Esse erro ocorre quando o valor da chave no código não existe na coleção. O resultado é um erro em tempo de execução, em vez de um erro de plataforma. Quando esse erro ocorre dentro de um plug-in, o código de erro depende se o erro foi capturado.
Se o desenvolvedor pegou a exceção e retornou InvalidPluginExecutionException, conforme descrito em Manipular exceções em plug-ins, o seguinte erro será retornado:
Código de Erro: -2147220891
Mensagem de erro: o código ISV anulou a operação.
No entanto, com esse erro, é comum que o desenvolvedor não o pegue corretamente e o seguinte erro seja retornado:
Código de Erro: -2147220956
Mensagem de Erro: ocorreu um erro inesperado do código ISV.
Observação
"ISV" significa Fornecedor independente de software.
Motivo
Esse erro ocorre frequentemente no momento do design e pode ser devido a um erro de ortografia ou ao uso do invólucro incorreto. Os valores principais são sensíveis a maiúsculas de minúsculas.
Em tempo de execução, o erro é frequentemente devido ao desenvolvedor supondo que o valor esteja presente quando não está. Por exemplo, em um plug-in registrado para a atualização de uma tabela, somente os valores alterados são incluídos na Entitycoleção .Attributes
Solução
Para resolver esse erro, você deve marcar que a chave existe antes de tentar usá-la para acessar um valor.
Por exemplo, ao acessar uma coluna de tabela, você pode usar o Entitymétodo .Contains(String) para marcar se existe uma coluna em uma tabela, conforme mostrado no código a seguir.
// Obtain the execution context from the service provider.
IPluginExecutionContext context = (IPluginExecutionContext)
serviceProvider.GetService(typeof(IPluginExecutionContext));
// The InputParameters collection contains all the data passed in the message request.
if (context.InputParameters.Contains("Target") &&
context.InputParameters["Target"] is Entity)
{
// Obtain the target entity from the input parameters.
Entity entity = (Entity)context.InputParameters["Target"];
//Check whether the name attribute exists.
if(entity.Contains("name"))
{
string name = entity["name"];
}
Alguns desenvolvedores usam o Entitymétodo .GetAttributeValue<T>(String) para evitar esse erro ao acessar uma coluna de tabela. Esse método retornará o valor padrão do tipo se a coluna não existir. Se o valor padrão for nulo, esse método funcionará conforme o esperado. Mas se o valor padrão não retornar nulo, como com um DateTime, o valor retornado será 1/1/0001 00:00 em vez de nulo.
Erro "Você não pode iniciar uma transação com um nível de isolamento diferente do que já está definido na transação atual"
Código de Erro: -2147220989
Mensagem de erro: você não pode iniciar uma transação com um nível de isolamento diferente do que já está definido na transação atual
Os plug-ins destinam-se a dar suporte à lógica de negócios. Não há suporte para modificar qualquer parte do esquema de dados em um plug-in síncrono. Essas operações geralmente demoram mais e podem fazer com que os metadados armazenados em cache usados pelos aplicativos fiquem fora de sincronização. No entanto, essas operações podem ser executadas em uma etapa de plug-in registrada para serem executadas de forma assíncrona.
Problema conhecido: Activity.RegardingObjectId name value not set with plug-in
O sintoma mais comum desse problema é que o campo Em relação a um registro de atividade mostra (No Name) em vez do valor do atributo de nome primário.
Em um plug-in, você pode definir atributos de pesquisa com um valor EntityReference . A propriedade EntityReference.Name não é necessária. Normalmente, você não precisa incluí-lo ao definir um valor de atributo de pesquisa porque o Dataverse o define. Você deve definir valores como este durante a fase de pré-operação do pipeline de eventos. Para obter mais informações, consulte Pipeline de execução de eventos.
A exceção a essa regra é ao definir a pesquisa ActivityPointer.RegardingObjectId . Todos os tipos de entidade derivados de ActivityPointer herdam essa pesquisa. Por padrão, eles incluem Compromisso, Chat, Email, Fax, Carta, PhoneCall, RecurringAppointmentMaster e quaisquer tabelas personalizadas que foram criadas como tipos de atividade. Para obter mais informações, consulte Tabelas de atividades.
Se você definir esse valor no estágio PreOperation , o valor do nome não será adicionado pelo Dataverse. O valor é nulo e o valor formatado que deve conter esse valor não está presente quando você recupera o registro.
Solução alternativa
Há duas maneiras de resolver esse problema:
- Você pode definir o valor da propriedade EntityReference.Name com o valor de campo de nome primário correto antes de definir o valor do atributo de pesquisa.
- Você pode definir o valor de pesquisa no estágio PreValidation em vez do estágio PreOperation .
Mais informações
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de