Utilizzo della documentazione Validations Messages

Per poter determinare quali convalide sono identificate come convalide configurabili che possono essere disabilitate, le organizzazioni possono fare riferimento alla documentazione Validation Messages fornita in formato HTML come parte dei programmi di installazione di sviluppo. Quando si esegue il programma di installazione di sviluppo, la documentazione si trova nella cartella di livello principale 'Doc' nella base di codice installata. Per accedere alla home page della documentazione Validation Messages selezionare il file index.html nella cartella ValidationMessages/html.

È possibile visualizzare un elenco delle convalide a cui fa riferimento ogni metodo di una classe facade selezionando il “Facades A-Z Index” dalla home page della documentazione, selezionando un nome classe facade e un metodo.

È possibile visualizzare anche un elenco delle convalide a cui fa riferimento ogni metodo di un pannello selezionando il link “Screens A-Z Index” dalla home page della documentazione, selezionando un nome di pannello e un metodo.

Per ogni convalida, vengono forniti il riferimento della convalida e il testo del messaggio di convalida. Ad esempio, per la convalida utilizzata per impedire che la data di inizio di un ruolo partecipante al caso sia successiva alla data di fine di un caso, vengono visualizzati il riferimento convalida BPOCASEPARTICIPANTROLE.ERR_CASEPARTICIPANTROLE_XFV_FROM_DATE_CASEHEADER_END_DATE e il testo del messaggio di convalida “La data di inizio del ruolo partecipante al caso non deve essere successiva alla data di fine del caso - "%1d".”.

Per ogni convalida, la documentazione visualizza anche se la convalida è configurabile o meno. Tutte le convalide configurabili sono state verificate per assicurarsi che non abbiano un impatto sull'elaborazione del sistema se non vengono eseguite, e possono essere disabilitate da un'agenzia. Se la convalida non viene indicata come configurabile, l'organizzazione non può disabilitare la convalida all'interno dell'applicazione di amministrazione del sistema, e deve generare un caso di supporto se ha necessità di poter disabilitare la convalida.

Inoltre, una sezione relativa ai messaggi configurabili elenca tutte le convalide identificate come configurabili, incluse le facade da cui viene fatto riferimento alle convalide. È possibile accedere a questa sezione selezionando il link “Configurable Messages A-Z Index” dalla home page della documentazione. L'organizzazione può utilizzare questo elenco per determinare il riferimento convalida univoco necessario per cercare e disabilitare la convalida come parte dell'amministrazione del sistema.

Ad esempio, se l'organizzazione desidera identificare le convalide esistenti e configurabili come parte del processo di modifica del membro del caso, può selezionare l'opzione “Screens A-Z Index” dalla home page della documentazione, immettere “modifyCaseMember” per filtrare l'elenco di pannelli, selezionare il pannello “Case_modifyCaseMemberFromList.uim”, selezionare il riferimento facade “Case.modifyCaseMember” e visualizzare un elenco delle convalide, incluso se ciascuna convalida è una convalida configurabile.

Se l'organizzazione rileva che la convalida BPOCASEPARTICIPANTROLE.ERR_CASEPARTICIPANTROLE_XFV_FROM_DATE_CASEHEADER_FROM_DATE è configurabile, può mettere a confronto il riferimento della convalida con l'elenco di convalide configurabili per identificare l'D riferimento convalida univoco per la convalida. Questa operazione viene effettuata utilizzando i filtri Riferimento facade e Riferimento messaggio. Se viene immesso il nome metodo “modifyCaseMember” nel filtro Riferimento facade e il riferimento convalida BPOCASEPARTICIPANTROLE.ERR_CASEPARTICIPANTROLE_XFV_FROM_DATE_CASEHEADER_FROM_DATE viene immesso nel filtro Riferimento messaggio, viene visualizzato il riferimento convalida bpocaseparticipantrole.err_caseparticipantrole_xfv_from_date_caseheader_from_date|a| per la convalida.

Se viene visualizzato più di un riferimento convalida univoco per una particolare combinazione di Riferimento facade e Riferimento messaggio, l'organizzazione può determinare quale riferimento convalida univoco disabilitare abilitando la visualizzazione del riferimento convalida univoco nell'applicazione insieme al testo del messaggio di convalida visualizzato quando viene eseguita un'elaborazione business che comporta il richiamo della convalida. Questo, nella maggior parte dei casi, porta alla visualizzazione di un unico riferimento convalida, che è la convalida da disabilitare. Nel caso improbabile che venga visualizzato più di un riferimento convalida quando viene eseguito il processo di business, rappresenta una situazione in cui la stessa convalida viene eseguita due volte durante lo stesso processo di business ed entrambe devono essere disabilitate.

Tenere presente che tutte le voci del catalogo messaggi a cui un metodo fa riferimento sono visualizzate per ciascun metodo nella documentazione Validation Messages; pertanto anche altri tipi di messaggi, come quelli di infrastruttura ed i messaggi utilizzati per la registrazione, possono essere visualizzati insieme ai messaggi di convalida. Inoltre, per ogni metodo la documentazione visualizza anche tutti i messaggi a cui fa riferimento un eventuale metodo richiamato dal metodo, e quindi, in alcuni casi, sono elencati messaggi non necessariamente richiamati dal pannello che utilizza il metodo.

La sezione riportata di seguito fornisce maggiori dettagli su come abilitare la visualizzazione dell'ID riferimento convalida univoco all'interno dell'applicazione.