Pacote de documentação - modelo de exemplo

Dica:

Baixe o arquivo de modelo de amostra para usá-lo como ponto de partida para seu pacote de documentação: Amostra de estrutura de documentação.docx.

Use essa estrutura como anexo obrigatório ao enviar um modelo de aplicativo do Process Mining. Cole em um arquivo Word/PDF, preencha os placeholders cinzas e anexe o documento finalizado à sua listagem.

1 | Identificação do modelo (obrigatório)

Item	Valor
Nome do modelo de aplicativo	Gerenciamento de incidentes do Salesforce
Versão	v1.0 (julho de 2025)
Sistema(s) de origem	Salesforce Service Cloud
Ferramenta de extração	CData Sync
Banco de dados de destino	Snowflake / SQL Server

2 | Estrutura de dados — Objetos obrigatórios (obrigatório)

Finalidade: mostrar aos revisores que você entregará o mínimo de tabelas brutas que o modelo espera. Não liste todos os campos aqui;

Camada	Tabelas /Arquivos obrigatórios	Observações
Transacional	Histórico de casos, Caso	Tabelas de objeto principal
Dados Mestres	Conta, Contato, TipoDeRegistro, Usuário, FunçãoDeUsuário, Perfil	Necessário para junções e pesquisas de dimensão
Marco	Marco, tipo de marco	Habilita a análise de data de vencimento e SLA

Convenção de nomeação de arquivo (exemplo):

bash

Case_raw.csv

CaseHistory_raw.csv

...

Observação: todos os arquivos entregues como UTF-8 CSV com delimitador de vírgula.

3 | Instruções de configuração (recomendado)

3.1 Conexão de origem - Salesforce

1. Conector: CData Sync
2. Esquema de autenticação: básico
3. Credenciais necessárias:
   • Usuário – Usuário da API do Salesforce
   • Senha – senha do usuário
   • Token de segurança — token do Salesforce
   • URL de login – por exemplo https://login.salesforce.com/pt/

3.2 Trabalho do CData Sync

Etapa	Configuração	Valor
1	Esquema de destino	<target_schema>
2	....	N/A

3.3. Banco de dados de destino

• Snowflake *ou
• SQL Server – Escolha um.
• Conceda ao usuário de destino do CData CREATE TABLE, INSERT, UPDATE, DELETE no esquema de destino.

3.4 Transformações (dbt)

• Todas as tabelas *_raw são transformadas por meio de modelos dbt para o formato final de entrada do Process Mining.

Observação: indique aos usuários se há algum modelo específico em que eles precisam prestar atenção (por exemplo valores codificados etc)

4 | Pré-requisitos do sistema (recomendado)

Component	Requisito Mínimo
Perfil do Salesforce	Acesso somente leitura a objetos na Seção 2
Versão do CData Sync	xx.XX ou posterior (as versões anteriores exigem edições de consulta por nota do provedor)

5 | Guia do usuário (recomendado)

(Forneça a documentação que abrange diretrizes de navegação específicas caso haja métricas ou campos que precisem ser configurados antes da publicação)

6 | Solução de problemas e suporte (recomendado)

Cenário	Causa raiz	Resolution
Falha de autenticação	Token ou restrição de IP inválido	Redefinir token de segurança do Salesforce e IP CData da lista de permissões
Tabelas ausentes	O perfil não tem acesso a objetos	Conceder permissão de leitura no nível do objeto
.....	N/A	N/A

Contato de suporte: [e-mail] – resposta dentro de 4 horas úteis.