> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeevdocs/dia-a-dia-no-zeev-docs/como-consultar-documentos/como-unir-documentos.md).

# Como unir documentos

Caso diversos documentos do mesmo assunto foram armazenados na mesma biblioteca, é possível juntá-los utilizando a funcionalidade de união de documentos.

## Visão geral

Caso diversos documentos do mesmo assunto foram armazenados na mesma biblioteca, é possível juntá-los utilizando a funcionalidade de união de documentos, que permite escolher um documento principal e  unir-lhe outro documento com seus aquivos. Após a união, os documentos secundários serão excluídos logicamente da biblioteca.

O Zeev docs permite que o usuário escolha entre três formas de união de documentos:

* **Mesclagem de arquivos:** os arquivos dos documentos secundários serão adicionados ao documento principal;
* **Substituição de arquivos:** os arquivos dos documentos secundários irão substituir os arquivos do documento principal;
* **Versionamento de arquivos:** os arquivos dos documentos secundários irão compor a versão mais atual do documento principal.

### Como mesclar arquivos <a href="#uniao-dos-arquivos-de-diversos-documentos-mesclagem-de-arquivos" id="uniao-dos-arquivos-de-diversos-documentos-mesclagem-de-arquivos"></a>

Na mesclagem de arquivos é preciso definir um documento como principal: esse documento receberá os arquivos dos demais documentos selecionados para a união, também chamados documentos secundários. É possível selecionar apenas 1 documento como principal e 1 ou mais documentos como secundários.

É importante ressaltar que os campos do documento principal (também chamados indexadores) serão mantidos com os mesmos valores que já estavam definidos. A operação de união não realiza a atualização dos campos da biblioteca, sendo esta uma operação que o usuário deverá realizar manualmente.

{% hint style="info" %}
**Dica**: só poderá ser realizada a união dos documentos que não estejam excluídos logicamente e estejam desbloqueados ou bloqueados para o usuário que estiver realizando a operação.
{% endhint %}

![Mesclagem de arquivos](https://content.gitbook.com/content/OIJt1dLjDh8tPhhAr4Od/blobs/JxtO63lOKSSln4kKfrL7/Gravar_2022_05_13_17_42_35_217.gif)

Para substituir ou versionar arquivos, basta seguir o mesmo procedimento supracitado e escolher a opção desejada, se substituição ou versionamento.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://kb.stoque.com.br/zeevdocs/dia-a-dia-no-zeev-docs/como-consultar-documentos/como-unir-documentos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
