Share via


Schritt 5 (optional): Erstellen des Outlook-Formularbereichs (OFS) und des Formularbereichmanifests (FormRegionManifest.xml)

Die Microsoft Outlook-Formularbereichsdatei enthält das Layout für die nicht zugeordneten Eigenschaften (Felder) aus der externen Datenquelle. Diese Formularbereichsdatei ist mit der Formularbereich-Manifestdatei gepaart, welche Informationen enthält, die Outlook zum Laden des Formularbereichs benötigt.

Letzte Änderung: Montag, 22. August 2011

Gilt für: SharePoint Server 2010

Für einfache Lösungen erstellt Microsoft Business Connectivity Services (BCS) standardmäßig einen Formularbereich zum Anzeigen der zusätzlichen nicht zugeordneten Felder aus der externen Datenquelle. Diese werden als erweiterte Business-Konnektivitätsdienste (Business Connectivity Services)-Eigenschaften im angrenzenden Formularbereich des Outlook-Inspektors angezeigt, falls maximal fünf solche Felder vorhanden sind, bzw. in einem separaten Formularbereich, falls mehr als fünf solche Felder vorhanden sind. Bei einer anspruchsvolleren deklarativen Outlook-Lösung können Sie angeben, wo die nicht zugeordneten Felder in der Formularbereich-Manifestdatei angezeigt werden sollen. In Tabelle 1 werden die unterschiedlichen Positionen beschrieben, an denen der Outlook-Formularbereich, der die nicht zugeordneten Felder enthält, in Outlook angezeigt werden kann.

Tabelle 1. Positionen des Outlook-Formularbereichs

Position des Formularbereichs

Beschreibung

Separate

Fügt den Formularbereich als neue Seite in einem Outlook-Formular hinzu.

Adjoining

Fügt den Formularbereich am Ende der Standardseite eines Outlook-Formulars an.

Replacement

Ersetzt die Standardseite des Formulars durch die angegebene Outlook-Formularspeicherdatei (OFS).

ReplaceAll

Ersetzt das Formular durch die angegebene Outlook-Formularspeicherdatei (OFS).

Falls Sie in Ihrer anspruchsvolleren deklarativen Outlook-Lösung einen benutzerdefinierten Formularbereich benötigen, erstellen Sie eine Outlook-Formularspeicherdatei (OFS), die das Layout für die nicht zugeordneten Eigenschaften (Felder) aus der externen Datenquelle enthält. Darüber hinaus müssen Sie eine Formularbereich-Manifestdatei erstellen. Diese Datei enthält Informationen, die Outlook zum Laden des Formularbereichs benötigt. Wenn Sie weitere Informationen zu den XML-Schemas für Formularbereiche wünschen, laden Sie die Office 2010-Referenz: XML-Schema für die Office Fluent-Benutzeroberfläche herunter, und lesen Sie die Abschnitte "Form Region Manifest" und "Form Region Localization Manifest".

So erstellen Sie einen Formularbereich in Outlook

  1. Klicken Sie in Outlook im Menü Datei auf Optionen. Klicken Sie auf Menüband anpassen, und aktivieren Sie unter Hauptregisterkarten das Kontrollkästchen Entwickler. Dadurch wird die Registerkarte Entwickler dem Menüband hinzugefügt.

  2. Klicken Sie auf der Registerkarte Entwickler in der Gruppe Benutzerdefinierte Formulare auf Ein Formular entwerfen. Wählen Sie anschließend ein Entwurfsformular in Abhängigkeit vom Outlook-Elementtyp aus (in diesem Fall Kontakt). Klicken Sie in der Gruppe Entwurf auf Neuer Formularbereich.

  3. Klicken Sie in der Gruppe Extras auf Steuerelement-Toolbox.

  4. Ziehen Sie im Fenster Toolbox die gewünschten Steuerelemente in den Formularbereich (beginnen Sie für dieses Beispiel mit einem Textfeld).

  5. Klicken Sie mit der rechten Maustaste auf das Steuerelement, und klicken Sie dann auf Eigenschaften.

  6. Klicken Sie im Dialogfeld Eigenschaften auf der Registerkarte Wert neben Feld auswählen auf Neu.

  7. Geben Sie im Dialogfeld Neue Spalte in das Feld Name den Namen des PropertyName-Attributs im Feld OfficeItemProperty der Lösungsmanifestdatei (OIR.config) ein, und wählen Sie den passenden Typ aus, wie z. B. Ganze Zahl oder Datum/Uhrzeit. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  8. Klicken Sie auf OK, um das Dialogfeld Eigenschaften zu schließen.

  9. Fügen Sie alle anderen gewünschten Eigenschaften auf dieselbe Weise hinzu.

  10. Bei Bedarf können Sie Beschriftungen hinzufügen bzw. ändern oder den Formularentwurf ändern.

  11. Klicken Sie in der Gruppe Entwurf auf Formularbereich und dann auf Formularbereich speichern unter. Benennen Sie den Formularbereich formRegionCustomer.ofs, und speichern Sie ihn im Ordner Solution Artifacts.

  12. Erstellen Sie im nächsten Schritt die Formularbereich-Manifestdatei. Sie können das BCS Artifact Generator-Tool zum Erstellen der Formularbereich-Manifestdatei basierend auf dem BDC-Modell verwenden.

    Alternativ können Sie das Formularbereichmanifest wie folgt manuell erstellen.

    1. Kopieren Sie die im SharePoint 2010 SDK bereitgestellte Vorlagendatei (siehe Vorlage: "FormRegionManifest.xml"), und speichern Sie sie im Ordner Solution Artifacts unter dem Namen formRegionCustomer.manifest.xml.

    2. Öffnen Sie die Datei formRegionCustomer.manifest.xml zum Bearbeiten in einem XML-Editor. Wenn Sie die XML-Datei in Visual Studio öffnen, fügen Sie das FormManifest-Schema an. Auf diese Weise steht IntelliSense-Funktionalität bereit, die Ihnen hilft, gültige Einträge zu erstellen.

    3. Ersetzen Sie die mit EnterX markierten Werte im XML-Code durch gültige Werte. Das folgende XML-Beispiel zeigt, wie die Datei nach der Bearbeitung aussehen könnte.

      <?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>
      
    4. Speichern und schließen Sie die Datei.

  13. Nun können Sie die Datei OIR.config mit den Details zum benutzerdefinierten Formularbereich aktualisieren. Beachten Sie, dass die BCS-Clientlaufzeit anhand dieses Felds die Komponenten in einer deklarativen Lösung bestimmt. Suchen Sie dazu das <FormRegions>-Elemente, und ersetzen Sie es durch Folgendes.

    <FormRegions xsl:type="Declarative:DeclarativeFormRegions">
      <FormRegion Name="Customer" InternalName="CustomerForm" 
                  FormFileName="formRegionCustomer.ofs" 
                  ManifestFileName="formRegionCustomer.manifest.xml" />
    </FormRegions>
    
  14. Speichern und schließen Sie die Datei.

Damit haben Sie erfolgreich einen benutzerdefinierten Formularbereich und eine Formularbereich-Manifestdatei erstellt, um Ihre anspruchsvollere deklarative Outlook-Lösung zu erweitern, und haben die Datei OIR.config mit diesen Informationen aktualisiert. Sie sollten die Lösung nun erneut packen, in Outlook bereitstellen und anschließend testen, um sicherzustellen, dass sie erwartungsgemäß ausgeführt wird.

Weitere Schritte

Schritt 6 (Optional): Erstellen benutzerdefinierter Outlook-Ansichtsdefinitionen (OVD)