> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/backup-and-archive/backup-and-archive-docs-pt-br/backup-e-arquivo/arquivos/enabling-retain-this-object-for-a-templated-archive.md).

# Ativando a opção Reter este objeto para um arquivo com modelo

{% hint style="success" %}

#### Credenciais de Usuário Obrigatórias

\[**Usuário Flosum**] - **Backup e Arquivo** licença com **Backup e Arquivo** permissões
{% endhint %}

## <img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-3f6faa4230b72167926fbc0a31dd17dc7d74581d%2FSummary2-Small-Icon.svg?alt=media" alt="" data-size="original">Visão geral

A **Manter Este Objeto** O recurso oferece maior controle sobre quais objetos são excluídos no Salesforce. Com esse recurso, você pode marcar objetos adicionados a um arquivo como **Retido**, o que significa que o objeto será incluído no arquivo, mas também permanecerá no Salesforce. Um objeto filho que não estiver **retido** ainda será excluído. As instruções abaixo demonstram como usar esse recurso e fornecem exemplos para ilustrar o resultado esperado.

{% hint style="info" %}
Por padrão, os objetos não têm **Manter Este Objeto** ativado, o que significa que serão excluídos do Salesforce quando arquivados.
{% endhint %}

<table><thead><tr><th width="76">Ícone</th><th>Descrição</th></tr></thead><tbody><tr><td><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-495996e1b962f62cadd244e22eca5bb571c24fe8%2FArchiveTemplate-RetainIcon.png?alt=media" alt=""></td><td>A <strong>Escudo verde</strong> o ícone indica que o objeto está marcado para retenção. No entanto, se o objeto depender de seu pai e o pai for excluído, o objeto também será excluído, mesmo estando marcado para retenção.</td></tr><tr><td><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-2c8b832f9b92cd020087adcd8cce9245d31e3d1d%2FArchiveTemplate-DependentIcon.png?alt=media" alt="" data-size="original"></td><td>A <strong>Cadeado vermelho</strong> o ícone indica que o objeto depende de seu pai. Isso significa que, se o objeto pai for excluído, o objeto filho também será excluído.</td></tr></tbody></table>

## Ativando Manter Este Objeto

1. Clique em um objeto para abrir o **Adicionar objetos filhos** diálogo.
2. Clique no **Manter este objeto** para ativá-lo.
3. Clique **Aplicar** para salvar as alterações.

   <div align="left"><figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-b5ba48a03250540c43313b9394984a3d5238f225%2FEnablingRetainThisObjectForATemplatedArchive-Retain-01.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
4. Quando a **Manter este objeto** alternância estiver ativada, um **Escudo verde** ícone aparecerá ao lado do objeto.

   <div align="left"><figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-a29285e54110dc7cc9b51fd35e0f55fb7404aceb%2FEnablingRetainThisObjectForATemplatedArchive-Retain-02.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

## Exemplos

Abaixo estão quatro exemplos que mostram cenários diferentes com **Manter Este Objeto** ativado. Cada exemplo explica quais configurações são usadas, quais objetos serão mantidos no Salesforce e quais serão excluídos.

{% stepper %}
{% step %}

### Exemplo: 1

Neste exemplo, o **Contato** e **Contato >> Contrato** os objetos estão marcados como **Retido**. A captura de tela abaixo indica quais objetos serão excluídos do Salesforce e quais serão salvos.

{% hint style="info" %}
A **Caso**, **Contrato**, e **Contrato de Serviço** os objetos têm objetos filhos dependentes que também serão excluídos. É importante entender que uma exclusão em cascata pode se estender por vários níveis de objetos. No entanto, para simplificar, este exemplo lista apenas os objetos filhos que dependem diretamente do pai raiz.
{% endhint %}

<div align="left"><figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-52353060c4e0f41d4b30565b5405c935e6fff243%2FEnablingRetainThisObjectForATemplatedArchive-Retain-03.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Exemplo: 2

Neste exemplo, apenas o **Contato >> Contrato** objeto está marcado como **Retido**. No entanto, como **Contato >> Contrato** depende de seu pai, ele ainda será excluído quando o Contato for excluído, acionando uma exclusão em cascata de **Contato >> Contrato**. A captura de tela abaixo indica quais objetos serão excluídos do Salesforce e quais serão salvos.

{% hint style="info" %}
Este exemplo ilustra a importância de entender como a dependência funciona ao usar o **Manter Este Objeto** recurso. Os objetos marcados como **Retido** ainda serão excluídos se dependerem de um pai que for excluído.
{% endhint %}

<div align="left"><figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-bc3102d136513329f053c786949744efd81eccc3%2FEnablingRetainThisObjectForATemplatedArchive-Retain-04.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Exemplo: 3

Neste exemplo, apenas o **Contato >> Resposta do Cliente** objeto está marcado como **Retido**. Como **Contato >> Resposta do Cliente** não depende de seu pai, ele será salvo mesmo após o **Contato** objeto ser excluído. A captura de tela abaixo indica quais objetos serão excluídos do Salesforce e quais serão salvos.

<div align="left"><figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-e5a1a7cf302ff55eb01b5256a193f9278a7e78ac%2FEnablingRetainThisObjectForATemplatedArchive-Retain-05.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Exemplo: 4

Neste exemplo, todos os objetos estão marcados como **Retido** exceto por **Contato >> Documento de Conteúdo**. Este é um exemplo prático de arquivar arquivos anexados a um contato enquanto se mantém o restante do registro de Contato no Salesforce. A captura de tela abaixo indica quais objetos serão excluídos do Salesforce e quais serão salvos.

<div align="left"><figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Fgit-blob-0e5786f621d8e4198bd0ef67ac6b88b7b1e23e7b%2FEnablingRetainThisObjectForATemplatedArchive-Retain-06.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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://docs.flosum.com/backup-and-archive/backup-and-archive-docs-pt-br/backup-e-arquivo/arquivos/enabling-retain-this-object-for-a-templated-archive.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.
