From 7ee58275655180d4edab21f072e91b84acac9091 Mon Sep 17 00:00:00 2001 From: Pier Paolo MAMMI Date: Fri, 28 Aug 2026 16:32:18 +0200 Subject: [PATCH 1/2] 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?). -- 2.54.0 From a1a5ae82489c2cf953e0f29c169940a04dbae58e Mon Sep 17 00:00:00 2001 From: Pier Paolo MAMMI Date: Tue, 13 Oct 2026 10:07:05 +0200 Subject: [PATCH 2/2] update some requests --- .../Anagrafiche/Studente (E-mail).yml | 4 ++-- .../Request details/Get ExportTags.yml | 13 ++++++----- .../Request details/Get Request.yml | 4 ++-- .../Requests lookup/Lookup By Status.yml | 23 +++++++++++-------- 4 files changed, 24 insertions(+), 20 deletions(-) diff --git a/bruno/collections/IDEM WebServices/Anagrafiche/Studente (E-mail).yml b/bruno/collections/IDEM WebServices/Anagrafiche/Studente (E-mail).yml index 23ea962..b9852a1 100644 --- a/bruno/collections/IDEM WebServices/Anagrafiche/Studente (E-mail).yml +++ b/bruno/collections/IDEM WebServices/Anagrafiche/Studente (E-mail).yml @@ -5,15 +5,15 @@ info: http: method: GET - url: "{{IdemApiUrl}}/studente.php?mail=pierpaolo.mammi@unipr.it" + url: "{{IdemApiUrl}}/studente.php?mail=sofiagiuliana.ba@studenti.unipr.it" params: - name: mail value: pierpaolo.mammi@unipr.it type: query + disabled: true - name: mail value: sofiagiuliana.ba@studenti.unipr.it type: query - disabled: true - name: mail value: bruno.rastelli@studenti.unipr.it type: query diff --git a/bruno/collections/elixForms API v2/Request details/Get ExportTags.yml b/bruno/collections/elixForms API v2/Request details/Get ExportTags.yml index 17dc2f3..fdb9ce3 100644 --- a/bruno/collections/elixForms API v2/Request details/Get ExportTags.yml +++ b/bruno/collections/elixForms API v2/Request details/Get ExportTags.yml @@ -5,13 +5,17 @@ info: http: method: GET - url: "{{elixFormsApiUrl}}/request/:request_id/view/:view_name/exportTags/get/v1?moduleTag=RIPARTIZIONE_CCT_DSAN&exportGroup=ReportOre" + url: "{{elixFormsApiUrl}}/request/:request_id/view/:view_name/exportTags/get/v1?exportGroup=IMPORTI" headers: - name: x-requested-with value: XMLHttpRequest - name: x-api-username value: "{{elixFormsApiUsername}}" params: + - name: exportGroup + value: API + type: query + disabled: true - name: username value: "{{elixFormsApiUsername}}" type: query @@ -19,15 +23,12 @@ http: - name: moduleTag value: RIPARTIZIONE_CCT_DSAN type: query - - name: exportGroup - value: API - type: query disabled: true - name: exportGroup - value: ReportOre + value: IMPORTI type: query - name: request_id - value: "31470" + value: "34453" type: path - name: view_name value: _DEFAULT diff --git a/bruno/collections/elixForms API v2/Request details/Get Request.yml b/bruno/collections/elixForms API v2/Request details/Get Request.yml index 2bd37f3..4e7ef33 100644 --- a/bruno/collections/elixForms API v2/Request details/Get Request.yml +++ b/bruno/collections/elixForms API v2/Request details/Get Request.yml @@ -20,10 +20,10 @@ http: - name: recordOrder value: NONE type: query - description: case sensitive + description: NONE (default), NEWEST_FIRST, NEWEST_LAST (case sensitive) disabled: true - name: request_id - value: "32976" + value: "34453" type: path auth: inherit diff --git a/bruno/collections/elixForms API v2/Requests lookup/Lookup By Status.yml b/bruno/collections/elixForms API v2/Requests lookup/Lookup By Status.yml index 6bd640b..03787b5 100644 --- a/bruno/collections/elixForms API v2/Requests lookup/Lookup By Status.yml +++ b/bruno/collections/elixForms API v2/Requests lookup/Lookup By Status.yml @@ -5,7 +5,7 @@ info: http: method: GET - url: "{{elixFormsApiUrl_Default}}/request/lookup/by-status?moduleTag=PROPOSTA_CCT_OPERATORE&requestStatus=PROCESSED" + url: "{{elixFormsApiUrl_Default}}/request/lookup/by-status?requestStatus=SUBMITTED&moduleTag=GESTIONE_SITI_WEB_NUOVO&moduleTag=RequestForm_RIPARTIZIONE_CCT_DOCENTE" headers: - name: x-requested-with value: XMLHttpRequest @@ -17,7 +17,7 @@ http: type: query disabled: true - name: requestStatus - value: SUBMITTED + value: IN_PROGRESS type: query description: |- Valori possibili: @@ -27,17 +27,27 @@ http: possibile selezionare valori multipli disabled: true - name: requestStatus - value: IN_PROGRESS + value: SUBMITTED + type: query + - name: requestStatus + value: PROCESSED type: query disabled: true - name: moduleTag value: PROPOSTA_CCT_OPERATORE type: query description: Possibile specificare valori multipli + disabled: true - name: moduleTag value: PROPOSTA_CCT_DOCENTE type: query disabled: true + - name: moduleTag + value: GESTIONE_SITI_WEB_NUOVO + type: query + - name: moduleTag + value: RequestForm_RIPARTIZIONE_CCT_DOCENTE + type: query - name: swfOptionKey value: "1" type: query @@ -46,13 +56,6 @@ http: value: IN type: query disabled: true - - name: moduleTag - value: GESTIONE_SITI_WEB_NUOVO - type: query - disabled: true - - name: requestStatus - value: PROCESSED - type: query auth: inherit settings: -- 2.54.0