Schritt 3: Erstellen der Lösungsmanifestdatei ("OIR.config")

Artikel
09/18/2014

Die Lösungsmanifestdatei (OIR.config) wird von der BCS-Clientlaufzeit als wichtigste Datei zum Konfigurieren der anspruchsvolleren deklarativen Outlook-Lösung verwendet.

Letzte Änderung: Montag, 22. August 2011

Gilt für: SharePoint Server 2010

In der Datei OIR.config beschreiben Sie das Verhalten der Benutzeroberfläche und die Geschäftslogik, die den externen Elementen in einer deklarativen Outlook-Lösung zugeordnet ist. Sie können in der Lösungsmanifestdatei beispielsweise angeben, dass für den Outlook-Elementtyp Kontakt eine bestimmte Benutzeroberfläche verwendet werden soll (beispielsweise ein Part für externe Daten) und dass im externen System eine bestimmte Methode (beispielsweise UpdateCustomerInstance(ID, NewInstanceValues) ) aufgerufen werden soll, um ein Element zu aktualisieren, das in Outlook geändert wurde.

Die Lösungsmanifestdatei beginnt mit der Angabe des Outlook-spezifischen Datentyps, dem der primäre externe Inhaltstyp zugeordnet ist, beispielsweise Kontakt oder Aufgabe. Als zentrale Steuerungsdatei ist die Datei jedoch für erheblich mehr zuständig als nur das Definieren der Zuordnung der Entitäten zu Outlook. Die Datei enthält außerdem Verknüpfungen mit anderen XML-Dateien, beispielsweise mit der Layoutdatei, mit der der Aufgabenbereich definiert wird, und mit der Menübanddatei. So werden alle für die Lösung erforderlichen benutzerdefinierten Menübandsteuerelemente deklarativ definiert. Außerdem werden Aktionen angegeben, die über das Menüband aufgerufen werden. Viele Lösungen verfügen beispielsweise auf dem Menüband über eine Schaltfläche, mit der der Aufgabenbereich gestartet wird. Das Verhalten für das Starten des Aufgabenbereichs wäre eine Aktion.

Es wird empfohlen, die Lösungsmanifestdatei anfangs mit minimalen Einstellungen zu erstellen. Später, wenn die Basislösung funktionsfähig ist, können Sie die Lösungsmanifestdatei mit Aktionen und Layouts erweitern. In der Basislösungs-Manifestdatei können Sie folgende Schritte ausführen:

Geben Sie allgemeine Lösungseinstellungen wie den eindeutigen Bezeichner (ID) sowie einen Anzeigenamen für die Lösung an.
Führen Sie für jeden externen Inhaltstyp, der in einem Outlook-Ordner angezeigt wird, folgende Schritte aus:
- Definieren Sie jedes Feld des externen Inhaltstyps, das in Outlook angezeigt werden soll, und die Zuordnung zu den Outlook-spezifischen Feldern. Felder ohne exakte Übereinstimmung können auch angegeben werden, müssen jedoch durch einen Outlook-spezifischen Datentyp definiert werden, der von Outlook erkannt wird (beispielsweise Text, YesNo oder DateTime). Diese benutzerdefinierten Felder werden erstellt und im Formularbereich von Outlook angezeigt.
- Akzeptieren Sie die Standardeinstellungen für den Formularbereich, damit von der BCS-Clientlaufzeit automatisch ein Standardformularbereich generiert wird. Wenn die Basislösung funktionsfähig ist, können Sie als Erweiterung benutzerdefinierte Formularbereiche einschließen.
- Geben Sie den Namen und weitere Details des Outlook-Ordners an, in dem sich die externen Elemente befinden werden.

Voraussetzungen

Erstellen eines Lösungsmanifests

Sie können das Lösungsmanifest mit dem BCS Artifact Generator-Tool oder manuell mithilfe der im SharePoint 2010 SDK bereitgestellten Vorlage erstellen.

So verwenden Sie das BCS Artifact Generator-Tool zum Erstellen der Lösungsmanifestdatei

Zum Erstellen der Lösungsmanifestdatei auf der Grundlage des BDC-Modells laden Sie das BCS Artifact Generator-Tool herunter und führen das Tool aus. Weitere Informationen finden Sie unter BCS Artifact Generator-Tool.

So verwenden Sie die Lösungsmanifestvorlage zum Erstellen der Lösungsmanifestdatei

Suchen Sie die Vorlage: Lösungsmanifest (Oir.config) im SharePoint 2010 SDK, kopieren Sie die Datei, und speichern Sie diese dann im Ordner Solution Artifacts als OIR.config.
Öffnen Sie die Datei OIR.config zur Bearbeitung in einem XML-Editor. Wenn Sie die XML-Datei in Visual Studio öffnen, fügen Sie das deklarative Schema für OIR.config (SolutionManifestDefinitions.xsd und SolutionManifestDeclarativeExtensions.xsd) an. Dadurch erhalten Sie IntelliSense-Funktionalität und können gültige Einträge erstellen. Weitere Informationen finden Sie in der Dokumentation zu "SolutionManifestDefinitions"-Schema und SolutionManifestDeclarativeExtensions-Schema.

Ersetzen Sie die mit EnterX markierten Werte im XML-Code durch gültige Werte. Nachfolgend sehen Sie ein XML-Beispiel, in dem der mögliche XML-Code nach der Bearbeitung gezeigt wird.

<?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>

Speichern und schließen Sie die Datei.

Sie haben erfolgreich die Basisdatei OIR.config erstellt, die für die anspruchsvollere deklarative Outlook-Lösung benötigt wird.

Weitere Schritte

Schritt 4: Packen und Bereitstellen der deklarativen Outlook-Lösung

Freigeben über