Schritt 2: Erstellen eines Cacheabonnements

Letzte Änderung: Dienstag, 6. Juli 2010

Gilt für: SharePoint Server 2010

Eine Cacheabonnementdatei definiert, welche externen Inhaltstypen im BDC-Modell zwischengespeichert werden sollen und welche Abfragen im Modell zum Auffüllen der Daten im Cache verwendet werden sollen. Außerdem definiert die Cacheabonnementdatei, wie oft externe Elemente im Cache aktualisiert werden sollen. Sie wird als XML-Datei dargestellt, deren Name auf Subscription.xml endet und die von Microsoft Business Connectivity Services (BCS) während der Bereitstellung einer einfachen Lösung automatisch generiert wird. Für eine erweiterte codebasierte Lösung müssen Sie die Datei Subscription.xml manuell erstellen. Diese Datei hält sich an ein sehr einfaches Schema und ist problemlos zu erstellen. Das SDK macht diesen Vorgang mithilfe einer entsprechenden Vorlage sogar noch einfacher.

In diesem Szenario erstellen Sie eine Abonnementdatei für den externen Inhaltstyp Customer.

Hinweis

Die AdventureWorks-Beispieldatenbank enthält mehr als 2.000 Kunden. Deshalb werden vom Beispielwebdienst nur die ersten 1.000 Kundenzeilen zurückgegeben, damit die auf dem Client eingehende Datenmenge überschaubar und verwaltbar bleibt. Aus diesem Grund werden in diesem Szenario nur die entsprechenden Bestellungen für diese 1.000 Kunden zurückgegeben, und nicht die gesamte Bestellliste. Deshalb definieren wir in diesem Beispiel eine Abonnementzuordnung, um den Cache mit den entsprechenden Bestellungen der 1.000 Kunden aufzufüllen. Zur Leistungsverbesserung können Sie auch eine BulkAssociationNavigator-Methodeninstanz verwenden.

Voraussetzungen

Schritt 1: Erstellen des BDC-Modells

Erstellen von Cacheabonnements

Verwenden Sie eine der folgenden beiden Vorgehensweisen zum Erstellen von Cacheabonnements.

Ansatz mit Tools

Verwenden Sie das Tool zum Generieren von BCS-Artefakten zum Erstellen der erforderlichen Abonnementdateien basierend auf dem BDC-Modell.

Manueller Ansatz

1. Suchen Sie die Vorlage: "SubscriptionWithAssociation_Subscription.xml", die im SharePoint 2010 SDK enthalten ist, kopieren Sie sie, und speichern Sie sie dann im Ordner Solution Artifacts als CustomerSubscription.xml.

2. Öffnen Sie die Datei CustomerSubscription.xml zum Bearbeiten in einem XML-Editor. Wenn Sie die XML-Datei in Microsoft Visual Studio öffnen, fügen Sie das Subscription-Schema an (Subscription.xsd). Auf diese Weise steht IntelliSense-Funktionalität bereit, die verhindert, dass Sie ungültige Einträge 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.

   Hinweis
   Hierbei handelt es sich um ein sehr einfaches Abonnement. Sie können komplexere Abonnementdateien erstellen, indem Sie der Datei weitere Elemente und Eigenschaften hinzufügen. Weitere Informationen finden Sie in der Dokumentation zum Subscription-Schema.

   <?xml version="1.0" encoding="utf-8"?>
   <Subscription LobSystemInstanceName="AdventureWorksContosoLOBInstance" 
   EntityNamespace="AdventureWorksContoso" EntityName="Customer" 
   Name="AdventureWorksContosoCustomerSubscription" View="GetCustomerById" IsCached="true" 
   RefreshIntervalInMinutes="360" xmlns="https://schemas.microsoft.com/office/2006/03/BusinessDataCatalog">
     <Queries>
       <Query Name="AdventureWorksContosoCustomerQuery" MethodInstanceName="GetCustomers" 
   DefaultDisplayName="Customer Read List" RefreshIntervalInMinutes="180" IsCached="true" Enabled="true" />
     </Queries>
   </Subscription>
   

4. Speichern und schließen Sie die Datei.

Damit haben Sie das Cacheabonnement, das Sie für die erweiterte codebasierte Outlook-Lösung benötigen, erfolgreich erstellt.

Weitere Schritte

Schritt 3: Erstellen des Lösungsmanifests