Gli schermi dell'applicazione host sono identificati per il contenitore da punti di riferimento definiti in una configurazione del contenitore. I punti di riferimento specificano le azioni che dovrebbero verificarsi per le diverse regioni dello schermo nell'applicazione host e per gli eventi che dovrebbero attivare le azioni. Attraverso la configurazione e i suoi punti di riferimento, il contenitore Host On-Demand permette all'applicazione composita di scambiare informazioni con un'applicazione host.

Configurazione dei contenitori Host On-Demand con l'Editor di applicazioni composite

È possibile utilizzare l'Editor di applicazioni composite per aggiungere il contenitore Host On-Demand a un'applicazione composita, definire i punti di riferimento e aggiungere le azioni. Per aggiungere il contenitore, trascinarlo sull'applicazione dalla cartella Contenitori alla tavolozza Componenti.

Aggiunta di operazioni

Una volta aggiunto il contenitore Host On-Demand all'applicazione e specificata l'applicazione host a cui si desidera accedere, è possibile utilizzare la barra degli strumenti dell'Editor di applicazioni composite per definire le azioni di scambio dei dati che dovrebbero essere attivate quando si verificano eventi specifici.

Configurazione dei contenitori Host On-Demand in plugin

È possibile anche configurare un plugin di contenitore Host On-Demand modificando il suo file "plugin.xml". Questo processo è generalmente descritto in "Application configurations", in Developing Applications for Lotus Expeditor nel centro di informazioni IBM Lotus Expeditor. Ricordare queste attività specifiche quando si aggiorna plugin.xml.

Creare proprietà per ogni campo dell'applicazione host a cui deve accedere l'applicazione composita.

Aggiungere un elemento targetBuilder per specificare la configurazione della sessione memorizzata in un file di proprietà esterno, simile a quello utilizzato per il bean della sessione Host On-Demand. È possibile specificare un URL (ad esempio, 'file://D:/session.properties') o un file di un pacchetto, nel qual caso l'attributo dell'espressione targetBuilder dovrebbe essere impostato a un valore nella forma 'bundle:/<bundle-symbolic-name>/<path>'; ad esempio, 'bundle:/test.plugin/configuration/session.properties'. Per un elenco completo della proprietà di sessione supportate, vedere il centro informazioni Host On-Demand (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp?topic=/com.ibm.hod.doc/doc/beans/com/ibm/eNetwork/beans/HOD/Session.html).

Nota Se si utilizza l'Editor di applicazioni composite, le proprietà della sessione base64-encoded sono memorizzate nella preferenza del componente 'hod.properties'. Se l'attributo dell'espressione targetBuilder manca o ha un valore vuoto, il contenitore utilizza le proprietà della sessione definite in questa preferenza. Questo è il meccanismo utilizzato dalle istanze del contenitore Host On-Demand generico creato nell'Editor di applicazioni composite.

• Creare un identificatore del punto di riferimento per definire una regione dello schermo da utilizzare per il confronto con le espressioni dei punti di riferimento. Se non è definito alcun identificativo del punto di riferimento, le espressioni dei punti di riferimento sono confrontate con l'intero contenuto dello schermo.
• Creare tutti gli elementi punto di riferimento necessari per gli eventi e le azioni richieste.
• Aggiungere espressioni punto di riferimento agli attributi delle espressioni degli elementi punto di riferimento. Le espressioni possono essere valori semplici, espressioni regolari o descrizioni di schermo più complesse memorizzate esternamente. Per specificare un'espressione regolare, anteporre 'regex:' all'espressione del punto di riferimento Per creare una descrizione esterna dello schermo, utilizzare la sintassi definita in "Host On-Demand macro programming guide" (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp?topic=/com.ibm.hod.doc/doc/macro/macro.html), e utilizzare uno dei seguenti meccanismi per farvi riferimento nell'espressione del punto di riferimento.
  • URL file esterno (ad esempio, 'file://D:/screen1.xml')
  • File in un pacchetto/plugin, con l'espressione nella forma 'bundle:/<bundle-symbolic-name>/<path> (ad esempio, ('bundle:/test.plugin/screens/screen2.xml')
  • Preferenza del componente, che contiene una descrizione dello schermo codificata base64. Il nome della preferenza deve essere nella forma 'hod.screen.<nome>' e l'espressione del punto di riferimento deve essere nella forma 'screen:<nome>'. Questo è il meccanismo utilizzato per la scheda dell'editor del punto di riferimento nell'Editor di applicazioni composite.
  Nota Per ignorare la regione specificata dall'identificativo del punto di riferimento, anteporre all'espressione del punto di riferimento '$<regione>=', dove <regione> specifica la nuova regione. Il valore che segue il prefisso può essere un valore semplice o un'espressione regolare.
• Definire gli eventi che attivano le azioni necessarie per il componente Host On-Demand. Il contenitore a Host On-Demand supporta i seguenti eventi:
  • contentComplete — Questo evento si verifica quando viene riconosciuto uno schermo. Tutte le azioni di questo evento sono eseguite in serie.
  • dataChange — Questo evento si verifica o quando una modifica della proprietà sta entrando nel contenitore o quando una regione dello schermo è cambiata.
  • viewInit - Questo evento si verifica quando si apre inizialmente il componente specifico (la parte della vista).
  • viewClose - Questo evento si verifica quando si chiude il componente specifico (la parte della vista).
• Specificare le azioni (pubblicazione o ricezione) da eseguire quando si verifica ciascun evento. In ogni azione, specificare le proprietà a cui si applica l'azione e i campi associati (regioni dello schermo).

  Rappresentare le posizioni dello schermo in una delle seguenti forme:

  • Posizione lineare - '<posizione lineare>' (ad esempio, '1')
  • Coordinata riga, colonna - '<riga>,<colonna>' (ad esempio, '5,10')
  Rappresentare le regioni dello schermo in una delle seguenti forme:
  • Regione lineare - '<posizione>:<lunghezza>' (ad esempio, '1:20' o '1.1:20')
  • Regione rettangolare - <posizione superiore sinistra>-<posizione inferiore destra> (ad esempio, '1-160' o '1,1-2,80')
  Nota Quando si imposta un campo, il valore può essere troncato se supera la dimensione della regione di schermo definita dal campo.

Per estendere le funzionalità del contenitore Host On-Demand, estendere la classe della vista, com.ibm.rcp.composite.container.hod.view.HODAppView. Utilizzare il metodo getContainer per accedere all'istanza HODAppContainer. Utilizzare il metodo getECLPS per accedere allo spazio di presentazione e il metodo g etTerminal per accedere al bean terminale. Per informazioni dettagliate sulle API Host On-Demand, vedere il centro informazioni Host On-Demand.

Per i dettagli completi sull'utilizzo del contenitore, vedere la documentazione dell'Editor di applicazioni composite, di Lotus Expeditor e il centro informazioni Host On-Demand (http://publib.boulder.ibm.com/infocenter/hodhelp/v10r0/index.jsp?topic=/com.ibm.hod.doc/doc/beans/com/ibm/eNetwork/beans/HOD/Session.html).

Glossario

Guida sulla Guida

Contenuto completo della Guida

Glossario