Introduzione
Questo documento è una guida agli Oggetti di Salesforce coinvolti nell'integrazione con Docebo. Segue un diagramma sulle relazioni fra le identità che mostra come gli Oggetti sono interconnessi. 
Struttura degli Oggetti
Questa sezione elenca gli Oggetti di Salesforce coinvolti nell'integrazione, e fornisce dettagli sulla loro struttura.
Docebo User (docebo_v3__DoceboUser__c)
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 | Controlling Field | Indexed |
| Contact | docebov3__Contact__c | Lookup(Contact) | TRUE | |
| Docebo User Id | Name | Text(80) | 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) | TRUE |
Learning Plan (docebo_v3__LearningPlan__c)
Questo oggetto raccoglie dati riguardo i Piani Formativi. Rappresenta i record dei piani formativi e le relative iscrizioni e i dati dei corsi. Raccogli i dati di completamento dei piani formativi grazie alle relazioni con le iscrizioni ai corsi.
| Field Label | Field Name | Data Type | Controlling Field | 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 | |
| Creation Date | docebov3__CreationDate__c | Date/Time | FALSE | |
| Deleted | docebov3__Deleted__c | Checkbox | FALSE | |
| Deletion Date | docebov3__DeletionDate__c | Date/Time | FALSE | |
| Description | docebov3__Description__c | Long Text Area(131072) | 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 | |
| Slug |
docebov3__Slug__c | Text(255) | FALSE | |
| Thumbnail |
docebov3__Thumbnail__c | URL(255) | FALSE |
Learning Plan Course (docebo_v3__LearningPlanCourse__c)
Questo Oggetto lega i corsi ai Piani Formativi. E' 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 | Controlling Field | Indexed |
| CompositeForeignKey | docebov3__CompsiteForeignKey__c | Text(255) (External ID) (Unique Case Insensitive) | TRUE | |
| Course | docebov3__Course__c | Master-Detail(Course) | TRUE | |
| Learning Plan | docebov3__LearningPlan__c | Master-Detail(Learning Plan) | TRUE | |
| Learning Plan Course Id | Name | Text(80) | FALSE |
Learning Plan Course Enrollment (docebo_v3__LearningPlanCourseEnrollment__c)
Questo Oggetto lega le iscrizioni ai Piani Formativi con le iscrizioni ai Corsi dei Piani Formativi. E' 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 | Controlling Field | Indexed |
| Completed | docebov3__Completed__c | Checkbox | FALSE | |
| Course Enrollment | docebov3__CourseEnrollment__c | Lookup(Course Enrollment) | TRUE | |
| Course Enrollment Status | docebov3__CourseEnrollmentStatus__c | Picklist | FALSE | |
| Learning Plan Course Enrollment Id | Name | Text(80) | TRUE | |
| Learning Plan Enrollment | docebov3__LearningPlanEnrollment__c | Master-Detail(Learning Plan Enrollment) | FALSE |
Learning Plan Enrollment (docebo_v3__LearningPlanEnrollment__c)
Questo Oggetto raccoglie i dati relativi alle iscrizioni ai Piani Formativi. Rappresenta l'iscrizione in Docebo di un utente della piattaforma ad un piano formativo.
| Field Label | Field Name | Data Type | Controlling Field | Indexed |
| Completed Courses | docebov3__CompletedCourses__c | Roll-Up Summary (COUNT Learning Plan Course Enrollment) | FALSE | |
| Completion | docebov3__Completion__c | Formula (Percent) | FALSE | |
| Docebo User | docebov3__DoceboUser__c | Master-Detail(Docebo User) | TRUE | |
| Enrolment Id | docebov3__EnrolmentId__c | Text(18) (External ID) (Unique Case Insensitive) | TRUE | |
| 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 | |
| Who | docebov3__Who__c | Text(18) | FALSE |
Course (docebo_v3__Course__c)
Questo Oggetto raccoglie i dati relativi ai corsi di Docebo. Rappresenta i dati dei corsi della piattaforma ed espone una parte delle relative proprietà.
| Field Label | Field Name | Data Type | Controlling Field | Indexed |
| Catalog_Deeplink |
docebo_v3_Catalog_Deeplink_c |
Formula (Text) | FALSE | |
| 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 | |
| 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 Update Date |
docebov3__LastUpdateDate__c | Date/Time | FALSE | |
| Name |
docebov3__Name__c | Text(255) | FALSE | |
| Slug |
docebov3__Slug__c | Text(255) | FALSE | |
| Thumbnail |
docebov3__Thumbnail__c | URL(255) | FALSE | |
| Type |
docebov3__Type__c | Picklist | FALSE |
Course Enrollment (docebo_v3__CourseEnrollment__c)
Questo Oggetto raccoglie dati riguardo le iscrizioni ai corsi di Docebo. Rappresenta l'iscrizione di un utente della piattaforma ad 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 | Controlling Field | 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 | |
| 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 | |
| Score | docebov3__Score__c | Number(14, 2) | FALSE | |
| Status |
docebov3__Status__c | Picklist | FALSE | |
| Time in Course |
docebov3__TimeInCourse__c | Number(18, 0) | FALSE | |
| Who |
docebov3__Who__c | Text(18) | FALSE |
Session (docebo_v3__Session__c)
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 | Controlling Field | Indexed |
| Course | docebov3__Course__c | Master-Detail(Course) | TRUE | |
| 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 | |
| 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_v3__SessionAttendance__c)
Questo Oggetto raccoglie dati relativi alla frequenza degli utenti alle sessioni webinar/corsi in aula. Rappresenta la frequenza degli utenti della piattaforma alle sessioni. La frequenza ad una sessione identifica il corso come completato nei dati integrati di Salesforce.
| Field Label | Field Name | Data Type | Controlling Field | Indexed |
| Docebo User | docebov3__DoceboUser__c | Master-Detail(Docebo User) | TRUE | |
| Enrolment Id |
docebov3__EnrolmentId__c | Text(18) (External ID) (Unique Case Insensitive) | TRUE | |
| Session |
docebov3__Session__c | Master-Detail(Session) | TRUE | |
| Session Attendance Id |
Name | Text(80) | TRUE |
Suggerimenti
L’integrazione di Docebo con Salesforce definisce una serie di Custom Object in Salesforce. L’elenco dei Custom Object è disponibile del package manager e in questo articolo. Come regola, 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.
- 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.
- 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.
Docebo non supporta le personalizzazioni sviluppate dai gestori delle piattaforme o da integratori di terze parte al Data Model proprietario in Salesforce.