Definition des Connectors

40%

60%

In der Registerkarte „Connector Administration" müssen Sie für den OData-Dienst „Import connection Paramters" angeben.

Host Ihres Odata-Dienstes z.B.: https://xxxx-api.s4hana.ondemand.com der Dienst Root z.B.: sap/opu/odata/SAP/API_GRTRANSACTIONDATA_SRV,

Authorization Type

Basic

40%

60%

Diese Methode erstellt zunächst eine Zeichenkette, indem sie den Benutzer, einen Doppelpunkt und das Passwort aneinanderreiht. Schließlich wird die BASE64-Zeichenkette in den Autorisierungs-Header der an den ODATA-Dienst gesendeten Anfrage eingebettet.

auth2

40%

60%

SmartNotes sendet hier zunächst eine Token-Anfrage an den Token-Endpunkt des Autorisierungsdienstes, um ein Zugriffstoken zu erhalten. Mit diesem Token holt es sich schließlich die Autorisierung für den Zugriff auf den Odata-Dienst.

Sie müssen hier den zusätzlichen Parameter AuthorizationServerRequest setzen, z.B. https://oauthasservices-xxxxx.hana.ondemand.com/oauth2/api/v1/token?grant_type=client_credentials and the logon parameters.

ClientAuthentificationMethod

Client Secret Basic as Method

40%

60%

Diese Methode erstellt zunächst eine Zeichenkette, indem sie eine Kunden-ID, einen Doppelpunkt und ein Kundengeheimnis aneinanderreiht. Schließlich bettet sie den BASE64-String in den Authorization-Header einer Token-Anforderung ein, die an den Authorization Service gesendet wird. Hier müssen Sie den zusätzlichen Parameter ClientAuthentificationMethod auf ClientSecretBasic und die Logon-Parameter setzen.

Client Secret Post as Method

40%

60%

Diese Methode, die eine Client-ID und ein Client-Geheimnis in eine Token-Anfrage einschließt, verwendet die Anfrageparameter client_id und client_secret in der Anfrage des Autorisierungsdienstes. Sie müssen hier den zusätzlichen Parameter ClientAuthentificationMethod auf ClientSecretPost und die Logon-Parameter setzen.

Logon Parameter

40%

60%

Wenn das Kontrollkästchen „Technischer Benutzer" im Anmeldedialog aktiviert ist, werden der Benutzer und das Passwort verschlüsselt in der Datenbank gespeichert.

Additional HeaderX (optional)

40%

60%

Dieser bietet die Möglichkeit, zusätzliche Header in der Konnektordefinition zu speichern, wie z.B. accept-language:de (das „:" trennt den Schlüssel und den Wert des Headers)

Nachdem Sie den neuen Konnektor definiert haben, müssen Sie zur Registerkarte Datenquellenverwaltung wechseln und mindestens eine Datenquelle definieren.

DataSource-Definition

40%

60%

Eine Datenquelle stellt die parametrisierte Anfrage an den OData-Dienst dar.

40%

60%

In der Datenquellendefinition müssen Sie mindestens den Ressourcenpfad angeben wie GRTransactionData(P_ConsolidationUnitHierId='$',P_ConsolidationPrftCtrHierId='$',P_ConsolidationSegmentHierId='$',P_KeyDate=datetime'2019-12-31T00:00:00')/Results or GRTransactionData(@Parameter_1,@Parameter_2,@Parameter_3,@Parameter_4)/Results using @Parameter_1, @Parameter_2… als Platzhalter.

Mit dem Select-Parameter können Sie die auszuwählenden Felder / Dimensionen angeben, z.B. ConsolidationVersion,FiscalYearPeriod,ConsolidationLedger,FinancialStatementItem

Mit dem Parameter Filter können Sie Filtereinschränkungen definieren, die mit Hilfe von Operatoren angewendet werden:

eq" ↔=

gt ↔ >

lt ↔ <

und verknüpfen sie mit den logischen Operatoren AND und OR, z. B. ConsolidationGroup eq 'CG3' and ConsolidationVersion eq 'Z10' and FiscalYearPeriod eq '0122019' and ConsolidationUnit eq 'S3002'

Mit dem Expand-Parameter können Sie die Navigationseigenschaften angeben, die bei Bedarf erweitert werden sollen.

40%

60%

Anschließend können Sie eine Vorschau auslösen, um zu prüfen, ob alle Verbindungs- und Datenquellenparameter korrekt eingerichtet sind.

Mapping des Anfrageergebnisses

40%

60%

In der Mapping-Administration müssen Sie festlegen, welche und wie die Daten gemappt und importiert werden sollen. Bitte lesen Sie dazu unser Kapitel Mapping-Administration in dem Sie auch Informationen zu den Verarbeitungsfunktionen finden.

Nachdem Sie alles korrekt eingerichtet haben und eine gültige, nicht leere Positionsvorschau erhalten haben, ist die Importdefinition vollständig eingerichtet.

CloudOData Interface