> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/weknow-client/cadastros-gerais/exportacao-e-importacao-de-conteudos-wkdatas.md).

# Exportação e Importação de Conteúdos (WKDATAs)

A funcionalidade de **Exportação e Importação de Conteúdo** permite transferir cadastros e configurações entre diferentes ambientes do Weknow por meio de arquivos com extensão **.WKDATA**.

Esse recurso pode ser utilizado para migração de ambientes, compartilhamento de configurações e realização de backups manuais de objetos da plataforma.

### Exportação de conteúdo

Para exportar conteúdos:

1. Abra o **Weknow Desktop**.
2. Acesse **Ferramentas > Exportar conteúdo**.

A janela de exportação apresenta os grupos de objetos disponíveis para exportação. O usuário pode selecionar apenas os itens desejados ou exportar todo o conteúdo disponível.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FFDems9XBBZ2fN5wdlK87%2Fimage.png?alt=media&amp;token=02c8380f-fa04-4078-bc86-f9ff845ee53c" alt=""><figcaption></figcaption></figure>

Ao expandir cada grupo, é possível selecionar individualmente os objetos que farão parte do arquivo de exportação.

### Configurações da exportação

Na parte inferior da janela estão disponíveis opções que permitem definir quais informações acompanharão os objetos exportados.

| Opção                              | Descrição                                                                   |
| ---------------------------------- | --------------------------------------------------------------------------- |
| **Exportar permissões**            | Exporta as permissões de acesso dos objetos.                                |
| **Proprietário**                   | Preserva o proprietário dos objetos exportados.                             |
| **Entidades**                      | Define quais entidades de segurança serão exportadas.                       |
| **Exportar privacidade de campos** | Exporta configurações de privacidade de metadados e regras de formatação.   |
| **Entidades (privacidade)**        | Define quais entidades serão consideradas nas configurações de privacidade. |
| **Exportar variáveis de contexto** | Exporta as variáveis de contexto globais do ambiente.                       |

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FgmzrPoWDyNeY0nOZsyb3%2Fimage.png?alt=media&amp;token=2856c1ab-e2da-496a-a8d6-306c77e73d9f" alt=""><figcaption></figcaption></figure>

Após concluir a seleção dos objetos, clique em **Exportar** e escolha a pasta onde o arquivo **.WKDATA** será salvo.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FJl0y5rz4nHCjlqXAKcnz%2Fimage.png?alt=media&amp;token=99153b50-9281-46df-840b-8c5d641b4837" alt=""><figcaption></figcaption></figure>

### Exportação de permissões

Durante a exportação de conteúdos, também é possível exportar as **permissões associadas aos objetos selecionados**, permitindo preservar as configurações de acesso durante a importação em outro ambiente.

Quando as permissões são incluídas no arquivo `.WKDATA`, elas podem ser utilizadas durante a importação para manter as configurações de acesso do ambiente de origem, conforme os usuários e grupos correspondentes disponíveis no ambiente de destino.

{% hint style="warning" %}
**Importante:** Para preservar as permissões de um objeto durante a transferência entre ambientes, inclua as permissões na exportação junto com o conteúdo.
{% endhint %}

#### Importação de permissões

Durante a importação de um arquivo `.WKDATA` que contém permissões, as configurações de acesso exportadas são consideradas na importação do objeto.

Quando usuários ou grupos da origem não puderem ser relacionados aos correspondentes existentes no ambiente de destino, as permissões deverão ser revisadas após a importação.

{% hint style="warning" %}
**Atenção:** Caso as permissões não sejam exportadas junto com o conteúdo, elas não serão preservadas no arquivo `.WKDATA`. Nesse cenário, o objeto importado poderá utilizar as configurações de **Acessibilidade padrão** definidas no ambiente de destino.
{% endhint %}

### Exportação de conexões

A partir desta versão, a categoria **Conexão** também está disponível na tela de exportação.

As conexões podem ser exportadas de duas formas:

* selecionando uma ou mais conexões na categoria **Conexão**;
* automaticamente, quando um objeto utiliza uma conexão não padrão de forma explícita.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FrsOsUYVp7fQLJ8P1Qy21%2Fimage.png?alt=media&amp;token=ffd2df01-08d6-4001-b544-2bbf9067b154" alt=""><figcaption></figcaption></figure>

Essa funcionalidade preserva o vínculo entre os objetos exportados e suas respectivas conexões.

Por motivos de segurança, os parâmetros da conexão, como servidor, banco de dados, usuário e senha, não são exportados.

{% hint style="info" %}
Quando vários objetos utilizam a mesma conexão, ela é exportada apenas uma vez.
{% endhint %}

***

### Importação de conteúdo

Para importar um arquivo **.WKDATA**:

1. Abra o **Weknow Desktop**.
2. Acesse **Ferramentas > Importar conteúdo**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FGdzHntlPQRpN6OxcmT76%2Fimage.png?alt=media&amp;token=495b66d8-c4c0-496b-b8a9-bf9ecefceb33" alt=""><figcaption></figcaption></figure>

3. Selecione o arquivo .WKDATA que será importado.
4. Na tela **Importar conteúdo**, selecione os conteúdos que deseja importar.
5. Clique em **Importar**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2Fyc3Y5W5eAeB6esE2sAKw%2Fimage.png?alt=media&amp;token=302354f9-871a-43eb-95ee-ca23e7627b32" alt=""><figcaption></figcaption></figure>

A seleção realizada nessa etapa define os conteúdos principais que participarão da operação de importação.

{% hint style="info" %}
O sistema utiliza, por padrão, a última pasta utilizada durante operações de exportação ou importação.
{% endhint %}

### Confirmar importação

Após avançar com a importação, o sistema apresenta a etapa **Confirmar importação**.

Essa etapa permite revisar os objetos que efetivamente participarão da operação antes da conclusão do processo.

A tela de confirmação pode apresentar tanto os conteúdos selecionados diretamente na etapa anterior quanto objetos relacionados necessários para a importação.

{% hint style="warning" %}
Nao interfere a marcação dos checkbox
{% endhint %}

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FiCdGlkZx7fu88mN9W1O9%2Fimage.png?alt=media&amp;token=4a0a098c-f9b8-4710-a81e-3c95a25189cb" alt=""><figcaption></figcaption></figure>

### Dependências da importação

Alguns objetos possuem dependências necessárias para seu funcionamento.

Por exemplo, um Metadado pode utilizar uma Área de negócio, uma Regra de conversão ou uma Conexão.

Mesmo que esses objetos não tenham sido selecionados diretamente na tela Importar conteúdo, eles podem ser apresentados na etapa *Confirmar* *importação* quando forem necessários para o objeto principal.

Nesses casos, as dependências necessárias poderão ser importadas automaticamente para preservar os vínculos e garantir o funcionamento do conteúdo importado.

**Exemplo**

Ao selecionar um Metadado para importação, a tela Confirmar importação pode apresentar o Metadado e os objetos dos quais ele depende, como Área de negócio e Regra de conversão.

Se nenhuma substituição for configurada, esses objetos necessários serão considerados na importação.

### Substituição de objetos

A tela I**mportar conteúdo** permite, quando aplicável, substituir objetos presentes no arquivo por objetos já existentes no ambiente de destino.

Para realizar uma substituição, selecione o objeto que deverá ser utilizado no campo **Substituição**.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FMasbLSxoqaWx0W3bENu2%2Fimage.png?alt=media&amp;token=466c559c-5cb4-4085-9a18-b6d0cbfe9ee6" alt=""><figcaption></figcaption></figure>

Essa possibilidade permite reutilizar objetos já cadastrados no ambiente de destino e evitar a criação de objetos duplicados.

### Usuários

Durante a confirmação da importação, um usuário presente no arquivo pode ser substituído por um usuário já existente no ambiente de destino.

Nesse caso, o usuário presente no arquivo não será criado e os objetos importados passarão a utilizar o usuário selecionado no ambiente de destino.

Essa substituição não realiza a mesclagem de logs, políticas ou propriedades entre os usuários.

***

### Importação de conexões

Quando o arquivo contém conexões exportadas, elas são criadas automaticamente no ambiente de destino.

Durante esse processo são preservados:

* descrição da conexão;
* tipo de banco de dados;
* vínculos entre a conexão e os objetos relacionados.

Os parâmetros de acesso não são importados e deverão ser configurados manualmente.

Após a importação, o sistema apresenta a seguinte mensagem:

> **Foi realizada a importação parcial de algumas conexões. É necessário revisá-las para que elas estejam funcionais.**

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FoqwXRqNQIpv2qGAIzgVT%2Fimage.png?alt=media&amp;token=5c806a39-5aef-4bf2-97cc-2f54df6f3765" alt=""><figcaption></figcaption></figure>

***

### Configurando uma conexão importada

Após concluir a importação:

1. Localize a conexão importada.
2. Abra seu cadastro.
3. Clique em **Parâmetros**.
4. Informe os dados de acesso do ambiente de destino.
5. Salve as alterações.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FSTOCcjqUG4290gJjXP9D%2Fimage.png?alt=media&amp;token=9695ccdc-fa7e-441e-becb-f73e9f09361f" alt=""><figcaption></figcaption></figure>

Depois que os parâmetros forem configurados, todos os objetos vinculados passam a utilizar automaticamente essa conexão.

{% hint style="success" icon="circle-info" %}
Configure as conexões importadas antes de executar metadados, componentes ou tarefas que dependam delas. Isso evita falhas de execução causadas por conexões ainda não parametrizadas.
{% endhint %}

***

### Considerações

* Pacotes exportados em versões anteriores permanecem compatíveis com o sistema, porém não contêm informações sobre conexões.
* O conteúdo importado é duplicado e não sobrescreve objetos existentes. Antes de importar um mesmo arquivo novamente, verifique se os objetos já não foram importados anteriormente para evitar duplicidades.