Protocollazione di un documento (del documentale)

Azione di Workflow per protocollare un documento del documentale.

L'azione apre la form di protocollazione inizializzata con i dati prelevati dall’elemento documentale indicato in input o sovrascritti dai parametri in ingresso. L’operatore può decidere di confermare i dati o modificarli e poi procedere alla protocollazione attraverso l’apposita form. A protocollazione avvenuta i dati del protocollo vengono ribaltati anche sul documento.

Se il documento passato in input è già stato protocollato l'azione di workflow si completa automaticamente senza generare attività in todolist e riportando in output i dati del relativo protocollo.

INPUT

• id_documento: id del documento da protocollare.
• oggetto: oggetto del protocollo (opzionale: se si vuole sia diverso dall'oggetto del documento)
• id_documento_principale: (opzionale) se id specificato si vuole indicare esplicitamente quale tra i documenti allegati all'elemento documentale debba essere il principale. Nel caso il parametro non sia valorizzato si attingerà ai file associati dell’elemento documentale (il file principale o, in sua assenza, il primo inserito). Gli altri file associati all’elemento documentale saranno presi come allegati.

• allegati: valori=TUTTI (default) / SOLO PRINCIPALE / SCEGLI / NESSUNO;
  TUTTI: allega tutti i documenti presenti nel documento al protocollo;
  SOLO PRINCIPALE: non allegare alcun allegato oltre al documento principale;
  SCEGLI: uso come allegati i documenti passati nell'attributo 'scegli_allegati'
  NESSUNO: non allegare alcun allegato principale compreso (no principale, no allegati)
• scegli_allegati: (opzionale) elenco degli id dei documenti di repository esterni da usare come allegati
• note: note del protocollo (opzionale: se si vuole siano diverse dalle note del documento)
• id_ufficio_mitt: (opzionale) id dell'ufficio mittente interno
• id_uffici_dest: (opzionale) elenco degli id degli uffici destinatari per competenza
• id_utenti_dest: (opzionale) elenco degli id degli utenti/gruppi destinatari per competenza
• id_uffici_cono: (opzionale) elenco degli id degli uffici destinatari per conoscenza
• id_utenti_cono: (opzionale) elenco degli id degli utenti/gruppi destinatari per conoscenza
• id_classifica: (opzionale) id della classifica di titolario da attribuire al protocollo
• id_fascicolo: (opzionale) id del fascicolo in cui inserire il protocollo
• num_documento: (opzionale) numero del documento
• data_documento: (opzionale) data del documento
• id_protocollo_collegato: (opzionale) id del protocollo padre a cui collegare il nuovo protocollo
• id_email_account: (opzionale) id dell'account PEC da utilizzare; l'account deve essere tra quelli disponibili all'utente che esegue l'invio (in base all'acl)
• skip_invio_email: NO/SI (default = NO)
  NO: in caso di mezzo di invio PEC/interoperabile in fase di salvataggio viene mostrato il messaggio che consente l'invio di o meno della email (modalità standard della form di registrazione)
  SI: in caso di mezzo di invio PEC/interoperabile in fase di salvataggio NON viene mostrato il messaggio e NON viene inviata nessuna email
• check_permessi: (default a SI) che se impostato a NO permette all'utente di eseguire la protocollazione anche se non possiede i permessi di protocollazione
• auto_close: NO/SI (default = SI), se impostata a NO permette di mantenere aperta la form del protocollo dopo la registrazione per permettere attività aggiuntive tipo: inserimento allegati, stampa delle etichette, invio mail
• auto_save: NO/SI (default = NO) permette registrare il protocollo senza richiedere l'intervento dell'utente. Solo in caso di errore si apre la form di registrazione. introdotta validazione dei dati del protocollo con tutti i controlli che fino ad ora erano eseguiti solo dalla maschera (compresi i warning che permettono di proseguire)

- in caso di presenza di errori o warning la protocollazione automatica viene bloccata e viene creato un todo per procedere alla protocollazione manuale. Una volta che l'operatore esegue il todo vengono visualizzati in sequenza gli errori o i warning che hanno impedito la protocollazione automatica; nel caso della sola presenza di warning quando l'utente conferma l'ultimo warning, il protocollo viene registrato automaticamente.

• ignore_warnings: NO/SI (default = NO) permette di procedere alla protocollazione automatica lato server, anche in presenza di warning.

OUTPUT

• id_protocollo: id del protocollo che è stato registrato
• num_protocollo: numero del protocollo registrato
• data_protocollo: data del protocollo registrato
• anno_protocollo: anno del protocollo registrato
• esito_richiesta_protocollazione: per le registrazioni con driver asincroni è indicato l'esito della 'richiesta'. Per le registrazioni sincrone il risultato si evince dalla presenza del numero di protocollo.