View Source

Grafico del flusso

Descrizione

Il flusso laboratory-topdown-flow è un flusso validato che modella il ciclo di vita di una Laboratorio (TOP-DOWN) che viene quindi gestito dalle strutture d'Ateneo.
Per informazioni sul modello dati, effettuare download del file excel disponibile al livello superiore.

Questo flusso prevede i seguenti attori nelle diverse visioni.

Visione completa
- Helpdesk - HD
  Team con profilo "Profilo Helpdesk per i Progetti (project)"
- 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 progetto. Cfr modello dati (TAB Soggetti interni) disponibile al livello superiore
- Partecipante - PA
  Persona appartenente al team "Utenti", che compare tra i partecipanti del progetto. Cfr modello dati (TAB Soggetti interni) disponibile al livello superiore
- Referente amministrativo - RA
  Persona appartenente al team "Utenti", che compare tra i referenti amministrativi del progetto. Cfr modello dati (TAB Soggetti interni) disponibile al livello superiore

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.
Inoltre, facciamo presente che gli stati in arancione sono gli stati di sincronizzazione con UGOV-PJ

I nomi degli stati possono essere personalizzati con la funzione di Gestione etichette.
Il formato dell'etichetta è wfState.<identificativo_stato>.
Supponendo di avere uno stato identificato da foo, l'etichetta associata è wfState.foo

Modello Dati

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

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
wfState.lab.draft (draft)	Helpdesk (helpdesk)	c r w d	approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Organi dipartimentali (headOfDepartment)	c r w d	approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Responsabile scientifico (owner)	r w	submitted	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Delegato (internalRepresentatives)	r w	submitted	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormVersion@
wfState.lab.submitted (submitted)	Helpdesk (helpdesk)	r w	draft,rejected,approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Organi dipartimentali (headOfDepartment)	r w	draft,rejected,approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Responsabile scientifico (owner)	r	none	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Delegato (internalRepresentatives)	r	none	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
wfState.lab.rejected (rejected)	Helpdesk (helpdesk)	r	submitted	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Organi dipartimentali (headOfDepartment)	r	submitted	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Responsabile scientifico (owner)	r	none	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
		r	none	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
wfState.lab.approved (approved)	Helpdesk (helpdesk)	r	submitted,reopened	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Organi dipartimentali (headOfDepartment)	r	submitted,reopened	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Responsabile scientifico (owner)	r	reopened	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Delegato (internalRepresentatives)	r	reopened	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
wfState.lab.reopened (reopened)	Helpdesk (helpdesk)	r w d	approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Organi dipartimentali (headOfDepartment)	r w d	approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Responsabile scientifico (owner)	r w	approved	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@
	Delegato (internalRepresentatives)	r w	submitted	@tab.laboratory/helpdeskForm1@ @tab.laboratory/helpdeskForm2@ @tab.laboratory/helpdeskFormAttach@ @tab.laboratory/helpdeskFormVersion@

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 eliminazionoe 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 non viene specificato nulla, la validazione è attiva di default.

Stato	Attori	MacroTipo	Tipo	Attributo/Identificativo	Applicabilita'
wfState.lab.draft (draft)	all	enter	required	wfItemTypeId	always
				description	always
				dateMap[startDate]	always
			complex	checkCreationPermissionsValidator	always
				ownerPositionStartValidator	always
				ownerWithSameDepartmentAsHeadValidator	always
		save	complex	getYearFromStartDateValidator	always
		save	complex	sameDefinitionForGenericItemValidator	always
		element	complex	owner:save addOrgUnitFromNewOwnerValidator	always
	Organi dipartimentali (headOfDepartment)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
	Organi dipartimentali (headOfDepartment)	element	complex	internalOrganizationUnit:save notAllowedValidator	always
	Responsabile scientifico (owner)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
				internalOrganizationUnit:save notAllowedValidator	always
				owner:save notAllowedValidator	always
				owner:delete notAllowedValidator	always
	Delegato (internalRepresentatives)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
				internalOrganizationUnit:save notAllowedValidator	always
				owner:save notAllowedValidator	always
				owner:delete notAllowedValidator	always
wfState.lab.submitted (submitted)	all	enter	required	wfItemTypeId	always
				description	always
				clobMap[abstract]	always
				dateMap[startDate]	always
				booleanMap[visibleOnPortal]	always
			complex	multipleOwnerValidator	always
				internalOrganizationUnitValidator	always
				equipmentValidatorLaboratory	always
				multipleOwnerPositionConsistencyStartDateValidator	always
		save	complex	sameDefinitionForGenericItemValidator	always
		save	complex	getYearFromStartDateValidator	always
		element	complex	owner:save addOrgUnitFromNewOwnerValidator	always
	Organi dipartimentali (headOfDepartment)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
	Organi dipartimentali (headOfDepartment)	element	complex	internalOrganizationUnit:save notAllowedValidator	always
wfState.lab.rejected (rejected)	all	enter	required	wfItemTypeId	always
				description	always
				dateMap[startDate]	always
wfState.lab.approved (approved)	all	enter	required	wfItemTypeId	always
				description	always
				clobMap[abstract]	always
				dateMap[startDate]	always
				booleanMap[visibleOnPortal]	always
			complex	multipleOwnerValidator	always
				internalOrganizationUnitValidator	always
				equipmentValidatorLaboratory	always
				multipleOwnerPositionConsistencyStartDateValidator	always
		save	complex	sameDefinitionForGenericItemValidator	always
		save	complex	getYearFromStartDateValidator	always
wfState.lab.reopened (reopened)	all	enter	required	wfItemTypeId	always
				description	always
				clobMap[abstract]	always
				dateMap[startDate]	always
		save	complex	sameDefinitionForGenericItemValidator	always
		save	complex	getYearFromStartDateValidator	always
		element	complex	owner:save addOrgUnitFromNewOwnerValidator	always
	Organi dipartimentali (headOfDepartment)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
	Organi dipartimentali (headOfDepartment)	element	complex	internalOrganizationUnit:save notAllowedValidator	always
	Responsabile scientifico (owner)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
				internalOrganizationUnit:save notAllowedValidator	always
				owner:save notAllowedValidator	always
				owner:delete notAllowedValidator	always
	Delegato (internalRepresentatives)	element	complex	internalOrganizationUnit:delete notAllowedValidator	always
				internalOrganizationUnit:save notAllowedValidator	always
				owner:save notAllowedValidator	always
				owner:delete notAllowedValidator	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

wfState.lab.draft (draft)
- ENTER LOGICS
  - wfActionLogicEnterMailSender
  - wfActionLogicTransitionLogger
- SAVE LOGICS
wfState.lab.submitted (submitted)
- ENTER LOGICS
  - wfActionLogicEnterMailSender
  - wfActionLogicTransitionLogger
- SAVE LOGICS
wfState.lab.rejected (rejected)
- ENTER LOGICS
  - wfActionLogicEnterMailSender
  - wfActionLogicTransitionLogger
- SAVE LOGICS
wfState.lab.approved (approved)
- ENTER LOGICS
- SAVE LOGICS
wfState.lab.reopened (reopened)
- ENTER LOGICS
  - wfActionLogicEnterMailSender
  - wfActionLogicTransitionLogger
- SAVE LOGICS