Questo enum definisce un set di stili di serializzazione polimorfica.
Ogni valore dell'enum rappresenta un diverso stile (applicabile ad una o più proprietà di uno o più DTO).
HTTP Header
L'header HTTP Crm-OpportunityPhaseStyle agisce sulla proprietà phase di OpportunityDTO.
Il nodo rappresenta una foreign key di tipo OpportunityPhaseDTO
Stili polimorfici
Di seguito una lista degli stili polimorfici supportati dall'header HTTP Crm-OpportunityPhaseStyle
Id
La foreign key è rappresentata dal valore nativo OpportunityPhaseDTO.id presente nel database di CRM in Cloud
{
"phase": 2
}
AdaptiveDescription
Transcodifica adattiva della foreign key usando i valori del corrispondente campo OpportunityPhaseDTO.description
{
"phase": "Contatto iniziale"
}
AdaptiveStringOnlyDescription
Funziona allo stesso modo di AdaptiveDescription, con la differenza che tutti i valori ritornati/serializzati sono sempre in formato stringa (inclusi i valori numerici degli id)
{
"phase": "Contatto iniziale"
}
AdaptiveExternalReference
Ogni “categoria” è rappresentata da una stringa che contiene il nome corrispondente nel database del client chiamante.
Attenzione: questo valore dell’opzione deve essere usato in concomitanza con l’opzione Crm-ApplicationName, che consente a CRM in Cloud di identificare l’applicazione chiamante, ed eseguire i relativi mappings per la risoluzione delle categorie
{
"phase": "Contatto iniziale"
}
FlattenedExpansion
La foreign key che connette il campo phase all'entità OpportunityPhaseDTO è "espansa" nel seguente set di campi JSON:
{
"phase":3,
"phase_Description": "Contatto iniziale"
}
- phase = Durante la serializzazione, contiene l'ID (intero) nativo dell'Opportunity Phase nel database. Durante la deserializzazione, può contenere sia questo ID (intero), sia una stringa contenente il valore del campo Description del record collegato. Se specificato, ha la precedenza su phase_Description durante la deserializzazione
- phase_Description = Descrizione dell'Opportunity Phase nel database. In fase di deserializzazione può essere utilizzato al posto di phase (se non presente). Se vengono specificati sia phase che phase_Description, il campo phase_Description ha meno precedenza di phase
Approfondimenti circa l'uso delle opzioni di serializzazione polimorfica
Le opzioni di serializzazione polimorfica agiscono ad un livello altamente granulare, consentendo una customizzazione più “chirurgica” di quanto sia possibile fare con le opzioni di formattazione.
Come già indicato nella sezione delle Opzioni, le funzioni delle API REST implementate in CRM in Cloud includono un vasto set di funzioni che consentono di adattare struttura e forma dei pacchetti JSON in base alle proprie esigenze e preferenze.
Consultare la sezione delle Opzioni per ottenere tutti i dettagli relativi al loro uso
Schema
La seguente tabella contiene le informazioni principali relative allo schema di questo tipo di dati.
Feature | Value |
---|---|
Complex type | OpportunityPhaseJsonStyle |
Required: |