Los componentes NSF son elementos de una aplicación de Lotus Notes expuestos en una aplicación compuesta. Sin modificar una aplicación de Notes existente, podrá utilizar el Editor de aplicaciones compuestas para exponer fácilmente las vistas, los formularios, los documentos y los demás elementos de la aplicación de Notes como componentes.

Nota Para ello, en primer lugar la aplicación de Notes debe contener las partes WSDL necesarias y tener activado el intermediario de propiedades. Si desea más información, consulte el tema "Uso del Editor del intermediario de propiedades en Domino Designer".

Para soportar la comunicación entre componentes, utilice las nuevas funciones de IBM® Lotus® Domino(TM) Designer con objeto de modificar la NSF y los elementos que se expondrán como componentes. La función del intermediario de propiedades incluida en IBM® Lotus® Notes® proporciona el entorno de tiempo de ejecución que da soporte a la comunicación entre componentes.

Utilice Lotus Domino Designer para crear los componentes NSF de la aplicación compuesta. Se da por supuesto que está familiarizado con la creación de bases de datos de Notes en el cliente Lotus Notes. También se da por hecho que está familiarizado con el uso versiones anteriores de Lotus Domino Designer para modificar vistas de notes, crear formularios de Notes sencillos y utilizar el panel de programación para escribir fórmulas y código LotusScript de Notes.

Para crear un componente de Notes, es necesario realizar los procedimientos siguientes:

• Determinar las propiedades que publicará el componente.
• Determinar las acciones que el componente realizará cuando se conecte con una propiedad de otro componente.
• Crear el archivo WSDL que enumera las acciones y las propiedades para el componente. Esto se hace con el Editor del intermediario de propiedades.
• Importar el archivo WSDL en la NSF donde se expondrán determinados elementos de diseño o documentos como componentes NSF. Esto se hace desde Domino Designer.
• Modificar los elementos de diseño de la NSF para vincularlos con las propiedades y las acciones que se definieron anteriormente con las funciones de Domino Designer, incluidos los métodos, las clases y las propiedades de LotusScript.

Nota Si la NSF se usará como uno o varios componentes de una aplicación compuesta alojada en WebSphere Portal, genere un archivo .WAR de portlets (módulos Web). Utilice el Editor de aplicaciones compuestas para generar los portlets. A continuación, podrá implantarla o instalarla en WebSphere Portal utilizando la interfaz de usuario del administrador de WebSphere Portal o un script xmlaccess.

Conceptos básicos de los componentes de Notes

Un componente de Notes es un vínculo a una vista, un conjunto de marcos, un documento u otro componente de diseño contenido en una base de datos de Notes. Una misma base de datos de Notes puede contener múltiples componentes, y dichos componentes pueden utilizarse en varias aplicaciones compuestas.

Todos los componentes de una misma base de datos de Notes comparten el mismo grupo de tipos, propiedades y acciones definidos en una o varias propiedades de conexiones de aplicaciones compuestas y elementos de diseño de aplicaciones. El componente no tiene que publicar todas las propiedades de salida ni implementar todas las acciones, definidas en el archivo WSDL de propiedades de la aplicación compuesta. Si desea más información, consulte los temas relacionados con el Editor del intermediario de propiedades.

Para que el componente participe en una aplicación compuesta, debe hacer referencia a propiedades y acciones del archivo WSDL de propiedades de la aplicación compuesta. Un componente puede publicar propiedades o consumirlas, o ambas cosas. Existen dos formas de publicar una propiedad de un componente:

1. Utilice la API de LotusScript que se describe a continuación. Puede hacerlo en cualquier lugar en el que se ejecute LotusScript; por ejemplo, en un agente.

2. Si el componente se una vista o una carpeta, puede asociar una columna a una propiedad de salida definida en el archivo WSDL. Esta opción se encuentra en la ficha Avanzadas del cuadro de propiedades de la columna. Dado que una columna contiene un solo valor, sólo es posible asociar a una columna propiedades con tipos "sencillos".

Nota El término "acción" se emplea en general para designar la "conexión" de un componente que consume el valor de una propiedad. El término "acción" utilizado con este sentido no debe confundirse con los botones de acción que se utilizan en las vistas y los formularios de Notes. Todos los componentes pueden tener "acciones WSDL", pero estas pueden o no ser aplicaciones de Notes.

Sólo existe un método por el que un componente de Notes puede consumir una propiedad de otro componente. El componente de Notes debe contener una "acción de Notes" que haga referencia a una "acción WSDL" que esté conectada para recibir la propiedad. Para crear una asociación entre una acción de Notes y una acción WSDL, utilice la ficha Avanzadas del cuadro de propiedades de la acción.

Cuando se produce un evento de cambio en una propiedad, si esa propiedad se ha "conectado" a una acción WSDL en el componente de Notes y si el componente de Notes contiene una acción de Notes que está asociada con esa acción WSDL, la acción de Notes se ejecutará. Normalmente, la acción de Notes utilizará las API de LotusScript que se describen a continuación para descubrir qué valor se ha publicado y hará algo con ese valor (por ejemplo, utilizarlo como clave para volver a situar la vista actual en un documento que coincida).

Una acción de Notes se ejecuta como respuesta cuando se desencadena una acción WSDL, sólo si el componente está mostrando el formulario, la vista o la página que contiene dicha acción en ese momento. Puede asociar una "acción compartida" de Notes con una acción WSDL, pero esto no hará que se ejecute en toda la aplicación; todavía tiene que poner la acción compartida en el formulario o la vista donde se supone que debe ejecutarse.

Los atributos "ocultar" de la acción de Notes no se utilizan para determinar si se ejecutará como respuesta a una acción WSDL. De hecho, todas las acciones de Notes llamadas mediante eventos de cambio de propiedades deberían estar ocultas generalmente en todo momento. Tales acciones normalmente utilizarán la API de LotusScript para leer una propiedad de entrada del intermediario de propiedades, y esto provocará un error si las activa un usuario, dado que no hay ninguna propiedad de entrada que leer en ese momento.

Puede crear componentes Lotus NSF (bases de datos, vistas, formularios etc.) para su uso en una aplicación compuesta como se explica a continuación:

• El diseño de bases de datos de Notes estándar se realiza con Domino Designer.
• Las propiedades y las acciones se definen en un archivo WSDL. El archivo WSDL debe importarse en la base de datos de Notes desde Domino Designer.
• Las nuevas API de LotusScript permiten publicar propiedades en el intermediario de propiedades y recibirlas de este. Si desea información relacionada, consulte el tema "Uso de las clases y las API de LotusScript en las aplicaciones compuestas". Por ejemplo, para implementar una nueva aplicación compuesta, pueden usarse las siguientes API de LotusScript nuevas para publicar una propiedad mediante programación:
  • NotesSession.GetPropertyBroker
  • NotesPropertyBroker.SetPropertyValue
  • NotesPropertyBroker.Publish

Esta versión incluye un gran número de propiedades, clases y métodos nuevos en las API de LotusScript. Son las siguientes:

NotesSession

• NotesSession.GetPropertyBroker( ): Da como resultado NotesPropertyBroker.

• NotesPropertyBroker.InputPropertyContext (propiedad): Da como resultado una matriz de NotesProperties de entrada. Para las versiones actuales, sólo se utilizará el primer miembro de la matriz.
• NotesPropertyBroker.Namespace (propiedad): Cadena. Proporciona el espacio de nombres predeterminado de lectura y escritura de interés para PropertyBroker.
• NotesPropertyBroker.HasProperty(Nombre): Booleano. Indica si existe una propiedad nueva.
• NotesPropertyBroker.GetProperty(Nombre): Da como resultado NotesProperty.
• NotesPropertyBroker.GetPropertyValue(Nombre): Da como resultado el valor para la propiedad especificada.
• NotesPropertyBroker.SetPropertyValue(Nombre, Valor): Da como resultado NotesProperty. Crea un objeto de fondo y lo llena con el valor. Este método genera un error si el nombre de la propiedad no está definido por el WSDL.
• NotesPropertyBroker.ClearProperty: Un nuevo método que purga cualquier propiedad nueva o modificada; no es para propiedades de entrada.
• NotesPropertyBroker.Publish: Un nuevo método que publica todas las propiedades nuevas y modificadas.

• NotesProperty.Values (propiedad): De lectura y escritura para propiedades sencillas; da como resultado una matriz Variant de tipo Cadena. Las propiedades de un solo valor contienen datos en el primer elemento de la matriz. Como entrada, acepta Variant o Array de tipo String. La matriz debe ser homogénea. En este momento, la matriz sólo puede contener una entrada de cadena. No es posible definir propiedades de entrada.
• NotesProperty.Name (propiedad): De sólo lectura. Da como resultado el nombre de la propiedad como cadena.
• NotesProperty.TypeName (propiedad): De sólo lectura. Da como resultado el nombre del tipo como cadena.
• NotesProperty.NameSpace (propiedad): De sólo lectura. Da como resultado el espacio de nombres como cadena.
• NotesProperty.Title (propiedad): De sólo lectura. Da como resultado el título como cadena.
• NotesProperty.isInput (propiedad): De sólo lectura. Da como resultado verdadero si se trata de una propiedad de entrada; de lo contrario, falso. Da como resultado un valor booleano.
• NotesProperty.Description (propiedad): De sólo lectura. Da como resultado la descripción como cadena.
• NotesProperty.Publish( ): Un nuevo método que publica esta propiedad si ha sido modificada.
• NotesProperty.Clear( ): Un nuevo método que purga esta propiedad si es nueva o ha sido modificada.

Glosario