Dokumentationspaket – Beispielvorlage

Tipp:

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 | Vorlagenidentifikation (obligatorisch)

Element	Wert
Name der App-Vorlage	Salesforce-Incident-Management
Version	v1.0 (Juni 2025)
Quellsystem(e)	Salesforce Service Cloud
Extraktionstool	CData-Synchronisierung
Ziel-DB	Snowflake/SQL-Server

2 | Datenstruktur – Erforderliche Objekte (obligatorisch)

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

Ebene	Obligatorische Tabellen/Dateien	Hinweise
Transaktional	Fallverlauf, Fall	Wichtige Objekttabellen
Stammdaten	Konto, Kontakt, Datensatztyp, Benutzer, Benutzerrolle, Profil	Erforderlich für Verknüpfungen und Dimensionensuchen
Meilensteine	Case Meilenstein, Meilensteintyp	Aktiviert Fälligkeitsdatum und SLA-Analyse

Dateibenennungskonvention (Beispiel):

bash

case_raw.csv

CaseHistory_raw.csv

...

Hinweis: Alle Dateien werden als UTF-8-CSV mit Komma-Trennzeichen bereitgestellt.

3 | Setup-Anweisungen (Empfohlen)

3.1 Quellverbindung – Salesforce

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

3.2 CData-Synchronisierungsauftrag

Schritt	Einstellung	Wert
1	Zielschema	<target_schema>
2	….	Keine Angabe

3.3 Zieldatenbank

• Snowflake *or
• SQL Server – choose one.
• Gewähren Sie dem CData-Zielbenutzer CREATE TABLE, INSERT, UPDATE, DELETE für das Zielschema.

3.4 Transformationen (dbt)

• Alle *_raw-Tabellen werden über dbt-Modelle in das endgültige Process Mining-Eingabeformat umgewandelt.

Hinweis: Geben Sie den Benutzern an, ob sie auf bestimmte Modelle achten müssen (z. B hartcodierte Werte usw.)

4 | Systemvoraussetzungen (Empfohlen)

Komponente	Mindestanforderungen
Salesforce-Profil	Schreibgeschützter Zugriff auf Objekte im Abschnitt 2
CData Sync-Version	XX.XX oder höher ( frühere Versionen erfordern Abfragebearbeitungen pro Anbieterhinweis)

5 | Benutzerhandbuch (Empfohlen)

(Dokumentation mit bestimmten Navigationsrichtlinien bereitstellen, wenn Metriken oder Felder vorhanden sind, die vor der Veröffentlichung konfiguriert werden müssen)

6 | Fehlerbehebung und Support (Empfohlen)

Szenario	Ursache	Resolution
Authentifizierungsfehler	Ungültige Token oder IP-Einschränkung	Setzen Sie das Salesforce-Sicherheitstoken und die CData-IP auf die Whitelist zurück
Fehlende Tabellen	Das Profil hat keinen Objektzugriff	Gewähren Sie eine Leseberechtigung auf Objektebene
…..	Keine Angabe	Keine Angabe

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