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.

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_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

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