Aktionen auf SharePoint Standortdatensätzen

Sie können die Aktionen ausführen, die in diesem Thema für Microsoft SharePoint Standortdatensätzen beschrieben werden.

Erstellen, Abrufen, Aktualisieren und Löschen von Standortdatensätzen

Mit den Nachrichten der Dynamics 365 Customer Engagement Webdienste auf den Entitäten SharePointSite und SharePointDocumentLocation können Sie Datensätze erstellen, abrufen, aktualisieren und löschen. Zur Durchführung dieser Vorgänge auf der SharePointSite-Entität müssen Sie die Systemadministratorrolle in Dynamics 365 Customer Engagement (on-premises) haben. Eine Liste der unterstützten Meldungen finden Sie unter SharePointSite Entity und SharePointDocumentLocation Entity.

Notiz

Die Durchführung dieser Operationen auf SharePoint-Standortdatensätzen manipuliert nur die Daten in Dynamics 365 Customer Engagement (on-premises). Dadurch werden keine Standorte auf dem SharePoint-Server erstellt, aktualisiert oder gelöscht.

Das SharepointSite.ValidationStatus-Attribut zeigt den Prüfungsstatus der SharePoint-Standort-URL. Die möglichen Werte für dieses Attribut sind im sharepoint_validationstatus Optionssatz definiert.

Das SharepointSite.ValidationStatusErrorCode Attribut zeigt den Grund für den Überprüfungsstatus der SharePoint Website-URL an. Die möglichen Werte für dieses Attribut sind im sharepoint_validationstatusreason Optionssatz definiert.

Die Speicherorte auf dem SharePoint-Server sind hierarchisch, wobei die SharePoint-Sitesammlung der Container ist, der mehrere Sites enthalten kann, und jede Site kann mehrere Sites oder Dokumentenbibliotheken enthalten. Jede Dokumentbibliothek kann mehrere Dokumentenordner enthalten. Geben Sie beim Erstellen von Standortdatensätzen in Dynamics 365 Customer Engagement (on-premises) den Pfad oder die URL dieser Standorte auf dem SharePoint-Server an.

Absolute URL der SharePoint-Dokumentdatensätze.

Dies ist die vollständige URL eines Speicherorts auf SharePoint. Sie können die absolute URL mit der Eigenschaft SharePointSite.AbsoluteURL oder SharePointDocumentLocation.AbsoluteURL angeben.

So erstellen Sie einen SharePointSite-Datensatz durch Angabe der absoluten URL:

// Instantiate a SharePoint site object.
// See the Entity Metadata topic in the SDK documentation to determine 
// which attributes must be set for each entity.
SharePointSite spSite = new SharePointSite
{
    Name = "Sample SharePoint Site",
    Description = "Sample SharePoint Site Location record",
    
    // TODO: Change this URL to a valid SharePoint URL.                        
    AbsoluteURL = "https://www.example.com",
};

// Create a SharePoint site record named Sample SharePoint Site.
_spSiteId = _serviceProxy.Create(spSite);

Entsprechend gilt für die Erstellung eines SharePoint-DokumentenStandortdatensatzes durch Angabe der absoluten URL:

SharePointDocumentLocation spDocLoc = new SharePointDocumentLocation  
{  
    Name = "Sample SharePoint Document Location",  
    Description = "Sample SharePoint Document Location record",  
    AbsoluteUrl = "https://www.example.com/spdocloc"     
};  
_spDocLocId = _serviceProxy.Create(spDocLoc);  

Absolute URLs werden in der Regel für die SharePoint-Standortdatensätze angegeben, da diese die Container übergeordneter Objekte sind, unter denen Sie andere Standorte für die Speicherung und Verwaltung Ihrer Dokumente erstellen möchten.

Notiz

Das SharePointDocumentLocation.LocationType-Attribut bestimmt, ob ein SharePointDocumentLocation-Datensatz auf einen SharePoint-Ordner (0) oder eine OneNote-Datei (1) zeigt. Wenn Sie eine SharePointDocumentLocation-Instanz (Datensatz) erstellen, wird der Wert des Attributs SharePointDocumentLocation.LocationType standardmäßig auf 0 festgelegt, um anzugeben, dass auf einen SharePoint-Ordner gezeigt wird. Weitere Informationen zum OneNote Support finden Sie unter Integrieren von Microsoft Dynamics 365 Customer Engagement (on-premises) mit OneNote.

Relative URL der SharePoint-Dokumentdatensätze

Dies ist der relative Standort eines Standortdatensatzes im Hinblick auf seinen übergeordneten Standortdatensatz auf dem SharePoint-Server. Wenn Sie eine relative URL für einen SharePoint-Standortdatensatz angeben, müssen Sie auch das übergeordnete Objekt angeben, unter dem er erstellt werden soll. Intern verwendet Dynamics 365 Customer Engagement (on-premises) die URL des übergeordneter Objekts, um die absolute URL für das untergeordnete Objekt zu ermitteln. Wenn Sie beispielsweise einen Datensatz für einen SharePoint Dokumentspeicherort unter dem im vorherigen Beispiel erstellten SharePoint-Standort erstellen, muss Folgendes angegeben werden:

// Instantiate a SharePoint document location object.
// See the Entity Metadata topic in the SDK documentation to determine 
// which attributes must be set for each entity.
SharePointDocumentLocation spDocLoc = new SharePointDocumentLocation
{
    Name = "Sample SharePoint Document Location",
    Description = "Sample SharePoint Document Location record",
    
    // Set the Sample SharePoint Site created earlier as the parent site.
    ParentSiteOrLocation = new EntityReference(SharePointSite.EntityLogicalName, _spSiteId),
    RelativeUrl = "spdocloc",

    // Associate this document location instance with the Fourth Coffee
    // sample account record.
    RegardingObjectId = new EntityReference(Account.EntityLogicalName, _account1Id)
};

// Create a SharePoint document location record named Sample SharePoint Document Location.
_spDocLocId = _serviceProxy.Create(spDocLoc);

Die absolute URL des untergeordneten Objekts (in diesem Beispiel der Dokumentenstandort) ist: „Parent_URL/Relative_URL”. In diesem Beispiel ist also die absolute URL des Dokumentstandorts https://www.example.com/spdocloc.

Relative URLs werden typischerweise bereitgestellt, wenn Sie einen Standort weiter unten in der Hierarchie oder als untergeordneten Datensatz erstellen möchten.

Der Vorteil der Verwendung einer relativen URL ist der, dass Sie bei der Entscheidung, Ihre Dokumente auf einem anderen SharePoint-Server zu speichern, nur die absolute URL des übergeordneten Objektstandortdatensatzes (möglicherweise einer Websitesammlung oder eines Websitedatensatzes) in Dynamics 365 Customer Engagement (on-premises) aktualisieren müssen, und alle Datensätze weiter unten in der Hierarchie weiterhin wie vorher funktionieren, da die absoluten URLs (automatisch von Dynamics 365 Customer Engagement (on-premises) bestimmt) weiterhin funktionieren. Hätten Sie absolute URLs für diese untergeordneten Standortdatensätze, müssten Sie die URLs einzeln ändern.

Einrichten eines Standortdatensatzes als Standard.

Sie können einen SharePoint-Standortdatensatz als Standard festlegen, so dass alle Dokumentenstandorte, die mit Dynamics 365 Customer Engagement (on-premises) erstellt werden, automatisch unter diesem Standort erstellt werden. Verwenden Sie dazu die Eigenschaft SharePointSite.IsDefault, und legen Sie sie auf true fest. Sie können einen Standortdatensatz beim Erstellen oder Aktualisieren eines Standortdatensatzes als Standard-Standortdatensatz festlegen.

Notiz

Die automatische Erstellung von Datensätzen für Dokumentenstandorte ist nur möglich, wenn es sich bei der Zielsite um einen SharePoint 2010 oder SharePoint 2013 Server handelt und Microsoft Dynamics CRM List Component für SharePoint Server auf der Zielsite-Sammlung SharePoint installiert ist. Weitere Informationen über die Microsoft Dynamics CRM List Component finden Sie unter Microsoft Dynamics 365 Customer Engagement (on-premises) List Component for Microsoft SharePoint Server.

Zuordnen eines Dokumentenstandortdatensatzes zu einem Entitätsdatensatz

Sie können einen Dokumentenstandortdatensatz einem Entitätsdatensatz zuordnen. Wenn Sie dies tun, werden alle Dokumente für den Entitätsdatensatz an diesem Standort auf dem SharePoint-Server gespeichert. Sie können einen SharePoint-Dokumentenstandortdatensatz mithilfe der Eigenschaft SharePointDocumentLocation.RegardingObjectId einer Entität zuordnen. Im folgenden Beispiel wird gezeigt, wie dies gemacht wird:

// Instantiate a SharePoint document location object.
// See the Entity Metadata topic in the SDK documentation to determine 
// which attributes must be set for each entity.
SharePointDocumentLocation spDocLoc = new SharePointDocumentLocation
{
    Name = "Sample SharePoint Document Location",
    Description = "Sample SharePoint Document Location record",
    
    // Set the Sample SharePoint Site created earlier as the parent site.
    ParentSiteOrLocation = new EntityReference(SharePointSite.EntityLogicalName, _spSiteId),
    RelativeUrl = "spdocloc",

    // Associate this document location instance with the Fourth Coffee
    // sample account record.
    RegardingObjectId = new EntityReference(Account.EntityLogicalName, _account1Id)
};

// Create a SharePoint document location record named Sample SharePoint Document Location.
_spDocLocId = _serviceProxy.Create(spDocLoc);

Abruf der absoluten URL und der Websitesammlungs-URL eines Standortdatensatzes

Wie bereits erläutert, folgt SharePoint Server einem hierarchischen Modell zum Speichern von Datensätzen. Wenn Sie die absolute (vollständige) URL eines Standortdatensatzes in der Hierarchie und die SiteCollection -URL erhalten möchten, unter der der Standortdatensatz vorhanden ist, können Sie dies mit der RetrieveAbsoluteAndSiteCollectionUrlRequest-Meldung tun.

Die Meldung RetrieveAbsoluteAndSiteCollectionUrlRequest funktioniert nur ordnungsgemäß, wenn beides zutrifft:

• Die Microsoft Dynamics CRM List Component für SharePoint Server wird in der SharePoint Websitesammlung auf dem SharePoint 2010 oder SharePoint 2013 Zielserver installiert. Weitere Informationen finden Sie in der Microsoft Dynamics 365 Customer Engagement (on-premises) Listenkomponente für Microsoft SharePoint Server.

• Der Standortdatensatz für die übergeordnete SharePoint-Websitesammlung ist in Dynamics 365 Customer Engagement (on-premises) vorhanden, und die Eigenschaft SharePointSite.IsGridPresent war auf true, gesetzt, während der übergeordnete Standortdatensatz erstellt wurde.

  Andernfalls erhalten Sie einen leeren oder falschen Wert für die Eigenschaft SiteCollectionUrl.

  Weitere Informationen finden Sie unter RetrieveAbsoluteAndSiteCollectionUrlRequest.

  Im folgenden Beispiel wird gezeigt, wie die Meldung RetrieveAbsoluteAndSiteCollectionUrl verwendet wird:

  
  
  // Retrieve the absolute URL and the Site Collection URL
  // of the SharePoint document location record.
  RetrieveAbsoluteAndSiteCollectionUrlRequest retrieveRequest = new RetrieveAbsoluteAndSiteCollectionUrlRequest
  {
      Target = new EntityReference(SharePointDocumentLocation.EntityLogicalName, _spDocLocId)
  };
  RetrieveAbsoluteAndSiteCollectionUrlResponse retriveResponse = (RetrieveAbsoluteAndSiteCollectionUrlResponse)_serviceProxy.Execute(retrieveRequest);
  
  Console.WriteLine("Absolute URL of document location record is '{0}'.", retriveResponse.AbsoluteUrl.ToString());
  Console.WriteLine("Site Collection URL of document location record is '{0}'.", retriveResponse.SiteCollectionUrl.ToString());
  
  

Siehe auch

RetrieveAbsoluteAndSiteCollectionUrlRequest
RetrieveAbsoluteAndSiteCollectionUrlResponseIntegrieren Sie Dynamics 365 Customer Engagement (on-premises) mit SharePoint
Einführung in die SharePoint Integration
Aktivieren der Dokumentenverwaltung für Entitäten
Beispiel: Aktivieren der Dokumentenverwaltung für Entitäten
Beispiel: Standortdatensatz erstellen, abrufen, aktualisieren und löschen (EAAL) SharePoint Standortdatensatz
Beispiel: Abruf der absoluten URL und der Websitesammlungs-URL eines Ortsdatensatzes
Integrieren Microsoft Dynamics 365 Customer Engagement (on-premises) mit OneNote