Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version published after converting to the new editor


German


Panel


Section


Column
width70%


Section


Column
width40%



Column
width60%

Das Open Data Protocol (OData) ist ein unter dem Open Specification Promise von Microsoft veröffentlichtes HTTP-basiertes Protokoll für den Datenzugriff zwischen kompatiblen Softwaresystemen,


Einrichtung in SmartNotes

Sie können den Import von einem beliebigen OData-Dienst in der SmartNotes Import Administration festlegen, indem Sie einen Konnektor definieren und die Schnittstelle „Odata Service Import" auswählen. Anschließend müssen die entsprechende(n) Datenquelle(n) und ein Mapping definiert werden. Sollte die Schnittstelle nicht verfügbar sein, wenden Sie sich bitte an die technische SmartNotes-Hotline, um die entsprechende Bibliothek zu erhalten.




Column
width30%


Panel
bgColor#ECECEC

<< Das SmartNotes Handbuch





Panel


Panel
titleDefinition des Connectors


Section


Column
width40%



Column
width60%

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,



Panel
titleAuthorization Type


Panel
titleBasic


Section


Column
width40%


Column
width60%

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.




Panel
titleauth2


Section


Column
width40%



Column
width60%

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_credentialsandthe logon parameters.



Panel
titleClientAuthentificationMethod


Panel
titleClient Secret Basic as Method


Section


Column
width40%


Column
width60%

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.




Panel
titleClient Secret Post as Method


Section


Column
width40%


Column
width60%

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.







Panel
titleLogon Parameter


Section


Column
width40%


Column
width60%

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




Panel
titleAdditional HeaderX (optional)


Section


Column
width40%


Column
width60%

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.






Panel
titleDataSource-Definition


Section


Column
width40%


Column
width60%

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




Section


Column
width40%


Column
width60%

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.




Section


Column
width40%


Column
width60%

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




Panel
titleMapping des Anfrageergebnisses


Section


Column
width40%


Column
width60%

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.









Panel
borderColor#666666
bgColor#ECECEC
borderWidth2


Section


Column
width33%

<< Zurück zu - MSSQL Stored Procedure --


Column
width34%

Zurück zur Übersicht - SmartNotes Benutzerhandbuch


Column
width33%

Weiter mit - Oracle/StoredProcedure Schnittstelle >>




...