Gestão de Dados para Objetos da REDA
Importar, exportar, atualizar em massa e limpar dados são todos recursos padrão do Salesforce — Data Loader, o Assistente de importação de dados, a exportação de dados — por isso este artigo trata dessa mecânica de forma breve e remete à documentação do Salesforce. O que ele cobre por completo são as armadilhas próprias do modelo de dados da REDA: os campos gerenciados pelo sistema que você nunca deve preencher na importação, os registros que a REDA protege contra exclusão e o fato de que a automação da REDA também dispara nas cargas feitas pelo Data Loader. Ao terminar a leitura, você conseguirá carregar e exportar dados da REDA em massa com segurança — sem corromper o estado gerenciado pelo sistema nem brigar com a automação.
Acesso necessário. Permissões de gestão de dados do Salesforce (Exportação de dados, Bulk API Hard Delete ou Modify All Data, conforme o caso) — no nível da organização. Além do acesso aos objetos da REDA que você for tocar: carregar negócios exige criação e edição de Oportunidade a partir de REDA - Property Leasing User ou REDA - Master Data - Admin; carregar Propriedades exige criação e edição de Propriedade. Excluir é mais restrito — a exclusão de Oportunidade se limita a Master Data Admin ou Property Leasing User; a exclusão de Propriedade, somente a Master Data Admin.
Quais objetos da REDA você vai carregar
Os objetos da REDA de alto volume que um administrador costuma carregar são:
- Propriedade, Oportunidade (o registro do negócio, da locação ou da venda) e Lead (o registro do prospect).
- Encargo de oportunidade e Fatura Opp — os registros financeiros abaixo de um negócio.
- Dados mestres: Região, Código de cobrança, Código de comodidades, Código de liquidação, Regra de Locação, Regra da Comissão, Regra da inflação, Tipo de propriedade e Lista de propriedades.
Uma observação sobre as edições: na edição Sales Cloud (ISV), os registros de prospect, negócio, serviço e marketing são os padrão Lead / Oportunidade / Caso / Campanha; na edição Platform (OEM), são os personalizados da REDA Lead / Oportunidade / Solicitação de serviço / Promoção. Carregue no objeto correspondente à sua edição.
Armadilha 1 — campos gerenciados pelo sistema (não mexa)
Muitos objetos da REDA trazem campos auxiliares gerenciados pelo sistema — campos que a automação grava para si mesma. Preenchê-los na importação corrompe o estado interno da REDA. A regra é simples:
As famílias de campos gerenciados pelo sistema que devem ficar em branco:
| Campo (rótulo) | Aparece em | Por que é gerenciado pelo sistema |
|---|---|---|
| SYS Currency | Conta, Contato, Oportunidade, Propriedade e a maioria dos objetos da REDA | Carimbado pela automação a partir da moeda do registro quando o multimoeda está ativado |
| Auto Created (Sys) | Fatura Opp (e faturas geradas automaticamente) | Marca os registros que a automação criou |
| Opp Invoice Batch SYS | Fatura Opp | Sinalizador de pertencimento ao lote |
| SYS Is Posted | Linha de reconciliação de despesas | Definido pelo processo de Contabilizar / Descontabilizar |
| Next Recurring Invoice Date SYS | Encargo de oportunidade | A chave com a qual o trabalho de faturamento recorrente faz a correspondência |
| SYS Month / SYS Period | Entrada da regra de inflação | Chaves de período calculadas |
| Key Definition ("DO NOT EDIT") | Conteúdo do REDA CMS | Chave de mapeamento interna — não preencha |
Armadilha 2 — a automação dispara na importação
Uma carga em massa em um objeto da REDA não é inerte. A automação da REDA é executada em qualquer alteração de dados, incluindo as cargas feitas pelo Data Loader e pela API — e não existe mecanismo para contorná-la: nenhuma configuração desliga a automação durante uma carga. Isso tem consequências reais:
- Quando o multimoeda está ativado, importar registros carimba a moeda a partir do campo SYS Currency da REDA.
- Os fluxos de reservas e de despesas podem criar Faturas Opp automaticamente como efeito colateral de uma carga.
- Fechar uma venda grava as trilhas de propriedade.
Como a automação sempre é executada, uma linha que viola uma regra de validação da REDA — por exemplo, uma Oportunidade que avança para um estágio com pré-requisitos sem os campos obrigatórios — é rejeitada linha a linha, com a mensagem do próprio REDA. Planeje as cargas em lotes pequenos e na ordem de dependências, e espere ler mensagens de validação ao longo do caminho.
Armadilha 3 — a exclusão é protegida
Vários registros da REDA são protegidos contra exclusão pela automação. Tentar excluir um deles retorna a mensagem do próprio REDA, na íntegra:
"This Opp Invoice Batch cannot be deleted."
"Expense Reconciliation Line cannot be deleted. Please unpost the batch prior to make any changes." — enquanto o lote está Posted
"You cannot delete this record. Record is locked for editing." — o bloqueio genérico
As Contas de Portfólio ativas e os Encargos de oportunidade também têm proteção contra exclusão. E, mesmo onde a exclusão é permitida, ela é restrita: a exclusão de Oportunidade se limita a Master Data Admin e Property Leasing User, a de Propriedade somente a Master Data Admin, e os Chamados não podem ser excluídos por ninguém. Quando uma exclusão é bloqueada, resolva antes o estado subjacente — descontabilize o lote, desvincule a fatura — e tente de novo.
Sequência de importação (ordem de dependências)
Carregue na ordem de dependências para que toda pesquisa seja resolvida contra um registro que já existe:
Isso espelha o roteiro de implementação (consulte O Roteiro de implementação).
Exportação e armazenamento
Exportar dados da REDA é uma exportação padrão do Salesforce — use a exportação do Data Loader ou a Exportação de dados agendada. O REDA não inclui uma ferramenta de exportação separada. O armazenamento é descontado dos mesmos limites da organização do Salesforce que qualquer outro dado; a REDA não acrescenta armazenamento próprio. Uma observação que vale conhecer: os arquivos de conteúdo do CMS — os arquivos que você carrega na guia Marketing de uma Propriedade — são arquivos do Salesforce (Salesforce Files) e contam para o armazenamento de arquivos da sua organização (consulte Administração do REDA CMS).
Exemplo prático: carregar 200 propriedades e suas locações
A Meridian Properties precisa carregar em massa 200 propriedades (as unidades do Meridian Court e da Harbour Tower) e, em seguida, suas locações:
O que vem a seguir
- Personalizando Objetos da REDA — campos e layouts personalizados nos objetos da REDA.
- Criando usuários e concedendo acesso à REDA — o acesso a objetos que cada carga exige.
- Administração do REDA CMS — os arquivos do CMS e como eles contam para o armazenamento.
- O Roteiro de implementação — a ordem para trazer os dados.
- Comportamento multimoeda — como funciona o carimbo do SYS Currency.
Perguntas frequentes
Sim, mas a automação da REDA dispara em cada linha — não há como desativá-la — e as regras de validação rejeitam as linhas com problema. Carregue em lotes pequenos, na ordem de dependências, e leia as mensagens de validação.
Não. Deixe em branco todos os campos gerenciados pelo sistema — a REDA os preenche. Preenchê-los corrompe o estado interno do registro.
Elas são protegidas contra exclusão. Você verá "This Opp Invoice cannot be deleted." ou "Expense Reconciliation Line cannot be deleted. Please unpost the batch prior to make any changes." Resolva o estado subjacente — descontabilize o lote, desvincule a fatura — e tente de novo.
Não. Use a Exportação de dados padrão do Salesforce ou o Data Loader. O REDA não inclui uma ferramenta de exportação separada.
Sim — são arquivos do Salesforce (Salesforce Files) e contam para o armazenamento de arquivos. O REDA não acrescenta armazenamento próprio.
Isso foi útil?