Páginas de dados
Acesso a dados sob demanda
O processamento de casos muitas vezes requer acesso a dados obtidos de outros aplicativos ou sistemas. Assegurar a precisão dos dados adquiridos reduz significativamente a probabilidade de erros – e de resultados indesejáveis – nos casos. Nos aplicativos da Pega Platform™, uma página de dados recupera dados de uma fonte de dados especificada e grava esses dados na memória. A página de dados gerencia a integração com a fonte de dados, separando os processos de negócios dos detalhes da integração. Essa separação permite aos desenvolvedores de aplicativos utilizar dados adquiridos em um aplicativo sem saber a fonte dos dados e os detalhes da conexão.
Ao contrário da maioria das páginas utilizadas na Pega Platform, os aplicativos tentam preencher o conteúdo de uma página de dados somente quando a página é acessada, e não por meio de uma ação explícita. Devido à natureza do conteúdo de uma página de dados, obtido sob demanda, essas páginas são consideradas um tipo de regra declaratória. A Pega Platform acrescenta, de forma antecipada e automática, os caracteres D_ ao nome de uma página de dados para diferenciá-la das demais páginas na memória.
Nota: O nome das páginas de dados criadas em versões de Pega Platform anteriores à 7.1 começam com Declare_ em vez de D_.
Na imagem a seguir, clique nos ícones + para saber como a Pega Platform preenche o conteúdo de uma página de dados.
Verifique seus conhecimentos com a interação a seguir.
Definição de página de dados
No Dev Studio, você pode criar páginas de dados. Ao criar uma página de dados, o desenvolvedor deve fornecer quatro informações cruciais:
- A estrutura do conteúdo da página.
- O tipo de objeto representado pelo conteúdo da página de dados.
- O modo de edição compatível com a página.
- O escopo da página de dados.
Estrutura
A estrutura da página determina se a página de dados pode conter um item ou vários itens. Defina a estrutura de uma página de dados selecionando uma opção na lista do dropdown Estrutura (Structure).
Ao utilizar uma estrutura em lista, a página de dados incorpora os itens da lista em uma matriz organizada chamada pxResults. Para acessar um registro específico na lista, use a sintaxe DataPageName.pxResults(n), em que n é o índice da matriz organizada que corresponde ao registro.
Considere uma página de dados que contenha informações sobre preços de uma ação específica. A estrutura está configurada com Página (Page). Entretanto, se uma página de dados contiver informações sobre preços de todas as ações em uma carteira de investimentos, você define a estrutura como uma Lista (List).
No centro da imagem a seguir, deslize a linha vertical para comparar as estruturas em formato de lista e página.
Tipo de objeto
O tipo de objeto da página identifica as informações contidas na página de dados. Para definir o tipo de objeto de uma página de dados, digite a classe do objeto no campo Tipo de objeto (Object type). O tipo de objeto permite que a página de dados referencie qualquer propriedade definida para a classe. Por exemplo, uma página de dados com uma lista de planos de seguro odontológicos oferecidos por uma seguradora contém o nome do plano, o custo e a coparticipação. Uma página de dados que relaciona pedidos recentes feitos por um cliente contém o número, a data e o custo total do pedido e o endereço para entrega.
Modo de edição
O modo de edição de uma página de dados indica como – ou se – um aplicativo pode manusear as informações em uma página de dados. Defina o modo de página de dados selecionando uma opção de na lista do dropdown Modo (Mode).
Configure o modo de edição como Somente leitura (Read-Only) para evitar que um aplicativo atualize uma página de dados, exceto quando estiver carregando e atualizando o conteúdo da fonte de dados. O modo Somente leitura evita que os usuários editem informações obtidas de um sistema de registro e assegura que o conteúdo da página de dados sempre corresponda ao conteúdo carregado do sistema de registro. Por exemplo, para acessar o histórico de sinistros de um cliente de seguro automotivo no banco de dados do DETRAN, leis estaduais ou federais podem proibir a edição dos dados obtidos. Para cumprir esse requisito legal, configure o modo de páginas como Somente leitura.
Nota: Se o modo de uma página de dados for Somente leitura, a ferramenta Área de transferência (Clipboard) lista a página de dados na categoria Páginas de dados (Data Pages).
Configure o modo de edição para Editável (Editable) para permitir que um aplicativo edite o conteúdo da página de dados. Por exemplo, uma loja permite que seus clientes salvem um ou mais endereços preferenciais de entrega ao fazer pedidos. A lista de endereços é carregada do banco de dados do cliente utilizando uma página de dados. Para permitir que um cliente atualize um endereço no ato do pedido, você configura o modo de páginas como Editável.
Nota: Se o modo da página de dados for Editável, a ferramenta Área de transferência relaciona a página de dados na categoria Páginas de usuários (User Pages).
Configure o modo de edição como Salvável (Savable) para configurar um plano de salvamento que permita ao aplicativo transferir o conteúdo da página de volta para a fonte de dados. Por exemplo, depois que um cliente atualiza o endereço de entrega, o aplicativo copia o endereço atualizado para uma savable data page configurada para atualizar o banco de dados de clientes. Quando o cliente conclui o pedido, o aplicativo segue o plano de salvamento para se conectar ao banco de dados de clientes.
Escopo
O escopo de uma página de dados determina a visibilidade do conteúdo da página no aplicativo. Para definir o escopo da página, selecione uma das opções permitidas no dropdown Escopo (Scope): Thread (Thread), Solicitante (Requestor) ou Nó (Node).
Na imagem a seguir, clique nos ícones + para saber mais sobre as opções de escopo e verificar como você pode usar as configurações de escopo para gerenciar dados em cache nos aplicativos da Pega Platform.
Verifique seus conhecimentos com a interação a seguir.
Fontes de dados
Use a seção Fonte de dados (Data sources) no formulário da página de dados para especificar como a Pega Platform deve preencher o conteúdo de uma página de dados quando um aplicativo referenciar essa página. Para configurar uma fonte de dados, especifique o nome da fonte de dados e o tipo de fonte. É página de dados utilizar qualquer opção a seguir para configurar uma fonte de dados de uma página de dados.
- Transformação de dados
- Atividade
- Conector
- Report definition
- Busca no banco de dados
- Automação robotizada
- Automação robótica para desktop
Para cada tipo de fonte, você identifica uma fonte de dados para consulta. O exemplo a seguir ilustra uma fonte de dados configurada para preencher uma página de dados com uma estrutura em lista, executando o DataTableEditorReport para a classe GoGo-GoGoRoad-Data-Customer.
É preciso configurar uma data transform para mapear a resposta de acordo com o modelo de dados para o tipo de caso ou tipo de dados ao:
- Utilizar uma report definition para obter dados de uma estrutura de página
- Utilizar uma busca para obter dados de uma estrutura de lista
- Utilizar uma automação robótica
- Utilizar uma automação robótica de desktop
Obtenção de dados de várias fontes de dados
Se for preciso combinar dados de várias fontes para preencher uma página de dados, selecione a opção Agregar fontes (Aggregate sources). Em seguida, identifique cada fonte de dados para consulta. A Pega Platform preenche a página de dados das fontes especificadas na ordem definida.
Obtenção condicional de dados de uma fonte de dados
A página de dados deve especificar pelo menos uma fonte de dados. Se uma página de dados contiver mais de uma fonte, configure uma condição lógica para cada fonte, para verificar se a fonte de dados deve ser consultada. A condição para a última fonte de dados relacionada está configurada como “Caso contrário” (Otherwise), para assegurar que a Pega Platform sempre identifique a fonte de dados da página de dados. Quando um aplicativo referencia a página de dados, a Pega Platform avalia cada condição na ordem da fonte de dados e utiliza a fonte de dados que atender primeiro à condição que gerar o resultado verdadeiro.
Parâmetros
Ao preencher uma página de dados, pode ser preciso limitar o conteúdo da página aos itens relevantes. Por exemplo, um banco de dados contém registros de todas as apólices com subscrição realizadas por uma seguradora. Se um cliente quiser ajustar a cobertura da apólice do seu seguro automotivo, você precisa de um meio para preencher uma página de dados apenas com os registros relevantes da apólice.
É possível utilizar parâmetros para limitar o conteúdo de uma página de dados. Por exemplo, se você selecionar Busca (Lookup) como fonte de dados, é preciso informar o valor da chave para identificar exclusivamente o registro a ser retornado à página de dados. Você também pode utilizar parâmetros para passar dados a um filtro de relatórios a fim de limitar os resultados a um conjunto específico de registros, como um tipo de produto específico em um banco de dados de ações. Você pode passar um parâmetro para uma página de dados de elementos de interfaces de usuário, como um dropdown ou um radio button, propriedades e outros tipos de regras. Para uma lista completa dos tipos de regras que podem passar parâmetros para uma página de dados, consulte o tópico de ajuda Passagem de parâmetros para páginas de dados a partir de regras não relacionadas à IU.
Cuidado: O uso de páginas de dados parametrizadas pode gerar várias instâncias de uma página de dados na área de transferência. Considere o impacto de várias instâncias de páginas de dados ao acrescentar um parâmetro a uma página de dados. Se você não precisar de uma instância para cada combinação exclusiva de parâmetros, marque a checkbox Limitar a uma única página de dados (Limit to a single data page) na guia Gerenciamento de cargas (Load Management), para manter uma só instância da página parametrizada que Pega Platform vai sobrescrever quando houver alterações nos parâmetros.
Para utilizar uma fonte de dados parametrizada, adicione um valor ao parâmetro na guia de Parâmetros (Parameters) do registro da página de dados.
Para referenciar uma página de dados parametrizada, inclua o nome e o valor de cada parâmetro na referência. Use chaves para identificar o nome e o valor de cada parâmetro, usando a sintaxe DataPageName[Parameter1_Name:Parameter1_Value,Parameter2_Name:Parameter2_Value,...].
Nota: Quando um usuário tenta acessar uma página de dados parametrizada, a Pega Platform ignora todas as instâncias da página de dados com um valor diferente para o mesmo parâmetro.
Na imagem da página de dados abaixo, clique nos ícones + para saber mais sobre as configurações de parâmetros.
Referências a páginas de dados
Quando os dados precisam ser referenciados em uma página de dados, um campo de tipo Consulta (Query) é utilizado. Ainda que a maioria dos objetos de dados criados por designers de integração não tenham uma chave ou outras páginas de dados necessárias para criar um relacionamento de referência. Os campos de consulta exigem uma página de dados de lista ou de busca.
O campo de consulta não armazena nenhum valor de chave, portanto, quaisquer parâmetros da página de dados serão externos ao campo. Considere um tipo de caso que gerencia instruções de voo e cria planos de voo para estudantes. O tipo de caso utiliza uma Consulta para obter dados meteorológicos para passar o código de um aeroporto obtido de uma fonte externa ao caso, que então retorna os dados meteorológicos e preenche automaticamente a visualização de confirmação do plano do voo com esses dados.
Nota: Uma Consulta não exige que o parâmetro seja um campo obtido fora do caso. O parâmetro pode ser obtido de qualquer campo no contexto de um objeto recipiente ou de um campo a partir de uma atividade.
Os parâmetros de um campo de consulta são definidos pela página de dados ou visualização que o campo está configurado para utilizar. Por exemplo, uma página de dados pode utilizar um período de tempo como parâmetro para determinar as transações que devem ser retornadas. Você pode configurar uma Consulta para copiar as informações da página de dados do caso no primeiro acesso. Além disso, você pode utilizar uma savable data page para transferir as informações de volta ao sistema de registro, como ao atualizar um valor.
Verifique seus conhecimentos com a interação a seguir.
This Topic is available in the following Modules:
If you are having problems with your training, please review the Pega Academy Support FAQs.
Quer nos ajudar a melhorar esse conteúdo?