> 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/informacoes-gerais/faq-e-orientacoes/faq-backup-and-archive.md).

# \[FAQ] Backup e Arquivo – Perguntas frequentes

## ![](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)Visão geral

Esta FAQ aborda perguntas comuns relacionadas ao Flosum Backup & Archive, incluindo sua arquitetura em diferentes plataformas de nuvem, segurança, comportamento operacional e funcionalidade de restauração.

## <img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FfQykTTOGk7YPHzoHNMo5%2FInfrastructure-Icon.svg?alt=media&amp;token=dd5fc2b4-aaa6-4324-9639-ec7ee1d13f4c" alt="" data-size="original"> Arquitetura e Infraestrutura

<details>

<summary><strong>Qual é a configuração arquitetural do Flosum Backup &#x26; Archive na AWS?</strong></summary>

O Flosum Backup & Archive é executado em uma instância Amazon EC2 e conecta-se ao Salesforce SaaS externamente.

* O Nginx lida com solicitações de proxy e habilita SSL.
* O User Pool Service gerencia o controle de acesso.
* O MySQL armazena configurações do aplicativo.
* Opções de armazenamento local incluem:
  * SSD (gp2 ou gp3)
  * Armazenamento de objetos S3

<figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FGnj5Ebh62wPAi07FCynQ%2FFAQ-ArchitectureAWS.png?alt=media&amp;token=e126ecdc-0dbb-4813-aa44-6152790c61fd" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Qual é a configuração arquitetural para o Google Cloud Platform (GCP)?</strong></summary>

Executa dentro de uma Máquina Virtual do GCP e conecta-se externamente ao Salesforce SaaS.

* Nginx para proxy/SSL
* Google Identity Platform para controle de acesso
* MySQL para armazenamento de configuração
* Armazenamento CSV local em SSD

<figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FsJoXIhudQzO7ZTKdp6NW%2FFlosum%20Backup%20%26%20Archive%20Architecture%20GCP.drawio.png?alt=media&amp;token=2ab3b865-25f6-4818-abf2-6fa28e9634c9" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Qual é a configuração arquitetural para o Azure?</strong></summary>

Executa dentro de uma VM do Azure com acesso ao Salesforce SaaS.

* Nginx para proxy/SSL
* Azure Active Directory para controle de acesso
* MySQL para configurações do aplicativo
* Opções de armazenamento:
  * SSD (gp2 ou gp3)
  * Armazenamento compatível com S3

<figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2Frk1vjvIjW9nG4FqBGCa7%2FFlosum%20Backup%20%26%20Archive%20Architecture%20Azure.drawio.png?alt=media&amp;token=22f11f40-3853-4abf-9db1-3747b5a64c69" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Qual é a finalidade do MySQL no Backup &#x26; Archive?</strong></summary>

O MySQL (executando em um contêiner Docker) armazena dados de configuração, mas **não** armazena backups de clientes.

</details>

<details>

<summary><strong>Quantas instâncias EC2 são necessárias?</strong></summary>

Apenas uma instância EC2 é necessária para uma implantação padrão auto-hospedada.

</details>

<details>

<summary><strong>Como faço para aplicar patch em uma instalação auto-hospedada do Backup &#x26; Archive?</strong></summary>

Use os seguintes comandos para:

1. Executar
2. Atualizar
3. Verificar

```docker
sudo docker pull flosum/agent-node:x.xx.x
sudo docker-compose up -d
sudo docker ps
```

</details>

## ![](https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FsYqu8OeJgtLxFUONknLk%2FSecurity-Icon.svg?alt=media\&token=32878dbc-3902-4809-b58b-ec20fd5540f1) Segurança e Armazenamento

<details>

<summary><strong>Os dados são criptografados antes da transmissão para a AWS?</strong></summary>

Sim, os dados são criptografados tanto em trânsito quanto em repouso usando o **SHA-256** algoritmo.

</details>

<details>

<summary><strong>Podemos escolher SSD em vez de S3?</strong></summary>

Sim, você pode escolher entre SSD (gp2/gp3) ou S3/S3 Glacier para suas necessidades de armazenamento local.

</details>

<details>

<summary><strong>Qual é o papel das Configurações Globais e do Armazenamento Local?</strong></summary>

* **Global** gerencia conexões com o Salesforce e controla o acesso de usuários com o AWS Cognito (ou provedores de identidade respectivos).
* **Armazenamento Local** serve como armazenamento temporário de dados durante o processamento.

</details>

<details>

<summary><strong>Quais são os tipos de armazenamento local disponíveis</strong></summary>

* SSD (gp2)
* SSD (gp3)
* S3 Glacier Instant Retrieval
* S3 Glacier Flexible Retrieval

</details>

<details>

<summary><strong>Qual é a finalidade do Nginx?</strong></summary>

* Fazer proxy das solicitações para o contêiner Docker
* Gerenciar terminação de SSL e certificados
* Habilitar HTTPS para comunicação segura

</details>

## ![](https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FO36HuytHtrB4AAaIU8AC%2FRestore-Icon.svg?alt=media\&token=8727e285-8b99-4993-8aa9-148140042c32) Comportamento de Backup e Restauração

<details>

<summary><strong>Por que preciso de dois backups para restaurar dados (pontos de corrupção e recuperação)?</strong></summary>

Para minimizar suposições e restaurar apenas os dados afetados. O Flosum compara alterações entre:

* O backup **antes** da perda de dados (Ponto de Recuperação)
* O backup **depois** do incidente (Ponto de Corrupção Conhecido)

Apenas os **registros alterados** são restaurados, garantindo precisão e velocidade.

</details>

<details>

<summary><strong>Posso executar vários trabalhos de backup ou restauração simultaneamente?</strong></summary>

Não, apenas **um trabalho** (backup, restauração, arquivamento ou pesquisa) pode ser executado em um dado momento.

</details>

<details>

<summary><strong>O que acontece se um backup agendado coincidir com um trabalho em execução?</strong></summary>

O backup que se sobrepõe é **ignorado**. O próximo slot não agendado capturará quaisquer alterações perdidas. Backups Compostos retomam e capturam todos os deltas desde a última execução bem-sucedida.

</details>

<details>

<summary><strong>Por que objetos de Histórico não são restaurados?</strong></summary>

No Salesforce, objetos de Histórico não possuem **permissões de inserção/atualização** Esta é uma restrição ao nível da plataforma Salesforce, não uma limitação do Flosum.

</details>

<details>

<summary><strong>Como funcionam as contagens de registros nos trabalhos de backup?</strong></summary>

Ao verificar um trabalho de backup concluído, o aplicativo exibe contagens de registros indicando quantos registros estão armazenados no backup e quantos foram processados naquele trabalho.

<figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FeAahNdD9A3LVLBOFlVGl%2FFAQ-BackupRecordCounts-01.png?alt=media&amp;token=885b31dd-3bdf-4a85-82b6-06eea8baf969" alt=""><figcaption></figcaption></figure>

* **Total**: Contagem de todos os registros atualmente armazenados no aplicativo Backup & Archive para um objeto específico (por exemplo, Contas, Contatos).

<figure><img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2FNAP91UV9PHXvRqHIvl5F%2FFAQ-BackupRecordCounts-02.png?alt=media&amp;token=780198df-d18b-4af8-b2b8-4a9fb065c9be" alt=""><figcaption></figcaption></figure>

* Clicar em uma linha de objeto abre a **Tabela de Registros**, mostrando:
  * **Todos** = Adicionados + Alterados + Excluídos
  * **Adicionados** = Novos registros capturados neste trabalho
  * **Alterados** = Registros existentes que foram atualizados
  * **Excluídos** = Registros removidos desde o último backup

**Exemplo:**

Por exemplo, um novo backup foi criado ontem e capturou 40 registros de Case da sua organização. O Total mostraria 40 registros de Case. Hoje, você adicionou 10 novos Cases e atualizou 5 Cases existentes.

O backup de hoje mostrará:

<table data-header-hidden><thead><tr><th width="110.3333740234375"></th><th></th></tr></thead><tbody><tr><td>Total</td><td>50 (40 originais + 10 novos)</td></tr><tr><td>Adicionados</td><td>10</td></tr><tr><td>Alterados</td><td>5</td></tr><tr><td>Excluídos</td><td>0</td></tr><tr><td>Todos</td><td>15 (10 adicionados + 5 alterados)</td></tr></tbody></table>

**Resumo:**

* **Total** = Todos os registros armazenados
* **Todos / Adicionados / Alterados / Excluídos** = Alterações neste trabalho de backup específico

</details>

<details>

<summary><strong>O que os ícones e labels representam na tela “Adicionar Objetos Filho” no aplicativo Backup &#x26; Archive?</strong></summary>

Ícones e indicadores na tela "Adicionar Objetos Filho" transmitem relacionamentos importantes entre objetos pai e filho, especialmente durante exclusões ao arquivar:

<img src="https://1704501280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Focom3JROuDKOidclKbQx%2Fuploads%2F503SL383XJ4z3trI0XqC%2FArchiveTemplate-CascadeIcon.png?alt=media&amp;token=99df6e94-d8a7-4871-8b52-e6821036b802" alt="" data-size="line"> **Triângulo de Aviso Amarelo (Exclusão em Cascata)**

* O objeto filho tem um relacionamento dependente (exclusão em cascata) com o pai.
* Estes são considerados **objetos dependentes** no Salesforce.
* **Opcional incluir** no arquivo.
* Se excluídos, os registros filhos serão removidos quando o pai for arquivado e excluído.
* Isso reflete o comportamento nativo de cascata do Salesforce.

<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="line"> **Ícone de Cadeado Vermelho (Exclusão Restrita)**

* O objeto filho tem um **relacionamento de Exclusão Restrita** com o objeto pai.
* Esses objetos são **automaticamente incluídos** no modelo de arquivamento e **não podem ser excluídos.**
* No Salesforce, relacionamentos de exclusão restrita impedem que o registro pai seja excluído a menos que os registros filhos relacionados sejam excluídos primeiro.
* Necessário para arquivar e evitar erros.

</details>

<details>

<summary><strong>Por que estou recebendo o erro INVALID_CROSS_REFERENCE_KEY para o campo RecordTypeId no objeto Order durante a restauração?</strong></summary>

Esse erro ocorre quando o RecordTypeId dos dados arquivados não existe mais ou não é acessível na organização atual.

**Causas raiz:**

* O registro arquivado possui um RecordTypeId atribuído implicitamente que:
  * Não existe mais na organização atual.
  * Não é visível/acessível para o usuário que executa a restauração (usuário em execução).
  * Estava vinculado a uma configuração passada ou pacote gerenciado.

**Solução:**

* Exclua o campo RecordTypeId durante a restauração.
* O Salesforce atribuirá automaticamente o Tipo de Registro padrão.
* Evita erros de referência cruzada e conclui a restauração.

</details>

<details>

<summary><strong>Por que recebo o erro INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST ao restaurar um registro EmailMessage com um FromAddress?</strong></summary>

Isso acontece quando o FromAddress não é reconhecido ou validado em sua organização Salesforce.

**O Salesforce permite apenas:**

* Endereços de E-mail de Toda a Organização
* Endereços de roteamento Email-to-Case
* Endereços de e-mail de usuários ativos

Se o FromAddress no seu backup (por exemplo, <abc@abc.com>) não estiver validado, o Salesforce retornará:

* **INVALID\_OR\_NULL\_FOR\_RESTRICTED\_PICKLIST**
* **INVALID\_FIELD\_VALUE**

Esse erro ocorre porque o Salesforce está aplicando uma restrição no <mark style="color:verde;">FromAddress</mark> campo do <mark style="color:verde;">EmailMessage</mark> objeto. O erro se refere a <mark style="color:verde;">ValidatedFromAddress</mark>, mas o problema está no valor no <mark style="color:verde;">FromAddress</mark> campo, que deve ser validado e autorizado no Salesforce.

Internamente, o Salesforce usa um campo chamado <mark style="color:verde;">ValidatedFromAddress</mark> para garantir que o <mark style="color:verde;">FromAddress</mark> esteja entre a lista de remetentes autorizados. Para evitar esse erro durante uma restauração ou inserção, exclua o <mark style="color:verde;">ValidatedFromAddress</mark> campo da sua solicitação de restauração para registros EmailMessage.

</details>

<details>

<summary><strong>Quando a permissão “Query All Files” deve ser concedida a um usuário que usa o aplicativo Backup &#x26; Archive, e o que acontece se ela não for concedida?</strong></summary>

A **"Query All Files"** permissão é sensível e deve ser atribuída apenas a usuários de sistema ou de integração confiáveis.

**Obrigatória quando:**

* Fazendo backup ou restaurando arquivos que não foram explicitamente compartilhados com o usuário.

**Se não for concedida:**

* Apenas arquivos compartilhados serão copiados no backup.
* Alguns arquivos visíveis via acesso a registros poderão ser ignorados.
* A restauração pode perder anexos de arquivos que não foram capturados.

**Impacto:**

* Backup e restauração de arquivos incompletos.
* Risco de lacunas de dados em ambientes compartilhados ou colaborativos.

</details>


---

# 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/informacoes-gerais/faq-e-orientacoes/faq-backup-and-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.
