Usando a fonte de dados na memória para expandir o alcance de dados do Reveal

Pode haver momentos em que você deseja se conectar diretamente a uma fonte de dados que Reveal pode ainda não dar suporte pronta para uso. Por exemplo, você pode ter seu próprio banco de dados personalizado. Para acomodar essa necessidade, oferecemos suporte na memória como fonte de dados. Você também pode usar essa opção se precisar usar dados que já estão na memória como parte do estado do aplicativo, como o resultado de um relatório solicitado por um usuário.

A fonte de dados na memória também oferece outros benefícios, como velocidade de recuperação, pois é muito mais rápido acessar dados na memória do que em uma unidade de disco.

Neste blog, veremos como usar esse recurso.

Definindo um esquema de dados

Recomendamos que você defina um arquivo de dados com um esquema que corresponda aos seus dados na memória. Os arquivos de dados podem ser, por exemplo, um arquivo CSV ou Excel, e um esquema é basicamente uma lista de campos e o tipo de dados para cada campo. No exemplo abaixo, você encontrará detalhes sobre como criar um arquivo de dados com um determinado esquema e, em seguida, usar dados na memória em vez de obter informações de um banco de dados.

No exemplo a seguir, usaremos dados na memória com a lista de funcionários da empresa para inserir um painel mostrando métricas de RH em seu sistema de RH. E em vez de obter a lista de funcionários do seu banco de dados, usaremos os dados na memória.

Preparando o arquivo de dados e o painel de amostra

Use as etapas a seguir com base em um funcionário simplificado que tem apenas algumas propriedades:

• EmployeeID: cadeia de caracteres
• Nome completo: string
• Salário: numérico

Primeiro, crie o arquivo CSV com o mesmo esquema:

1. Carregue o arquivo para seu sistema de compartilhamento de arquivos preferido, como Dropbox ou Google Drive
2. Crie um painel usando os dados fictícios. Observe que você fornecerá os dados reais de produção posteriormente em sua aplicação
3. Exporte o painel (Menu do painel → Exportar → painel) e salve como um arquivo .rdash.

Visualizando o painel e retornando os dados reais

Agora você precisa visualizar o painel usando seus próprios dados em vez do fictício.

Implemente IRVDataSourceProvider e retorne-o como a propriedade DataSourceProvider em IRevealSdkContext, conforme descrito em Substituindo fontes de dados.

Em seguida, na implementação do método ChangeVisualizationDataSourceItemAsync, você precisa adicionar um código semelhante a este:

Dessa forma, você basicamente substitui todas as referências a arquivos CSV no painel pela fonte de dados na memória identificada por "funcionários". Essa identificação será usada posteriormente ao retornar os dados.

Implemente o método que retornará os dados reais, para fazer isso, implemente IRVDataProvider conforme mostrado abaixo:

Observe que as propriedades na classe Employee são nomeadas exatamente como as colunas no arquivo CSV e o tipo de dados também é o mesmo. Caso você queira alterar o nome do campo, o rótulo do campo e/ou o tipo de dados de qualquer uma das propriedades, você pode usar atributos na declaração de classe:

• O atributo RVSchemaColumn pode ser usado para alterar o nome do campo e/ou o tipo de dados.
• O atributo DisplayName pode ser usado para alterar o rótulo do campo

Além disso, para implementar IRVDataProvider, você precisa modificar sua implementação de IRevealSdkContext.DataProvider para retorná-lo:

Para saber mais sobre Reveal ou testar o SDK, caso ainda não tenha feito isso, solicite uma demonstração.