Configurazione dell'indice Process Portal

È possibile modificare la posizione in cui è memorizzato l'indice su un sistema Business Automation Workflow modificando una variabile di ambiente. Per modificare il comportamento dell'indice, ad esempio la lunghezza dell'intervallo di aggiornamento o l'inclusione delle attività completate nell'indice, è necessario modificare il file di configurazione 100Custom.xml .

Importante: Le informazioni riportate di seguito si applicano sia a Heritage Process Portal (obsoleto) che a Process Portal.

L'indice consente ai partecipanti al processo in Process Portal di cercare attività o istanze del processo che contengono metadati o dati di istanza particolari. L'indice viene utilizzato anche per i dati cronologici nei dashboard Prestazioni del processo e Prestazioni attività.

Poiché l'indicizzazione è abilitata per impostazione predefinita, le seguenti azioni di configurazione sono facoltative.

Impostazione dell'ubicazione dell'indice

L'ubicazione dell'indice è determinata dal valore della variabile BPM_SEARCH_TASK_INDEX WebSphere . Questa variabile ha un ambito server su un server autonomo e un ambito cluster su un cluster.

Su un cluster
L'ubicazione predefinita è $<BPM_SEARCH_TASK_INDEX_ROOT>/cluster_name. L'uso di questa posizione predefinita risulta in un indice per cluster su ciascun nodo in modo che tutti i membri del cluster sullo stesso nodo condividano l'indice.

In modo che un indice non debba essere gestito per ogni membro del cluster, un indice può essere condiviso tra i nodi. L'indice può essere gestito solo in un membro cluster alla volta, che viene applicato da una strategia di blocco sull'indice. Per impostare l'indice, utilizzare una soluzione di memoria di rete condivisa per l'indice e modificare il valore della variabile BPM_SEARCH_TASK_INDEX_ROOT nell'ambito della cella in modo che punti all'ubicazione comune.

Se si desidera che un membro del cluster abbia un indice separato, è possibile modificare il valore della variabile BPM_SEARCH_TASK_INDEX_ROOT nell'ambito della cella in modo che punti a un'ubicazione diversa.

Per individuare le variabili di ambiente, nella console di amministrazione fare clic su Ambiente > WebSphere.

Su un server autonomo
L'ubicazione predefinita dell'indice attività è $<BPM_SEARCH_TASK_INDEX_ROOT>/server_name. Se la variabile BPM_SEARCH_TASK_INDEX non è impostata, l'ubicazione assume il valore predefinito $<USER_INSTALL_ROOT>/searchIndex/task/$<WAS_SERVER_NAME>, che risulta in un indice per server.

Per modificare l'ubicazione dell'indice, nella console di gestione fare clic su Ambiente > WebSphere. Se la variabile BPM_SEARCH_TASK_INDEX non esiste, definirla con l'ambito della cella, quindi impostare il valore sulla nuova ubicazione.

Modifica del comportamento dell'indice

La configurazione dell'indice comprende le seguenti impostazioni predefinite:
  • L'indicizzazione è abilitata.
  • L'indice viene aggiornato ogni 5 secondi.
  • Al completamento dell'attività, l'indice viene aggiornato per l'attività appena completata e le attività aperte. Non viene aggiornato per le attività precedentemente completate associate al processo.
Per modificare il comportamento dell'indice, effettuare quanto segue:
  1. Modificare il file 100Custom.xml per il server appropriato. Le informazioni sul percorso del file 100Custom.xml si trovano nell'argomento Percorso dei file di configurazione 100Custom.
  2. Aggiungere o modificare il seguente frammento di codice come richiesto:
    <search-index merge="replace">            
        <task-index-enabled>true</task-index-enabled>            
        <task-index-update-interval>5</task-index-update-interval>
        <task-index-update-completed-tasks>false</task-index-update-completed-tasks>
        <task-index-store-fields>false</task-index-store-fields>
        <task-index-work-manager>wm/default</task-index-work-manager>
        <task-index-include-system-tasks>true</task-index-include-system-tasks>
        <process-index-instance-completion-best-effort>false</process-index-instance-completion-best-effort>
    </search-index>
  3. Nella sezione <search-index> , modificare le tag di indice di attività appropriate per le impostazioni di configurazione che si desidera modificare.
    Tabella 1. Tag XML che è possibile utilizzare per modificare le impostazioni di configurazione dell'indice
    Tag XML Descrizione delle impostazioni di configurazione
    <task-index-enabled> Questo valore booleano determina se l'indicizzazione è abilitata. Il valore predefinito è true; se l'indice non esiste, viene creato.
    Per disattivare l'indicizzazione, modificare il valore in false; se l'indice non esiste, non viene creato.
    Limitazione : se l'indicizzazione è disattivata, il campo di ricerca nell'interfaccia utente Process Portal è nascosto. Inoltre, l'elenco di processi, il dashboard Prestazioni del processo e il dashboard Prestazioni del team non funzionano correttamente.
    <task-index-update-interval> Questo valore intero specifica il tempo tra gli aggiornamenti dell'indice in secondi. L'intervallo specificato determina quando viene acquisito lo stato delle variabili di istanza per le attività completate dall'ultimo aggiornamento dell'indice. Solo le attività completate durante l'intervallo corrente sono ricercabili con i dati dell'istanza più recenti.

    Il valore predefinito per l'aggiornamento è 5 secondi. Il valore minimo è un secondo.

    <task-index-update-completed-tasks> Questo valore booleano controlla se l'indice viene aggiornato per le attività precedentemente completate. Il valore predefinito è false, il che significa che solo l'attività appena completata e aperta viene aggiornata nell'indice.
    Se si modifica il valore in true, si verificano le seguenti modifiche nel comportamento:
    • Gli aggiornamenti a livello di istanza, come i dati di business aggiornati successivamente nel processo, vengono propagati alle attività completate.
    • Sebbene il sistema abbia del lavoro aggiuntivo per indicizzare le attività completate, le ricerche sulle attività completate si basano sui dati di business dell'istanza finale.
    • Gli utenti con molte attività assegnate sperimentano prestazioni migliorate delle query sulle istanze del processo attive perché le query possono filtrare le attività dalle istanze completate.
    <task-index-store-fields> Questo valore booleano controlla se i valori dei campi effettivi vengono memorizzati come campi separati. Il valore predefinito è false, che significa che i valori dei campi effettivi non vengono memorizzati come campi separati. È possibile modificare il valore in true per scopi di debug perché migliora la leggibilità per le persone e consente le query da parte di altri strumenti di ricerca.
    <task-index-work-manager> Questa stringa contiene il nome JNDI del gestore lavoro utilizzato dal processo di indicizzazione per gestire l'indice di ricerca. Il valore predefinito è wm/default, che è il gestore lavoro predefinito per WebSphere® Application Server.

    Per migliorare le prestazioni della creazione dell'indice, nella console di gestione è possibile creare un work manager dedicato con un maggior numero di thread disponibili. È quindi possibile utilizzare questa tag per passare al nuovo gestore lavoro.

    <task-index-include-system-tasks> Questo valore booleano controlla se le attività di sistema sono indicizzate. Per abilitare la visualizzazione delle attività di sistema nei grafici Gantt in Process Portal, verificare che il valore della tag sia impostato su true. Se il valore di questa tag è false, le attività di sistema non vengono visualizzate nei grafici Gantt.
    <process-index-instance-completion-best-effort> Questo valore booleano controlla se le date di completamento vengono create quando le istanze migrate dalle versioni precedenti di IBM® BPM vengono indicizzate. L'impostazione predefinita è false.

    Se si modifica il valore in true, l'ultima data di completamento delle attività associate viene utilizzata per la data di completamento dell'istanza. Se non esiste alcuna attività associata, la data / ora dell'ultima modifica dell'istanza viene utilizzata come data di completamento.

  4. Salva le tue modifiche.
  5. Riavviare il server per attivare le modifiche.