From 7ee58275655180d4edab21f072e91b84acac9091 Mon Sep 17 00:00:00 2001 From: Pier Paolo MAMMI Date: Fri, 28 Aug 2026 16:32:18 +0200 Subject: [PATCH] update requests documentation and values --- ... istanze elaborate da processo esterno.yml | 47 ++++++++++++++----- .../Update Request SWF values.yml | 25 ++++++---- 2 files changed, 53 insertions(+), 19 deletions(-) diff --git a/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Acquisizione istanze elaborate da processo esterno.yml b/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Acquisizione istanze elaborate da processo esterno.yml index 48ca92a..e962bd2 100644 --- a/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Acquisizione istanze elaborate da processo esterno.yml +++ b/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Acquisizione istanze elaborate da processo esterno.yml @@ -11,7 +11,7 @@ http: value: XMLHttpRequest params: - name: request_id - value: "7007" + value: "27547" type: path body: type: form-urlencoded @@ -19,17 +19,16 @@ http: - name: username value: "{{elixFormsApiUsername}}" - name: outcome - value: OK + value: KO description: OK, KO - name: resultCode - value: VAL + value: KO description: 'possibili valori: VAL("Validata"), IMP("Importata"), IMPW("Impostata con warning"), KO("Rifiutata")' - name: resultDescription - value: "" + value: messaggio custom description: descrizione esito processo esterno - disabled: true - name: resultReceiptId - value: "123" + value: "999" description: id pratica processo esterno di riferimento - name: resultTimestamp value: "" @@ -136,8 +135,34 @@ examples: } } -docs: |- - Viene ritornato l'esito dell'operazione di storicizzazione si elixForms©. - La ricezione di "ok" o "ko" provocherà una decisione nel workflow semplice (analogo a quello di elixFlow©) in base a quanto disposto in elixForms per il modulo. - Esempio="OK","VAL","..." imposta lo stato di workflow semplice corrispondente imposta lo step ad "evasa" notifica email - Esempio="KO","KO","..." imposta lo stato di workflow semplice corrispondente non cambia lo stato dello step +docs: | + # Acquisizione delle istanze elaborate da processo esterno + + ~~Scopo: per confermare che l'istanza é stata ricevuta e non andrà più trasmessa.~~ + **(MA ASSOLUTAMENTE NO!)** + + Empiricamente, sposta l'istanza in stato "Evasa" e impedisce la riapertura della stessa. + + ## Parametri importanti + + - **outcome(*)** (esito del servizio): possibili valori: + - OK + - KO + - **resultCode(*)** (codice esito processo esterno): possibili valori: + - VAL("Validata") + - IMP("Importata") + - IMPW("Impostata con warning") + - KO("Rifiutata") + - **resultDescription** (descrizione esito processo esterno) + - **resultReceiptId(*)** (id pratica processo esterno di riferimento) + - **resultTimestamp**: (timestamp di riferimento dell'elaborazione pratica dal processo esterno): in formato standard ISO 8601; se non impostata viene inizializzata con la data/ora server corrente + - **properties** (mappa chiave,valore/i aggiuntivo/i in formato json): url-encoding richiesto in UTF-8 + + ## Descrizione + + Viene ritornato l'esito dell'operazione di storicizzazione su elixForms. + + La ricezione di "ok" o "ko" provocherà una decisione nel workflow semplice (analogo a quello di elixFlow) in base a quanto disposto in elixForms per il modulo. + + - Esempio="OK","VAL","..." imposta lo stato di workflow semplice corrispondente imposta lo step ad "evasa" notifica email + - Esempio="KO","KO","..." imposta lo stato di workflow semplice corrispondente non cambia lo stato dello step diff --git a/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Update Request SWF values.yml b/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Update Request SWF values.yml index db21281..39329f9 100644 --- a/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Update Request SWF values.yml +++ b/bruno/collections/elixForms API v2/Cambio stato e-o integrazione/Update Request SWF values.yml @@ -5,7 +5,7 @@ info: http: method: POST - url: "{{elixFormsApiUrl_Default}}/request/:request_id/swf/columns;{{elixRegisterResultColumns}}?username={{elixFormsApiUsername}}" + url: "{{elixFormsApiUrl_Default}}/request/:request_id/swf/{{columns}}?username={{elixFormsApiUsername}}" headers: - name: x-requested-with value: XMLHttpRequest @@ -14,12 +14,18 @@ http: value: "{{elixFormsApiUsername}}" type: query - name: request_id - value: "6085" + value: "27310" type: path - body: - type: form-urlencoded auth: inherit +runtime: + variables: + - name: columns + value: "" + disabled: true + - name: columns + value: COL0001="1";COL0002={{$isoTimestamp}} + settings: encodeUrl: true timeout: 0 @@ -103,12 +109,13 @@ examples: } docs: |- - The elixRegisterResultColumns variable must be built like the following: + The columns variable must be built like the following: - - one index=value couple for every field in the SWF schema that must be updated, where index is the "name" of the schema field (e.g.: COL0003, if the field is found in the SWF schema) and the value is the string content that must be assigned + - variable must start with "columns;" + - add one "index=value" couple for every field in the SWF schema to be updated, where "index" is the name of the associated SWF schema field (e.g.: COL0003) and "value" is the string content to be used - each couple must be separated by a semi-period (\`;\` character) - For example, suppose the request has a SWF schema with ID 356, containing: + For example, suppose the request has a SWF schema with ID 356 having: - State = COL0001 - Date = COL0002 @@ -117,6 +124,8 @@ docs: |- If you want to change the CURRENT state's date and message values, you will put into the variable the following value: + `columns;[{"key":"COL0002","value":"31-03-2025"},{"key":"COL0004","value":"this is the new message"}]` + `COL0002=31-03-2025;COL0004=this is the new message` - Keep in mind that Postman automatically encodes the parameter, so it's allowed to use spaces and other symbols (maybe?). + Keep in mind that Bruno automatically encodes the parameter, so you may use spaces and other symbols (maybe?).