Il data model di Salesforce V3

Introduzione

Questo documento è una guida agli oggetti di Salesforce coinvolti nell'integrazione con Docebo.

Struttura degli oggetti

Questa sezione elenca gli oggetti di Salesforce coinvolti nell'integrazione, e fornisce dettagli sulla loro struttura.

Docebo User (`docebo_v3DoceboUserc`)

Questo oggetto raccoglie i dati relativi agli utenti di Docebo. Rappresenta gli utenti della piattaforma coinvolti dall'integrazione ed è associato alle eventuali iscrizioni relative ai corsi e/o ai piani formativi sincronizzati.

Field Label	Field Name	Data Type	Indexed
Contact	`docebov3__Contact__c`	`Lookup(Contact)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Docebo User Id	`Name`	`Text(80)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Owner	`OwnerId`	`Lookup(User,Group)`	`TRUE`
User	`docebov3__User__c`	`Lookup(User)`	`TRUE`
User Id	`docebov3__UserId__c`	`Number(18, 0) (External ID) (Unique)`	`TRUE`
Who	`docebov3__Who__c`	`Text(18)`	`FALSE`

Learning Plan (`docebo_v3LearningPlanc`)

Questo oggetto raccoglie dati relativi ai piani formativi. Rappresenta i record dei piani formativi e le relative iscrizioni e i dati dei corsi. Raccoglie i dati di completamento dei piani formativi grazie alle relazioni con le iscrizioni ai corsi.

Field Label	Field Name	Data Type	Indexed
Catalog_Deeplink	`docebo_v3_Catalog_Deeplink_c`	`Formula (Text)`	`FALSE`
Code	`docebov3__Code__c`	`Text(255)`	`FALSE`
Courses	`docebov3__Courses__c`	`Roll-Up Summary (COUNT Learning Plan Course)`	`FALSE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Creation Date	`docebov3__CreationDate__c`	`Date/Time`	`FALSE`
Deeplink	`docebov3__Deeplink__c`	`Formula (Text)`	`FALSE`
Deleted	`docebov3__Deleted__c`	`Checkbox`	`FALSE`
Deletion Date	`docebov3__DeletionDate__c`	`Date/Time`	`FALSE`
Description	`docebov3__Description__c`	`Long Text Area(131072)`	`FALSE`
Effective	`docebov3__Effective__c`	`Checkbox`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Last Update Date	`docebov3__LastUpdateDate__c`	`Date/Time`	`FALSE`
Learning Plan Id	`docebov3__LearningPlanId__c`	`Number(11, 0) (External ID) (Unique)`	`TRUE`
Learning Plan Id	`Name`	`Text(80)`	`TRUE`
Name	`docebov3__Name__c`	`Text(255)`	`FALSE`
Owner	`OwnerID`	`Lookup(User,Group)`	`TRUE`
Slug	`docebov3__Slug__c`	`Text(255)`	`FALSE`
Thumbnail	`docebov3__Thumbnail__c`	`URL(255)`	`FALSE`

Learning Plan Course (`docebo_v3LearningPlanCoursec`)

Questo oggetto lega i corsi ai piani formativi. È l'anello di congiunzione fra docebo_v3__LearningPlan__c e docebo_v3__Course__c e rappresenta la relazione fra corsi e piani formativi in piattaforma.

Field Label	Field Name	Data Type	Indexed
CompositeForeignKey	`docebov3__CompsiteForeignKey__c`	`Text(255) (External ID) (Unique Case Insensitive)`	`TRUE`
Course	`docebov3__Course__c`	`Master-Detail(Course)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Learning Plan	`docebov3__LearningPlan__c`	`Master-Detail(Learning Plan)`	`TRUE`
Learning Plan Course Id	`Name`	`Text(80)`	`TRUE`

Learning Plan Course Enrollment (`docebo_v3LearningPlanCourseEnrollmentc`)

Questo oggetto lega le iscrizioni ai piani formativi con le iscrizioni ai corsi dei piani formativi. È l'anello di congiunzione utilizzato per rappresentare i dati di completamento dei piani formativi in base al completamento dei corsi del piano formativo da parte degli utenti.

Field Label	Field Name	Data Type	Indexed
Completed	`docebov3__Completed__c`	`Checkbox`	`FALSE`
Course Enrollment	`docebov3__CourseEnrollment__c`	`Lookup(Course Enrollment)`	`TRUE`
Course Enrollment Status	`docebov3__CourseEnrollmentStatus__c`	`Picklist`	`FALSE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Effective	`docebo_v3__Effective__c`	`Checkbox`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Learning Plan Course Enrollment Id	`Name`	`Text(80)`	`TRUE`
Learning Plan Enrollment	`docebov3__LearningPlanEnrollment__c`	`Master-Detail(Learning Plan Enrollment)`	`TRUE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`

Learning Plan Enrollment (`docebo_v3LearningPlanEnrollmentc`)

Questo oggetto raccoglie i dati relativi alle iscrizioni ai piani formativi. Rappresenta l'iscrizione di un utente della piattaforma a un piano formativo.

Field Label	Field Name	Data Type	Indexed
Completed Courses	`docebov3__CompletedCourses__c`	`Roll-Up Summary (COUNT Learning Plan Course Enrollment)`	`FALSE`
Completion	`docebov3__Completion__c`	`Formula (Percent)`	`FALSE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Docebo User	`docebov3__DoceboUser__c`	`Master-Detail(Docebo User)`	`TRUE`
Enrolment Id	`docebov3__EnrolmentId__c`	`Text(18) (External ID) (Unique Case Insensitive)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Learning Plan	`docebov3__LearningPlan__c`	`Lookup(Learning Plan)`	`TRUE`
Learning Plan Courses	`docebov3__LearningPlanCourses__c`	`Formula (Number)`	`FALSE`
Learning Plan Enrollment Id	`Name`	`Text(80)`	`TRUE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`
Who	`docebov3__Who__c`	`Text(18)`	`FALSE`

Course (`docebo_v3Coursec`)

Questo oggetto raccoglie i dati relativi ai corsi di Docebo. Rappresenta i dati dei corsi della piattaforma ed espone una parte delle loro proprietà.

Field Label	Field Name	Data Type	Indexed
Catalog_Deeplink	`docebo_v3_Catalog_Deeplink_c`	`Formula (Text)`	`TRUE`
Code	`docebov3__Code__c`	`Text(255)`	`FALSE`
Course External Id	`docebov3__CourseId__c`	`Number(11, 0) (External ID) (Unique)`	`TRUE`
Course Id	`Name`	`Text(80)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Creation Date	`docebov3__CreationDate__c`	`Date/Time`	`FALSE`
Deeplink	`docebov3__Deeplink__c`	`Formula (Text)`	`FALSE`
Deleted	`docebov3__Deleted__c`	`Checkbox`	`FALSE`
Deletion Date	`docebov3__DeletionDate__c`	`Date/Time`	`FALSE`
Description	`docebov3__Description__c`	`Long Text Area(131072)`	`FALSE`
Effective	`docebov3__Effective__c`	`Checkbox`	`FALSE`
Language	`docebov3__Language__c`	`Text(100)`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Last Update Date	`docebov3__LastUpdateDate__c`	`Date/Time`	`FALSE`
Name	`docebov3__Name__c`	`Text(255)`	`FALSE`
Owner	`OwnerId`	`Lookup(User,Group)`	`FALSE`
Slug	`docebov3__Slug__c`	`Text(255)`	`FALSE`
Thumbnail	`docebov3__Thumbnail__c`	`URL(255)`	`FALSE`
Type	`docebov3__Type__c`	`Picklist`	`FALSE`

Course Enrollment (`docebo_v3CourseEnrollmentc`)

Questo oggetto raccoglie dati riguardo le iscrizioni ai corsi di Docebo. Rappresenta l'iscrizione di un utente della piattaforma a un corso. Raccoglie anche dati relativi al completamento di una determinata iscrizione (es. quanti materiali didattici sono stati completati da un utente in un corso).

Field Label	Field Name	Data Type	Indexed
CompletedLearningObjects	`docebov3__CompletedLearningObjects__c`	`Number(10, 0)`	`FALSE`
Completion	`docebov3__Completion__c`	`Percent(16, 2)`	`FALSE`
Completion Date	`docebov3__EnrollmentCompletionDate__c`	`Date/Time`	`FALSE`
Course	`docebov3__Course__c`	`Master-Detail(Course)`	`TRUE`
Course Enrollment Id	`Name`	`Text(80)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Credits	`docebov3__Credits__c`	`Number(14, 2)`	`FALSE`
Docebo User	`docebov3__DoceboUser__c`	`Master-Detail(Docebo User)`	`TRUE`
Enrollment Date	`docebov3__EnrollmentStartDate__c`	`Date/Time`	`FALSE`
Enrollment ID	`docebov3__EnrolmentId__c`	`Text(16) (External ID) (Unique Case Insensitive)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Score	`docebov3__Score__c`	`Number(14, 2)`	`FALSE`
Status	`docebov3__Status__c`	`Picklist`	`FALSE`
Time in Course	`docebov3__TimeInCourse__c`	`Number(18, 0)`	`FALSE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`
Who	`docebov3__Who__c`	`Text(18)`	`FALSE`

Session (`docebo_v3Sessionc`)

Questo oggetto raccoglie dati riguardo le sessioni Docebo (per i webinar e i corsi in aula ILT). Rappresenta le sessioni della piattaforma di qualsiasi tipo, ed espone una parte dei dati ad esse associati.

Field Label	Field Name	Data Type	Indexed
Course	`docebov3__Course__c`	`Master-Detail(Course)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Date End	`docebo_v3_Date_End_c`	`Date/Time`	`FALSE`
Date Start	`docebo_v3_Date_Start_c`	`Date/Time`	`FALSE`
Deleted	`docebov3__Deleted__c`	`Checkbox`	`FALSE`
DeletionDate	`docebov3__DeletionDate__c`	`Date/Time`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Name	`docebov3__Name__c`	`Text(255)`	`FALSE`
Session External Id	`docebov3__SessionId__c`	`Text(32) (External ID) (Unique Case Insensitive)`	`TRUE`
Session Id	`Name`	`Text(80)`	`TRUE`
Session Type	`docebov3__SessionType__c`	`Formula (Text)`	`FALSE`

Session Attendance (`docebo_v3SessionAttendancec`)

Questo oggetto raccoglie dati relativi alla frequenza degli utenti alle sessioni webinar/corsi in aula. Rappresenta la frequenza degli utenti della piattaforma alle sessioni.

Suggerimento: La frequenza ad una sessione identifica il corso come completato nei dati integrati di Salesforce.

Field Label	Field Name	Data Type	Indexed
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Docebo User	`docebov3__DoceboUser__c`	`Master-Detail(Docebo User)`	`TRUE`
Enrolment Id	`docebov3__EnrolmentId__c`	`Text(18) (External ID) (Unique Case Insensitive)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Session	`docebov3__Session__c`	`Master-Detail(Session)`	`TRUE`
Session Attendance Id	`Name`	`Text(80)`	`TRUE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Lookup(User,Group)`	`FALSE`

Consigli d'uso

L’integrazione di Docebo con Salesforce definisce una serie di Custom Object in Salesforce. L’elenco dei Custom Object è disponibile sia nel package manager che in questo articolo. Di norma, Docebo utilizza operazioni batch, trigger e processi per caricare e gestire i dati custoditi nei Custom Object. Non sono supportati altri tipi di operazioni che possano interferire con i flussi sopracitati.

Consigliamo vivamente di ridurre al minimo la sovrapposizione delle procedure necessarie all’integrazione con altre procedure, poiché Docebo non è in grado di monitorare, eseguire il debug e gestire problemi derivanti dalle personalizzazioni che sono coinvolte o coinvolgono la logica dell’integrazione.

Seguono alcuni suggerimenti per la pianificazione delle personalizzazioni al pacchetto dell’integrazione di Docebo per Salesforce,

Tempistiche

L’integrazione con Docebo può essere configurata in modo da eseguire l’import e l’export di una grande mole di dati. Quando si eseguono questo tipo di operazioni, l’integrazione utilizza le risorse di Salesforce: chiamate API, trigger e query SQL. Quando si esegue l’import e l’export dei dati, assicurarsi che non ci siano altre procedure in corso sugli stessi oggetti per evitare di esaurire tutte le risorse disponibili.

Custom Object di Docebo

I Custom Object di Docebo sono soggetti ad aggiornamenti da parte di Docebo. Consigliamo vivamente di evitare di alterarne la struttura o aggiungere procedure di popolamento dati all’interno degli oggetti. Campi e dati aggiuntivi possono alterare il corretto funzionamento dell’integrazione, e causare interruzioni di servizio ai plugin non supportati da Docebo.

Evoluzione del Codice

Docebo effettua manutenzione e aggiorna il pacchetto dell’integrazione con Salesforce per tre motivi:

Nuove funzionalità
L’integrazione si arricchisce costantemente di nuove funzionalità. Docebo invia una comunicazione prima del rilascio di nuove funzionalità, in modo da consentire un periodo di test prima del rilascio ufficiale.
Risoluzione di bug
L’attività di bug fixing ha lo scopo di risolvere i problemi rilevati sull’integrazione standard. Il fix è rilasciato durante il rilascio settimanale solo se non altera la logica di business della funzionalità. In questo caso, è comunicato nella pagina degli Aggiornamenti di prodotto (si apre in una nuova scheda).
Migliorie alle performance
Così come per i bug fixing, queste modifiche non impattano la logica di business e sono rilasciate durante il rilascio settimanale e comunicate nella pagina degli Aggiornamenti di prodotto (si apre in una nuova scheda).

Consistenza

L’integrazione Docebo per Salesforce garantisce che:

I Custom Object non sono mai cancellati;
I dati nei Custom Object non sono mai cancellati (fatta eccezione per il Custom Object learning plan);
Le procedure e i trigger in uso non saranno mai cancellati, sebbene possano essere modificati per aggiungere nuove funzionalità, migliorare le performance e risolvere bug.

Attenzione! Docebo non supporta le personalizzazioni sviluppate dai gestori delle piattaforme o da integratori di terze parte al Data Model proprietario in Salesforce.

Introduzione

Struttura degli oggetti

Docebo User (docebo_v3__DoceboUser__c)

Learning Plan (docebo_v3__LearningPlan__c)

Learning Plan Course (docebo_v3__LearningPlanCourse__c)

Learning Plan Course Enrollment (docebo_v3__LearningPlanCourseEnrollment__c)

Learning Plan Enrollment (docebo_v3__LearningPlanEnrollment__c)

Course (docebo_v3__Course__c)

Course Enrollment (docebo_v3__CourseEnrollment__c)

Session (docebo_v3__Session__c)

Session Attendance (docebo_v3__SessionAttendance__c)