# Floui Database

## Introdução

O Floui Database possibilita a integração e o gerenciamento de tabelas não relacionais, permitindo a criação, consulta e manipulação de registros de forma isolada dentro do Workspace.

A ferramenta disponibiliza uma coleção de conectores dedicados para a manipulação de dados em fluxos, possibilitando a gestão de registros no próprio Workspace ou o envio de informações para aplicações externas.

Com um conjunto robusto de funcionalidades, o Floui Database é uma solução poderosa para processos de integração e automação na manipulação de dados.

## Gerencie suas tabelas&#x20;

O ambiente Floui oferece uma interface intuitiva para a gestão de tabelas não relacionais e seus registros. Para acessá-la, navegue até o menu lateral do Workspace e, na seção **Construção**, clique em **Database**.

Nesta tela, é possível visualizar todas as tabelas criadas, criar novas tabelas e editar ou remover tabelas existentes. Além disso, permite o acesso a visualização dos registros e a edição da estrutura das tabelas.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2F2DFKDxkmnG6WQ5nwyEAm%2Fimage.png?alt=media&#x26;token=fe9231ea-0bc8-4cba-9f9c-edbfc98c7140" alt=""><figcaption><p>Gerenciamento de databases</p></figcaption></figure>

## Estruture uma tabela&#x20;

Para acessar a criação de uma tabela, acesse o menu de gerenciamento e listagem de tabelas. No topo lateral direito clique em **Criar Tabela de Dados**. Por esta tela será definido toda a estrutura dos campos da tabela.

A configuração da estrutura de uma tabela é composta pelos seguintes campos de configuração:

* **Campo**: Código do campo.
* **Label (Legenda)**: Título visual para o campo.
* **Tipo**: Tipo de entrada de dados.
* **Tamanho**: Tamanho do dado. Apenas em caso de dados do tipo Texto ou Texto Longo.
* **Valor Padrão**: Valor padrão para o campo caso não seja preenchido.
* **É Único**: Garante que o valor inserido neste campo seja único em toda a tabela, garantindo que não sejam cadastrados registros duplicados.
* **É obrigatório**: Define se o campo é obrigatório na criação de registro.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FkwUe4W0DIqhgmg0XnRKS%2Fimage.png?alt=media&#x26;token=fbe87c1b-4199-4ec1-8c3d-d8ecfa462623" alt=""><figcaption><p>Criação de tabela</p></figcaption></figure>

## Importe e exporte a estrutura de tabelas

Tabelas criadas no Workspace podem ter sua estrutura exportada para um arquivo JSON ou importadas para o ambiente.

Para importar uma tabela, acesse a criação de uma tabela e clique no botão superior direito **Importar Estrutura**. Selecione um arquivo JSON válido para importar os campos.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FSR84A5ayoslKheYlBktV%2Fimage.png?alt=media&#x26;token=9a8f5cef-474f-4b74-8acd-da7511aadadc" alt=""><figcaption><p>Importação de tabelas</p></figcaption></figure>

Para exportar uma tabela já criada e estruturada, acesse a listagem de tabelas e localize a estrutura que deseja exportar. Clique em opções e Exportar Estrutura. Confirme o download para exportar a estrutura. Isto exportará apenas a estrutura, para exportar os registro consulte a seção [Exportação de dados](#exportacao-de-dados).

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FwPZLED541gFxsEfz8m3b%2Fimage.png?alt=media&#x26;token=a539a9a5-ec4e-4394-8ea7-e9e255d44185" alt=""><figcaption><p>Exportação de tabelas</p></figcaption></figure>

## Visualize os registros gerados

O Floui disponibiliza uma interface intuitiva para a visualização e consulta de registros armazenados em uma database. Para acessar esses registros, navegue até a tela de gerenciamento de databases e, em uma database criada, clique na opção **Ver Registros**.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FOOTE94N8DdhRlzUkDekL%2Fimage.png?alt=media&#x26;token=fbcb0097-ccf6-4b5b-af69-c95c2944d8ca" alt=""><figcaption><p>Acessar a visualização de listagens</p></figcaption></figure>

A tela de listagem de registros oferece diversas funcionalidades para facilitar a consulta e filtragem de dados, além de permitir a inserção, edição e remoção manual de registros.

Na listagem, todas as colunas definidas na estrutura da tabela serão exibidas, juntamente com os registros gerados. Além disso, todas as tabelas internas possuem colunas fixas de ID, Data de criação e de atualização. A informação ID é usada para identificar os registros internamente no ambiente Floui e não pode ser modificado. Esse identificador pode ser utilizado em conjunto com outros conectores de consulta e gerenciamento de tabelas, mas os usuários também podem adicionar uma coluna própria de identificação da organização.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FvSznFCwQGq2YuYZMTiU0%2Fimage.png?alt=media&#x26;token=518ca257-1157-48f4-a4ff-823eba95b33d" alt=""><figcaption><p>Listagem de registros</p></figcaption></figure>

### Filtre e consulte registros

Na visualização dos registros existentes na tabela, é possível aplicar filtros sobre os dados. Para isso, clique no botão com o símbolo <img src="https://content.gitbook.com/content/226k0cnPTn1PWu9xHcK8/blobs/wDPEqIsXwebh02oASCpU/Captura%20de%20Tela%202023-07-13%20a%CC%80s%2020.11.54.png" alt="" data-size="line"> e insira o valor desejado em um dos campos da tabela.

Por exemplo, ao filtrar um campo específico, o Floui exibirá apenas os registros que correspondem ao critério definido, permitindo uma busca mais precisa e eficiente. Essa funcionalidade facilita a gestão das informações armazenadas.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2F40JYFtfZMKNpZJR4iQuR%2Fimage.png?alt=media&#x26;token=01b33d00-95cc-4b21-bc21-1c70c5571877" alt=""><figcaption><p>Filtro de registros</p></figcaption></figure>

## Armazene novos registros

Com os conectores exclusivos da biblioteca Floui, a inclusão de dados torna-se um processo ágil e automatizado. Os registros podem ser adicionados individualmente, por meio da inserção manual, ou utilizando os conectores disponíveis.

### Inserção manual de registros

A inserção manual permite um gerenciamento detalhado da tabela, proporcionando uma interface intuitiva para adicionar registros conforme a estrutura definida. Para incluir um novo registro manualmente, acesse a visualização de registros da tabela e clique em **Adicionar Registro**.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2Ftro1QwB2rBA6aCA7fTF2%2Fimage.png?alt=media&#x26;token=0c5417c1-ddf4-4dd8-8131-0e941e50c041" alt=""><figcaption><p>Acesso a criação manual de registros</p></figcaption></figure>

O formulário de criação manual de registros seguirá a configuração dos campos definida na estrutura da tabela, garantindo que todas as validações estabelecidas sejam aplicadas.&#x20;

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2Fh5cKUG4RjvQld3EzSujP%2Fimage.png?alt=media&#x26;token=328ee299-4ebc-4fd7-8f38-a86a0d6445be" alt=""><figcaption><p>Exemplo de criação manual de registro</p></figcaption></figure>

### Conectores Floui Database

Os conectores do Floui Database representam a porta de entrada para uma automação eficaz na manipulação de dados. Ao permitir a interação fluida entre diferentes sistemas e serviços, esses conectores são pilares na automação de processos e manipulação de tabelas.&#x20;

Acesse a [documentação de conectores do Floui Database](https://docs.floui.io/guia/conectores/categorias/servicos-do-floui/floui-database) para ampliar o seu conhecimento e gerar processos automatizados complexos em tabelas internas.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FUGh5imn9xVIf0S2M2Sxu%2Fimage.png?alt=media&#x26;token=052907b4-2030-4376-9b47-d0f3b0eec961" alt=""><figcaption><p>Conectores Floui Database</p></figcaption></figure>

## Exportação de registros

Os dados armazenados em uma Floui Database podem ser exportados para um arquivo CSV, isso possibilita a geração de relatórios, a partir de dados manipulados dentro do Workspace Floui, ou a importação em sistemas externos.

Acesse a visualização de registros da tabela. No menu superior, clique em Exportar CSV, em seguida confirme o download.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FAdaXpFG2OE6GaFQZZhQ4%2Fimage.png?alt=media&#x26;token=013b10d7-6c1b-42c8-b305-6854ba9b39b4" alt=""><figcaption></figcaption></figure>

## Alterações na estrutura de tabelas

Para modificar uma estrutura de uma tabela, basta acessar o botão **Editar estrutura**, localizada na tela de listagem e gerenciamento de tabelas.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FeOKv1tb6GG3IurCHSa5w%2Fimage.png?alt=media&#x26;token=3a74652e-5b7a-45a5-b790-423e7b2a69b4" alt=""><figcaption><p>Edição da estrutura da tabela</p></figcaption></figure>

Por esta tela será possível adicionar novas colunas, remover colunas existentes, além de alterar a estrutura dos dados de colunas específicas.&#x20;

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2Fkg24F6MmygdTNZqvLELa%2Fimage.png?alt=media&#x26;token=13ed5c83-2aa9-4ada-a501-a57592e9d15e" alt=""><figcaption><p>Alteração na estrutura da tabela</p></figcaption></figure>

No exemplo acima, foi inserido uma nova coluna para informar o código do fabricante, com um valor padrão de 1, podendo se referir a uma regra de negócio específica da organização.&#x20;

Também é possível selecionar a opção **Aplicar valores padrões para novos campos em registros existentes**, isto indica que registros antigos, prévios a esta modificação, serão atualizados para incluir a nova coluna com o valor padrão. Neste caso os registros antigos receberão a coluna referente ao código do fabricante, e com valor 1 preenchido por padrão.

{% hint style="danger" %}
Recomendamos criar uma cópia dos dados antes de realizar qualquer alteração na estrutura da tabela. Essa prática ajuda a prevenir a perda de informações existentes em caso de erros durante a edição.
{% endhint %}

Após as edições estarem concluídas, salve as alterações clicando no botão **Salvar tabela**.

## Duplique tabelas

A partir da listagem e gerenciamento de tabelas criadas, é possível duplicar uma tabela (juntamente com os seus registros). Para isto, clique no botão **Duplicar** na tabela desejada e informe o novo nome para a tabela.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FexNLl3O3rF9zReVGvbjx%2Fimage.png?alt=media&#x26;token=34a04a5b-71dd-4637-892a-3fdfb67701ca" alt=""><figcaption><p>Duplicação de tabelas</p></figcaption></figure>
