Schema di richiesta e risposta
Nel servizio REST per l'esecuzione della serie di regole, le richieste e le risposte seguono schemi specifici, a seconda che lo XOM della serie di regole sia basato su classi XML o su classi Java™ . Lo schema determina come vengono serializzati i tipi.
Lo schema di richiesta e risposta risulta dalla firma della serie di regole di destinazione.
- La parte richiesta è composta dai seguenti elementi:
- I parametri IN e INOUT della serie di regole, in ordine alfabetico.
- Facoltativamente, un ID decisione se si desidera impostarlo su un valore specifico.
- Facoltativamente, un filtro di traccia.
- La parte della risposta è composta dai seguenti elementi:
- I parametri INOUT e OUT della serie di regole, in ordine alfabetico.
- L'ID decisione: l'identificativo predefinito o il valore impostato nella richiesta.
- La traccia restituita, a seconda del filtro impostato nella richiesta.
Il payload XML viene analizzato rispetto ai file XSD generati. La risposta di esecuzione viene inviata nello stesso formato della richiesta di esecuzione (XML o JSON).
Convalida richiesta XML
La risposta di validazione viene restituita in formato JSON:
- Se la richiesta è valida, la risposta è un elenco JSON vuoto[].
- Se la richiesta non è valida, lo strumento restituisce l'elenco di errori. Ogni errore contiene i seguenti campi:
- Tipo: il tipo di errore. I valori possibili sono"Error","Fatal"e"Warning".
- Riga: il numero della riga che contiene l'errore nel file .xml
- Colonna: il numero della colonna che contiene l'errore nel file .xml
- Messaggio: il messaggio di errore stesso
Di seguito sono riportati esempi di messaggi di errore:
{"type": "Error", "line": 8, "column": 32, "message": "cvc-datatype-valid.1.2.1: 'falseee' is not a valid value for 'boolean'."}
{"type": "Error", "line": 9, "column": 22, "message": "cvc-datatype-valid.1.2.1: '5d' is not a valid value for 'integer'."}
{"type": "Fatal", "line": 39, "column": 24, "message": "The element type \"par:longParam\" must be terminated by the matching end-tag \"</par:longParam>\"."}