Sage 300 Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8843 des Connectors.

Erste Schritte

Sage 300 Versionsunterstützung

Der Connector nutzt die Sage 300 API, um bidirektionalen Zugriff auf Sage 300 zu ermöglichen. Zu den unterstützten Sage 300 Modulen gehören:

• AP (Kreditorenbuchhaltung)
• AR (Debitorenbuchhaltung)
• BK (Banken)
• CS (Gemeinsame Dienste)
• GL (Hauptbuch)
• IC (Bestandskontrolle)
• OE (Auftragserfassung)
• PO (Einkaufsaufträge)
• TX (Steuerverfolgung)

Herstellen einer Verbindung

Vor der Authentifizierung

Sage 300 erfordert eine anfängliche Einrichtung, um über die Sage 300 Web-API kommunizieren zu können. Der angemeldete Benutzer muss API Zugriff auf ein oder alle Module der Sage300-Instanz haben. In Sage300 wird einem Benutzer eine Sicherheitsgruppe zugewiesen. Eine Sicherheitsgruppe ist eine Reihe von Berechtigungen für jedes Modul. Es wird empfohlen, einen anderen Benutzer als den zu verwenden ADMIN Benutzer für den Zugriff auf die API. Der ADMIN Der Benutzer muss einige zusätzliche Schritte ausführen, um Zugriff auf die API zu erhalten. Befolgen Sie die folgenden Schritte, um Zugriff auf die API zu erhalten.

Erstellen eines Benutzers

Überspringen Sie diesen Schritt, wenn Sie bereits einen neuen Benutzer erstellt haben oder ein vorhandenes Konto verwenden möchten.

• Öffnen Sie die Sage300-Desktopanwendung, die in der Installation von Sage300 enthalten ist. Melden Sie sich mit an ADMIN Konto.
• Gehe zu Administrative Services -> Users
• Geben Sie die erforderlichen Informationen ein und klicken Sie auf Add

Einrichten der Sicherheitsgruppe

• Öffnen Sie die Sage300-Desktopanwendung, die in der Installation von Sage300 enthalten ist. Melden Sie sich mit an ADMIN Konto.
• Gehe zu Administrative Services -> Security Groups
• Im Application finden Sie alle Module von Sage300. Die Group ID steht für die Sicherheitsgruppe, die Sie ändern möchten. Unten finden Sie eine Liste der Berechtigungen, die Sie überprüfen können.
• (Optional) Erstellen Sie eine neue Security Group fülle das Group ID, Group Description und überprüfen Sie alle Berechtigungen, einschließlich der Sage 300 Web API Erlaubnis. Zuletzt klicken Add(für jede erforderliche Anwendung)
• Oder wählen Sie eine vorhandene ausSecurity Group Sie werden dem Benutzer unter zuweisen Group ID und überprüfen Sie die Sage 300 Web API Berechtigung am Ende der Berechtigungen (für jede Anwendung erforderlich).

Zuweisen einer Sicherheitsgruppe

• Öffnen Sie die Sage300-Desktopanwendung, die in der Installation von Sage300 enthalten ist. Melden Sie sich mit an ADMIN Konto.
• Gehe zu Administrative Services -> User Authorization
• Unter User ID wählen Sie Ihre neue/bestehende User
• Jetzt für jeden Application Weisen Sie die Group ID die Sie erstellt/verändert haben
• Sobald der Benutzerzugriff erfolgt ist, stellen Sie sicher, dass er Zugriff auf die Web API hat. Erstellen Sie eine URL, um den Zugriff für die Sage 300 Web API wie folgt zu testen: https://{server}/Sage300WebApi/, ersetzt {server} mit der URL Ihrer Sage300-Instanz.

Mit Sage 300 verbinden

Der Jitterbit Connector für Sage 300 kommuniziert mit Sage 300 über die OData API. Sie können sich mit der Basisauthentifizierung bei Sage 300 authentifizieren.

Herstellen einer Verbindung mithilfe der Basisauthentifizierung

Sie müssen Werte für die folgenden Eigenschaften angeben, um sich erfolgreich bei Sage 300 zu authentifizieren. Beachten Sie, dass der Anbieter die von Sage 300 mithilfe von Cookies geöffnete Sitzung wiederverwendet.

Das bedeutet, dass Ihre Anmeldeinformationen nur bei der ersten Anforderung zum Öffnen der Sitzung verwendet werden. Danach werden von Sage 300 zurückgegebene Cookies zur Authentifizierung verwendet.

• URL: Setzen Sie dies auf die URL des Servers, auf dem Sage 300 gehostet wird. Erstellen Sie wie folgt eine URL für die Sage 300 Web-API : {protocol}://{host-application-path}/v{version}/{tenant}/
  Zum Beispiel: http://localhost/Sage300WebApi/v1.0/-/.
• User: Legen Sie hier den Benutzernamen Ihres Kontos fest.
• Password: Legen Sie hier das Passwort Ihres Kontos fest.

Optimieren des Datenzugriffs

Optimieren des Datenzugriffs

Mit den folgenden Eigenschaften können Sie mehr Kontrolle über die von Sage 300 zurückgegebenen Daten erhalten:

• Company: Geben Sie das Unternehmen an, von dem Sie Daten erhalten möchten. Wenn nicht angegeben, wird das erste Unternehmen verwendet, das auf der /Companies Endpoint wird ausgewählt.
• Modules: Verwenden Sie diese Verbindungseigenschaft, um den Metadatenabruf auf die gewünschten Module zu beschränken. Dadurch wird die Leistung der abgerufenen Metadaten verbessert.
• IncludeCustomFields: Auf „true“ setzen, um benutzerdefinierte Felder als Tabellenspalten aufzulisten.

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 Sage 300 Connectors detailliert 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 Sage 300 und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

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

Verwenden Sie die 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

Der Sage 300 Connector modelliert Sage 300 Objekte als relationale Tabellen und Ansichten. Ein Sage 300 Objekt hat Beziehungen zu anderen Objekten; in den Tabellen werden diese Beziehungen durch Fremdschlüssel ausgedrückt.

Hauptmerkmale

• Der Connector modelliert Sage 300 Entitäten als relationale Tabellen und Ansichten, sodass Sie SQL schreiben können, um Sage 300 Daten Abfrage.
• Gespeicherte Prozeduren ermöglichen Ihnen, Operationen an Sage 300 auszuführen.
• Durch die Live-Konnektivität zu diesen Objekten werden alle Änderungen an Ihrem Sage 300 Konto bei Verwendung des Connectors sofort angezeigt.

Tabellen

Tabellen werden dynamisch vom authentifizierten Sage 300 Konto abgerufen.

Untergeordnete Tabellen

Es werden auch untergeordnete Tabellen abgerufen, die untergeordnete Objekte ihrer übergeordneten Tabellen enthalten. Beispielsweise hat OEOrders die untergeordneten Tabellen OEOrders_OrderCommentsInstructions und OEOrders_OrderDetails. Diese Tabellen werden beim Abfragen ihrer übergeordneten Tabelle als aggregierte Spalten angezeigt. Sie enthalten außerdem Verweise auf die eindeutige Kennung ihrer übergeordneten Tabelle.

Ansichten

Schreibgeschützte Ansichten werden dynamisch vom authentifizierten Sage 300 Konto abgerufen.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Sage 300. Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Operationen an Sage 300.

SELECT-Anweisungen für die Haupttabellen werden größtenteils serverseitig unterstützt. Beispiel:

SELECT * FROM APInvoiceBatches WHERE BatchDate='2019-01-09 01:00:00.0'

wird serverseitig ausgeführt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT-Operationen mit Sage 300 hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Sage 300 zurück, zusammen mit einer Angabe, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Gespeicherte Prozeduren für den Sage 300 Connector

APCreateGLBatch - Das ist eine kostenlose Testversion von APCreateGL

Nutzungsinformationen für die Operation APCreateGLBatch.rsb.

Eingang

Ergebnissatzspalten

APCreateRecurringPayableBatch

Nutzungsinformationen für die Operation APCreateRecurringPayableBatch.rsb.

Eingang

Ergebnissatzspalten

APCreateRetainageDocumentBatch

Verwendungsinformationen für die Operation APCreateRetainageDocumentBatch.rsb.

Eingang

Ergebnissatzspalten

APDeleteInactiveRecords

Nutzungsinformationen für die Operation APDeleteInactiveRecords.rsb.

Eingang

Ergebnissatzspalten

APPostRechnungen

Nutzungsinformationen für die Operation APPostInvoices.rsb.

Eingang

Ergebnissatzspalten

APPostZahlungenUndAnpassungen

Nutzungsinformationen für die Operation APPostPaymentsAndAdjustments.rsb.

Eingang

Ergebnissatzspalten

ARCreateGLBatch

Nutzungsinformationen für die Operation ARCreateGLBatch.rsb.

Eingang

Ergebnissatzspalten

ARCreateRecurringCharge

Nutzungsinformationen für die Operation ARCreateRecurringCharge.rsb.

Eingang

Ergebnissatzspalten

ARCreateRetainageDocumentBatch

Verwendungsinformationen für die Operation ARCreateRetainageDocumentBatch.rsb.

Eingang

Ergebnissatzspalten

ARPostRechnungen

Nutzungsinformationen für die Operation ARPostInvoices.rsb.

Eingang

Ergebnissatzspalten

ARBuchenBelegeUndAnpassungen

Nutzungsinformationen für die Operation ARPostReceiptsAndAdjustments.rsb.

Eingang

Ergebnissatzspalten

ARPostRückerstattungen

Nutzungsinformationen für die Operation ARPostRefunds.rsb.

Eingang

Ergebnissatzspalten

Schema erstellen

Erstellt eine Schema für die angegebene Tabelle oder Ansicht.

Schema erstellen

Erstellt eine lokale Schema (.rsd) aus einer vorhandenen Tabelle oder Ansicht im Datenmodell.

Die Schema wird in dem Verzeichnis erstellt, das in festgelegt ist Location Verbindungseigenschaft, wenn dieses Verfahren ausgeführt wird. Sie können die Datei bearbeiten, um Spalten ein- oder auszuschließen, Spalten umzubenennen oder Spaltendatentypen anzupassen.

Der Connector überprüft die Location um zu bestimmen, ob die Namen von .rsd-Dateien mit einer Tabelle oder Ansicht im Datenmodell übereinstimmen. Wenn ein Duplikat vorhanden ist, hat die Schema Vorrang vor der Standardinstanz dieser Tabelle im Datenmodell. Wenn eine Schema in vorhanden ist Location das nicht mit einer vorhandenen Tabelle oder Ansicht übereinstimmt, wird dem Datenmodell des Connectors ein neuer Tabellen- oder Ansichtseintrag hinzugefügt.

Eingang

Ergebnissatzspalten

GLPostJournal

Nutzungsinformationen für die Operation GLPostJournal.rsb.

Eingang

Ergebnissatzspalten

ICCreateGLBatch

Nutzungsinformationen für die Operation ICCreateGLBatch.rsb.

Eingang

Ergebnissatzspalten

ICDayEndProcessing

Verwendungsinformationen für die Operation ICDayEndProcessing.rsb.

Eingang

Ergebnissatzspalten

POErstellenBatch

Nutzungsinformationen für die Operation POCreateBatch.rsb.

Eingang

Ergebnissatzspalten

POTagesendeVerarbeitung

Verwendungsinformationen für die Operation PODayEndProcessing.rsb.

Eingang

Ergebnissatzspalten

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 Sage 300 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 OEInvoices-Tabelle zurück:

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

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 APCreateGLBatch zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='APCreateGLBatch' 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 OEInvoices-Tabelle ab:

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

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

Verbindung

SSL

Schema

Verschiedenes

Authentifizierung

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

URL

Legen Sie die URL auf den HTTP- oder HTTPS- Endpoint Ihres Sage 300 Systems fest. Beispiel: http://localhost/Sage300WebApi/v1.0/-/.

Datentyp

string

Standardwert

""

Hinweise

Legen Sie die URL auf den HTTP- oder HTTPS- Endpoint Ihres Sage 300 -Systems fest. Erstellen Sie wie folgt eine URL für die Sage 300 Web-API : {protocol}://{host-application-path}/v{version}/{tenant}/ Zum Beispiel, http://localhost/Sage300WebApi/v1.0/-/.

Benutzer

Das zur Authentifizierung verwendete Sage 300 Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem Sage 300 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.

Verbindung

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

Unternehmen

Bestimmt das Unternehmen.

Datentyp

string

Standardwert

""

Hinweise

Geben Sie das Unternehmen an, von dem Sie Daten erhalten möchten. Wenn Sie keine Angaben machen, wird das erste am Endpoint /Companies gefundene Unternehmen ausgewählt.

Module

Durch Komma getrennte Liste der Module.

Datentyp

string

Standardwert

*

Hinweise

Durch Kommas getrennte Liste von Modulen. (Verwenden Sie diese Verbindungseigenschaft, um nur auf die gewünschten Module zugreifen zu können. Dadurch wird die Leistung der abgerufenen Metadaten verbessert.) Optionen: AP (Kreditorenbuchhaltung), AR (Debitorenbuchhaltung), BK (Banken), CS (Allgemeine Dienste), GL (Hauptbuch), IC (Lagerkontrolle), OE (Auftragserfassung), PO (Bestellungen), TX (Steuerverfolgung)

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.

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%\Sage300 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%\Sage300 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.

Benutzerdefinierte Felder einschließen

Bestimmt, ob benutzerdefinierte Felder als Tabellenspalten einbezogen werden sollen oder nicht.

Datentyp

bool

Standardwert

false

Hinweise

Um ihre Werte abzurufen, können Sie IncludeCustomFields=true als Verbindungseigenschaft festlegen. Dadurch werden die benutzerdefinierten Felder aufgelistet, die als Tabellenspalten erstellt wurden.

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.

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

Pseudospalten

Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.

Datentyp

string

Standardwert

""

Hinweise

Diese Einstellung ist besonders hilfreich im Entity Framework, da Sie dort keinen Wert für eine Pseudospalte festlegen können, es sei denn, es handelt sich um eine Tabellenspalte. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das Zeichen „*“ verwenden, um alle Tabellen und alle Spalten einzuschließen, z. B. „*=*“.

Zeilenscantiefe

Die maximale Anzahl zu scannender Zeilen, um nach den in einer Tabelle verfügbaren Spalten zu suchen.

Datentyp

int

Standardwert

100

Hinweise

Die Spalten in einer Tabelle müssen durch das Scannen der Tabellenzeilen ermittelt werden. Dieser Wert bestimmt die maximale Anzahl der zu scannenden Zeilen.

Das Festlegen eines hohen Wertes kann die Leistung beeinträchtigen. Das Festlegen eines niedrigen Wertes kann dazu führen, dass der Datentyp nicht richtig ermittelt wird, insbesondere wenn Nulldaten vorhanden sind.

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.

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

Verwenden Sie 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.