Erstellen Sie Serviceinstanzen und Serviceschlüssel in SAP Globaler Account der Business Technology Platform (BTP), der zugelassen werden soll SAP DMS-Connector für externe Inhalte für den Zugriff auf SAP DMS-Dokumente und Repositorys.
Vorbereitungen
Sie müssen ein globaler Account-Administrator auf sein SAP BTP. Ihr globaler Account muss für den Zugriff auf autorisiert sein SAP Dokumentverwaltungsservice.
A
SAP Der globale Account-Administrator muss einen Unteraccount in erstellt haben
SAP Globaler BTP-Account mit diesen Berechtigungen:
- Dokumentverwaltungsservice, Anwendungsoption
- Dokumentverwaltungsservice, Integrationsoption
- Dokumentverwaltungsservice, Repository-Option
- Cloud-Foundry-Umgebung
- Autorisierungs- und Vertrauensverwaltungsservice
Wenn Sie noch kein Unterkonto mit diesen Berechtigungen in haben
SAP BTP für globalen Account, führen Sie aus
Erstellen Sie einen Unteraccount in SAP Geschäftstechnologie-Plattform (BTP) Vorläufige Aufgabe, bevor diese Aufgabe ausgeführt wird.
Erforderliche Rolle: keine
Warum und wann dieser Vorgang ausgeführt wird
Die SAP Der DMS-Connector für externe Inhalte ruft Dokumente aus Repositorys in ab SAP DMS-Quellsystem, das die REST-API für Dokumentverwaltungsservice, Integrationsoption verwendet.
Damit der Connector auf zugreifen kann SAP DMS-Quellsystem über diese API müssen Sie Serviceinstanzen und Serviceschlüssel in konfigurieren SAP DMS-Geschäftstechnologie-Plattform (BTP). Ihr Connector der administrator kann Einstellungen verwenden, die aus Ihren neuen Serviceschlüssel kopiert wurden, um zu konfigurieren SAP Externer DMS-Connector für eine ordnungsgemäße Verbindung mit Ihrem Quellsystem.
Prozedur
-
Erstellen Sie eine Serviceinstanz für die Option „Dokumentverwaltungsservice, Anwendung“ in Ihrem Unterkonto.
-
Melden Sie sich bei an SAP Business Technology Platform (BTP) unter https://cockpit.btp.cloud.sap/ Verwenden Sie Ihre globalen Account-Anmeldeinformationen.
-
Wählen Sie auf der Registerkarte Unterkonten Ihr Unterkonto aus.
-
Navigieren zu an.
-
Suchen Sie nach, und wählen Sie aus Dokumentverwaltungsservice, Anwendungsoption Eintrag.
-
Wählen Sie Erstellen aus.
-
Füllen Sie im Formular „neue Instanz“ oder „Abonnement“ die Felder aus.
| Feld |
Beschreibung |
| Planen |
Wählen Sie Aus Standard , Wählen Sie dann die Haftungsausschlussoption aus. |
| Laufzeitumgebung |
Wählen Sie Aus Cloud-Gießerei . |
| Bereich |
Geben Sie den Namen des Cloud Foundry-Bereichs ein, den Sie für Ihr Unterkonto erstellt haben. Wenn Sie die Schritte zur Erstellung von Unterkonten von ausgeführt haben Erstellen Sie einen Unteraccount in SAP Geschäftstechnologie-Plattform (BTP), Dieser Name ist DMS . |
| Instanzname |
Geben Sie einen Namen Ihrer Wahl ein. Beispiel: Geben Sie ein DMS-AO . |
-
Wählen Sie Erstellen aus.
SAP BTP erstellt die Serviceinstanz „Dokumentverwaltungsservice“ und „Anwendungsoption“ in Ihrem Unterkonto.
-
Erstellen Sie einen Serviceschlüssel für Ihre neue Instanz des Dokumentverwaltungsservice, der Anwendungsoption.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Wählen Sie auf der Registerkarte Abonnements in der Zeile für Ihren neuen Dokumentverwaltungsservice, Anwendungsoption-Serviceinstanz aus an.
-
Geben Sie im Formular „neuer Serviceschlüssel“ einen Namen für Ihren neuen Serviceschlüssel ein.
Beispiel: Geben Sie ein DMS-AO .
-
Wählen Sie Erstellen aus.
SAP BTP erstellt den Serviceschlüssel für Dokumentverwaltungsservice und Anwendungsoption in Ihrem Unterkonto.
-
Erstellen Sie eine Serviceinstanz für den Dokumentverwaltungsservice, die Integrationsoption in Ihrem Unteraccount.
-
Melden Sie sich bei an SAP Business Technology Platform (BTP) unter https://cockpit.btp.cloud.sap/ Verwenden Sie Ihre globalen Account-Anmeldeinformationen.
-
Wählen Sie auf der Registerkarte Unterkonten Ihr Unterkonto aus.
-
Navigieren zu an.
-
Suchen Sie nach, und wählen Sie aus Dokumentverwaltungsservice, Integrationsoption Eintrag.
-
Wählen Sie Erstellen aus.
-
Füllen Sie im Formular „neue Instanz“ oder „Abonnement“ die Felder aus.
| Feld |
Beschreibung |
| Planen |
Wählen Sie Aus Standard , Wählen Sie dann die Haftungsausschlussoption aus. |
| Laufzeitumgebung |
Wählen Sie Aus Cloud-Gießerei . |
| Bereich |
Geben Sie den Namen des Cloud Foundry-Bereichs ein, den Sie für Ihr Unterkonto erstellt haben. Wenn Sie die Schritte zur Erstellung von Unterkonten von ausgeführt haben Erstellen Sie einen Unteraccount in SAP Geschäftstechnologie-Plattform (BTP), Dieser Name ist DMS . |
| Instanzname |
Geben Sie einen Namen Ihrer Wahl ein. Beispiel: Geben Sie ein DMS-IO . |
-
Wählen Sie Erstellen aus.
SAP BTP erstellt die Serviceinstanz „Dokumentverwaltungsservice“ und „Integrationsoption“ in Ihrem Unteraccount.
-
Erstellen Sie einen Serviceschlüssel für Ihre neue Instanz des Dokumentverwaltungsservice und der Integrationsoption, und kopieren Sie die Clienteinstellungen und die API-URL.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Wählen Sie auf der Registerkarte Abonnements in der Zeile für Ihren neuen Dokumentverwaltungsservice, Integrationsoption-Serviceinstanz aus an.
-
Geben Sie im Formular „neuer Serviceschlüssel“ einen Namen für Ihren neuen Serviceschlüssel ein.
Beispiel: Geben Sie ein DMS-IO .
-
Wählen Sie Erstellen aus.
SAP BTP erstellt den Serviceschlüssel für Dokumentverwaltungsservice und Integrationsoption in Ihrem Unteraccount.
-
Zeigen Sie im Abschnitt Serviceschlüssel Ihren neuen Serviceschlüssel an, indem Sie auswählen In seinem Eintrag.
-
Kopieren Sie im Formular „Anmeldeinformationen“ clientid , Clientgeheim , Und URL Werte aus uaa Schneiden Sie ab, und speichern Sie sie an einem sicheren Ort.
Wichtig: Ihr Administrator des Connectors für externe Inhalte benötigt diese Client-Einstellungswerte, wenn Sie konfigurieren SAP Connector für externe DMS-Inhalte.
-
Kopieren Sie im Formular „Anmeldeinformationen“ URL Feldwert aus dem ecmservice-Eintrag des Abschnitts „Endpunkte“, und speichern Sie ihn an einem sicheren Ort.
Wichtig: Ihr Administrator des Connectors für externe Inhalte benötigt diese Endpunkt-URL, wenn Sie konfigurieren SAP Connector für externe DMS-Inhalte.
-
Kopieren Sie im Formular „Anmeldeinformationen“ Apiurl Feldwert und an einem sicheren Ort speichern.
Wichtig: Ihr Administrator des Connectors für externe Inhalte benötigt diese Endpunkt-URL für Rollensammlungen, wenn Sie konfigurieren SAP Connector für externe DMS-Inhalte.
-
Kopieren Sie im Formular „Anmeldeinformationen“ den Teil von Xsappname Feldwert, der nach dem Pipe |-Symbol angezeigt wird, und an einem sicheren Ort speichern.
Beispiel: Wenn Xsappname Feldwert ist 673dc63a-f785-4225-b974-de10815701fc!b23581|sdm-di-DocumentManagement-sdm_Integration!b62497 , Der Teil des zu kopierenden Werts ist sdm-di-DocumentManagement-sdm_Integration!b62497 .
-
Erstellen Sie eine Serviceinstanz für die Option „Dokumentverwaltungsservice, Repository“ in Ihrem Unteraccount.
-
Melden Sie sich bei an SAP Business Technology Platform (BTP) unter https://cockpit.btp.cloud.sap/ Verwenden Sie Ihre globalen Account-Anmeldeinformationen.
-
Wählen Sie auf der Registerkarte Unterkonten Ihr Unterkonto aus.
-
Navigieren zu an.
-
Suchen Sie nach, und wählen Sie aus Dokumentverwaltungsservice, Repository-Option Eintrag.
-
Wählen Sie Erstellen aus.
-
Füllen Sie im Formular „neue Instanz“ oder „Abonnement“ die Felder aus.
| Feld |
Beschreibung |
| Planen |
Wählen Sie Aus Standard , Wählen Sie dann die Haftungsausschlussoption aus. |
| Laufzeitumgebung |
Wählen Sie Aus Cloud-Gießerei . |
| Bereich |
Geben Sie den Namen des Cloud Foundry-Bereichs ein, den Sie für Ihr Unterkonto erstellt haben. Wenn Sie die Schritte zur Erstellung von Unterkonten von ausgeführt haben Erstellen Sie einen Unteraccount in SAP Geschäftstechnologie-Plattform (BTP), Dieser Name ist DMS . |
| Instanzname |
Geben Sie einen Namen Ihrer Wahl ein. Beispiel: Geben Sie ein DMS-RO . |
-
Wählen Sie Erstellen aus.
SAP BTP erstellt die Serviceinstanz „Dokumentverwaltungsservice“ und „Repository-Option“ in Ihrem Unteraccount.
-
Erstellen Sie einen Serviceschlüssel für Ihre neue Instanz des Dokumentverwaltungsservice, der Repository-Option.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Wählen Sie auf der Registerkarte Abonnements in der Zeile für Ihren neuen Dokumentverwaltungsservice, die Serviceinstanz der Repository-Option aus an.
-
Geben Sie im Formular „neuer Serviceschlüssel“ einen Namen für Ihren neuen Serviceschlüssel ein.
Beispiel: Geben Sie ein DMS-RO .
-
Wählen Sie Erstellen aus.
SAP BTP erstellt den Serviceschlüssel für Dokumentverwaltungsservice, Repository-Option in Ihrem Unteraccount.
-
Erstellen Sie eine Serviceinstanz für den Autorisierungs- und Vertrauensverwaltungsservice in Ihrem Unterkonto.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Suchen Sie nach, und wählen Sie aus Autorisierungs- und Vertrauensverwaltungsservice Eintrag.
-
Wählen Sie Erstellen aus.
-
Füllen Sie im Formular „neue Instanz“ oder „Abonnement“ die Felder aus.
| Feld |
Beschreibung |
| Planen |
Wählen Sie Aus ApiAccess . |
| Laufzeitumgebung |
Wählen Sie Aus Cloud-Gießerei . |
| Bereich |
Geben Sie den Namen des Cloud Foundry-Bereichs ein, den Sie für Ihr Unterkonto erstellt haben. Wenn Sie die Schritte zur Erstellung von Unterkonten von ausgeführt haben Erstellen Sie einen Unteraccount in SAP Geschäftstechnologie-Plattform (BTP), Dieser Name ist DMS . |
| Instanzname |
Geben Sie einen Namen Ihrer Wahl ein. Beispiel: Geben Sie ein GELDAUTOMATEN . |
-
Wählen Sie Weiter.
-
Fügen Sie im Formular „neue Instanz“ oder „Abonnement“ den folgenden JSON-Code in das Texteingabefeld „Instanzparameter konfigurieren“ ein und ersetzen Sie ihn <instance-name> Mit dem Namen von ServiceNow AI Platform Instanz.
{
"xsappname": "dms-servicenow-client",
"tenant-mode": "dedicated",
"description": "XSUAA config for DMS API access via IAS",
"oauth2-configuration": {
"redirect-uris": [
"https://<instance-name>.service-now.com/oauth_redirect.do"
],
"grant-types": [
"authorization_code",
"client_credentials",
"password",
"refresh_token"
]
},
"scopes": [
{
"name": "$XSAPPNAME.DMSViewer",
"description": "Read-only access to DMS repositories"
},
{
"name": "$XSAPPNAME.DMSContributor",
"description": "Create and modify documents in DMS"
},
{
"name": "$XSAPPNAME.DMSAdministrator",
"description": "Full administrative access to DMS"
}
],
"role-templates": [
{
"name": "DMSViewerRole",
"description": "Role for viewing DMS documents",
"scope-references": [
"$XSAPPNAME.DMSViewer"
]
},
{
"name": "DMSContributorRole",
"description": "Role for contributing documents",
"scope-references": [
"$XSAPPNAME.DMSContributor"
]
},
{
"name": "DMSAdministratorRole",
"description": "Role for administering DMS",
"scope-references": [
"$XSAPPNAME.DMSAdministrator"
]
}
],
"authorities": [
"$XSAPPNAME.DMSViewer",
"$XSAPPNAME.DMSContributor",
"$XSAPPNAME.DMSAdministrator"
]
}
-
Wählen Sie Erstellen aus.
SAP BTP erstellt die Serviceinstanz für den Autorisierungs- und Vertrauensverwaltungsservice in Ihrem Unterkonto.
-
Erstellen Sie einen Serviceschlüssel für Ihre neue Instanz des Autorisierungs- und Vertrauensverwaltungsservice.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Wählen Sie auf der Registerkarte Abonnements in der Zeile für Ihre neue Instanz des Autorisierungs- und Vertrauensverwaltungsservice die Option aus an.
-
Geben Sie im Formular „neuer Serviceschlüssel“ einen Namen für Ihren neuen Serviceschlüssel ein.
Beispiel: Geben Sie ein GELDAUTOMATEN .
-
Wählen Sie Erstellen aus.
SAP BTP erstellt den Serviceschlüssel für den Autorisierungs- und Vertrauensverwaltungsservice in Ihrem Unterkonto.
-
Zeigen Sie im Abschnitt Serviceschlüssel Ihren neuen Serviceschlüssel an, indem Sie auswählen In seinem Eintrag.
-
Kopieren Sie im Formular „Anmeldeinformationen“ clientid , Clientgeheim , Und URL Werte aus dem Abschnitt „Serviceschlüssel“ und speichern Sie sie an einem sicheren Ort.
Wichtig: Ihr Administrator des Connectors für externe Inhalte benötigt diese Client-Einstellungswerte, wenn Sie konfigurieren SAP Connector für externe DMS-Inhalte.
-
Erstellen Sie eine neue Instanz für den Autorisierungs- und Vertrauensverwaltungsservice mit dem Anwendungsplan in Ihrem SAP BTP-Unteraccount.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Wählen Sie Erstellen aus.
-
Füllen Sie auf der Seite „Basisinformationen“ des Formulars „neue Instanz“ oder „Abonnement“ die Felder aus.
| Feld |
Beschreibung |
| Service |
Wählen Sie Aus Autorisierungs- und Vertrauensverwaltungsservice . |
| Planen |
Wählen Sie Aus Anwendung . |
| Laufzeitumgebung |
Wählen Sie Aus Cloud-Gießerei . |
| Bereich |
Wählen Sie Aus DMS . |
| Instanzname |
Geben Sie einen eindeutigen Namen für diese Serviceinstanz ein. |
-
Wählen Sie Weiter.
-
Fügen Sie auf der Seite „Parameter“ des Formulars „neue Instanz“ oder „Abonnement“ den folgenden JSON-Code in das Texteingabefeld „Instanzparameter konfigurieren“ ein und ersetzen Sie ihn <service-name> Mit dem Namen, den Sie für die neue Instanz des Autorisierungs- und Vertrauensverwaltungsservice mit dem Anwendungsplan in Schritt eingegeben haben 9.c, <instance-name> Mit dem Namen von ServiceNow AI Platform Instanz, und <xsappname> Mit Xsappname Teilzeichenfolge, die Sie in Schritt kopiert haben 4.i.
{
"xsappname": "<service-name>",
"tenant-mode": "dedicated",
"description": "XSUAA config for DMS API access via IAS",
"oauth2-configuration": {
"redirect-uris": [
"https://<instance-name>.service-now.com/oauth_redirect.do"
],
"grant-types": [
"authorization_code",
"client_credentials",
"password",
"refresh_token"
]
},
"scopes": [
{
"name": "$XSAPPNAME.DMSViewer",
"description": "Read-only access to DMS repositories"
},
{
"name": "$XSAPPNAME.DMSContributor",
"description": "Create and modify documents in DMS"
},
{
"name": "$XSAPPNAME.DMSAdministrator",
"description": "Full administrative access to DMS"
}
],
"role-templates": [
{
"name": "DMSViewerRole",
"description": "Role for viewing DMS documents",
"scope-references": [
"$XSAPPNAME.DMSViewer"
]
},
{
"name": "DMSContributorRole",
"description": "Role for contributing documents",
"scope-references": [
"$XSAPPNAME.DMSContributor"
]
},
{
"name": "DMSAdministratorRole",
"description": "Role for administering DMS",
"scope-references": [
"$XSAPPNAME.DMSAdministrator"
]
}
],
"authorities": [
"$ACCEPT_GRANTED_AUTHORITIES",
"<xsappname>.sdmadmin",
"<xsappname>.sdmbusinessadmin"
],
"foreign-scope-references": [
"<xsappname>.sdmuser",
"<xsappname>.sdmadmin",
"<xsappname>.sdmbusinessadmin"
]
}
-
Wählen Sie Erstellen aus.
SAP BTP erstellt die Serviceinstanz für den Autorisierungs- und Vertrauensverwaltungsservice mit dem Anwendungsplan in Ihrem Unteraccount.
-
Erstellen Sie einen Serviceschlüssel für Ihre neue Instanz des Autorisierungs- und Vertrauensverwaltungsservice mit dem Anwendungsplan.
-
Navigieren Sie in Ihrem Unterkonto zu an.
-
Wählen Sie auf der Registerkarte Abonnements in der Zeile für Ihre neue Instanz des Autorisierungs- und Vertrauensverwaltungsservice mit dem Anwendungsplan aus an.
-
Geben Sie im Formular „neuer Serviceschlüssel“ einen Namen für Ihren neuen Serviceschlüssel ein.
Beispiel: Geben Sie ein GELDAUTOMATEN-App-Plan .
-
Wählen Sie Erstellen aus.
SAP BTP erstellt den Serviceschlüssel für die Serviceinstanz für Autorisierungs- und Vertrauensmanagement mit dem Anwendungsplan in Ihrem Unteraccount.
-
Zeigen Sie im Abschnitt Serviceschlüssel Ihren neuen Serviceschlüssel an, indem Sie auswählen In seinem Eintrag.
-
Kopieren Sie im Formular „Anmeldeinformationen“ clientid Und Clientgeheim Werte aus dem Abschnitt „Serviceschlüssel“ und speichern Sie sie an einem sicheren Ort.
Wichtig: Ihr Administrator des Connectors für externe Inhalte benötigt diese Client-Einstellungswerte, wenn Sie konfigurieren SAP Connector für externe DMS-Inhalte.
-
Kopieren Sie die Basis-Web-URL für Dokumente in SAP DMS-Mandant.
-
Melden Sie sich bei an SAP DMS-Mandant mit Ihren globalen Account-Anmeldeinformationen.
-
Navigieren Sie zu einem Repository Ihrer Wahl.
-
Navigieren Sie im Repository zu einem Ordner Ihrer Wahl, der mindestens ein Dokument enthält.
-
Wählen Sie Aus … Wählen Sie in einem beliebigen Dokumenteintrag die Option aus Eigenschaften anzeigen Aus dem Kontextmenü.
-
Kopieren Sie Weblink Extrahieren Sie für das Dokument dann die Basis-Web-URL, und speichern Sie sie an einem sicheren Ort.
Die Basis-Web-URL ist der Teil von Weblink URL, die mit endet /Offen . Beispiel: Wenn Weblink URL ist https://example.sap.com/cp.portal/site#user-display?sap-ui-app-id-hint=com.sap.ecm.sdm.user&/documents/v1/open/rep=ABCDE&obj=12345&vs=1 , Die Basis-Web-URL ist https://example.sap.com/cp.portal/site#user-display?sap-ui-app-id-hint=com.sap.ecm.sdm.user&/documents/v1/open .
Wichtig: Ihr Administrator des Connectors für externe Inhalte benötigt diese Basis-Web-URL, wenn Sie konfigurieren SAP Connector für externe DMS-Inhalte.
Nächste Maßnahme
Stellen Sie die folgenden Elemente für bereit
Connector administrator:
- Die Client-ID, der geheime Client und die Zugriffstoken-URL, die Sie aus dem Serviceschlüssel für die Serviceinstanz „Dokumentverwaltungsservice“, „Integrationsoption“ in Schritt kopiert haben 4.f.
- Die ecmservice-Endpunkt-URL, die Sie aus dem Serviceschlüssel für die Serviceinstanz „Dokumentverwaltungsservice, Integrationsoption“ in Schritt kopiert haben 4.g.
- Die Endpunkt-URL der Rollensammlungen, die Sie aus dem Serviceschlüssel für die Serviceinstanz „Dokumentverwaltungsservice“, „Integrationsoption“ in Schritt kopiert haben 4.h.
- Die Client-ID, der geheime Client und die Zugriffstoken-URL, die Sie aus dem Serviceschlüssel für die Instanz des Autorisierungs- und Vertrauensverwaltungsservice in Schritt kopiert haben 8.f.
- Die Client-ID und das geheime Clientgeheimnis, die Sie aus dem Serviceschlüssel für die Serviceinstanz für Autorisierungs- und Vertrauensmanagement mit dem Anwendungsplan in Schritt kopiert haben 10.f.
- Die Basis-Web-URL, die Sie in Schritt kopiert haben 11.e.
Ihr Connector der administrator benötigt diese Elemente, um einen zu konfigurieren SAP Connector für externe DMS-Inhalte zum Abrufen von Dokumenten und Sicherheitsprinzipalen von Ihrem SAP DMS-Quellsystem.
Für Details zum Erstellen und Konfigurieren von SAP Connector für externe DMS-Inhalte, siehe Erstellen Sie ein SAP Connector für externe DMS-Inhalte.