Paso 5 (opcional): creación del área del formulario de Outlook (*.ofs) y el manifiesto del área de formulario (FormRegionManifest.xml)
El archivo de área del formulario de Microsoft Outlook contiene el diseño de las propiedades (campos) sin asignar del origen de datos externo. Este archivo de área del formulario se corresponde con el archivo de manifiesto de área de formulario, que contiene la información que Outlook requiere para cargar el área del formulario.
Última modificación: lunes, 22 de agosto de 2011
Hace referencia a: SharePoint Server 2010
En las soluciones más básicas, Servicios de conectividad empresarial (BCS) de Microsoft crea de manera predeterminada un área del formulario para mostrar los campos adicionales sin asignar del origen de datos externo. Estos campos se muestran como propiedades extendidas de Servicios de conectividad empresarial en el área del formulario adyacente del inspector de Outlook si el número de estos campos es igual o inferior a cinco, mientras que, si es superior a cinco, los muestra en un área del formulario independiente. En una solución declarativa intermedia de Outlook, puede especificar dónde desea que se muestren los campos sin asignar en el archivo de manifiesto de área de formulario. En la tabla 1 se describen las distintas ubicaciones de Outlook en las que puede aparecer el área del formulario de Outlook, que contiene campos sin asignar.
Tabla 1. Ubicaciones del área del formulario de Outlook
Ubicación del área del formulario |
Descripción |
|---|---|
Separate |
Agrega el área del formulario como una página nueva en un formulario de Outlook. |
Adjoining |
Anexa el área del formulario a la parte inferior de la página predeterminada de un formulario de Outlook. |
Replacement |
Reemplaza la página predeterminada del formulario por el archivo de almacenamiento de formularios de Outlook (.ofs) especificado. |
ReplaceAll |
Reemplaza el formulario por el archivo de almacenamiento de formularios de Outlook (.ofs) especificado. |
Si necesita un área del formulario personalizada en la solución declarativa intermedia de Outlook, cree un archivo de almacenamiento de formularios de Outlook (*.ofs) que contenga el diseño de las propiedades (campos) sin asignar del origen de datos externo. También debe crear un archivo de manifiesto de área de formulario. Éste contiene la información que Outlook necesita para cargar el área del formulario. Para obtener más información acerca de los esquemas XML relativos a las áreas del formulario, descargue la referencia de Office 2010: esquema XML de interfaz de usuario de Office Fluent y vea las secciones sobre el manifiesto de área de formulario y el manifiesto de localización de área del formulario.
Para crear un área del formulario de Outlook
En el menú Archivo de Outlook, haga clic en Opciones, seleccione Personalizar cinta de opciones y, a continuación, en Fichas principales, active la casilla Programador. Se agregará la ficha Programador a la cinta de opciones.
En el grupo Formularios personalizados deesta ficha, haga clic en Diseñar un formulario. A continuación, seleccione un formulario de diseño en función del tipo de elemento de Outlook (Contacto, en este caso). En el grupo Diseño, haga clic en Nueva área del formulario.
En el grupo Herramientas, haga clic en Cuadro de controles.
En la ventana Herramientas, arrastre los controles que desee al área del formulario (en este ejemplo, comience con un cuadro de texto).
Haga clic con el botón secundario en el control y, a continuación, haga clic en Propiedades.
En la ficha Valor del cuadro de diálogo Propiedades, junto a Elegir campo, haga clic en Nuevo.
En el campo Nombre del cuadro de diálogo Nueva columna, escriba el nombre del atributo PropertyName en el campo OfficeItemProperty del manifiesto de la solución (OIR.config) y elija el tipo correspondiente, por ejemplo, Entero o Fecha y hora. Haga clic en Aceptar para cerrar el cuadro de diálogo.
Haga clic en Aceptar para cerrar el cuadro de diálogo Propiedades.
Agregue el resto de propiedades que desee de la misma manera.
Agregue o modifique etiquetas o el diseño del formulario como desee.
En el grupo Diseño, haga clic en Área del formulario y, a continuación, haga clic en Guardar área del formulario como. Asigne el nombre formRegionCustomer.ofs al área del formulario y guárdela en la carpeta Solution Artifacts.
A continuación, cree el archivo de manifiesto de área de formulario. Puede usar el BCS Artifact Generator (generador de artefactos de BCS) para crear el archivo de manifiesto de área de formulario basado en el modelo BDC.
Como alternativa, puede crear el manifiesto del área de formulario de forma manual, como se indica a continuación.
Copie el archivo de plantilla que se proporciona en el SDK de SharePoint 2010 (vea Plantilla: FormRegionManifest.xml) y, a continuación, guárdelo en la carpeta Solution Artifacts como formRegionCustomer.manifest.xml.
Abra formRegionCustomer.manifest.xml para editarlo en un editor XML. Si va a abrir el archivo XML en Visual Studio, adjunte el esquema FormManifest que le proporcionará funcionalidad IntelliSense y le ayudará a crear entradas válidas.
Reemplace los valores marcados con EnterX en el elemento XML con valores válidos. El siguiente ejemplo de XML muestra cómo se podría ver el archivo después de modificarlo.
<?xml version="1.0" encoding="utf-8"?> <FormRegion xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="https://schemas.microsoft.com/office/outlook/12/formregion.xsd"> <icons> <page>addin</page> </icons> <name>CustomerForm</name> <formRegionType>adjoining</formRegionType> <exactMessageClass>false</exactMessageClass> <layoutFile>formRegionCustomer.ofs</layoutFile> <title>Customer Details</title> </FormRegion>Guarde y cierre el archivo.
Ya está preparado para actualizar el archivo OIR.config con los detalles sobre el área del formulario personalizada. Recuerde que el Tiempo de ejecución del cliente BCS usará este archivo para determinar cuáles son los componentes de una solución declarativa. Para ello, busque el elemento <FormRegions> y reemplácelo por lo siguiente.
<FormRegions xsl:type="Declarative:DeclarativeFormRegions"> <FormRegion Name="Customer" InternalName="CustomerForm" FormFileName="formRegionCustomer.ofs" ManifestFileName="formRegionCustomer.manifest.xml" /> </FormRegions>Guarde y cierre el archivo.
Ha creado correctamente un área del formulario personalizada y un archivo de manifiesto de área de formulario para ampliar la solución declarativa intermedia de Outlook; además, ha actualizado el archivo OIR.config con esta información. Ahora deberá volver a empaquetar la solución, implementarla en Outlook y probarla para asegurarse de que funciona según lo previsto.
Pasos siguientes
Paso 6 (opcional): creación de definiciones de vistas de Outlook personalizadas (*.ovd)