Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


anchor
German


SeitenanfangSeitenanfang
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





anchor
Panel


Definition des ConnectorsDefinition des Connectors
Seitenanfang ^
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,

Anchor
Authorization Type Authorization Type



Client Secret Post as Method
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.

Seitenanfang ^




ClientAuthentificationMethod
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.

Anchor
ClientAuthentificationMethod



Panel
titleClientAuthentificationMethod


Anchor
Client Secret Basic as MethodClient Secret Basic as Method
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.

Anchor

Client Secret Post as Method Seitenanfang ^




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.

anchor

Logon ParameterLogon Parameter Seitenanfang ^







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.

AnchorAdditional HeaderX (optional)Additional HeaderX (optional) Seitenanfang ^




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.

AnchorDataSource-DefinitionDataSource-Definition

Seitenanfang ^






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.

AnchorMapping des Anfrageergebnisses Mapping des Anfrageergebnisses

Seitenanfang ^




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.

Seitenanfang ^









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





English


Anchor
topofpagetopofpage
Panel


Section


Column
width70%


Section


Column
width40%



Column
width60%

The Open Data Protocol (OData) is an HTTP-based protocol published under Microsoft's Open Specification Promise for data access between compatible software systems.


Setup in SmartNotes

You can define the import from any OData service in the SmartNotes Import Administration by defining a connector and selecting the interface "Odata Service Import". Then the corresponding data source(s) and a mapping must be defined. If the interface is not available, please contact the SmartNotes technical hotline to obtain the appropriate library.




Column
width30%


Panel
bgColor#ECECEC

<< SmartNotes User Manual





Panel


Anchor
Connector DefinitionConnector Definition
top ^
Panel
titleConnector Definition


Section


Column
width40%



Column
width60%

In the Connector Administration Tab You have to specify for the OData service Import connection Paramters

e.g. https://xxxx-api.s4hana.ondemand.com

the Service Rooot

e.g. sap/opu/odata/SAP/API_GRTRANSACTIONDATA_SRV,

anchor

Authorization Type Authorization Type



Panel
titleAuthorization Type


Panel
titleBasic


Section


Column
width40%


Column
width60%

This method, first, builds a string by concatenating the user, a colon and the password. Finally, embeds the BASE64 string in the Authorization header in the request send to the ODATA Service.

top ^




ClientAuthentificationMethod
Panel
titleauth2


Section


Column
width40%



Column
width60%

SmartNotes first sends here a token request to the token endpoint of the Authorization Service to get an access token. Finally, it uses this token to get the Authorization to access the Odata Service.

You have here to set the additional Parameter AuthorizationServerRequest e.g. https://oauthasservices-xxxxx.hana.ondemand.com/oauth2/api/v1/token?grant_type=client_credentialsandthe logon parameters.

Anchor

ClientAuthentificationMethod



Client Secret Basic as Method
Panel
titleClientAuthentificationMethod
Anchor


Client Secret Basic as Method
Panel
titleClient Secret Basic as Method


Section


Column
width40%


Column
width60%

This method, first, builds a string by concatenating a client ID, a colon and a client secret. Finally, embeds the BASE64 string in the Authorization header in a token request send to the Authorization Service. You have here to set the additional Parameter ClientAuthentificationMethod to ClientSecretBasic and the logon parameters.

AnchorClient Secret Post as MethodClient Secret Post as Method top ^




Panel
titleClient Secret Post as Method


Section


Column
width40%


Column
width60%

This Method include a client ID and a client secret in a token request is to use the client_id and client_secret request parameters in Authorization Service Request. You have here to set the additional Parameter ClientAuthentificationMethod to ClientSecretPost and the logon parameters.

anchor

Logon ParameterLogon Parameter top ^







Panel
titleLogon Parameter


Section


Column
width40%


Column
width60%

If the checkbox “Technical User” is checked in the logon dialog, the user and the password will be stored encrypted in the database.

anchor

Additional HeaderX (optional)Additional HeaderX (optional) top ^




Panel
titleAdditional HeaderX (optional)


Section


Column
width40%


Column
width60%

It offers the possibility to store additional headers in the connector definition such as accept-language:de (the “:” separates the key and value of the header)

After defining the new connector You have to move to the datasource administration tab and to define at least one data source.

AnchorDataSource DefinitionDataSource Definition top ^






Panel
titleDataSource Definition


Section


Column
width40%


Column
width60%

A data source represents the parameterised request to the Odata Service.




Section


Column
width40%


Column
width60%

In the Datasource definition You have at least to specify the Resource Path like 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… as placeholders (please see Figure 4).

By the Select Parameter You can specify the fields / dimensions to be selected e.g. ConsolidationVersion,FiscalYearPeriod,ConsolidationLedger,FinancialStatementItem

By the Filter parameter You can define filter restrictions to be applied using the operators:

eq ↔ =

gt ↔ >

lt ↔ <


and joining them using the logical operators AND and OR e.g. ConsolidationGroup eq 'CG3' and ConsolidationVersion eq 'Z10'  and FiscalYearPeriod eq '0122019' and ConsolidationUnit eq 'S3002'

By the Expand Parameter You can specify the navigation properties to be extanded if necessary.



Section


Column
width40%


Column
width60%

Afterwards you can trigger a preview to check if all connection and datasource parameter are set up correctly.

AnchorMapping of the request result Mapping of the request result top ^




Panel
titleMapping of the request result


Section


Column
width40%


Column
width60%

In the mapping administration you have to define which and how the data should be mapped and imported. Please read our chapter Mapping Administration where you will also find information on the processing functions.

After you have set up everything correctly and received a valid, non-empty position preview, the import definition is completely set up.

top ^









Panel
borderColor#666666
bgColor#ECECEC
borderWidth2


Section


Column
width33%

<< Back to - MSSQL Stored Procedure --


Column
width34%

Back to overview - SmartNotes User Manual


Column
width33%

Continue with - Oracle/StoredProcedure >>




...