Esposizione dei servizi umani heritage (obsoleto)

Modifica in linea

Oltre ad implementare le attività in un processo, i servizi con interazione dell'utente heritage creati in IBM® Process Designer possono essere utilizzati anche per personalizzare la Process Admin Console o per creare un dashboard personalizzato per IBM Process Portal. Le impostazioni di esposizione per un servizio dipendono dallo scopo previsto.

Prima di iniziare

Per informazioni sull'esposizione dei servizi con interazione dell'utente lato client, vedi Definizione delle impostazioni di utilizzo per i servizi con interazione dell'utente lato client.

Procedura

Aprire un'applicazione del processo o un toolkit in Process Designer
Apri il servizio con interazione dell'utente heritage che vuoi esporre e passa a Panoramica.
Selezionare il team di cui i membri possono visualizzare e utilizzare il servizio esposto.
In Process Designer, impostare l'opzione Esposto per avviare in Utilizzo.
Nel desktop Process Designer, impostare l'opzione Esponi a nella sezione Esposizione .

Specificare come si desidera utilizzare il servizio. Nell'elenco Utilizza come o Esponi come , selezionare una delle seguenti opzioni.

Tabella 1. Esposizione delle opzioni
Opzione	Descrizione
Attività (servizio contenuto in un processo) o Non presentare (servizio contenuto in un BPD o tipo di caso)	Utilizzare questa opzione predefinita per i servizi che implementano le attività all'interno di un processo. Quando questa opzione è selezionata, l'impostazione Esposto a non viene utilizzata.
Servizio di gestione (disponibile nella Console di gestione del processo)	Utilizzare questa opzione per rendere il servizio con interazione dell'utente Heritage disponibile ai membri del team selezionato come pagina separata in Process Admin Console nelle funzionalità Server Admin. Una nuova categoria viene aggiunta al menu, che ha lo stesso nome dell'applicazione di processo che contiene il servizio. Il nome della singola pagina nella nuova categoria corrisponde al nome servizio.
Servizio avviabile (Avvio da Process Portal)	Utilizzare questa opzione per consentire ai componenti del gruppo selezionato di avviare il servizio dall'elenco di avvio in Process Portal.
Dashboard (disponibile nel menu Dashboard di Process Portal )	Utilizzare questa opzione per rendere il servizio con interazione dell'utente Heritage disponibile in Process Portal ai membri del team selezionato. I membri del team possono accedere al dashboard facendo clic sull'icona Organizza schede e selezionando il dashboard dall'elenco di pagine nascoste. Se non si specifica una risorsa di localizzazione per il nome del dashboard, la pagina del dashboard ha lo stesso nome del servizio esposto. Se è stata definita una risorsa di localizzazione per il nome del dashboard, fare clic su Seleziona accanto al campo Etichetta e selezionare la chiave nella risorsa. Vedi Globalizzazione dei nomi dei dashboard. Se il servizio con interazione dell'utente heritage si trova in un toolkit, è necessario completare la seguente procedura: Creare una snapshot del toolkit. Attivare la snapshot del toolkit. Consultare Attivazione di snapshot da utilizzare con IBM Process Portal Aggiungere la snapshot del toolkit come dipendenza a un'applicazione del processo. Consultare Creazione, modifica ed eliminazione di una dipendenza del toolkit nella vista Designer. Se si desidera esporre il dashboard all'esterno di Process Portal, generare un portlet che è possibile distribuire su un portal server facendo clic su Crea un portlet dal dashboard.
URL (Disponibile solo su URL )	Utilizzare questa opzione per rendere il servizio disponibile da un indirizzo URL. Per informazioni sull'API REST che fornisce il sito URL per il servizio esposto, vedere Interfaccia REST per le risorse relative alla BPD - Risorsa Elementi esposti.

Fare clic su Salva o Termina modifica.

Risultati

Oltre ad essere esposti alle interfacce utente come descritto nella precedente tabella, tutti i servizi con interazione dell'utente heritage esposti vengono resi disponibili per essere richiamati come URL.

L'indirizzo URL è composto dal nome dell'host su cui si trova il IBM Workflow Center il server o Workflow Server è installato, la porta designata per il server durante l'installazione e l'acronimo dell'applicazione di processo che contiene il servizio IBM Business Automation Workflow e l'acronimo dell'applicazione di processo che contiene il servizio. Ad esempio, se si espone un servizio chiamato MyService,, è possibile accedervi dal seguente URL :

http://host_name:port/contextRootPrefix/executeServiceByName?processApp=acronym&serviceName=MyService

Il valore predefinito per contextRootPrefix è teamworks. Per ulteriori informazioni su come configurare una root di contesto personalizzata, consultare la sezione per il parametro -update nell'argomento Programma di utilità della riga comandi BPMConfig .

Ricordare: Qualsiasi limitazione URL specifica del browser, come le restrizioni di lunghezza e di caratteri URL, si applica e deve essere presa in considerazione quando si richiama un servizio umano patrimoniale come URL.

Parametri URL

Il sito URL può contenere uno o più dei seguenti parametri:

processApp: Il nome dell'applicazione del processo
serviceName: Il nome del servizio con interazione dell'utente Heritage
snapshot: Il nome dell'istantanea
com.lombardisoftware.errorPage: Il sito URL della pagina di errore

Variabili di input

Nel sito URL, le variabili di input definite per il servizio hanno il seguente formato:

&tw.local.variableName=value

La configurazione predefinita è definita nel file 99Local.xml . Per ulteriori informazioni, consultare Il file 100Custom.xml e la configurazione. Inoltre, il seguente esempio mostra come personalizzare il file 100Custom.xml per abilitare l'opzione di configurazione type-string-to-date :

<common merge="mergeChildren">
		<type-string-to-date merge="replace">true</type-string-to-date>
</common>

Per i servizi umani Heritage, variableName può essere un SimpleType definito dal sistema o un BusinessObject basato su una variabile SimpleType (di tipo String, Integer, Decimal, Date, Time, Selection). Date o Time sono consentiti solo dopo l'abilitazione dell'opzione di configurazione type-string-to-date .

Limitazione : l'opzione di configurazione type-string-to-date è applicabile solo ai servizi con interazione dell'utente Heritage. Non si applica ai servizi con interazione dell'utente lato client.

<common merge="mergeChildren">
		<type-string-to-date merge="replace">true</type-string-to-date>
</common>

Sintassi data/ora

Il formato della data e dell'ora differisce tra i servizi con interazione dell'utente lato client e i servizi con interazione dell'utente heritage. La sintassi per gli altri tipi semplici (String, Integer, Decimal, Selection) è la stessa per i servizi con interazione dell'utente lato client e i servizi con interazione dell'utente heritage.

Nota: per informazioni sulla sintassi di data e ora nei servizi umani, vedi Definizione delle impostazioni di utilizzo per i servizi umani lato client.

Per i servizi con interazione dell'utente heritage, il formato di data e ora è il seguente:

Il formato Date è YYYY-MM-DD.
Il formato Time è HH:mm:ss.
Fuso orario: poiché il supporto per le informazioni sul fuso orario non è fornito con i servizi umani heritage, il fuso orario predefinito è impostato sul fuso orario del server.

Versione del servizio richiamata

Se non viene passato un nome specifico di snapshot a URL, la versione predefinita del servizio che viene eseguita dipende dall'ambiente in cui il servizio è in esecuzione.

Tabella 2. Versione del servizio con interazione dell'utente Heritage richiamato per ogni ambiente
Ambiente	Versione del servizio con interazione dell'utente Heritage
Workflow Center	Viene eseguito il servizio esposto nella punta della traccia predefinita.
Workflow Server	Viene eseguito il servizio esposto nell'istantanea predefinita.
Process Portal	Quando si avvia un servizio con interazione dell'utente Heritage come dashboard in Process Portal, la versione avviata è la versione di lavoro corrente del servizio con interazione dell'utente Heritage se la versione è esposta. Altrimenti, se è presente un'istantanea attiva in cui è esposto il servizio con interazione dell'utente heritage, la versione dell'istantanea viene avviata. Se la versione di lavoro corrente non è esposta e sono presenti più istantanee attive in cui è esposto il servizio con interazione dell'utente Heritage, viene avviata l'ultima versione dell'istantanea.
Un portlet in un portal server esterno	È possibile esportare solo una snapshot valida quando si genera un portlet per un dashboard. Quando il portlet comunica nuovamente con IBM Business Automation Workflow, tale snapshot deve essere attiva.