Page tree
Skip to end of metadata
Go to start of metadata

Grafico del flusso

Descrizione

Il flusso contract-centralized-flow è un flusso centralizzato che modella il ciclo di vita di un contratto, dalla proposta, all'ottenimento del servizio e dei successivi risultati.

Questo flusso prevede i seguenti attori nelle diverse visioni.
  • Visione completa
    • Helpdesk - HD
      Team con profilo "Profilo Helpdesk per i Contratti (contract)"
    • Divisione Ricerca - DR
      Team con profilo "Profilo Divisione Ricerca"
    • Contabilità - CO
      Team con profilo "Profilo Contabilità"
  • Visione dipartimentale
    • Organi dipartimentali - OD
      Team con la seguente naming convention "Profilo di dipartimento per XXX", dove XXX è il nome del dipartimento
      La completa operatività su un dato contratto è consentita solo per il dipartimento marcato come "Principale"
      I dipartimenti aggregati avranno accesso in sola lettura.
  • Visione personale
    • Responsabili scientifici - RS
      Persona appartenente al team "Utenti", che compare tra i responsabili del contratto. Cfr modello dati TAB Soggetti interni
    • Partecipante - PA
      Persona appartenente al team "Utenti", che compare tra i partecipanti del contratto. Cfr modello dati TAB Soggetti interni
    • Referente amministrativo - RA
      Persona appartenente al team "Utenti", che compare tra i referenti amministrativi del contratto. Cfr modello dati TAB Soggetti interni
Trattandosi di un flusso centralizzato, la creazione di un nuovo contratto è consentita SOLO all' HD e DR in visione completa e OD (Organi dipartimentali) in visione dipartimentale.
Per gli OD (Organi dipartimentali) è possibile abilitare/disabilitare la creazione di un nuovo contratto.
Se la variabile ap.contract-centralized-flow.headOfDepartment.create non è definita o è settata a true allora la creazione è consentita in visione dipartimentale, mentre se la variabile ap.contract-centralized-flow.headOfDepartment.create è settata a false allora la creazione NON è consentita in visione dipartimentale.
Questo flusso consente all'HD di effettuare qualunque transizione di stato anche senza seguire il flusso canonico: è quindi possibile anche effettuare "salti" di stato.
Nel grafico, per chiarezza, vengono riportate però solo le transizioni di stato canoniche.
Questo flusso prevede delle logiche di calcolo dinamico delle permissions basate su opportune variabili di configurazioni.
I permessi calcolati dinamicamente sono individuabili dal simbolo "+" all'interno delle icone dei permessi (ellipse, square, rhombus).
In caso di presenza del simbolo "+", le icone presenti indicano i "massimi" permessi assegnabili
Questi permessi sono calcolati dalla seguente logica: I permessi calcolati da questa logica prevale su quelli indicati dall'icona relativa.
Inoltre, facciamo presente che gli stati in arancione sono gli stati di sincronizzazione con UGOV-PJ

Etichette Stati

I nomi degli stati possono essere personalizzati con la funzione di Gestione etichette.
Nella tabella sottostante vengono riportati tutti gli stati previsti dal flusso con relativa etichetta e valore di default.
Vengono anche fornite le etichette per i vari bottoni che consentono lo spostamento di stato.
Di default venegono utilizzate le etichette dei bottoni per lo stato successivo, è possibile configurare il flusso in maniera tale da utlizzare anche le etichette dei bottoni per lo stato precedente.
Esempio di utilizzo: l'oggetto si trova nello stato in attesa di essere validato, i possibili stati di cambio sono bozza e operativo. Il bottone per lo stato operativo utilizzerà l'etichetta per lo stato successivo, mentre il bottone per lo stato bozza utilizzerà l'etichetta per lo stato precedente.

Identificativo stato Chiave etichetta stato Valore default stato Etichetta del bottone stato successivo Etichetta del bottone stato precedente Valore etichetta del bottone stato successivo Valore etichetta del bottone stato precedente
draft wfState.con.draft Bozza button.forward.to.con.draft button.backward.to.con.draft Salva e invia in "Bozza" Salva e invia in "Bozza"
validated wfState.con.validated Validato button.forward.to.con.validated button.backward.to.con.validated Salva e invia in "Validato" Salva e invia in "Validato"
signed wfState.con.signed Stipulato button.forward.to.con.signed button.backward.to.con.signed Salva e invia in "Stipulato" Salva e invia in "Stipulato"
closed wfState.con.closed Concluso button.forward.to.con.closed button.backward.to.con.closed Salva e invia in "Concluso" Salva e invia in "Concluso"
archived wfState.con.archived Archiviato button.forward.to.con.archived button.backward.to.con.archived Salva e invia in "Archiviato" Salva e invia in "Archiviato"

Modello Dati

Il dettaglio del modello dati associato a questo flusso è disponibile alla seguente pagina Produzione - Modello dati (contract - CON)

Permessi

Nella seguente sezione viene riportato il dettaglio dei permessi e delle transizioni di stato possibili per tutti gli attori del flusso.
Per quanto riguarda le transizioni di stato vengono riportati gli identificativi degli stati verso i quali è possibile effettuare la transizione.
Quando viene riportato il marcatore "__PREVIOUS_STATE__" significa che la transizione di stato è consentita verso lo stato precedente.
Di seguito la legenda dei permessi:

  • c: create (disponibile solo per il primo stato del flusso)
  • r: read
  • w: write
  • d: delete
Viene, inoltre, fornito dettaglio dei TAB disponibili (quelli in sola lettura presentano il suffisso readonly)

Stato Attori Permessi Transizioni Tab
Bozza
(draft)
Helpdesk (helpdesk) c r w d validated
Divisione Ricerca (researchDivision) c r w d validated
Organi dipartimentali (headOfDepartment) c r w d validated
Referente amministrativo (administrativeOwner) r w d validated
Validato
(validated)
Helpdesk (helpdesk) r w signed,archived,draft
Divisione Ricerca (researchDivision) r w signed,archived,draft
Organi dipartimentali (headOfDepartment) r w signed,archived,draft
Referente amministrativo (administrativeOwner) r w signed,archived,draft
Responsabile/Proprietario (owner) r w none
Stipulato
(signed)
Helpdesk (helpdesk) r w validated,closed
Divisione Ricerca (researchDivision) r w validated,closed
Organi dipartimentali (headOfDepartment) r w validated,closed
Referente amministrativo (administrativeOwner) r w validated,closed
Responsabile/Proprietario (owner) r w none
Contabilita' (accountancy) r none
Concluso
(closed)
Helpdesk (helpdesk) r w signed
Divisione Ricerca (researchDivision) r w signed
Organi dipartimentali (headOfDepartment) r w signed
Referente amministrativo (administrativeOwner) r w signed
Responsabile/Proprietario (owner) r w none
Contabilita' (accountancy) r none
Archiviato
(archived)
Helpdesk (helpdesk) r w d validated
Divisione Ricerca (researchDivision) r w d validated
Organi dipartimentali (headOfDepartment) r w d validated
Referente amministrativo (administrativeOwner) r w d validated
Responsabile/Proprietario (owner) r w none

Validazioni

Nella seguente sezione viene riportato il dettaglio delle validazioni per tutte le coppie (attore, stato) del flusso.
Le validazioni sono distinte nei seguenti macrotipi e sono riferite, se non specificato altrimenti, all'oggetto radice.

  • enter: validazione applicata in ingresso nello stato
    La transizione in ingresso viene NEGATA se anche solo una validazione NON viene superata con successo.
  • save: validazione applicata ad ogni salvataggio e quindi anche per ogni spostamento di TAB
    Il salvataggio viene NEGATO se anche solo una validazione NON viene superata con successo.
  • delete: validazione applicata in fase di eliminazione di un oggetto radice
  • element: validazione applicata agli elementi figli di un oggetto radice
  • permissions: logiche di generazione dinamica dei permessi (rwfd) sull'oggetto radice che sovrascrive i permessi di flusso (rwfd)
Le validazioni sono ulteriormente distinte nei seguenti tipi.
  • required: validazione di obbligatorietà di un attributo sull'oggetto radice.
  • complex: validazione complessa applicabile sia all'oggetto radice che agli elementi.
    Per avere maggiori dettagli sulla validazione cliccare sull'identificativo della validazione
Nel caso di validazioni di tipo element, oltre all'identificativo della validazione, viene riportato anche l'identificativo dell'elemento a cui è applicata e l'azione che l'ha scatenata:
  • salvataggio (save)
  • eliminazione (delete)

Ad esempio la seguente stringa
internalOrganizationUnit:delete departmentDeleteValidator indica che la validazione "departmentDeleteValidator" è applicata in eliminazione di un elemento di tipo internalOrganizationUnit dell'oggetto radice.

Per avere maggiori dettagli sui possibili elementi fare riferimento alla definizione del modello, disponibile nella sezione Modello Dati.

Infine è possibile applicare le validazioni, condizionalmente al soddisfacimento di determinate condizioni (opzionali).
Queste condizioni sono specificate nella colonna "Applicabilità": se è specificato always, la validazione è sempre attiva.

Stato Attori MacroTipo Tipo Attributo/Identificativo Applicabilita'
Bozza
(draft)
all enter required wfItemTypeId always
dateMap[proposalStartDate] always
description always
complex checkEffectiveDepartmentAccess always
checkCreationPermissionsValidator always
ownerValidatorContract always
save required identifier always
complex checkEffectiveDepartmentAccess always
sameDefinitionForGenericItemValidator always
uniquePeopleInOwnerAndContributorSetValidator isNotLegacy
delete complex checkEffectiveDepartmentAccess always
childAndParentDetectorDeleteValidator always
element required owner:save  dateMap[startDate] always
Organi dipartimentali (headOfDepartment) permissions complex wfIdentityLogicHeadOfDepartmentContractPermissionsJs always
Validato
(validated)
all enter required wfItemTypeId always
dateMap[proposalStartDate] always
description always
complex checkEffectiveDepartmentAccess always
ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
save required identifier always
complex checkEffectiveDepartmentAccess always
sameDefinitionForGenericItemValidator always
uniquePeopleInOwnerAndContributorSetValidator isNotLegacy
delete complex checkEffectiveDepartmentAccess always
childAndParentDetectorDeleteValidator always
element required owner:save  dateMap[startDate] always
Organi dipartimentali (headOfDepartment) permissions complex wfIdentityLogicHeadOfDepartmentContractPermissionsJs always
Stipulato
(signed)
all enter required wfItemTypeId always
description always
dateMap[proposalStartDate] always
dateMap[startDate] always
dateMap[endDate] always
wfDictionaryMap[currency] always
numberMap[totalAmount] always
complex checkEffectiveDepartmentAccess always
uniqueIdentifierContract isNotLegacy
ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
organizationUnitRoleValidatorContract isNotLegacy
startDateAndEndDateValidator always
ownerAndOrganizationUnitMatchValidatorContract isNotLegacy
checkDateExtensionValidator always
contributorAndOwnerStartDateValidator isNotLegacy
contributorAndOwnerValidatorWithStartEndDate isNotLegacy
customerValidatorContract isNotLegacy
currencyAndTotalAmountValidatorContract isNotLegacy
wfUgovPjSenderValidatorContract always
save required identifier always
complex checkEffectiveDepartmentAccess always
sameDefinitionForGenericItemValidator always
checkDateExtensionValidator always
contributorAndOwnerStartDateValidator isNotLegacy
contributorAndOwnerValidatorWithStartEndDate isNotLegacy
uniquePeopleInOwnerAndContributorSetValidator isNotLegacy
changeItemTypeForSynchronizedItemValidator always
delete complex checkEffectiveDepartmentAccess always
childAndParentDetectorDeleteValidator always
element required owner:save  dateMap[startDate] always
Helpdesk (helpdesk) save required description always
wfItemTypeId always
dateMap[startDate] always
dateMap[endDate] always
wfDictionaryMap[currency] always
numberMap[totalAmount] always
complex ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
organizationUnitRoleValidatorContract isNotLegacy
ownerAndOrganizationUnitMatchValidatorContract isNotLegacy
customerValidatorContract isNotLegacy
currencyAndTotalAmountValidatorContract isNotLegacy
wfUgovPjSenderValidatorContract always
Divisione Ricerca (researchDivision) save required description always
wfItemTypeId always
dateMap[startDate] always
dateMap[endDate] always
wfDictionaryMap[currency] always
numberMap[totalAmount] always
complex ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
organizationUnitRoleValidatorContract isNotLegacy
ownerAndOrganizationUnitMatchValidatorContract isNotLegacy
customerValidatorContract isNotLegacy
currencyAndTotalAmountValidatorContract isNotLegacy
wfUgovPjSenderValidatorContract always
Organi dipartimentali (headOfDepartment) permissions complex wfIdentityLogicHeadOfDepartmentContractPermissionsJs always
Responsabile/Proprietario (owner) save complex wfUgovPjSenderValidatorContract always
Concluso
(closed)
all enter required description always
wfItemTypeId always
dateMap[proposalStartDate] always
dateMap[startDate] always
dateMap[endDate] always
wfDictionaryMap[currency] always
numberMap[totalAmount] always
complex checkEffectiveDepartmentAccess always
ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
organizationUnitRoleValidatorContract isNotLegacy
startDateAndEndDateValidator always
ownerAndOrganizationUnitMatchValidatorContract isNotLegacy
customerValidatorContract always
contributorAndOwnerStartDateValidator isNotLegacy
contributorAndOwnerValidatorWithStartEndDate isNotLegacy
checkDateExtensionValidator always
currencyAndTotalAmountValidatorContract isNotLegacy
wfUgovPjSenderValidatorContract always
save required identifier always
complex checkEffectiveDepartmentAccess always
sameDefinitionForGenericItemValidator always
checkDateExtensionValidator always
contributorAndOwnerStartDateValidator isNotLegacy
contributorAndOwnerValidatorWithStartEndDate isNotLegacy
uniquePeopleInOwnerAndContributorSetValidator isNotLegacy
changeItemTypeForSynchronizedItemValidator always
delete complex checkEffectiveDepartmentAccess always
childAndParentDetectorDeleteValidator always
element required owner:save  dateMap[startDate] always
Helpdesk (helpdesk) save required description always
wfItemTypeId always
dateMap[startDate] always
dateMap[endDate] always
wfDictionaryMap[currency] always
numberMap[totalAmount] always
complex ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
organizationUnitRoleValidatorContract isNotLegacy
ownerAndOrganizationUnitMatchValidatorContract isNotLegacy
customerValidatorContract isNotLegacy
currencyAndTotalAmountValidatorContract isNotLegacy
wfUgovPjSenderValidatorContract always
Divisione Ricerca (researchDivision) save required description always
wfItemTypeId always
dateMap[startDate] always
dateMap[endDate] always
wfDictionaryMap[currency] always
numberMap[totalAmount] always
complex ownerValidatorContract always
organizationUnitValidatorContract isNotLegacy
organizationUnitRoleValidatorContract isNotLegacy
ownerAndOrganizationUnitMatchValidatorContract isNotLegacy
customerValidatorContract isNotLegacy
currencyAndTotalAmountValidatorContract isNotLegacy
wfUgovPjSenderValidatorContract always
Organi dipartimentali (headOfDepartment) permissions complex wfIdentityLogicHeadOfDepartmentContractPermissionsJs always
Responsabile/Proprietario (owner) save complex wfUgovPjSenderValidatorContract always
Archiviato
(archived)
all enter complex checkEffectiveDepartmentAccess always
save required identifier always
complex checkEffectiveDepartmentAccess always
sameDefinitionForGenericItemValidator always
delete complex checkEffectiveDepartmentAccess always
childAndParentDetectorDeleteValidator always
element required owner:save  dateMap[startDate] always
Organi dipartimentali (headOfDepartment) permissions complex wfIdentityLogicHeadOfDepartmentContractPermissionsJs always

Logiche (action/start)

Nella seguente sezione vengono riportate le

  • START LOGICS
    Le start logics sono le "azioni" che vengono eseguite in fase di creazione di un nuovo oggetto radice
  • ACTION LOGICS
    Le action logics sono delle "azioni" che vengono eseguite al verificarsi di determinati eventi.
    Gli eventi contemplati sono:
    • enter: ingresso in uno stato
    • save: salvataggio dell'oggetto radice
Di seguito viene riportato il dettaglio delle logiche definite per questo flusso.

START LOGICS ACTION LOGICS
  • No labels