Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Dataverse fornece um conjunto de parâmetros opcionais e valores de cabeçalho de solicitação que você pode usar para modificar o comportamento de solicitações individuais. Este artigo descreve os valores de parâmetro e os cabeçalhos de solicitação que você pode usar para obter os comportamentos necessários.
Note
Este artigo apresenta esses parâmetros, mas não os explica detalhadamente. Para entender completamente os cenários para usar esses parâmetros, siga os links para obter mais informações.
Como usar
Como você usa esses parâmetros opcionais depende se você está usando o SDK do Dataverse para .NET ou API Web.
Normalmente, você adiciona o parâmetro à Coleção OrganizationRequest.Parameters da classe de solicitação nomeada.
Note
Não é possível especificar esses parâmetros usando os sete métodos de atalho expostos por IOrganizationService. Você deve usar a classe de solicitação nomeada com o método IOrganizationService.Execute.
Uma exceção é quando se define o partitionid. Defina o partitionid como um atributo da instância da entidade. Para obter mais informações, consulte: Executar uma operação de dados com a partição especificada
Mais informações:
- Use mensagens com o SDK para .NET
- Veja os exemplos a seguir
Associar um componente de solução a uma solução
Ao executar operações de dados em um componente de solução, você pode associá-lo a uma solução especificando o nome exclusivo da solução com o SolutionUniqueName parâmetro.
Você pode usar esse parâmetro com estas mensagens:
AddPrivilegesRoleCopySystemForm-
Create(POST) -
Delete(DELETE) MakeAvailableToOrganizationTemplateRemovePrivilegeRoleReplacePrivilegesRole-
Update(PATCH) Upsert
A operação retorna um erro quando o valor SolutionUniqueName:
- Inclui caracteres inválidos. Somente letras, dígitos e caracteres de sublinhado são permitidos.
- É uma cadeia de caracteres vazia ou usa um nome de solução restrito.
- Não corresponde a nenhum valor da solução
UniqueName.
Importante
Nenhum erro é retornado quando o valor do SolutionUniqueName parâmetro corresponde a uma solução gerenciada. O valor é ignorado. Você não pode adicionar um componente de solução a uma solução gerenciada.
Os exemplos a seguir criam um componente de solução de recurso da Web e o adicionam à solução com o nome exclusivo de ExampleSolution.
static void CreateWebResourceInSolution(IOrganizationService service)
{
Entity webResource = new("webresource");
webResource["displayname"] = "Simple HTML web resource";
webResource["content"] = "PCFET0NUWVBFIGh0bWw+CjxodG1sPgogIDxib2R5PgogICAgPGgxPkhlbGxvIFdvcmxkPC9oMT4KICA8L2JvZHk+CjwvaHRtbD4=";
webResource["webresourcetype"] = new OptionSetValue(1);
webResource["name"] = "sample_SimpleHTMLWebResource.htm";
webResource["description"] = "An example HTML web resource";
CreateRequest request = new();
request.Target = webResource;
request["SolutionUniqueName"] = "ExampleSolution";
service.Execute(request);
}
Mais informações:
Mais informações:
- Criar uma tabela personalizada usando código
- Criar e atualizar definições de tabela usando a API Web
Suprimir a detecção de duplicatas
Se você quiser que o Dataverse retorne um erro quando um novo registro criado ou um registro que você atualiza corresponder às regras de detecção duplicadas de outro registro, você deverá criar ou atualizar a linha usando o SuppressDuplicateDetection parâmetro com um valor igual falsea .
Os exemplos a seguir retornam um erro quando as seguintes condições são verdadeiras:
- A detecção de duplicatas é habilitada para o ambiente quando você cria ou atualiza uma linha.
- A tabela
accounttem a detecção de duplicatas habilitada. - Uma regra de detecção duplicada foi publicada e verifica se o valor da conta
nameé uma correspondência exata para uma linha existente. - Há uma conta existente com o nome
Sample Account.
static void DemonstrateSuppressDuplicateDetection(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("SuppressDuplicateDetection", false);
try
{
service.Execute(request);
}
catch (FaultException<OrganizationServiceFault> ex)
{
throw ex.Detail.ErrorCode switch
{
-2147220685 => new InvalidOperationException(ex.Detail.Message),
_ => ex,
};
}
}
Mais informações:
Adicionar uma variável compartilhada ao contexto de execução do plug-in
Use o parâmetro tag para incluir um valor de variável compartilhada acessível dentro de um plug-in. Essas informações extras permitem que um plug-in aplique a lógica que depende do aplicativo cliente.
Note
Esse parâmetro destina-se a aplicativos cliente para definirem qualquer valor que desejarem. Nenhum recurso de Microsoft deve exigir que você defina um valor específico no código do aplicativo cliente para habilitar comportamentos diferentes.
Para acessar o valor em um plug-in, use a coleção IExecutionContext.SharedVariables.
if (context.SharedVariables.ContainsKey("tag")){
string tagValue = context.SharedVariables["tag"];
}
Os exemplos a seguir aceitam este valor: A string value ao criar um registro de conta.
static void DemonstrateTag(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("tag", "A string value");
service.Execute(request);
}
Mais informações: Variáveis compartilhadas
Executar uma operação de dados com a partição especificada
Ao usar tabelas elásticas com uma estratégia de particionamento, passe um valor de cadeia de caracteres exclusivo com o partitionid parâmetro para acessar dados de tabela não relacionais em uma partição de armazenamento.
Os exemplos a seguir usam o partitionid valor de deviceId ao recuperar um contoso_sensordata registro.
private static Entity RetrieveRecord(
IOrganizationService service,
Guid contosoSensorDataId,
string deviceId,
string sessionToken)
{
EntityReference entityReference = new("contoso_sensordata", contosoSensorDataId);
RetrieveRequest request = new()
{
ColumnSet = new ColumnSet("contoso_value"),
Target = entityReference,
["partitionId"] = deviceId, //To identify the record
["SessionToken"] = sessionToken //Pass the session token for strong consistency
};
var response = (RetrieveResponse)service.Execute(request);
return response.Entity;
}
Como alternativa, use o partitionid valor com o estilo de chave alternativo.
- Saiba mais sobre como usar as chaves alternativas com tabelas elásticas.
- Saiba mais sobre como especificar um partitionid.
Ignorar a lógica personalizada do Dataverse
A lógica síncrona se aplica durante a transação e pode afetar significativamente o desempenho de operações individuais. Com operações em massa, o tempo extra para essas operações individuais pode aumentar o tempo necessário. Use o BypassBusinessLogicExecution parâmetro quando quiser melhorar o desempenho ao executar operações de dados em massa.
Importante
O usuário de chamada deve ter o prvBypassCustomBusinessLogic privilégio.
O exemplo a seguir define o BypassBusinessLogicExecutionparâmetro opcional para lógica personalizada síncrona e assíncrona ao criar um novo registro de conta usando a classe SDK for .NET CreateRequest.
static void DemonstrateBypassBusinessLogicExecution(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("BypassBusinessLogicExecution", "CustomSync,CustomAsync");
service.Execute(request);
}
Saiba mais sobre maneiras de ignorar a lógica personalizada do Dataverse
Ignorar fluxos de Power Automate
Quando ocorrem operações de dados em massa que disparam fluxos, o Dataverse cria trabalhos do sistema para executar os fluxos. Quando o número de jobs do sistema é grande, pode causar problemas de desempenho para o sistema. Se ocorrerem problemas de desempenho, você poderá optar por ignorar o acionamento dos fluxos usando o parâmetro opcional SuppressCallbackRegistrationExpanderJob.
A tabela CallbackRegistration gerencia gatilhos de fluxo e há uma operação interna chamada expander que chama os gatilhos de fluxo registrados.
Note
Quando você usa essa opção, os proprietários de fluxo não recebem uma notificação de que a lógica de fluxo foi ignorada.
static void DemonstrateSuppressCallbackRegistrationExpanderJob(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("SuppressCallbackRegistrationExpanderJob", true);
service.Execute(request);
}
Mais informações: Contornar fluxos do Power Automate
Exibir dados sem máscara
Ao configurar uma coluna para usar o recurso de visualização de regras de mascaramento , use o UnMaskedData parâmetro opcional para solicitar o valor desmascarado.
RetrieveMultipleRequest request = new()
{
Query = query,
["UnMaskedData"] = true
};
var response = (RetrieveMultipleResponse)service.Execute(request);
Saiba mais sobre como recuperar dados desmascarados.
Consulte também
Use mensagens com o SDK para .NET
Web API: Compor solicitações HTTP e tratar erros: outros cabeçalhos
Ignorar lógica de negócios personalizada