SAP Business ByDesign Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.

Erste Schritte

SAP ByDesign-Versionsunterstützung

Der Connector nutzt die SAPByDesign APIs, um einen bidirektionalen Zugriff auf SAPByDesign zu ermöglichen.

Herstellen einer Verbindung

In diesem Abschnitt wird beschrieben, wie Sie die Authentifizierung für Ihr Konto und Ihren Diensttyp durchführen und dann eine Verbindung herstellen.

Authentifizieren eines SAPByDesign-Kontos

Legen Sie die folgenden Verbindungseigenschaften fest, um eine Verbindung mit SAP ByDesign herzustellen.

Herstellen einer Verbindung zu einem Analysedienst

• URL: Setzen Sie dies auf die URL Ihrer SAP ByDesign-Site. Beispiel: https://test.sapbydesign.com.

• ServiceType: Wenn Sie die Berichte eines Analysedienstes abrufen möchten, geben Sie an ServiceType=AnalyticsService;.

• ServiceName: Der Name des Dienstes, von dem Sie Daten abrufen möchten. Es darf nur kein oder ein Dienst angegeben werden. Wenn Sie eine Liste von Diensten angeben möchten, siehe BrowsableSchemas.

  Wenn Sie nicht sicher sind, welchen Dienst Sie angeben sollen, können Sie jederzeit die sys_schemas Abfrage, um die verfügbaren Dienste aufzulisten.

• User: Setzen Sie hier den Benutzernamen Ihres Kontos.

• Password: Legen Sie hier das Passwort Ihres Kontos fest.

Beispiel für eine Verbindungszeichenfolge für analytische Dienste:

Url=https://test.sapbydesign.com;ServiceType=AnalyticsService;ServiceName=cc_home_analytics.svc;User=Test;Password=test;

Mit einem benutzerdefinierten Dienst verbinden

• URL: Setzen Sie dies auf die URL Ihrer SAP ByDesign-Site. Beispiel: https://test.sapbydesign.com.

• ServiceType: Wenn Sie einen benutzerdefinierten Dienst haben, von dem Sie Daten abrufen möchten, geben Sie an ServiceType=Kundendienst;.

• ServiceName: Der Name des Dienstes, von dem Sie Daten abrufen möchten. Es darf nur kein oder ein Dienst angegeben werden. Wenn Sie eine Liste von Diensten angeben möchten, siehe BrowsableSchemas.

  Wenn Sie nicht sicher sind, welchen Dienst Sie angeben sollen, können Sie jederzeit die sys_schemas Abfrage, um die verfügbaren Dienste aufzulisten.

• User: Setzen Sie hier den Benutzernamen Ihres Kontos.

• Password: Legen Sie hier das Passwort Ihres Kontos fest.

Beispiel für eine benutzerdefinierte Dienstverbindungszeichenfolge:

Url=https://test.sapbydesign.com;ServiceType=CustomService;ServiceName=khsalesorder;User=Test;Password=test;

Herstellen einer Verbindung zur ODataDataSource API

• URL: Setzen Sie dies auf die URL Ihrer SAP ByDesign-Site. Beispiel: https://test.sapbydesign.com.

• ServiceType: Wenn Sie die OData Datenquellen-API (odata/analytics/ds) Abfrage möchten, geben Sie an ServiceType=ODataDatenquelle.

• ServiceName: Der Name des Dienstes, von dem Sie Daten abrufen möchten. Es darf nur kein oder ein Dienst angegeben werden. Wenn Sie eine Liste von Diensten angeben möchten, siehe BrowsableSchemas.

  Wenn Sie nicht sicher sind, welchen Dienst Sie angeben sollen, können Sie jederzeit die sys_schemas Abfrage, um die verfügbaren Dienste aufzulisten.

• User: Setzen Sie hier den Benutzernamen Ihres Kontos.

• Password: Setzen Sie dies auf das Passwort Ihres Kontos.

Beispiel für ODataDataSource-Verbindungszeichenfolge:

Url=https://test.sapbydesign.com;ServiceType=ODataDataSource;ServiceName=Customer.svc;User=Test;Password=test;

Einen neuen benutzerdefinierten ODATA-Dienst hinzufügen

• Klicken Sie in der SAP ByDesign-Workcenteransicht auf „Anwendungs- und Benutzerverwaltung“.
• Wählen Sie „OData Dienste“.
• Wählen Sie in der Dropdown-Liste „Benutzerdefinierte OData Dienste“ aus.
• Jetzt sollten Sie eine Liste Ihrer aktuellen benutzerdefinierten Dienste sehen. Um einen neuen hinzuzufügen, klicken Sie auf „Neu“.

URL Einschränkungen für SAP ByDesign

Der SAP ByDesign-Connector erzwingt URL Einschränkungen, um die Überschreitung der maximal zulässigen URI-Länge zu vermeiden. Andernfalls gibt der Dienst den Fehler „URI zu lang“ aus.

Standardmäßig ist die Länge der Spalten in der Projektion auf 1000 Zeichen begrenzt. Wenn die in der Projektion ausgewählten Spalten diese Grenze überschreiten, löscht der Treiber die Projektionsspezifikation und ruft alle Felder ab. Dies kann die Leistung aufgrund von Verzögerungen bei der Serviceantwort und erhöhter Payload beeinträchtigen.

Im Falle des Analysedienstes (ServiceType=AnalyticsService) gibt der Treiber einen Fehler aus, der Sie darauf hinweist, dass Sie die Anzahl der Spalten in der Projektion reduzieren müssen. Darüber hinaus ist die serverseitige Filterlänge aus denselben Gründen auf 1000 Zeichen beschränkt. Wenn die generierte Filterlänge diese Grenze überschreitet, löscht der Treiber die zusätzlichen Filter und verarbeitet sie clientseitig.

In SAP ByDesign können Sie diese Einschränkungen mithilfe der versteckten Verbindungseigenschaften MaxSelectLength und MaxFilterLength konfigurieren oder deaktivieren. Die Standardlänge dieser Eigenschaften beträgt beide 1000 Zeichen. Wenn Ihr Dienst diese Einschränkungen nicht hat, setzen Sie die Eigenschaften auf -1, um die Längenbeschränkungen zu deaktivieren.

Optimieren des Datenzugriffs

Navigationseigenschaften als Ansichten

Navigationseigenschaften sind Eigenschaften einer Entität, die selbst entweder eine einzelne verknüpfte Entität oder eine Liste verknüpfter Entitäten ist.
Standardmäßig werden diese als Ansichten angezeigt, obwohl sie durch Festlegen von ausgeblendet werden können NavigationPropertiesAsViews auf false.
Diese Eigenschaft hat nur eine Auswirkung, wenn mit gearbeitet wird ServiceType=CustomService, da bei der Arbeit mit anderen Diensten keine Navigationseigenschaften vorhanden sind.

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 SAP ByDesign-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 SAP ByDesign und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für SAP ByDesign 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 Account 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

In diesem Abschnitt werden die verfügbaren API Objekte angezeigt und weitere Informationen zur Ausführung von SQL für SAP ByDesign-APIs bereitgestellt.

Hauptmerkmale

• Der Connector modelliert SAP ByDesign Analytics Services als relationale Ansichten. Entitäten, die in einem benutzerdefinierten Service definiert sind, werden mithilfe einer Kombination aus Tabellen und Ansichten modelliert, sodass Sie SQL schreiben können, um SAP ByDesign-Daten Abfrage.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem SAP ByDesign-Konto bei Verwendung des Connectors sofort berücksichtigt werden.

Tabellen

Tabellen sind dynamisch definierte Einheiten, die auf der ServiceType=CustomService.

Ansichten

Ansichten werden dynamisch definiert, entweder aus den Navigationseigenschaften eines ServiceType=CustomService, oder aus den Abfragen auf einem ServiceType=AnalyticsService, ServiceType=ODataDataSource.

Analysedienste

Um Berichte eines Analysedienstes abzurufen, müssen Sie Folgendes angeben: URL ServiceType=AnalyticsService-Eigenschaft. Beispiel: Url=https://my999999.businessbydesign.cloud.sap;ServiceType=AnalyticsService;ServiceName=cc_home_analytics.svc;. Alle Berichte werden als Ansichten angezeigt. Beachten Sie, dass die clientseitige Filterung deaktiviert wird, wenn Sie versuchen, einen von der SAP ByDesign API nicht unterstützten Filter auf eine Dimension anzuwenden und diese Dimension gleichzeitig nicht in die SELECT-Klausel einschließen. Wenn Sie die clientseitige Filterung verwenden möchten (Filter ausführen, die von der SAP ByDesign API nicht unterstützt werden), müssen Sie die Dimension in die SELECT-Klausel einschließen.

Wenn die Abfrage eine Abfrage ist und die Anzahl der Dimensionen höher als 15 ist, verwendet der Treiber nur die Standarddimension und ignoriert die anderen. Dies geschieht, weil es wirklich schwierig ist, einem Ergebnissatz mit zu vielen Dimensionen einen Sinn zu geben. Dieser Anwendungsfall ist üblich, wenn der Treiber in verschiedenen Tools verwendet wird. Die Standarddimension wird vom Treiber dynamisch und zufällig ausgewählt.

Tabellen

Der Connector stellt Tabellen für jeden Entitätssatz und jedes Singleton bereit, das in der Stamm-URL von SAP ByDesign definiert ist. Entitäten in diesen Tabellen können mit standardmäßigen SQL-Anweisungen zum Einfügen, Aktualisieren oder Löschen eingefügt, aktualisiert oder gelöscht werden.

Ausführen von Deep Inserts mit SQL

Der Connector unterstützt OData Deep Inserts, bei denen Sie gleichzeitig eine Basisentität erstellen und diese mit verwandten Entitäten verknüpfen, indem Sie Navigationseigenschaften angeben. Um Navigationseigenschaften anzugeben für eine Entität erstellen Sie eine temporäre Tabelle für die Navigationseigenschaft und verweisen dann im Insert auf die temporäre Tabelle in der Basistabelle. Verweisen Sie in der entsprechenden Navigationseigenschaftsspalte in der Basistabelle auf die temporäre Tabelle. Jede Navigationseigenschaftsspalte ist mit dem Wort „Verlinkt“ gekennzeichnet.

Beachten Sie, dass Sie die temporären Tabellen definieren und in die Basisentität innerhalb derselben Verbindung einfügen müssen.

Beispiel: Tiefe Einsätze

Nehmen Sie beispielsweise eine Tabelle mit dem Namen „Bestellungen“ an. Um eine neue Bestellung zu erstellen, geben Sie die bestellten Produkte, den Kunden, den Mitarbeiter und den Versender an. Dazu müssen Sie die folgenden Navigationseigenschaften angeben.

Temporäre Tabellen erstellen

Fügen Sie die zugehörigen Entitäten in temporäre Tabellen ein, die den einzelnen Navigationseigenschaften entsprechen. Sie können den Primärschlüssel einer vorhandenen Entität angeben oder eine neue Entität einfügen.

• Customer: Die folgende Anweisung erstellt einen neuen Kunden:

  INSERT INTO Customers#TEMP (CustomerID, CompanyName, ContactName, ContactTitle, Address, City, PostalCode, Country, Phone, Fax)
  
  VALUES ('VINET', 'Vins et alcools Chevalier', 'Paul Henriot', 'Accounting Manager', '59 rue de l''Abbaye', 'Reims', '51100', 'France', '26.47.15.10', '26.47.15.11')
  

• Order Details: Die folgenden Anweisungen fügen der Bestellung zwei Produkte hinzu:

  INSERT INTO Order_Details#TEMP (ProductID, UnitPrice, Quantity, Discount) VALUES (72, 34.80, 5, 0)
  
  INSERT INTO Order_Details#TEMP (ProductID, UnitPrice, Quantity, Discount) VALUES (42, 9.80, 10, 0)
  

• Employee: Die folgende Anweisung gibt den vorhandenen Mitarbeiter an:

  INSERT INTO Employees#TEMP (EmployeeID)
  VALUES (5)
  

• Shipper: Die folgende Anweisung gibt den vorhandenen Versender an:

  INSERT INTO Shippers#TEMP (ShipperID) VALUES (3)
  

Der Jitterbit Connector für SAP ByDesign geht davon aus, dass der Versender und der Mitarbeiter bereits vorhanden sind, und verknüpft nur die vorhandenen Referenzen, da für beide nur die Primärschlüssel angegeben wurden. Wenn mehr als nur der Primärschlüssel definiert ist, wie in den Beispielen für Kunde und Bestelldetails, versucht der Jitterbit Connector für SAP ByDesign, neue Einträge zu erstellen - und löst damit den Deep Insert aus.

Einfügen der Entität

Verweisen Sie in der INSERT-Anweisung für die Basisentität auf die temporären Tabellen in den Spalten LinkedOrder_Details, LinkedCustomer, LinkedEmployee und LinkedShipper:

INSERT INTO Orders (CustomerID, EmployeeID, ShipVia, ShipName, ShipAddress, ShipCity, ShipPostalCode, ShipCountry, OrderDate, LinkedOrder_Details, LinkedCustomer, LinkedEmployee, LinkedShipper) VALUES ('VINET', 5, 3, 'Paul Henriot', '59 rue de l''Abbaye', 'Reims', '51100', 'France', '07/04/1996', 'Order_Details#TEMP', 'Customers#TEMP', 'Employees#TEMP', 'Shippers#TEMP')

Codebeispiel

Nachfolgend finden Sie den vollständigen Code zum Erstellen der neuen Bestellung:

Connection conn = DriverManager.getConnection("jdbc:sapbydesign:URL=https://my999999.businessbydesign.cloud.sap;User=username;Password=password;ServiceType=AnalyticsService;ServiceName=servicename;");
Statement stat = conn.createStatement();
stat.executeUpdate("INSERT INTO Customers#TEMP (CustomerID, CompanyName, ContactName, ContactTitle, Address, City, PostalCode, Country, Phone, Fax) VALUES ('VINET', 'Vins et alcools Chevalier', 'Paul Henriot', 'Accounting Manager', '59 rue de l''Abbaye', 'Reims', '51100', 'France', '26.47.15.10', '26.47.15.11')");

stat.executeUpdate("INSERT INTO Order_Details#TEMP (ProductID, UnitPrice, Quantity, Discount) VALUES (72, 34.80, 5, 0)");

stat.executeUpdate("INSERT INTO Order_Details#TEMP (ProductID, UnitPrice, Quantity, Discount) VALUES (42, 9.80, 10, 0)");

stat.executeUpdate("INSERT INTO Employees#TEMP (EmployeeID) VALUES (5)");

stat.executeUpdate("INSERT INTO Shippers#TEMP (ShipperID) VALUES (3)");

stat.executeUpdate("INSERT INTO Orders (CustomerID, EmployeeID, ShipVia, ShipName, ShipAddress, ShipCity, ShipPostalCode, ShipCountry, OrderDate, LinkedOrder_Details, LinkedCustomer, LinkedEmployee, LinkedShipper) VALUES ('VINET', 5, 3, 'Paul Henriot', '59 rue de l''Abbaye', 'Reims', '51100', 'France', '07/04/1996', 'Order_Details#TEMP', 'Customers#TEMP', 'Employees#TEMP', 'Shippers#TEMP')");

stat.close();

Navigationseigenschaften

In OData ist eine Navigationseigenschaft eine Eigenschaft einer Entität, die selbst entweder eine einzelne Entität oder eine Liste von Entitäten ist.

Eine Navigationseigenschaft mit einer einzelnen Entität bedeutet eine Eins-zu-eins-Beziehung. Beispielsweise kann ein OData Dienst zulassen, dass ein Produkt nur eine Kategorie hat. In diesem Dienst kann Kategorie eine Navigationseigenschaft für Produkte sein.

Eine Navigationseigenschaft eines Entitätssatzes bezeichnet eine Eins-zu-viele-Beziehung. Beispielsweise können viele Produkte zur selben Kategorie gehören. In diesem Dienst könnten Produkte eine Navigationseigenschaft für Kategorien sein.

Modellieren von Navigationseigenschaften

Standardmäßig werden die Connector-Modelle Navigationseigenschaften als separate Ansichten. Die Ansichten werden im Format ParentTable_NavigationProperty benannt. Sie können dieses Verhalten mit deaktivieren NavigationPropertiesAsViews.

Relationales Arbeiten mit Navigationseigenschaften

Navigationseigenschaften in OData verknüpfen verwandte Entitäten. In einer relationalen Datenbank dient ein Fremdschlüssel auf ähnliche Weise zum Verknüpfen von Tabellen. Ein Produktdatensatz kann beispielsweise eine Spalte „CategoryId“ enthalten, die eindeutig identifiziert, zu welcher Kategorie das Produkt gehört. In OData gibt es jedoch keine Anforderung, dass eine Entität einen Fremdschlüsselverweis auf eine verwandte Entität enthalten muss. Dies bedeutet, dass Sie manchmal Navigationseigenschaften erhalten, ohne einen Fremdschlüsselverweis auf diese Entität im übergeordneten Element oder zurück zum übergeordneten Element von der verwandten Entität zu haben. In Fällen ohne Fremdschlüsselverweis ist die Existenz der Navigationseigenschaft das einzige, anhand dessen eine Beziehung zwischen den beiden Entitäten identifiziert werden kann.

Wählen

NavigationPropertiesAsViews ist nützlich für den Zugriff auf Daten in OData Diensten, denen Fremdschlüsselverweise fehlen. Ebenso kann es verwendet werden, um verwandte Entitäten abzurufen, die nicht für sich allein existieren, wie z. B. Positionen auf einer Rechnung. Weitere Informationen zum Abfragen von Navigationseigenschaften finden Sie in den Tabellen.

Einfügen

Der Connector unterstützt OData Deep Inserts. Siehe Tabellen für weitere Informationen zum Festlegen von Navigationseigenschaften beim Erstellen einer Entität.

Abfragen von Navigationseigenschaften

Ein Beispiel für die Arbeit mit einer Navigationseigenschaft als Ansicht ist BusinessPartners. Der Entitätssatz BusinessPartners hat eine Navigationseigenschaft Orders. Der Jitterbit Connector für SAP ByDesign zeigt für diesen Dienst eine Ansicht namens BusinessPartners_Orders an. Beim Abrufen von Daten aus BusinessPartners_Orders werden alle mit einem bestimmten BusinessPartner verknüpften Bestellungen angezeigt. Die Ansicht BusinessPartners_Orders hat einen Primärschlüssel, der aus dem Primärschlüssel der übergeordneten Entität und dem Primärschlüssel der verknüpften Entität besteht.

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für SAP ByDesign zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Account“ zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Account'

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur SelectEntries zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Tabelle „Account“ ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Account'

Spalten

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Sys_primarykeys

Beschreibt die Primärschlüssel.

Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:

SELECT * FROM sys_primarykeys

Spalten

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

Sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:sapbydesign:config:

Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.

Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:

SELECT * FROM sys_connection_props WHERE Value <> ''

Spalten

Sys_sqlinfo

Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.

Entdecken der SELECT-Funktionen der Datenquelle

Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden. Andernfalls enthält die Spalte NO.

Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'

Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; siehe Datenmodell Abschnitt für weitere Informationen.

Spalten

Systemidentität

Gibt Informationen zu versuchten Änderungen zurück.

Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:

SELECT * FROM sys_identity

Spalten

Erweiterte Konfigurationseigenschaften

Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.

Authentifizierung

SSL

Verbindung

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

URL

URL zu Ihrem System-Host.

Datentyp

string

Standardwert

""

Hinweise

URL zu Ihrem System-Host.

Diensttyp

Geben Sie den Typ des Dienstes an, von dem Berichte abgerufen werden sollen. Wird zusammen mit den Verbindungseigenschaften URL und ServiceName verwendet, um den Dienst zu bestimmen, von dem Daten abgerufen werden sollen.

Mögliche Werte

AnalyticsService, CustomService, ODataDataSource

Datentyp

string

Standardwert

""

Hinweise

• AnalyticsService: Wenn Sie Berichte vom Analysedienst abrufen möchten.
• CustomService: Wenn Sie Daten vom benutzerdefinierten Dienst abrufen möchten, den Sie in der Benutzeroberfläche konfiguriert haben.
• ODataDataSource: Wenn Sie die DataSources Abfrage möchten (OData Data Source API -> odata/analytics/ds).

Benutzer

Das zur Authentifizierung verwendete SAP ByDesign-Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem SAP ByDesign-Server verwendet.

Passwort

Das zur Authentifizierung des Benutzers verwendete Passwort.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer Und Password werden zusammen zur Authentifizierung beim Server verwendet.

SSL

Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.

SSLServerCert

Das vom Server zu akzeptierende Zertifikat bei einer Verbindung über TLS/SSL.

Datentyp

string

Standardwert

""

Hinweise

Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.

Diese Eigenschaft kann folgende Formen annehmen:

Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.

Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).

Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.

Verbindung

Dieser Abschnitt enthält eine vollständige Liste der Verbindungseigenschaften, die Sie konfigurieren können.

Dienstname

Geben Sie den SAP ByDesign-Dienstnamen an, mit dem eine Verbindung hergestellt werden soll.

Datentyp

string

Standardwert

""

Hinweise

Geben Sie den SAP ByDesign-Dienstnamen an, mit dem eine Verbindung hergestellt werden soll. Lassen Sie dieses Feld leer, um alle Dienste abzurufen.

Schema

Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\SAPByDesign Data Provider\Schema

Hinweise

Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen möchten (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.

Wenn nichts angegeben wird, ist der Standardspeicherort „%APPDATA%\SAPByDesign Data Provider\Schema“ mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

DurchsuchbareSchemas

Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.

Tabellen

Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Ansichten

Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Verschiedenes

Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.

MaxRows

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.

Datentyp

int

Standardwert

-1

Hinweise

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.

NavigationPropertiesAsViews

Ein Boolescher Wert, der angibt, dass Navigationseigenschaften auf Vollansichten hochgestuft werden sollen.

Datentyp

bool

Standardwert

true

Hinweise

Diese Eigenschaft kann für SAP ByDesign nützlich sein, da es verwandte Sammlungen von Entitäten oder Navigationseigenschaften zurückgeben kann. Auf einige SAP ByDesign-Entitäten kann nur über Navigationseigenschaften zugegriffen werden. NavigationPropertiesAsViews bewirkt, dass alle erkannten Navigationseigenschaften als Ansichten im Format ParentTable_NavigationProperty hinzugefügt werden.

Andere

Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.

Datentyp

string

Standardwert

""

Hinweise

Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.

Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.

Integration und Formatierung

Zeitüberschreitung

Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.

Datentyp

int

Standardwert

60

Hinweise

Wenn Timeout = 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.

Wenn Timeout abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.

Anzeigenamen verwenden

Boolescher Wert, der bestimmt, ob SAP -Beschriftungen verwendet werden sollen oder nicht.

Datentyp

bool

Standardwert

false

Hinweise

Boolescher Wert, der bestimmt, ob SAP -Beschriftungen verwendet werden sollen oder nicht.

Wenn dieser Wert auf „true“ gesetzt ist, dienen die Beschriftungen, die Sie in Ihrem Konto für die OData-Eigenschaften konfiguriert haben, als Spaltennamen. Andernfalls wird der Name der Eigenschaft zum Spaltennamen.

BenutzerdefinierteAnsichten

Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.

Datentyp

string

Standardwert

""

Hinweise

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 Account WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

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

Beachten Sie, dass der angegebene Pfad nicht in Anführungszeichen steht.