Microsoft Project Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.

Erste Schritte

Versionsunterstützung für Microsoft Project

Der Connector ermöglicht bidirektionalen SQL-Zugriff auf Project Server und modelliert die CSOM- und OData APIs von Microsoft Project als relationale Datenbank. Der Microsoft Project Connector kann sowohl mit der Cloud- als auch mit der lokalen Version von Project Server eine Verbindung herstellen.

Herstellen einer Verbindung

Herstellen einer Verbindung mit Microsoft Project

Um eine Verbindung mit der Microsoft Project Datenquelle herzustellen, legen Sie diese Verbindungseigenschaften fest:

• URL: Eine gültige Microsoft Project Web App-URL, wie etwa http://contoso.com/sites/pwa/.
• Schema: Entweder ODataV1 oder ODataV2 (Standard). Während ODataV2 für vollständige CRUD-Operationen verwendet werden kann, ist ODataV1, das detailliertere Daten bereitstellt und benutzerdefinierte Felder verfügbar macht, für Berichtszwecke besser geeignet. Weitere Informationen zu den verfügbaren Funktionen in den einzelnen Schema, siehe Datenmodell.
• ProjectId (optional): Wenn die Schema Ist ODataV2, Sie können diese Eigenschaft verwenden, um eine Standardprojekt-ID für alle Vorgänge anzugeben, die eine solche erfordern.

Authentifizieren bei Microsoft Project

Für die Verbindung mit Microsoft Project stehen mehrere Authentifizierungsmethoden zur Verfügung, darunter SharePoint Online Cookie Service, ADFS, OAuth und SSO. Die unterstützten SSO-Identitätsanbieter sind Microsoft Entra ID, OneLogin und OKTA.

SharePoint Online-Cookie-Dienst

Um Ihre Anmeldeinformationen für die Verbindung mit Microsoft Project auf SharePoint Online zu verwenden, legen Sie das AuthScheme Zu SharePointOnlineCookies, User zu Ihrem Benutzer-Login und Password zu Ihrem Benutzeranmeldekennwort.

OAuth

Um diese Authentifizierung von allen Microsoft Project OAuth-Flows aus zu aktivieren, müssen Sie eine benutzerdefinierte OAuth-Anwendung erstellen und festlegen AuthScheme Zu OAuth.

In den folgenden Unterabschnitten wird die Authentifizierung bei Microsoft Project über drei gängige Authentifizierungsabläufe beschrieben. Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung. Eine vollständige Liste der in Microsoft Project verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Connection.

Desktop-Anwendungen

Um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-Anwendung zu authentifizieren, müssen Sie das OAuth-Zugriffstoken abrufen und aktualisieren. Danach können Sie eine Verbindung herstellen.

OAuth-Zugriffstoken abrufen und aktualisieren:

• InitiateOAuth: GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken.
• OAuthClientId: Die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret: Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• CallbackURL: Die Umleitungs-URI, die bei der Registrierung Ihrer Anwendung definiert wurde.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Microsoft Project in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen.

Nachdem Sie der Anwendung Berechtigungen erteilt haben, schließt der Connector den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von Microsoft Project und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden im in angegebenen Pfad gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Wenn das Zugriffstoken abläuft, aktualisiert der Connector es automatisch.

Automatische Aktualisierung des OAuth-Zugriffstokens:

So lässt der Connector das OAuth-Zugriffstoken automatisch aktualisieren:

1. Legen Sie vor der ersten Verbindung mit Daten diese Verbindungsparameter fest:
   • InitiateOAuth: REFRESH.
   • OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret: Das Client-Geheimnis in Ihren Anwendungseinstellungen.
   • OAuthAccessToken: Der von GetOAuthAccessToken zurückgegebene Zugriffstoken.
   • OAuthSettingsLocation: Der Pfad, in dem der Connector die OAuth-Werte speichern soll, die über Verbindungen hinweg bestehen bleiben.
2. Legen Sie bei nachfolgenden Datenverbindungen Folgendes fest:
   • InitiateOAuth
   • OAuthSettingsLocation

Manuelle Aktualisierung des OAuth-Zugriffstokens:

Der einzige Wert, der zur manuellen Aktualisierung des OAuth-Zugriffstokens benötigt wird, ist das OAuth-Aktualisierungstoken.

1. Um das OAuthAccessToken nach dem ExpiresIn-Zeitraum (zurückgegeben von GetOAuthAccessToken manuell zu aktualisieren) abgelaufen ist, rufen Sie den RefreshOAuthAccessToken gespeicherte Prozedur.
2. Legen Sie diese Verbindungseigenschaften fest:
   • OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret: Das Client Secret in Ihren Anwendungseinstellungen.
3. Rufen Sie RefreshOAuthAccessToken auf mit OAuthRefreshToken auf das von GetOAuthAccessToken zurückgegebene OAuth-Aktualisierungstoken gesetzt.
4. Nachdem die neuen Token abgerufen wurden, setzen Sie das OAuthAccessTokenEigenschaft auf den von RefreshOAuthAccessToken zurückgegebenen Wert. Dadurch wird eine neue Verbindung geöffnet.

Speichern Sie das OAuth-Aktualisierungstoken, damit Sie es verwenden können, um das OAuth-Zugriffstoken nach Ablauf manuell zu aktualisieren.

ADFS

Um eine Verbindung zu ADFS herzustellen, setzen Sie AuthScheme Zu ADFS, und legen Sie diese Eigenschaften fest:

• User: Der ADFS-Benutzer.
• Password: Das Passwort des ADFS-Benutzers.
• SSOLoginURL: Die Login URL des SSO-Anbieters.

Beispiel-Verbindungszeichenfolge:

AuthScheme=ADFS;User=username;Password=password;SSOLoginURL='https://sts.company.com';

Unterstützte SSO-Anbieter

Okta

Um eine Verbindung mit Okta herzustellen, setzen Sie die AuthScheme Zu Okta, und legen Sie diese Eigenschaften fest:

• User: Der Okta Benutzer.
• Password: Das Passwort des Okta Benutzers.
• SSOLoginURL: Die Login URL des SSO-Anbieters.

Wenn Sie eine vertrauenswürdige Anwendung oder einen Proxy verwenden, der die Okta Clientanforderung überschreibt, ODER MFA konfigurieren, müssen Sie Kombinationen aus verwenden SSOProperties zur Authentifizierung mit Okta. Legen Sie je nach Bedarf die folgenden Optionen fest:

• APIToken: Wenn Sie einen Benutzer über eine vertrauenswürdige Anwendung oder einen Proxy authentifizieren, der den Anforderungskontext des Okta Clients überschreibt, legen Sie dies auf das API Token fest, das der Kunde aus der Okta-Organisation erstellt hat.

• MFAType: Wenn Sie den MFA-Flow konfiguriert haben, legen Sie ihn auf einen der folgenden unterstützten Typen fest: OktaVerify, Email, oder SMS.

• MFAPassCode: Wenn Sie den MFA-Flow konfiguriert haben, legen Sie hier einen gültigen Passcode fest.

  Wenn Sie dies auf leer oder einen ungültigen Wert setzen, sendet der Connector eine Einmalkennwort-Abfrage an Ihr Gerät oder Email. Nachdem der Passcode empfangen wurde, öffnen Sie die Verbindung erneut, wobei der abgerufene Einmalkennwortwert auf die Verbindungseigenschaft MFAPassCode gesetzt wird.

• MFARememberDevice: True standardmäßig. Okta unterstützt das Speichern von Geräten, wenn MFA erforderlich ist. Wenn das Speichern von Geräten gemäß den konfigurierten Authentifizierungsrichtlinien zulässig ist, sendet der Connector ein Gerätetoken, um die Lebensdauer der MFA-Authentifizierung zu verlängern. Wenn Sie nicht möchten, dass MFA gespeichert wird, setzen Sie diese Variable auf False.

Beispiel-Verbindungszeichenfolge:

AuthScheme=Okta;SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46';User=oktaUserName;Password=oktaPassword;

OneLogin

Um eine Verbindung zu OneLogin herzustellen, setzen Sie das AuthScheme Zu OneLogin, und legen Sie diese Eigenschaften fest:

• User: Der OneLogin-Benutzer.
• Password: Das Passwort des OneLogin-Benutzers.

Um sich bei OneLogin zu authentifizieren, legen Sie Folgendes fest: SSOProperties:

• OAuthClientId: Die OAuthClientId, die durch Auswahl von abgerufen werden kann Developers > API Credentials > Credential > ClientId.
• OAuthClientSecret: Das OAuthClientSecret, das durch Auswahl von abgerufen werden kann Developers > API Credentials > Credential > ClientSecret.
• Subdomäne: Die Subdomäne des OneLogin-Benutzers, der auf die SSO-Anwendung zugreift. Wenn Ihre OneLogin-URL beispielsweise splinkly.onelogin.com lautet, splinkly ist der Subdomänenwert.
• AppId: Die ID der SSO-Anwendung.
• Region (optional): Die Region, in der sich Ihr OneLogin-Konto befindet. Gültige Werte sind US (Standard) oder EU.

Die folgende Beispielverbindungszeichenfolge verwendet einen API Schlüssel, um eine Verbindung mit OneLogin herzustellen:

AuthScheme=OneLogin;User=OneLoginUserName;Password=OneLoginPassword;SSOProperties='OAuthClientID=3fc8394584f153ce3b7924d9cd4f686443a52b;OAuthClientSecret=ca9257fd5cc3277abb5818cea28c06fe9b3b285d73d06;Subdomain=OneLoginSubDomain;AppId=1433920';

Microsoft Entra ID

Diese Konfiguration erfordert zwei separate Microsoft Entra ID Anwendungen:

• Die Anwendung „Microsoft Project“, die für die einmalige Anmeldung verwendet wird, und
• Eine benutzerdefinierte OAuth-Anwendung mit user_impersonation-Berechtigung für die Anwendung „Microsoft Project“. (Siehe Erstellen einer benutzerdefinierten OAuth-Anwendung.)

Um eine Verbindung mit Microsoft Entra ID herzustellen, setzen Sie das AuthScheme Zu AzureAD, und legen Sie diese Eigenschaften fest:

• OAuthClientId: Die Anwendungs-ID der Connector-Anwendung, die im Abschnitt „Übersicht“ der App-Registrierung aufgeführt ist.
• OAuthClientSecret: Der geheime Clientschlüsselwert der Connector-Anwendung. Microsoft Microsoft Entra ID zeigt dies an, wenn Sie einen neuen geheimen Clientschlüssel erstellen.
• CallbackURL: Die Umleitungs-URI der Connector-Anwendung. Beispiel: https://localhost:33333.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.

Um sich bei der Microsoft Entra ID zu authentifizieren, legen Sie diese fest: SSOProperties:

• Ressource: Die Anwendungs-ID-URI der Microsoft Project Anwendung, die im Abschnitt „Übersicht“ der App-Registrierung aufgeführt ist. In den meisten Fällen ist dies die URL Ihrer benutzerdefinierten Microsoft Project Domäne.
• AzureTenant: Die ID des Microsoft Entra ID Mandanten, bei dem die Anwendungen registriert sind.

Beispiel-Verbindungszeichenfolge:

AuthScheme=AzureAD;InitiateOAuth=GETANDREFRESH;OAuthClientId=3ea1c786-d527-4399-8c3b-2e3696ae4b48;OauthClientSecret=xxx;CallbackUrl=https://localhost:33333;SSOProperties='Resource=;AzureTenant=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';

Erstellen einer benutzerdefinierten OAuth-Anwendung

Erstellen einer benutzerdefinierten OAuth-Anwendung

Für Benutzer, die sich über OAuth authentifizieren, müssen Sie eine benutzerdefinierte OAuth-Anwendung erstellen, um die erforderlichen OAuth-spezifischen Anmeldeinformationen bereitzustellen, und dann die erforderlichen Umfangsberechtigungen für den Zugriff auf die Microsoft Project API hinzufügen.

Erstellen der Anwendung

1. Melden Sie sich über die Benutzeroberfläche Ihrer Site bei der Project Web App-Site an oder geben Sie den Link „App erstellen“ Ihrer Site in Ihren Browser ein: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/_layouts/15/appregnew.aspx.

2. Füllen Sie die erforderlichen Felder aus. Wenn Sie die Callback-URL der Anwendung angeben (eine Website-Seite, auf der Sie

   Benutzer, die landen sollen, nachdem sie Ihrer benutzerdefinierten OAuth-Anwendung die Berechtigung erteilt haben), führen Sie einen der folgenden Schritte aus:

   • Geben Sie eine sichere URL für die Seite an (sollte beginnen mit https://).
     OR
   • Angeben https://oauth.cdata.com/oauth/ als Rückruf-URL und fügen Sie dann eine zusätzliche Statusverbindungseigenschaft hinzu, die den eigentlichen Umleitungsrückruf enthält.

   Notieren Sie die ClientID und das ClientSecret zur späteren Verwendung.

Bereichsberechtigungen hinzufügen

Um auf die Microsoft Project API zugreifen zu können, müssen Sie dem neuen OAuth Berechtigungen für den Anwendungsbereich erteilen.

1. Loggen Sie sich ein unter https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/_layouts/15/AppInv.aspx.

2. Im App Id Geben Sie in das Feld die ClientID ein, die Sie beim Erstellen der Anwendung erhalten haben.

3. Klicken Sie auf Lookup. Die anderen Felder sollten automatisch mit Anwendungsdetails wie Titel, App-Domäne und Umleitungs-URL ausgefüllt werden.

4. Um die für den vollständigen API Zugriff erforderlichen Standardberechtigungen anzugeben, geben Sie den folgenden Text in das XML-Feld für die Berechtigungsanforderung ein:

     <AppPermissionRequests>
       <AppPermissionRequest Scope="http://sharepoint/projectserver" Right="Manage"/>
       <AppPermissionRequest Scope="http://sharepoint/projectserver/projects" Right="Write"/>
       <AppPermissionRequest Scope="http://sharepoint/projectserver/enterpriseresources" Right="Write"/>
       <AppPermissionRequest Scope="http://sharepoint/projectserver/reporting" Right="Read"/>
   
   </AppPermissionRequests>
   

Benutzern Zugriff auf Webdienste gewähren

Es gibt zwei verschiedene Möglichkeiten, Benutzern Zugriff auf Webdienste zu gewähren, je nachdem, ob sich Ihre Project Web Application (PWA) im Project-Berechtigungsmodus oder im SharePoint-Berechtigungsmodus befindet.

Projektberechtigungsmodus

Wenn sich Ihre PWA im Projektberechtigungsmodus befindet, können Sie Benutzern Zugriff auf Webdienste gewähren, indem Sie ihre globalen Berechtigungen bearbeiten. Gehen Sie für jeden Benutzer, den Sie hinzufügen möchten, wie folgt vor:

1. Öffnen Sie die PWA Settings Seite.
2. Klicken Sie im Abschnitt „Sicherheit“ auf Manage Users.
3. Suchen Sie den Benutzernamen des interessierten Benutzers. Klicken Sie auf seinen Namen. Die PWA zeigt ein Feld „Benutzer bearbeiten“ an.
4. Erweitern Sie den Abschnitt „Globale Berechtigungen“.
5. Unter Access Project Server Reporting Service, überprüfen Allow.

SharePoint-Berechtigungsmodus

Wenn sich Ihre PWA im SharePoint-Berechtigungsmodus befindet, können Sie Benutzern Zugriff auf Webdienste gewähren, indem Sie

sie zu einer von vier Sicherheitsgruppen hinzufügen, die mindestens Zugriff auf „Project Server Reporting Service“ haben. Gehen Sie für jeden Benutzer, den Sie hinzufügen möchten, folgendermaßen vor:

1. Öffnen Sie die PWA Settings Seite.

2. Klicken Sie im Abschnitt Sicherheit auf Manage Users.

3. Suchen Sie den Benutzernamen des interessierten Benutzers. Klicken Sie auf seinen Namen. Die PWA zeigt ein Feld „Benutzer bearbeiten“ an.

4. Wählen Sie im Abschnitt „Sicherheitsgruppen“ eine der Gruppen mit den erforderlichen Zugriffsberechtigungen aus, z. B.

   Portfolio-Betrachter, Portfolio-Manager und Administratoren.

5. Um den Benutzer hinzuzufügen, klicken Sie auf >.

CSOM-Veraltung

In der Ausgabe 2020 wurden einige Änderungen am Connector vorgenommen, die berücksichtigt werden sollten.

CSOM-Support eingestellt

Vor der 2020-Edition des Connectors wurden Verbindungen zu Microsoft Project sowohl über die CSOM- als auch über die OData Schnittstelle unterstützt, was zu Schwierigkeiten bei der gleichzeitigen Pflege der beiden Schemas führte.

Durch das Entfernen der Unterstützung für CSOM werden Verbindungen zu Microsoft Project optimiert, da keine speziellen Verbindungseigenschaften mehr speziell für jedes Schema erstellt werden. Außerdem kann die OData Schnittstelle jetzt alle CRUD-Operationen ausführen, die CSOM ausführen kann. Schließlich ist CSOM schlecht dokumentiert und fehleranfälliger als OData.

Aus diesen Gründen wurde entschieden, die Unterstützung für das CSOM einzustellen und stattdessen ausschließlich das zu unterstützen OData Schnittstelle.

Verbesserte Leistung mit OData Massenoperationen

Ein weiterer Vorteil der ausschließlichen Verwendung der Microsoft Project OData Schnittstelle ist die Unterstützung effizienter Massenvorgänge.

Microsoft Project Daten müssen ausgecheckt werden, ein INSERT/UPDATE/DELETE Operation wird ausgeführt, die Änderungen werden veröffentlicht und schließlich werden die Änderungen eingecheckt.

Manchmal kann der Checkout-Schritt fehlschlagen, was zu zahlreichen Anfragen pro einzelner INSERT/UPDATE/DELETE Operation führt.

Mit der Charge Unterstützung des Connectors können Sie die Anzahl der übermittelten Anfragen drastisch reduzieren, da mehrere Datensätze gleichzeitig über den Check-in/Check-out-Prozess übermittelt werden können.

Siehe Stapelverarbeitung

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Microsoft Project Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf Microsoft Project und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Benutzerdefinierte Ansichten

Mit dem Microsoft Project Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Projects WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Überblick

Der Microsoft Project Connector modelliert Microsoft Project Objekte als relationale Tabellen und Ansichten. Ein Microsoft Project Objekt hat Beziehungen zu anderen Objekten. In den Tabellen werden diese Beziehungen durch Fremdschlüssel ausgedrückt.

Herstellen einer Verbindung mit dem ODataV2-Schema

Das ODataV2-Datenmodell (Standard) kann für vollständige CRUD-Operationen verwendet werden. Die Metadaten der Hauptspalten werden für jede Entität dynamisch abgerufen, das Schema ist jedoch festgelegt und benutzerdefinierte Felder sind nicht enthalten.

Tabellen und Ansichten beschreibt ein Beispiel der in der ODataV2 API verfügbaren Tabellen.

Herstellen einer Verbindung mit dem ODataV1-Schema

Das ODataV1-Datenmodell kann nur zum Lesen von Daten verwendet werden. Metadaten werden dynamisch abgerufen, einschließlich der benutzerdefinierten Felder für dieses Schema.

Ansichten beschreibt ein Beispiel der in der ODataV1 API verfügbaren Ansichten.

Hauptmerkmale

• Der Connector modelliert Microsoft Project Entitäten als relationale Tabellen und Ansichten, sodass Sie SQL schreiben können, um Microsoft Project Daten Abfrage.
• Gespeicherte Prozeduren ermöglichen Ihnen, Vorgänge in Microsoft Project auszuführen.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Microsoft Project Konto bei Verwendung des Connectors sofort berücksichtigt werden.

ODataV2-Datenmodell

Das ODataV2 Schema implementiert die ProjectServer-Endpoints, die vollständige CRUD-Operationen unterstützen.

Tabellen

Tabellen werden dynamisch vom authentifizierten Microsoft Project Konto abgerufen.

Ansichten

Schreibgeschützt Ansichten werden dynamisch vom authentifizierten Microsoft Project Konto abgerufen.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Microsoft Project. Gespeicherte Prozeduren ermöglichen die Ausführung von Operationen in Microsoft Project.

Vorteile von ODataV2 im Vergleich zu ODataV1

• Unterstützt Schreibvorgänge (INSERT, UPDATE und DELETE) für die freigegebenen Tabellen.

ODataV2-Einschränkungen

• Um einige Tabellen und Ansichten Abfrage, wie z. B. Zuweisungen, Projektressourcen, TaskLinks und Aufgaben,

  die ProjectId muss entweder in den WHERE-Klauselkriterien der Abfrage oder über angegeben werden ProjectId Verbindungseigenschaft.

• Die benutzerdefinierten Felder werden nicht angezeigt.

Tabellen

Der Connector modelliert die Daten in Microsoft Project als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Microsoft Project Connector-Tabellen

Aufgaben

Aufgaben abrufen und ändern.

Tabellenspezifische Informationen

Um diese Tabelle Abfrage, muss die ProjectId entweder in den WHERE-Klauselkriterien der Abfrage oder über angegeben werden ProjectId Verbindungseigenschaft.

SELECT * FROM Assignments WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Spalten

Kalender

Kalender abrufen und ändern.

Spalten

Unternehmensressourcen

Ressourcen abrufen und ändern.

Spalten

Phasen

Projektphasen abrufen und ändern.

Spalten

ProjektRessourcen

Projektressourcen abrufen und ändern.

Tabellenspezifische Informationen

Um diese Tabelle Abfrage, muss die ProjectId entweder in den WHERE-Klauselkriterien der Abfrage oder über angegeben werden ProjectId Verbindungseigenschaft.

SELECT * FROM ProjectResources WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Spalten

Projekte

Projekte abrufen und ändern.

Spalten

Etappen

Projektphasen abrufen und ändern.

Spalten

TaskLinks

Aufgabenlinks abrufen und ändern.

Tabellenspezifische Informationen

Um diese Tabelle Abfrage, muss die ProjectId entweder in den WHERE-Klauselkriterien der Abfrage oder über angegeben werden ProjectId Verbindungseigenschaft.

SELECT * FROM TaskLinks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Spalten

Aufgaben

Aufgaben abrufen und ändern.

Tabellenspezifische Informationen

Um diese Tabelle Abfrage, muss die ProjectId entweder in den WHERE-Klauselkriterien der Abfrage oder über angegeben werden ProjectId Verbindungseigenschaft.

SELECT * FROM Tasks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Spalten

Arbeitszeittabelle

Zeitnachweise abrufen und ändern.

Spalten

Arbeitszeitnachweise

Zeitnachweise abrufen und ändern.

Spalten

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Microsoft Project Connector-Ansichten

Zuweisungsressource

Aufgaben abrufen und ändern.

Spalten

Zuweisungsaufgabe

Aufgaben abrufen und ändern.

Spalten

Veranstaltungen

Ereignisse abrufen.

Spalten

Projektdetailseiten

Projektdetails abrufen.

Spalten

StageDetailPages

Projektdetails abrufen..

Spalten

Aufgaben_Zuweisungen

Aufgaben abrufen und ändern.

Spalten

Aufgaben_Kalender

Aufgaben abrufen und ändern.

Spalten

ArbeitszeitnachweisPerioden

Zeiträume aus Arbeitszeitnachweisen abrufen.

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Microsoft Project hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Microsoft Project zurück, zusammen mit einer Angabe, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Gespeicherte Prozeduren im Microsoft Project Connector

Einchecken

Checken Sie das angegebene Projekt ein.

Eingang

Ergebnissatzspalten

Kasse

Schauen Sie sich das angegebene Projekt an.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Microsoft Project ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern den OAuthAccessToken von dieser URL an.

Eingang

Ergebnissatzspalten

GetOnlineCookies

Ruft die Cookies zur Authentifizierung mit SharePoint Online ab.

Eingang

Ergebnissatzspalten

Veröffentlichen

Veröffentlichen Sie das angegebene Projekt.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert den OAuth-Zugriffstoken, der für die Authentifizierung bei Microsoft Project verwendet wird.

Eingang

Ergebnissatzspalten

ODataV1-Datenmodell

Das ODataV1 Schema implementiert die ProjectData-Endpoints, die schreibgeschützt sind und nur für die Berichterstellung verwendet werden können.

Ansichten

Schreibgeschützt Ansichten werden dynamisch vom authentifizierten Microsoft Project Konto abgerufen.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Microsoft Project. Gespeicherte Prozeduren ermöglichen die Ausführung von Operationen in Microsoft Project.

Vorteile von ODataV1 im Vergleich zu ODataV2

• Die benutzerdefinierten Felder werden als Ansichtsspalten angezeigt.
• Die ProjectId ist nicht erforderlich, um eine der freigegebenen Ansichten Abfrage, da die ProjectData-Endpoints Daten für alle verfügbaren Projekte zurückgeben.

ODataV1-Einschränkungen

• Es werden keine Operation unterstützt, da dieses Schema schreibgeschützt ist.

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Microsoft Project Connector-Ansichten

ZuweisungsBaselines

Zuweisungsbasislinien abrufen.

Spalten

AssignmentBaselineTimephasedDataSet

Zeitphasendatensatz für die Zuweisungsbasislinie abrufen.

Spalten

Aufgaben

Aufgaben abrufen.

Spalten

ZuweisungZeitphasenDatensatz

Zeitphasendatensatz für die Zuweisung abrufen.

Spalten

GeschäftFahrerAbteilungen

Rufen Sie die Abteilungen des Business Treiber ab.

Spalten

Geschäftstreiber

Geschäftstreiber abrufen.

Spalten