Il data model di Salesforce V3

Introduzione

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

Elenco della struttura degli oggetti personalizzati

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

Utente Docebo (`docebo_v3DoceboUserc`)

Questo oggetto personalizzato 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.

Voce campo	Nome campo	Tipo Data	Indicizzato
Contact	`docebo_v3__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	`docebo_v3__User__c`	`Lookup(User)`	`TRUE`
User Id	`docebo_v3__UserId__c`	`Number(18, 0) (External ID) (Unique)`	`TRUE`
Who	`docebo_v3__Who__c`	`Text(18)`	`FALSE`

Suggerimento: quando un utente viene creato da Salesforce in Docebo, il campo Who in Salesforce non viene popolato finché l'utente non viene iscritto a un piano formativo in Docebo. Se per identificare un utente in Docebo ci si basa sul campo Who, un'altra opzione consiste nell'utilizzare il campo docebo_v3_User_c, che corrisponde al campo sfdc_id in Docebo ed è sempre popolato.

Piano formativo (`docebo_v3LearningPlanc`)

Questo oggetto personalizzato raccoglie dati relativi ai piani formativi. Rappresenta i record dei piani formativi ed è collegato alle iscrizioni e ai dati dei corsi. Raccoglie inoltre i dati di completamento tramite una relazione roll-up con le iscrizioni ai propri corsi.

Attenzione! Questo oggetto rappresenta solo i piani formativi standard. Le certificazioni create con la nuova architettura di certificazione e riqualificazione non vengono sincronizzate con Salesforce e non sono rappresentate in questo oggetto.

Voce campo	Nome campo	Tipo Data	Indicizzato
Catalog_Deeplink	`docebo_v3__Catalog_Deeplink__c`	`Formula (Text)`	`FALSE`
Code	`docebo_v3__Code__c`	`Text(255)`	`FALSE`
Courses	`docebo_v3__Courses__c`	`Roll-Up Summary (COUNT Learning Plan Course)`	`FALSE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Creation Date	`docebo_v3__CreationDate__c`	`Date/Time`	`FALSE`
Deeplink	`docebo_v3__Deeplink__c`	`Formula (Text)`	`FALSE`
Deleted	`docebo_v3__Deleted__c`	`Checkbox`	`FALSE`
Deletion Date	`docebo_v3__DeletionDate__c`	`Date/Time`	`FALSE`
Description	`docebo_v3__Description__c`	`Long Text Area(131072)`	`FALSE`
Effective	`docebo_v3__Effective__c`	`Checkbox`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Last Update Date	`docebo_v3__LastUpdateDate__c`	`Date/Time`	`FALSE`
Learning Plan Id	`docebo_v3__LearningPlanId__c`	`Number(11, 0) (External ID) (Unique)`	`TRUE`
Learning Plan Id	`Name`	`Text(80)`	`TRUE`
Name	`docebo_v3__Name__c`	`Text(255)`	`FALSE`
Owner	`OwnerID`	`Lookup(User,Group)`	`TRUE`
Slug	`docebo_v3__Slug__c`	`Text(255)`	`FALSE`
Thumbnail	`docebo_v3__Thumbnail__c`	`URL(255)`	`FALSE`

Corso del piano formativo (`docebo_v3LearningPlanCoursec`)

Questo oggetto personalizzato 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.

Voce campo	Nome campo	Tipo Data	Indexed
CompositeForeignKey	`docebo_v3__CompsiteForeignKey__c`	`Text(255) (External ID) (Unique Case Insensitive)`	`TRUE`
Course	`docebo_v3__Course__c`	`Master-Detail(Course)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Learning Plan	`docebo_v3__LearningPlan__c`	`Master-Detail(Learning Plan)`	`TRUE`
Learning Plan Course Id	`Name`	`Text(80)`	`TRUE`

Iscrizione al corso del piano formativo (`docebo_v3LearningPlanCourseEnrollmentc`)

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

Voce campo	Nome campo	Tipo Data	Indicizzato
Completed	`docebo_v3__Completed__c`	`Checkbox`	`FALSE`
Course Enrollment	`docebo_v3__CourseEnrollment__c`	`Lookup(Course Enrollment)`	`TRUE`
Course Enrollment Status	`docebo_v3__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	`docebo_v3__LearningPlanEnrollment__c`	`Master-Detail(Learning Plan Enrollment)`	`TRUE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`

Iscrizione al piano formativo (`docebo_v3LearningPlanEnrollmentc`)

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

Voce campo	Nome campo	Tipo Data	Indicizzato
Completed Courses	`docebov3__CompletedCourses__c`	`Roll-Up Summary (COUNT Learning Plan Course Enrollment)`	`FALSE`
Completion	`docebo_v3__Completion__c`	`Formula (Percent)`	`FALSE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Docebo User	`docebo_v3__DoceboUser__c`	`Master-Detail(Docebo User)`	`TRUE`
Enrolment Id	`docebo_v3__EnrolmentId__c`	`Text(18) (External ID) (Unique Case Insensitive)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Learning Plan	`docebo_v3__LearningPlan__c`	`Lookup(Learning Plan)`	`TRUE`
Learning Plan Courses	`docebo_v3__LearningPlanCourses__c`	`Formula (Number)`	`FALSE`
Learning Plan Enrollment Id	`Name`	`Text(80)`	`TRUE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`
Who	`docebo_v3__Who__c`	`Text(18)`	`FALSE`

Corso (`docebo_v3Coursec`)

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

Voce campo	Nome campo	Tipo Data	Indicizzato
Catalog_Deeplink	`docebo_v3_Catalog_Deeplink_c`	`Formula (Text)`	`FALSE`
Code	`docebo_v3__Code__c`	`Text(255)`	`FALSE`
Course External Id	`docebo_v3__CourseId__c`	`Number(11, 0) (External ID) (Unique)`	`TRUE`
Course Id	`Name`	`Text(80)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Creation Date	`docebo_v3__CreationDate__c`	`Date/Time`	`FALSE`
Deeplink	`docebo_v3__Deeplink__c`	`Formula (Text)`	`FALSE`
Deleted	`docebo_v3__Deleted__c`	`Checkbox`	`FALSE`
Deletion Date	`docebo_v3__DeletionDate__c`	`Date/Time`	`FALSE`
Description	`docebo_v3__Description__c`	`Long Text Area(131072)`	`FALSE`
Effective	`docebo_v3__Effective__c`	`Checkbox`	`FALSE`
Language	`docebo_v3__Language__c`	`Text(100)`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Last Update Date	`docebo_v3__LastUpdateDate__c`	`Date/Time`	`FALSE`
Name	`docebo_v3__Name__c`	`Text(255)`	`FALSE`
Owner	`OwnerId`	`Lookup(User,Group)`	`TRUE`
Slug	`docebo_v3__Slug__c`	`Text(255)`	`FALSE`
Thumbnail	`docebo_v3__Thumbnail__c`	`URL(255)`	`FALSE`
Type	`docebo_v3__Type__c`	`Picklist`	`FALSE`

Iscrizione al corso (`docebo_v3CourseEnrollmentc`)

Questo oggetto personalizzato raccoglie i dati relativi alle iscrizioni ai corsi di Docebo. Rappresenta l'iscrizione di un utente della piattaforma a un corso. Raccoglie anche dati relativi al completamento di quella determinata iscrizione (ad esempio, quanti materiali didattici sono stati completati da un determinato utente in un corso specifico).

Voce campo	Nome campo	Tipo Data	Indicizzato
CompletedLearningObjects	`docebo_v3__CompletedLearningObjects__c`	`Number(10, 0)`	`FALSE`
Completion	`docebo_v3__Completion__c`	`Percent(16, 2)`	`FALSE`
Completion Date	`docebo_v3__EnrollmentCompletionDate__c`	`Date/Time`	`FALSE`
Course	`docebo_v3__Course__c`	`Master-Detail(Course)`	`TRUE`
Course Enrollment Id	`Name`	`Text(80)`	`TRUE`
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Credits	`docebo_v3__Credits__c`	`Number(14, 2)`	`FALSE`
Docebo User	`docebo_v3__DoceboUser__c`	`Master-Detail(Docebo User)`	`TRUE`
Enrollment Date	`docebo_v3__EnrollmentStartDate__c`	`Date/Time`	`FALSE`
Enrollment ID	`docebo_v3__EnrolmentId__c`	`Text(16) (External ID) (Unique Case Insensitive)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Score	`docebo_v3__Score__c`	`Number(14, 2)`	`FALSE`
Status	`docebo_v3__Status__c`	`Picklist`	`FALSE`
Time in course	`docebo_v3__TimeInCourse__c`	`Number(18, 0)`	`FALSE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`
Who	`docebo_v3__Who__c`	`Text(18)`	`FALSE`

Sessione (`docebo_v3Sessionc`)

Questo oggetto personalizzato raccoglie i dati relativi alle sessioni Docebo (per i corsi ILT). Rappresenta le sessioni della piattaforma di qualsiasi tipo, ed espone una parte dei dati ad esse associati.

Voce campo	Nome campo	Tipo Data	Indicizzato
Course	`docebo_v3__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	`docebo_v3__Deleted__c`	`Checkbox`	`FALSE`
DeletionDate	`docebo_v3__DeletionDate__c`	`Date/Time`	`FALSE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Name	`docebo_v3__Name__c`	`Text(255)`	`FALSE`
Session External Id	`docebo_v3__SessionId__c`	`Text(32) (External ID) (Unique Case Insensitive)`	`TRUE`
Session Id	`Name`	`Text(80)`	`TRUE`
Session Type	`docebo_v3__SessionType__c`	`Formula (Text)`	`FALSE`

Presenza in sessione (`docebo_v3SessionAttendancec`)

Questo oggetto personalizzato raccoglie i dati relativi alla frequenza degli utenti alle sessioni ILT o in aula. Rappresenta i dati di frequenza degli utenti della piattaforma alle sessioni.

Suggerimento: la frequenza a una sessione segna il corso come completato nei dati integrati di Salesforce.

Voce campo	Nome campo	Tipo Data	Indicizzato
Created By	`CreatedById`	`Lookup(User)`	`FALSE`
Docebo User	`docebo_v3__DoceboUser__c`	`Master-Detail(Docebo User)`	`TRUE`
Enrolment Id	`docebo_v3__EnrolmentId__c`	`Text(18) (External ID) (Unique Case Insensitive)`	`TRUE`
Last Modified By	`LastModifiedById`	`Lookup(User)`	`FALSE`
Session	`docebo_v3__Session__c`	`Master-Detail(Session)`	`TRUE`
Session Attendance Id	`Name`	`Text(80)`	`TRUE`
UnenrollmentDate	`docebo_v3__UnenrollmentDate__c`	`Date/Time`	`FALSE`

Consigli d'uso

L'integrazione di Docebo con Salesforce definisce una serie di oggetti personalizzati in Salesforce. L'elenco degli oggetti personalizzati è disponibile sia nel package manager che in questo articolo. Di norma, Docebo utilizza operazioni batch, trigger e process builder per caricare e gestire i dati custoditi in questi oggetti personalizzati. Non sono supportati altri tipi di operazioni che possano interferire con i flussi di lavoro.

Consigliamo vivamente di ridurre al minimo la sovrapposizione dell'integrazione con le procedure esistenti, 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.

Se si intende implementare personalizzazioni al pacchetto dell'integrazione di Docebo per Salesforce, considerare quanto segue:

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 queste operazioni, l'integrazione utilizza le risorse di Salesforce come 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 nello stesso momento per evitare di esaurire tutte le risorse disponibili.

Oggetti personalizzati di Docebo

Gli oggetti personalizzati di Docebo possono essere soggetti ad aggiornamenti da parte di Docebo. Consigliamo vivamente di evitare di alterarne la struttura o di aggiungere procedure che eseguano direttamente il push dei dati al loro interno. Campi e dati aggiuntivi possono alterare il corretto funzionamento dell'integrazione e causare interruzioni di servizio del plugin non supportate da Docebo.

Evoluzione del codice

Docebo effettua la manutenzione e aggiorna il pacchetto dell'integrazione per tre motivi principali:

Nuove funzionalità
L'integrazione si arricchisce costantemente di nuove funzionalità. Prima del rilascio di una nuova funzionalità si riceve una comunicazione e si dispone di un periodo di test prima che venga messa in produzione.
Risoluzione di bug
L'attività di bug fixing ha lo scopo di risolvere i problemi rilevati sull'integrazione standard. Se il bug fix non altera la logica di business della funzionalità, viene rilasciato durante il rilascio di manutenzione settimanale e comunicato nella pagina degli Aggiornamenti di prodotto.
Migliorie alle performance
Così come per i bug fix, questo tipo di modifiche non impatta la logica di business e viene rilasciato durante il rilascio di manutenzione settimanale e comunicato nella pagina degli Aggiornamenti di prodotto.

Consistenza

L'integrazione di Docebo per Salesforce garantisce che:

Gli oggetti personalizzati non saranno mai cancellati;
I dati negli oggetti personalizzati non saranno mai cancellati (fatta eccezione per l'oggetto Learning Plan Course);
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 alcuna personalizzazione al proprio data model in Salesforce sviluppata dall'utente o da qualsiasi integratore di terze parti.

Introduzione

Elenco della struttura degli oggetti personalizzati

Utente Docebo (docebo_v3__DoceboUser__c)

Piano formativo (docebo_v3__LearningPlan__c)

Corso del piano formativo (docebo_v3__LearningPlanCourse__c)

Iscrizione al corso del piano formativo (docebo_v3__LearningPlanCourseEnrollment__c)

Iscrizione al piano formativo (docebo_v3__LearningPlanEnrollment__c)

Corso (docebo_v3__Course__c)

Iscrizione al corso (docebo_v3__CourseEnrollment__c)

Sessione (docebo_v3__Session__c)

Presenza in sessione (docebo_v3__SessionAttendance__c)