Paquete de documentación: plantilla de muestra

Consejo:

Download the sample template file to use it as a starting point for your documentation package: Documentation Framework Sample.docx.

Use this structure as your mandatory attachment when submitting a Process Mining App Template. Paste into a Word / PDF file, fill in the grey placeholders, and attach the finished document to your listing.

1 | Identificación de plantilla (obligatorio)

Elemento	Valor
Nombre de la plantilla de aplicación	Gestión de incidentes de Salesforce
Versión	v1.0 (junio de 2025)
Sistemas de origen	Salesforce Service Cloud
Herramienta de extracción	Sincronización de CData
BD de destino	Snowflake/SQL Server

2 | Estructura de datos: objetos necesarios (obligatorio)

Purpose: show reviewers you will deliver the minimum raw tables the template expects. Do not list every field here;

Capa	Tablas/archivos obligatorios	Notas
Transaccional	HistorialDeCaso, Caso	Tablas de objetos clave
Datos maestros	Cuenta, contacto, tipo de registro, usuario, rol de usuario, perfil	Necesario para combinaciones y búsquedas de dimensiones
Hitos	Hito del caso, Tipo de hito	Habilita el análisis de fecha límite y SLA

Convención de nomenclatura de archivos (ejemplo):

bash

Caso_sin_procesar.csv

CasoHistorial_sin procesar.csv

...

Nota: Todos los archivos se entregan como UTF-8 CSV con delimitador de coma.

3 | Instrucciones de configuración (recomendado)

3.1 Conexión de origen: Salesforce

1. Connector: CData Sync
2. Auth Scheme: Basic
3. Credenciales necesarias:
   • User – Salesforce API user
   • Password – user password
   • Security Token – Salesforce token
   • Login URL – e.g. https://login.salesforce.com

3.2 Trabajo de sincronización de CData

Paso	Configuración	Valor
1	Esquema de destino	<target_schema>
2	….	N/D

3.3. Base de datos de destino

• Snowflake *or
• SQL Server – choose one.
• Concede al usuario de destino de CData CREAR TABLA, INSERTAR, ACTUALIZAR, ELIMINAR en el esquema de destino.

3.4 Transformaciones (dbt)

• Todas las tablas *_raw se transforman a través de modelos dbt al formato de entrada final de Process Mining.

Nota: indica a los usuarios si hay algún modelo específico al que deban prestar atención (p. ej. valores codificados, etc.)

4 | Requisitos previos del sistema (recomendado)

Componente	Requisitos mínimos
Perfil de Salesforce	Acceso de solo lectura a objetos en la sección 2
Versión de CData Sync	XX.XX o posterior (las versiones anteriores requieren ediciones de consulta por nota del proveedor)

5 | Guía del usuario (recomendado)

(Proporcione documentación que cubra las directrices de navegación específicas en los casos en que haya métricas o campos que deban configurarse antes de publicar)

6 | Solución de problemas y soporte (recomendado)

Escenario	Causa principal	Resolución
Fallo de autenticación	Token o restricción de IP no válidos	Restablecer el token de seguridad de Salesforce y la IP de CData de la lista blanca
Faltan tablas	El perfil carece de acceso a objetos	Conceder permiso de lectura a nivel de objeto
.....	N/D	N/D

Support contact: [e-mail] – response within 4 business hours.