Paso 3: creación del archivo de manifiesto de la solución (OIR.config)

  • Artículo

El archivo de manifiesto de la solución (OIR.config) es el archivo principal que el Tiempo de ejecución del cliente BCS usa para configurar la solución intermedia declarativa de Outlook.

Última modificación: lunes, 22 de agosto de 2011

Hace referencia a: SharePoint Server 2010

En el archivo OIR.config se describe la interfaz de usuario (IU), el comportamiento y la lógica de negocios asociados a los elementos externos de una solución declarativa de Outlook. Por ejemplo, en el archivo de manifiesto de la solución, puede especificar que, para un tipo de elemento de contacto de Outlook, se use una interfaz de usuario determinada (por ejemplo, una parte de datos externos) y se llame a un método específico en el sistema externo (por ejemplo, UpdateCustomerInstance(ID, NewInstanceValues) ) para actualizar un elemento si se cambia en Outlook.

El archivo de manifiesto de la solución empieza especificando el tipo de datos concreto de Outlook al que se asigna el tipo de contenido externo principal, como Contact o Task. Sin embargo, y en tanto que archivo de control central, debe realizar muchas más tareas además de definir la asignación de entidad para Outlook. También vincula a otros archivos XML, como el archivo de diseño, que se usa para definir el panel de tareas y el archivo de cinta de opciones; por lo tanto, define de forma declarativa cualquier control de cinta de opciones personalizado que la solución necesita. Además, especifica las acciones a las que se va a llamar desde la cinta de opciones. Por ejemplo, muchas soluciones tendrán un botón en la cinta de opciones que abrirá el panel de tareas. El comportamiento para abrir el panel de tareas será una acción.

Se recomienda crear un archivo de manifiesto de la solución básica con una configuración inicial mínima. Más adelante, cuando la solución básica esté en funcionamiento, podrá ampliarla para que incluya acciones y diseños. En el archivo de manifiesto de la solución básico puede hacer lo siguiente:

  • Especificar las opciones de configuración generales de la solución, como el identificador único y el nombre para mostrar de la solución.

  • Para cada tipo de contenido externo que se mostrará en una carpeta de Outlook:

    • Definir los campos del tipo de contenido externo que se deben exponer en Outlook y el modo en que deben asignarse a los campos específicos de Outlook. También se pueden especificar los campos que no sean coincidencias exactas, aunque se deben definir mediante un tipo de datos específico de Outlook que Outlook pueda reconocer (por ejemplo, Text, YesNo o DateTime). Estos campos personalizados se crean y exponen en el área del formulario en Outlook.

    • Aceptar la configuración predeterminada de área del formulario para que el Tiempo de ejecución del cliente BCS genere automáticamente un área del formulario predeterminada. Una vez que la solución básica está en funcionamiento, puede ampliarla para que incluya áreas del formulario personalizadas.

    • Especificar el nombre y otros detalles de la carpeta de Outlook que contendrá los elementos externos.

Requisitos previos

Creación de un manifiesto de la solución

Puede crear el manifiesto de la solución mediante el generador de artefactos de BCS o manualmente, con la plantilla incluida en el SDK de SharePoint 2010.

Para usar el generador de artefactos de BCS para crear el archivo de manifiesto de la solución

Para crear el archivo de manifiesto de la solución a partir del modelo BDC, descargue y ejecute el generador de artefactos de BCS. Para obtener más información, vea el tema sobre BCS Artifact Generator (generador de artefactos de BCS).

Para usar la plantilla de manifiesto de la solución para crear el archivo de manifiesto de la solución

  1. Busque la Plantilla: manifiesto de solución (Oir.config) que se proporciona en el SDK de SharePoint 2010, cópiela y, a continuación, guárdela en la carpeta Solution Artifacts como OIR.config.

  2. Abra OIR.config para editarlo en un editor XML. Si abre el archivo XML en Visual Studio, adjunte el esquema declarativo de OIR.config (SolutionManifestDefinitions.xsd y SolutionManifestDeclarativeExtensions.xsd). De esta forma, dispondrá de la funcionalidad IntelliSense y podrá crear entradas válidas. Vea la documentación de Esquema SolutionManifestDefinitions y Esquema SolutionManifestDeclarativeExtensions para obtener más información.

  3. Reemplace los valores marcados con EnterX en el XML con valores válidos. El siguiente ejemplo de XML muestra el aspecto que podría tener después de la edición.

    <?xml version="1.0" encoding="utf-8"?>
<SolutionDefinition xmlns:Declarative="https://schemas.microsoft.com/office/2009/05/BusinessApplications/Manifest/DeclarativeExtensions" 

xmlns="https://schemas.microsoft.com/office/2009/05/BusinessApplications/Manifest" xmlns:xsl="http://www.w3.org/2001/XMLSchema-instance">
  <SolutionSettings SolutionId="ContosoSalesManager" SolutionDisplayName="Contoso Sales Manager" SolutionVersion="1.0.0.0"/>
  <ContextDefinitionGroups>
    <ContextDefinitionGroup xsl:type="Declarative:DeclarativeContextDefinitionGroup" ItemType="OutlookContact" >
      <ContextDefinition xsl:type="Declarative:DeclarativeContextDefinition" ContentType="OutlookContactCustomer">
        <Entities>
          <Entity Name="Customer" EntityTypeName="Customer" EntityTypeNamespace="AWWSExample" Description="Customer">
            <View Name="PrimaryEntityNameInContext" ViewName="GetCustomerById" Description="GetCustomerById" IsPrimary="true">
              <PromotedProperty Name="CustomerId" ViewInstancePath="CustomerId" OfficeItemPropertyName="CustomerId" ReadOnly="true" />
              <PromotedProperty Name="Title" ViewInstancePath="Title" OfficeItemPropertyName="Title" ReadOnly="false" />
              <PromotedProperty Name="FirstName" ViewInstancePath="FirstName" OfficeItemPropertyName="FirstName" ReadOnly="false" />
              <PromotedProperty Name="MiddleName" ViewInstancePath="MiddleName" OfficeItemPropertyName="MiddleName" ReadOnly="false" />
              <PromotedProperty Name="LastName" ViewInstancePath="LastName" OfficeItemPropertyName="LastName" ReadOnly="false" />
              <PromotedProperty Name="Email1Address" ViewInstancePath="EmailAddress" OfficeItemPropertyName="Email1Address" ReadOnly="false" />
              <PromotedProperty Name="BusinessTelephoneNumber" ViewInstancePath="Phone" OfficeItemPropertyName="BusinessTelephoneNumber" ReadOnly="false" />
              <PromotedProperty Name="ModifiedDate" ViewInstancePath="ModifiedDate" OfficeItemPropertyName="ModifiedDate" ReadOnly="false" />
            </View>
          </Entity>
        </Entities>
        <OfficeItemCustomizations xsl:type="OutlookItemCustomizations" ItemTypeDisplayName="Contoso Customer" MessageClass="IPM.Contact.AWWSCustomer">
          <OfficeItemProperties>
            <OfficeItemProperty Name="CustomerId" PropertyName="CustomerId" PropertyType="OutlookInteger" />
            <OfficeItemProperty Name="Title" PropertyName="Title" PropertyType="OutlookText" />
            <OfficeItemProperty Name="FirstName" PropertyName="FirstName" PropertyType="OutlookText" />
            <OfficeItemProperty Name="MiddleName" PropertyName="MiddleName" PropertyType="OutlookText" />
            <OfficeItemProperty Name="LastName" PropertyName="LastName" PropertyType="OutlookText" />
            <OfficeItemProperty Name="Email1Address" PropertyName="Email1Address" PropertyType="OutlookText" />
            <OfficeItemProperty Name="BusinessTelephoneNumber" PropertyName="BusinessTelephoneNumber" PropertyType="OutlookText" />
            <OfficeItemProperty Name="ModifiedDate" PropertyName="ModifiedDate" PropertyType="OutlookDateTime" />
          </OfficeItemProperties>
          <FormRegions xsl:type="Declarative:DeclarativeFormRegions" AutoGenerate="true"></FormRegions>
          <OutlookFolder Name="ContosoCustomers" FolderDisplayName="Contoso Customers" NativeType="FolderContacts" SubscriptionName="AWWSExampleCustomerSubscription" FolderName="ContosoCustomerFolderID" CanCreate="true" CanUpdate="true" CanDelete="false">
            <Views />
            <Associations />
          </OutlookFolder>
        </OfficeItemCustomizations>
      </ContextDefinition>
    </ContextDefinitionGroup>
  </ContextDefinitionGroups>
</SolutionDefinition>

  4. Guarde y cierre el archivo.

Ha creado correctamente el archivo OIR.config básico necesario para la solución intermedia declarativa de Outlook.

Pasos siguientes

Paso 4: Empaquetar e implementar la solución de Outlook declarativa