View Source

Grafico del flusso

UGOV - Help utente > Produzione - contract-centralized-flow: flusso contratti centralizzato > graph.png

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)"
- 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.
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

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.

Identificativo stato	Chiave etichetta stato	Valore default stato	Chiave etichetta bottone transizione in ingresso	Valore default bottone transizione in ingresso
draft	wfState.con.draft	Bozza	button.forward.to.con.draft	Salva e invia in "Bozza"
added	wfState.con.added	Inserito	button.forward.to.con.added	Salva e invia in "Inserito"
validated	wfState.con.validated	Validato	button.forward.to.con.validated	Salva e invia in "Validato"
signed	wfState.con.signed	Stipulato	button.forward.to.con.signed	Salva e invia in "Stipulato"
closed	wfState.con.closed	Concluso	button.forward.to.con.closed	Salva e invia in "Concluso"
archived	wfState.con.archived	Archiviato	button.forward.to.con.archived	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	added	Dati generali Date Soggetti Interni Corrispettivi Risultati & Parole chiave Pubblicazioni & Collegamenti Allegati & Log Transizioni
Inserito (added)	Helpdesk (helpdesk)	r w	draft,validated	Dati generali Date Soggetti Interni Corrispettivi Risultati & Parole chiave Pubblicazioni & Collegamenti Allegati & Log Transizioni
Inserito (added)	Responsabile/Proprietario (owner)	r w	none	@tab.contract.Owner@
Validato (validated)	Helpdesk (helpdesk)	r w	added,signed,archived	Dati generali Date Soggetti Interni Corrispettivi Risultati & Parole chiave Pubblicazioni & Collegamenti Allegati & Log Transizioni
Validato (validated)	Responsabile/Proprietario (owner)	r w	none	@tab.contract.Owner@
Stipulato (signed)	Helpdesk (helpdesk)	r w	validated,closed	Dati generali Date Soggetti Interni Corrispettivi Risultati & Parole chiave Pubblicazioni & Collegamenti Allegati & Log Transizioni
	Responsabile/Proprietario (owner)	r w	none	@tab.contract.Owner@
	Organi dipartimentali (headOfDepartment)	r	none
	Contabilita' (accountancy)	r	none
Concluso (closed)	Helpdesk (helpdesk)	r w	signed	Dati generali Date Soggetti Interni Corrispettivi Risultati & Parole chiave Pubblicazioni & Collegamenti Allegati & Log Transizioni
	Responsabile/Proprietario (owner)	r w	none	@tab.contract.Owner@
	Organi dipartimentali (headOfDepartment)	r	none
	Contabilita' (accountancy)	r	none
Archiviato (archived)	Helpdesk (helpdesk)	r w	validated	Dati generali Date Soggetti Interni Corrispettivi Risultati & Parole chiave Pubblicazioni & Collegamenti Allegati & Log Transizioni
Archiviato (archived)	Responsabile/Proprietario (owner)	r	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	checkCreationPermissionsValidator	always
			complex	ownerValidatorContract	always
		save	required	identifier	always
		save	complex	personInFragmentValidator	isNotLegacy
		delete	complex	childAndParentDetectorDeleteValidator	always
		element	required	owner:save dateMap[startDate]	always
Inserito (added)	all	enter	required	wfItemTypeId	always
				dateMap[proposalStartDate]	always
				description	always
			complex	ownerValidatorContract	always
			complex	organizationUnitValidatorContract	isNotLegacy
		save	required	identifier	always
		save	complex	personInFragmentValidator	isNotLegacy
		delete	complex	childAndParentDetectorDeleteValidator	always
		element	required	owner:save dateMap[startDate]	always
Validato (validated)	all	enter	required	wfItemTypeId	always
				dateMap[proposalStartDate]	always
				description	always
			complex	ownerValidatorContract	always
			complex	organizationUnitValidatorContract	isNotLegacy
		save	required	identifier	always
		save	complex	personInFragmentValidator	isNotLegacy
		delete	complex	childAndParentDetectorDeleteValidator	always
		element	required	owner:save dateMap[startDate]	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	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	checkDateExtensionValidator	always
				contributorAndOwnerStartDateValidator	isNotLegacy
				contributorAndOwnerValidatorWithStartEndDate	isNotLegacy
				personInFragmentValidator	isNotLegacy
		delete	complex	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
	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	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	checkDateExtensionValidator	always
				contributorAndOwnerStartDateValidator	isNotLegacy
				contributorAndOwnerValidatorWithStartEndDate	isNotLegacy
				personInFragmentValidator	isNotLegacy
		delete	complex	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
	Responsabile/Proprietario (owner)	save	complex	wfUgovPjSenderValidatorContract	always
Archiviato (archived)	all	save	required	identifier	always
		delete	complex	childAndParentDetectorDeleteValidator	always
		element	required	owner:save dateMap[startDate]	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

Bozza (draft)
- ENTER LOGICS
Inserito (added)
- ENTER LOGICS
- SAVE LOGICS
  - wfActionLogicSaveMultipleOwner
  - wfActionLogicSaveMultipleOrganizationUnit
Validato (validated)
- ENTER LOGICS
- SAVE LOGICS
  - wfActionLogicSaveMultipleOwner
  - wfActionLogicSaveMultipleOrganizationUnit
Stipulato (signed)
- ENTER LOGICS
- SAVE LOGICS
  - wfActionLogicSaveMultipleOwner
  - wfActionLogicSaveMultipleOrganizationUnit
Concluso (closed)
- ENTER LOGICS
- SAVE LOGICS
  - wfActionLogicSaveMultipleOwner
  - wfActionLogicSaveMultipleOrganizationUnit
Archiviato (archived)
- ENTER LOGICS
- SAVE LOGICS
  - wfActionLogicSaveMultipleOwner
  - wfActionLogicSaveMultipleOrganizationUnit