Package de documentation : exemple de modèle

Astuce :

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 | Identification du modèle (requis)

Elément	Valeur (Value)
Nom du modèle d'application	Gestion des incidents Salesforce
Version	v1.0 (juin 2025)
Système(s) source(s)	Salesforce Service Cloud
Outil d'extraction	Synchronisation des données C
BD de destination	Snowflake / SQL Server

2 | Structure des données : Objets requis (requis)

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

Couche	Tables/fichiers obligatoires	Remarques
Transactionnel	Historique des cas, cas	Tables d’objets clés
Données de base	Compte, Contact, TypeEnregistrement, Utilisateur, RôleUtilisateur, Profil	Nécessaire pour les jointures et les recherches de dimension
Étapes	Cas Étape, TypeÉtape	Permet l’analyse de la date d’échéance et du SLA

Conventions d'affectation de noms de fichiers (exemple) :

bash

Cas_Brut.csv

CaseHistorique_raw.csv

...

Remarque : tous les fichiers sont livrés au format CSV UTF-8 avec délimiteur par virgule.

3 | Instructions de configuration (recommandée)

3.1 Connexion source - Salesforce

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

3.2 Tâche CData Sync

Étape	Paramètre	Valeur (Value)
1	Schéma de destination	<target_schema>
2	….	S/O

3.3. Base de données de destination

• Snowflake *or
• SQL Server – choose one.
• Accordez l'utilisateur cible CData CREATE Table, INSERT, UPDATE, DELETE sur le schéma de destination.

3.4 Transformations (dbt)

• Toutes les tables *_raw sont transformées via des modèles dbt au format d'entrée final Process Mining.

Remarque : indiquez aux utilisateurs s'il existe des modèles spécifiques auxquels ils doivent faire attention (par exemple valeurs codées en dur, etc.)

4 | Prérequis système (recommandé)

Composant (Component)	Configuration minimale requise
Profil Salesforce	Accès en lecture seule aux objets dans la section 2
Version CData Sync	XX.XX ou versions ultérieures (les versions antérieures nécessitent des modifications de requête par note de fournisseur)

5 | Guide de l’utilisateur (recommandé)

(Fournissez une documentation couvrant des directives de navigation spécifiques au cas où des métriques ou des champs doivent être configurés avant la publication)

6 | Dépannage et assistance (recommandé)

Scénario	Cause profonde	Résolution
Échec de l'authentification	Jeton ou restriction IP non valide	Réinitialiser le jeton de sécurité Salesforce et ajouter une adresse IP CData à la liste blanche
Tables manquantes	Le profil ne contient pas l'accès aux objets	Accorder une autorisation de lecture au niveau de l’objet
….	S/O	S/O

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