Configurar origens de dados de pesquisa para utilizar parâmetros específicos da aplicação de ER

A funcionalidade de parâmetros específicos da aplicação de Relatórios eletrónicos (ER) permite configurar a filtragem de dados num formato de ER para que se baseie num conjunto de regras abstratas. Este conjunto de regras pode ser configurado para utilizar a origem de dados do tipo Pesquisa que está disponível num formato de ER. Pode especificar regras reais para além dos estruturadores de componentes de ER utilizando a interface de utilizador (IU) que é gerada automaticamente com base nas definições da origem de dados de Pesquisa do formato de ER correspondente e dos dados da entidade legal atual. Por fim, a origem de dados Pesquisa do formato de ER acederá às regras especificadas quando esse formato de ER for executado.

Nota

Utilize as origens de dados configuradas do formato de ER editável para especificar quais os dados de aplicação que serão utilizados para configurar regras reais.

Utilize o Estruturador de operações de ER para incluir uma origem de dados do tipo Pesquisa no formato de ER. A origem de dados tem de ser configurada para descrever o aspeto das suas regras abstratas, incluindo o seguinte:

• O conjunto de parâmetros de determinado tipo de dados cujo valor é fornecido para especificar uma única regra.
• O tipo de valor de determinado tipo de dados que é devolvido por uma única regra quando esta regra é considerada a mais adequada entre outras.

Pode configurar os seguintes tipos de origens de dados de Pesquisa, dependendo do tipo de valor que é devolvido por qualquer regra configurada:

• Utilize o tipo Modelo de dados\Pesquisa quando um valor de enumeração do modelo tem de ser devolvido.
• Utilize o tipo Dynamics 365 Operations\Pesquisa quando um valor de enumeração da aplicação ou um valor de tipo de dados expandido da aplicação tem de ser devolvido.
• Utilize o tipo Enumeração de formato\Pesquisa quando um valor de enumeração do formato tem de ser devolvido.

A seguinte ilustração mostra como uma enumeração de formato pode ser configurada no formato de ER de exemplo.

A ilustração seguinte mostra os componentes de formato que foram configurados para reportar diferentes tipos de impostos numa secção diferente de um relatório gerado.

A seguinte ilustração mostra como o estruturador de operações de ER permite a adição de uma origem de dados do tipo Enumeração de formato\Pesquisa. A origem de dados adicionada é configurada para devolver um valor da enumeração de formato List of taxation levels.

A seguinte ilustração mostra como a origem de dados adicionada está configurada para utilizar o campo Código da lista de registos Model.Data.Tax da origem de dados Modelo como parâmetro que tem de ser especificado para cada regra configurada.

A origem de dados Model.Data.Tax adicionada está configurada para especificar um código fiscal para cada regra configurada ao aceder aos registos da tabela de aplicações TaxTable.

Pode configurar as regras de pesquisa para o formato de ER selecionado utilizando a IU que está automaticamente alinhada com a estrutura da origem de dados configurada. Atualmente, esta IU requer que, para cada regra, seja especificado o valor devolvido como o valor de enumeração de formato List of taxation levels, bem como o código fiscal como parâmetro.

A seguinte ilustração mostra como a origem de dados Model.Data.Summary.LevelByLookup do tipo Campo Calculado pode ser configurada para chamar a origem de dados de Pesquisa fornecendo os parâmetros necessários. Para processar esta chamada durante o runtime, ER analisa a lista de regras configuradas na sequência definida para localizar a primeira regra que satisfaz as condições fornecidas. Neste exemplo, é a regra que contém o código fiscal que corresponde ao fornecido. Como resultado, a regra mais adequada é encontrada e o valor de enumeração configurado para a regra encontrada é devolvido por esta origem de dados.

Nota

Uma exceção é lançada quando não é encontrada nenhuma regra aplicável. Para evitar estas exceções, configure regras adicionais no final da lista de regras para lidar com os casos em que é fornecido um valor não configurado ou não é fornecido nenhum valor. Utilize as opções *Não em branco* e *Em branco* em conformidade.

Ao definir a opção Transversal à empresa como Sim para a origem de dados de pesquisa editável, adiciona um novo parâmetro Empresa obrigatório ao conjunto de parâmetros desta origem de dados. O valor do parâmetro Empresa tem de ser especificado durante o runtime quando a origem de dados de pesquisa é chamada. Quando o código da empresa é especificado durante o runtime, as regras configuradas para esta empresa são utilizadas para encontrar a regra mais adequada e o valor correspondente é devolvido. A seguinte ilustração mostra como pode fazê-lo e como o conjunto de parâmetros da origem de dados editável é alterado.

Nota

Selecione cada empresa separadamente para configurar o conjunto de regras para esta origem de dados de pesquisa do formato de ER editável. Uma exceção é lançada durante o runtime quando a pesquisa transversal à empresa é chamada com o código da empresa para a qual a configuração de pesquisa não foi concluída.

Certifique-se de que concede permissões a um utilizador que executa o formato de ER com a origem de dados de Pesquisa transversal à empresa para aceder aos dados de todas as empresas que estão dentro do âmbito desta origem de dados. Caso contrário, uma exceção é iniciada durante o runtime.

A partir da versão 10.0.19, as capacidades expandidas das origens de dados de Pesquisa estão disponíveis. Ao definir a opção Expandido como Sim para a origem de dados de pesquisa editável, a origem de dados de pesquisa configurada é transformada na origem de dados estruturada que oferece as capacidades adicionais para analisar o conjunto de regras configuradas. A ilustração seguinte mostra esta transformação.

• O subitem de Pesquisa foi concebido como uma função para encontrar a regra mais adequada a partir do conjunto de regras configuráveis com base no conjunto de parâmetros fornecidos.

• O subitem IsLookupResultSet foi concebido como uma função para aceitar o valor fornecido da origem de dados de enumeração base e devolver o valor Booleano de Verdadeiro quando o conjunto de regras contiver pelo menos uma regra para a qual o valor de enumeração fornecido foi configurado como valor devolvido. Esta função devolve o valor Booleano de Falso quando não há regras configuradas para devolver o valor de enumeração fornecido.

• O subitem de Definição foi concebido como uma função que devolve o conjunto de regras configuradas como registos de uma lista de registos. Os valores devolvidos e o conjunto de parâmetros das regras configuradas são apresentados em todos os registos devolvidos como campos dos tipos de dados relevantes:

  • O valor devolvido é apresentado como campo Resultado da pesquisa.
  • Os parâmetros configurados são apresentados como campos com nomes de parâmetros (campo Código neste exemplo).

Para obter mais informações sobre como configurar a origem de dados de Pesquisa, consulte Configurar formatos de ER para utilizar parâmetros especificados por entidade legal. Para saber mais sobre como definir as regras de Pesquisa, consulte Configurar os parâmetros de um formato de ER por entidade legal.

Recursos adicionais

Configurar formatos ER para utilizar parâmetros especificados por entidade legal

Configurar os parâmetros de um formato ER por entidade legal