Come leggere il Composer Field Reference#
Questo manuale è il riferimento del linguaggio usato dal Bond Composer. È rivolto a strutturatori, legali, compliance, prodotto, sviluppatori e a chi deve richiedere un’estensione.
Campo, regola, clausola, calcolo, evento ed evidenza#
Prima di chiedere “un nuovo campo”, identificare la natura del requisito.
| Oggetto | Che cos’è | Esempio |
|---|---|---|
| Campo | Dato elementare o scelta | maturity_date |
| Regola | Vincolo fra dati/stati | maturity > issue date |
| Clausola | Diritto/obbligo contrattuale | call con finestre e prezzi |
| Calcolo | Formula derivata | cedola o prezzo |
| Evento | Fatto nel ciclo di vita | record date, breach, rimborso |
| Stato | Posizione del processo | submitted, paid, manual_review |
| Evidenza | Prova dell’input/esito | fixing, receipt, timestamp |
Aggiungere un campo quando serve una nuova informazione stabile. Non aggiungerlo per rappresentare una regola o per evitare di modellare un workflow.
Anatomia di una voce#
Ogni voce indica:
- codice tecnico stabile;
- nome HTML/API;
- tipo;
- obbligatorietà;
- categoria;
- significato;
- dipendenze ed effetti;
- esempio;
- errore frequente.
Il codice tecnico è il riferimento da usare nelle richieste, nei test e nelle integrazioni. L’etichetta può migliorare senza cambiare il significato del codice.
Percentuali, prezzi e importi#
Obbligatorio e condizionale#
“Obbligatorio nel catalogo” significa che il campo è richiesto nella configurazione corrente. Alcuni campi facoltativi diventano sostanzialmente necessari per un modello specifico: reference_index per il floating, base_index_value per l’inflation, gli step per il modello step.
La validazione di dominio prevale sul semplice attributo HTML.
Valori controllati#
Le liste correnti comprendono:
- emittenti:
corporate,municipality,public_entity,public_network,project_vehicle; - remunerazione:
fixed,zero_coupon,floating,inflation,step; - rimborso:
bullet,linear_amortising,custom; - collocamento:
fixed_price,bookbuilding,auction,private_placement; - protocollo:
rfq,dealer_quotes,limit_orders,trade_registration; - holding:
intermediated,direct; - rail:
commercial_bank,external_csd,central_bank_future; - frequenze:
annual,semiannual,quarterly,monthly,none; - day count:
ACT/360,ACT/365,30E/360; - business day:
following,modified_following,preceding.
Effetti downstream#
Un campo può alimentare più superfici:
Composer
→ dossier e approvazione
→ Master Record
→ pre-collocamento/collocamento
→ registro e settlement
→ Exchange
→ servicing
→ evidenze e reporting
Per questo una modifica non va valutata soltanto in base alla schermata in cui compare.
Versioni#
Il catalogo e il manuale sono versionati insieme al pacchetto. I record storici mantengono i valori della versione con cui sono stati creati. Disabilitare un campo non lo cancella dai dossier precedenti.
