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.

FeatureValue
Complex typeOpportunityPhaseJsonStyle
Required: