Package de documentation : exemple de modèle

Astuce : Téléchargez l’exemple de fichier de modèle pour l’utiliser comme point de départ de votre package de documentation : Infrastructure de documentation JavaScript.docx.

Utilisez cette structure comme pièce jointe obligatoire lorsque vous soumettez un modèle d'application Process Mining. Collez dans un fichier Word/PDF, remplissez les espaces réservés gris et joignez le document terminé à votre liste.

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)

Objectif : affichez les réviseurs que vous fournirez le minimum de tables brutes que le modèle attend. Ne pas répertorier chaque champ ici ;

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. Connecteur : CData Sync
2. Schéma d'authentification : Basique
3. Identifiants requis :
   • Utilisateur : Utilisateur de l'API Salesforce
   • Mot de passe : mot de passe de l'utilisateur
   • Jeton de sécurité : jeton Salesforce
   • URL de connexion – par ex. https://connexion.salesforce.com

3.2 Tâche CData Sync

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

3.3. Base de données de destination

• Snowflake ou SQL Server : choisissez-en un.
• 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
….

Contact d'assistance : [e-mail] : réponse dans les 4 heures ouvrables.