Generazione di portlet per i servizi umani heritage esposti come dashboard (obsoleto)

Se è stato esposto un servizio con interazione dell'utente heritage come dashboard per un gruppo di partecipanti al processo e si desidera utilizzare il dashboard in IBM® WebSphere® Portal, generare un portlet. Quindi l'amministratore del portal server può distribuire il portlet JSR 286 all'ambiente di runtime del portal server.

Prima di iniziare

Per eseguire questa attività, è necessario trovarsi nell'editor desktop IBM Process Designer , che è obsoleto.

Assicurarsi che il servizio con interazione dell'utente heritage sia esposto al gruppo appropriato di partecipanti al processo che lavorano con il pannello di controllo in fase di runtime e che il servizio con interazione dell'utente heritage sia esposto come pannello di controllo. Assicurarsi che il servizio con interazione dell'utente Heritage abbia almeno una snapshot e un coach.

Il dashboard è disponibile per gli utenti specificati in Process Portal per impostazione predefinita. Se si completa la seguente procedura, il dashboard è disponibile anche per gli utenti specificati come portlet distribuito su un server WebSphere Portal .

Quando si progettano servizi con interazione dell'utente heritage che si intende esporre come dashboard distribuiti come portlet, considerare le seguenti linee guida:
  • Lavorare con l'amministratore del portal server per comprendere come i portlet del dashboard sono correlati ad altri portlet e servizi nell'ambiente di runtime del portal server.
  • Assicurarsi che il server IBM WebSphere Portal sia stato aggiunto all'elenco di server attendibili come descritto in Aggiunta di server all'elenco di server attendibili.
  • Di solito, i servizi con interazione dell'utente heritage esposti come dashboard non sono servizi che terminano. Tuttavia, non ti è vietato utilizzare gli eventi di fine nei servizi umani heritage che esponi come dashboard. Tenere presente che quando un portlet del pannello di controllo viene distribuito e contiene un endpoint, il portlet termina e deve essere riavviato. Se il coach è progettato per terminare il servizio, il portlet del dashboard generato include un pulsante Ricarica per i partecipanti al processo per avviare una nuova istanza e aggiornare il dashboard.
  • Se un servizio con interazione dell'utente Heritage contiene due Coach con lo stesso nome, assicurarsi che tutti gli eventi limite sui Coach abbiano ID di controllo univoci. Se gli ID di controllo eventi limite non sono univoci, i partecipanti al processo che utilizzano il portlet del dashboard potrebbero ricevere errori o interazioni portlet non previste.
  • È possibile generare portlet per i dashboard che contengono heritage coach, ma non è possibile associare heritage coach agli eventi limite per i portlet del dashboard.
  • Se si utilizza la pre - elaborazione e la post - elaborazione per il servizio con interazione dell'utente Heritage, prestare attenzione a dove si verifica l'elaborazione in relazione all'evento di limite. Poiché i portlet possono essere collegati insieme e collegati ad altri servizi, potrebbe essere necessario spostare la pre - elaborazione e la post - elaborazione in modo che l'evento di limite venga attivato correttamente nel portlet del dashboard.
  • Se si prevede di aggiornare le variabili all'interno di un coach da un evento in entrata, ma non si desidera attivare alcun evento di limite per il coach, aggiungere un nuovo evento di limite che esegua il loop allo stesso coach specificato come parte di un evento in entrata. Assicurarsi di selezionare il nuovo evento di limite quando si definisce l'evento in ingresso per il portlet del pannello di controllo generato.
  • Se stai pianificando di designare una variabile di payload per gli eventi in entrata o in uscita per il dashboard, assicurati che la variabile di payload sia inclusa in ogni Coach che fa parte del servizio con interazione dell'utente Heritage. La variabile payload deve essere inclusa su ogni coach che fa parte del servizio con interazione dell'utente heritage esposto come dashboard e distribuito come portlet. Tuttavia, un coach può includere una variabile senza visualizzarla per elaborare i partecipanti se si aggiunge un campo per la variabile al coach e si imposta la visibilità del campo come Nessuno (nascondi o disabilita).
  • Per il supporto di globalizzazione per il nome e la descrizione dei portlet generati, assicurarsi di preparare un file XML designato quando si crea il portlet dal dashboard. XML deve essere pronto prima di avviare la procedura guidata Esporta dashboard . Assicurarsi che l'XML utilizzi lo stesso formato del seguente esempio:
    <?xml version='1.0' encoding='UTF-8' ?>
    <portlet>
    	<description xml:lang="en">English description</description>
    	<description xml:lang="fr">French description</description>
    	<description xml:lang="es">Spanish description</description>
    	<display-name xml:lang="en">English display name</display-name>
    	<display-name xml:lang="fr">French display name</display-name>
    	<display-name xml:lang="es">Spanish display name</display-name>
    </portlet>

    Verificare che il file XML abbia la codifica definita come UTF-8. Il file XML può contenere zero o più elementi description o display-name . Gli elementi description e display-name non possono avere valori stringa vuoti. L'attributo xml:lang deve seguire la specifica RFC 1766, disponibile all'indirizzo http://www.ietf.org/rfc/rfc1766.txt.

  • (Obsoleto.) La funzione di collaborazione non è disponibile per i dashboard esposti come portlet. In altre parole, gli utenti non possono interagire in un'attività con altri utenti o esperti come possono fare in Heritage Process Portal (obsoleto).
  • (Obsoleto.) L'utilizzo dello stesso protocollo di sicurezza sia per il server Business Automation Workflow che per IBM WebSphere Portal evita un problema per cui la funzione di collaborazione non è disponibile per i dashboard esposti come portlet. Ciò significa che gli utenti non possono interagire in un'attività con altri utenti o esperti come possono fare in Process Portal. gli utenti visualizzano una vista di completamento attività vuota in un portlet IBM WebSphere Portal . Ad esempio, utilizzare HTTPS sia per il Business Automation Workflow sia per il server che per la portlet in esecuzione sul server IBM WebSphere Portal, oppure utilizzare HTTP sia per il server che per la portlet in esecuzione sul server Business Automation Workflow server e la portlet in esecuzione sul server IBM WebSphere Portal. Quando si configura la portlet sul server IBM WebSphere Portal e si specifica il protocollo di sicurezza Business Automation Workflow URL specificare lo stesso protocollo di sicurezza utilizzato dal server Business Automation Workflow server.

Informazioni su questa attività

Utilizzare la procedura guidata Esporta dashboard in Process Designer per definire i parametri del portlet e associare gli eventi durante l'esportazione del dashboard. Dopo aver generato un portlet per il dashboard, l'amministratore del portal server può distribuire il portlet in IBM WebSphere Portal in modo che i partecipanti del processo interagiscano con il dashboard nell'ambiente di runtime.

Procedura

  1. Per i servizi con interazione dell'utente heritage esposti come dashboard per un gruppo di partecipanti al processo, fare clic su Crea un portlet dal dashboard nella pagina della panoramica nel desktop Process Designer per aprire la procedura guidata Esporta dashboard .
  2. Quando si impostano i parametri per il portlet, considerare il modo in cui l'amministratore del server del portale e i partecipanti al processo utilizzano il portlet distribuito:
    • Immettere un nome e una descrizione che descrivono le operazioni del portlet.
    • Se è stato creato un file XML per la globalizzazione del nome e della descrizione del portlet, selezionare Globalizzazione e selezionare il file.
    • Selezionare l'istantanea che rappresenta la versione del dashboard che si desidera generare come portlet per i partecipanti al processo da utilizzare in fase di runtime. Se si seleziona un'istantanea meno recente, le modifiche dopo l'acquisizione dell'istantanea non vengono rappresentate nel portlet generato.
  3. Facoltativo: definire gli eventi in entrata per il portlet del dashboard.

    In fase di runtime, altri portlet interagiscono con il portlet del dashboard inviandogli eventi. Quando il portlet del pannello di controllo riceve un evento da un altro portlet, attiva un evento di limite, spostando il dashboard su un altro coach.

    • Per ciascun evento in entrata a cui si desidera che questo portlet del pannello di controllo risponda, modificare il campo del nome evento in qualcosa di significativo per il pannello di controllo. Il valore predefinito dello spazio dei nomi rende l'evento univoco e impedisce interazioni indesiderate tra i portlet.
    • Specificare una variabile di payload se si prevede che l'evento in entrata contenga i dati che si desidera utilizzare per aggiornare i dati del dashboard. Se il coach utilizza una variabile payload, selezionare la variabile payload che il portlet del dashboard riceve da altri portlet al runtime. Puoi scegliere tra le variabili che fanno parte del servizio con interazione dell'utente heritage. Come precedentemente menzionato, assicurarsi che la variabile payload sia inclusa in ogni coach che fa parte del servizio con interazione dell'utente Heritage.
    • Selezionare un Coach e un evento limite che rappresenta l'elemento dell'interfaccia utente con cui si desidera che il portlet del dashboard interagisca quando riceve l'evento. L'evento di limite in un diagramma del servizio con interazione dell'utente heritage è etichettato come End State Binding. Se è stata selezionata una variabile di payload, assicurarsi di selezionare un coach che abbia la stessa variabile.
    • Definire più elementi di interfaccia facendo clic sul segno più e designando un altro evento coach e limite.
    • Quando il portlet del dashboard riceve l'evento, interagisce solo con l'elemento dell'interfaccia sul coach attualmente visualizzato.
  4. Facoltativo: Definire gli eventi in uscita per il portlet del dashboard.

    In fase di runtime, il portlet del dashboard invia eventi ad altri portlet.

    • Selezionare un evento di limite per designare gli elementi dell'interfaccia utente che fanno sì che il portlet del dashboard invii l'evento.
    • Se si specifica una variabile di payload, il portlet del dashboard include i dati nell'evento inviato per altri portlet da utilizzare. Come precedentemente menzionato, assicurarsi che la variabile payload sia inclusa in ogni coach che fa parte del servizio con interazione dell'utente Heritage.
  5. Una volta terminata l'esportazione del pannello di controllo come portlet, installare il file .war sul proprio server Business Automation Workflow e indicare all'amministratore del portal server di puntare all'endpoint per il protocollo WSRP (Web Services for Remote Portlets) 2.0 e importare il file .war .

    Il server Business Automation Workflow viene fornito con un provider WSRP 2.0 già installato, che consente l'utilizzo dei portlet generati da WebSphere Portal. L'indirizzo URL per accedere al servizio web del provider WSPR 2.0 su un server installato è Business Automation Workflow è: http://{BPM_host_name}:{BPM_port}/producer/wsdl/wsrp_service.wsdl.

    Se non si utilizza WSRP, fornire il file .war all'amministratore del portal server per la distribuzione.

    Discutere i seguenti punti con l'amministratore del portal server:
    • l'amministratore deve installare i portlet del dashboard sullo stesso cluster di Process Portal.
    • Notificare all'amministratore che la parola chiave IBMBPM è stata aggiunta al portlet del dashboard generato. La parola chiave rende più semplice per gli amministratori trovare e gestire i portlet del pannello di controllo.
    • Assicurarsi che l'amministratore sappia che le preferenze del portlet possono essere modificate in WebSphere Portal utilizzando la pagina di modifica per il portlet. L'amministratore può modificare le seguenti informazioni per il portlet del dashboard generato: nome host, numero porta, larghezza e altezza.
    • Fornire all'amministratore le seguenti informazioni sulle preferenze del portlet Business Automation Workflow che è possibile modificare nel portlet del dashboard. Tutte le altre preferenze del portlet Business Automation Workflow non dovrebbero essere modificate.
      • bpmHost (valore predefinito: localhost) - Il nome host o l'indirizzo IP per il server
      • bpmPort (valore predefinito: 9080) - Il numero di porta del server
      • bpmUseSSL (valore predefinito: false) - L'indicazione che https deve essere utilizzato invece di http
      • bpmWidth - La larghezza (in pixel) da utilizzare per il portlet iframe che visualizza il dashboard
      • bpmHeight (valore predefinito: 400) - L'altezza (in pixel) da utilizzare per l'iframe del portlet che visualizza il dashboard
      • bpmUseDojo (valore predefinito: true) - Un valore booleano per indicare se Dojo deve essere utilizzato quando disponibile per gli eventi lato client. Se il valore è true, il portlet verifica se Dojo è caricato e utilizza i metodi di pubblicazione - sottoscrizione Dojo per inviare e ricevere eventi. Se il valore è false, il portlet utilizza gli eventi lato server come specificato in JSR286.
      Suggerimento: il Producer WSRP per WebSphere Application Server è un producer senza stato e non gestisce le preferenze del portlet sul server. Se si sta utilizzando il Producer WSRP, è necessario aggiornare il file portlet.xml contenuto nel file .war esportato con le modifiche delle preferenze del portlet prima che l'amministratore installi il file .war .
    • Informare l'amministratore dei seguenti requisiti per l'utilizzo del protocollo SSO (single - sign - on) e SSL (Secure Sockets Layer) in WebSphere Portal con i portlet del dashboard da Business Automation Workflow.
      • Per impedire che il pannello di accesso di Process Portal venga visualizzato nel portlet del dashboard, gli amministratori devono abilitare e configurare SSO (single - sign - on) per i server WebSphere Portal e Business Automation Workflow . Consultare Single sign-on for authentication nella documentazioneIBM Documentation per WebSphere Application Server.
      • Per evitare messaggi del browser relativi alle connessioni sicure per i partecipanti al processo che si collegano a WebSphere Portal e utilizzano i portlet del pannello di controllo, gli amministratori devono sostituire i certificati personali autofirmati con quelli forniti da una CA (Certificate Authority) esterna attendibile. Consultare Creazione di una richiesta di autorità di certificazione nella documentazione IBM Documentation per WebSphere Application Server.
      • Se si utilizzano certificati personali per il test o in un ambiente di pre - produzione, l'amministratore può importare i certificati da ogni sistema nel browser prima del test.
      • In un ambiente di produzione, gli amministratori devono evitare di utilizzare certificati autofirmati.
      • Se si usa HTTPS per connettersi a WebSphere Portal, l'amministratore deve usare anche HTTPS nelle portlet del cruscotto. Se una parte di una pagina viene caricata utilizzando HTTPS e altre parti vengono caricate utilizzando HTTP, i partecipanti al processo che si connettono a WebSphere Portal e utilizzano le portlet del cruscotto potrebbero ricevere un avviso che indica che alcuni contenuti della pagina non sono sicuri.
    • L'amministratore del portal server deve stabilire se utilizzare eventi lato client o eventi lato server. Sia gli eventi lato client che quelli lato server utilizzano gli eventi di limite modellati come parte della definizione del servizio con interazione dell'utente heritage. La differenza tra eventi lato client ed eventi lato server è il canale per la comunicazione.

      Quando si utilizzano gli eventi lato client, i portlet creati con Process Designer utilizzano Dojo Toolkit per inviare messaggi tra i portlet che si trovano sulla stessa pagina nel portal server. L'utilizzo degli eventi lato client è più rapido, perché non richiede l'invio di eventi al server per l'elaborazione e non richiede ricaricamenti di pagina quando un evento viene inviato o ricevuto. Se vengono utilizzati gli eventi lato client, il Dojo Toolkit deve essere caricato come parte del tema per la pagina del portale e i portlet del dashboard generati inviano gli eventi utilizzando solo il Dojo Toolkit. I portlet del dashboard generati ricevono eventi lato server da altri portlet sulla pagina che non utilizzano eventi lato client.

      Gli eventi lato server non richiedono il caricamento di Dojo Toolkit e sono il meccanismo di eventi standard definito nella specifica JSR286 . L'elaborazione degli eventi lato server richiede più tempo perché gli eventi devono essere inviati al server per l'elaborazione e la pagina deve essere ricaricata per visualizzare i risultati. Gli eventi lato server possono essere utilizzati nelle pagine del server del portale con la configurazione e il collegamento corretti del portale.

    • Se l'amministratore decide di utilizzare gli eventi lato client, Dojo Toolkit deve essere caricato come parte del tema per la pagina del portale.