Aktionen auf SharePoint-Standortdatensätzen

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Mit Microsoft Dynamics 365 SDK können Sie folgende Aktionen auf Microsoft SharePoint-Standortdatensätzen ausführen.

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

• Einrichten eines Standortdatensatzes als Standard.

• Zuordnen eines Dokumentenstandortdatensatzes zu einem Entitätsdatensatz

• Abruf der absoluten URL und der Websitesammlungs-URL eines Standortdatensatzes

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

Mit den Microsoft Dynamics 365 SDK-Meldungen 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 Microsoft Dynamics 365 haben. Eine Liste der unterstützten Meldungen finden Sie unter SharePointSite-Entitätsmeldungen und -methoden und SharePointDocumentLocation-Entitätmeldungen und -methoden.

Hinweis

Die Durchführung dieser Operationen auf SharePoint-Standortdatensätzen manipuliert nur die Daten in Microsoft Dynamics 365. 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 Überprüfungsstatus (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 Statusgrund für Überprüfung (sharepoint_validationstatusreason) Optionssatz definiert.

Die Speicherorte auf SharePoint Server sind hierarchisch, wo die SharePoint-Websitesammlung der Container ist, der mehrere Standorte enthalten kann; jeder dieser Standorte kann mehrere Standorte oder Dokumentenbibliotheken enthalten. Jede Dokumentbibliothek kann mehrere Dokumentenordner enthalten. Geben Sie beim Erstellen von Standortdatensätzen in Microsoft Dynamics 365den Pfad oder die URL dieser Standorte auf SharePoint Server an.

Absolute URL der SharePoint-Standortdatensä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 = "http://www.example.com",
};

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

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

' 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 = "http://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.

Hinweis

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 zur OneNote-Unterstützung finden Sie unter Integrieren von Microsoft Dynamics 365 in OneNote.

Relative URL der SharePoint-Standortdokumente

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 Microsoft Dynamics 365 die URL des übergeordneter Objekts, um die absolute URL für das untergeordnete Objekt zu ermitteln. Wenn Sie beispielsweise einen Datensatz für einen SharePointDokumentspeicherort 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);

' 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.
Dim spDocLoc As SharePointDocumentLocation =
 New SharePointDocumentLocation With {
  .Name = "Sample SharePoint Document Location",
  .Description = "Sample SharePoint Document Location record",
  .ParentSiteOrLocation = New EntityReference(SharePointSite.EntityLogicalName, _spSiteId),
  .RelativeUrl = "spdocloc",
  .RegardingObjectId = New EntityReference(Account.EntityLogicalName, _account1Id)
 }
' Set the Sample SharePoint Site created earlier as the parent site.
' Associate this document location instance with the Fourth Coffee
' sample account record.

' 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 die absolute URL des Dokumentenstandorts also http://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 Microsoft Dynamics 365) aktualisieren müssen, und alle Datensätze weiter unten in der Hierarchie weiterhin wie vorher funktionieren, da die absoluten URLs (automatisch von Microsoft Dynamics 365 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 Microsoft Dynamics 365 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.

Hinweis

Das automatische Erstellen von Dokumentenstandortdatensätzen ist nur möglich, wenn der Zielstandort ein SharePoint 2010- oder SharePoint 2013-Server ist, und Microsoft Dynamics CRM-Listenkomponente für SharePoint Server auf der Ziel-SharePoint-Websitesammlung installiert ist. Weitere Informationen zum Microsoft Dynamics CRM-Listenkomponente finden Sie in unter Microsoft Dynamics CRM list component für Microsoft SharePoint Server (möglicherweise in englischer Sprache).

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);

' 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.
Dim spDocLoc As SharePointDocumentLocation =
 New SharePointDocumentLocation With {
  .Name = "Sample SharePoint Document Location",
  .Description = "Sample SharePoint Document Location record",
  .ParentSiteOrLocation = New EntityReference(SharePointSite.EntityLogicalName, _spSiteId),
  .RelativeUrl = "spdocloc",
  .RegardingObjectId = New EntityReference(Account.EntityLogicalName, _account1Id)
 }
' Set the Sample SharePoint Site created earlier as the parent site.
' Associate this document location instance with the Fourth Coffee
' sample account record.

' 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 vorher erläutert, folgt SharePoint Server beim Speichern von Datensätzen einem hierarchischen Modell. 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:

• Der Microsoft Dynamics CRM-Listenkomponente für SharePoint Server ist auf der SharePoint-Websitesammlung auf dem Ziel-SharePoint 2010- oder SharePoint 2013-Server installiert. Weitere Informationen finden Sie unter Microsoft Dynamics CRM list component für Microsoft SharePoint Server (möglicherweise in englischer Sprache).

• Der Standortdatensatz für die übergeordnete SharePoint-Websitesammlung ist in Microsoft Dynamics 365 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());

' Retrieve the absolute URL and the Site Collection URL
' of the SharePoint document location record.
Dim retrieveRequest As RetrieveAbsoluteAndSiteCollectionUrlRequest =
 New RetrieveAbsoluteAndSiteCollectionUrlRequest With {
  .Target = New EntityReference(SharePointDocumentLocation.EntityLogicalName, _spDocLocId)
 }
Dim retriveResponse As RetrieveAbsoluteAndSiteCollectionUrlResponse =
 CType(_serviceProxy.Execute(retrieveRequest), RetrieveAbsoluteAndSiteCollectionUrlResponse)

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
RetrieveAbsoluteAndSiteCollectionUrlResponse
Integrieren Sie Microsoft Dynamics 365 in SharePoint
Erste Schritte mit SharePoint-Integration
Aktivieren der Dokumentenverwaltung für Entitäten
SharePoint-Integrationsentität
Beispiel: Aktivieren der Dokumentenverwaltung für Entitäten
Beispiel: SharePoint-Speicherortdatensatz erstellen, abrufen, aktualisieren und löschen
Beispiel: Abruf der absoluten URL und der Websitesammlungs-URL eines Ortsdatensatzes
Integrieren von Microsoft Dynamics 365 in OneNote

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright