Sage 50 UK -Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8843 des Connectors.

Erste Schritte

Unterstützung für die Sage 50 UK

Der Connector modelliert Daten in Sage 50 UK 2012 und höher als relationale Tabellen. Beachten Sie, dass Sie für v28 und höher den Sdata-Adapter installieren müssen, bevor Sie den Sage 50 UK Treiber verwenden. Siehe die Sage 50 UK -Dokumentation für weitere Informationen.

Herstellen einer Verbindung

Vor dem Anschließen

Für v28 und höher müssen Sie den Sdata-Adapter installieren, bevor Sie den Sage 50 UK Treiber verwenden. Siehe die Sage 50 UK -Dokumentation für weitere Informationen.

Mit Sage 50 UK verbinden

Der Connector stellt über die in der Sage 50 UK Installation enthaltene SData REST API eine Verbindung zu Sage 50 UK Daten her. SData ermöglicht den Zugriff auf lokale Unternehmensdatensätze sowie auf Datensätze auf Netzwerklaufwerken.

Nachdem Sie den Sage SData-Dienst konfiguriert haben, stellen Sie mit den folgenden Schritten eine Verbindung her: URL Die Eigenschaft sollte auf die Adresse des gewünschten Firmendatensatzes gesetzt werden. Um die Adresse zu erhalten, gehen Sie wie folgt vor:

1. Sofern Sie dies noch nicht getan haben, öffnen Sie die Sage 50 UK -Software.
2. Wählen Sie Tools > Internet Options.
3. Wählen Sie Sdatasettings Tab.
4. Klicken Sie auf Details neben der Sage 50-Softwareanwendung, mit der Sie eine Verbindung herstellen möchten. Es öffnet sich ein Fenster mit einer Liste von Firmennamen sowie den Adressen zu den entsprechenden Datensätzen.
5. Legen Sie die fest URLEigenschaft auf den Wert im Adressfeld neben der gewünschten Firma setzen.

Authentisierung bei Sage 50 UK

Der User Und Password Eigenschaften müssen auf gültige Sage 50 UK Benutzeranmeldeinformationen gesetzt werden. Diese Werte sind dieselben Werte, die zum Anmelden bei der Sage 50 UK -Software verwendet werden. Um sich mit HTTP-Digest beim SData-Dienst zu authentifizieren, setzen Sie AuthScheme zu Digest. Ansonsten Basic AuthScheme wird verwendet.

• Sie verwenden UNC-Pfade zum Ordner auf dem Computer, den Sie als SData-Anbieter verwenden.
• Sie legen die Anmelderechte für den SData-Dienst für einen Benutzer fest, der über vollständige Rechte für die Netzwerkfreigabe oder das zugeordnete Laufwerk verfügt.

Starten Sie den SData-Dienst

Der Sage 50 UK -Connector stellt über den Sage SData-Dienst (das Web-Toolkit von Sage zum Herstellen einer Verbindung mit Sage-Instanzen) eine Verbindung zu Sage Sage 50 UK her, der in die Sage 50 UK -Software integriert ist. SData ermöglicht den Fernzugriff auf Sage-Softwareanwendungen. Standardmäßig ist Sage UK 2015-Instanzen SData aktiviert und einsatzbereit.

Mit den folgenden Schritten können Sie überprüfen, ob der SData-Dienst gestartet wurde.

1. Sofern Sie dies noch nicht getan haben, öffnen Sie Sage 50.
2. Navigieren Sie zu Extras > Internetoptionen. Das Fenster „Internetoptionen“ wird angezeigt.
3. Wählen Sie die Tab „Sdatasettings“. Eine Liste der aktuell verfügbaren Sage-Softwareanwendungen wird angezeigt.
4. Um den SData-Dienst für die Anwendung zu aktivieren, wählen Sie die Option „Ein“.
5. Wenn der SData-Dienststatus nicht „SData wird derzeit ausgeführt“ lautet, klicken Sie auf die Schaltfläche „Erweitert“.
6. Geben Sie im angezeigten Dialogfeld die beim Herstellen der Verbindung gewünschte Portnummer an und klicken Sie auf die Schaltfläche „Neu starten“.
7. Wenn die Schaltfläche „Windows Firewall“ aktiviert ist, klicken Sie auf diese Schaltfläche, um den Port freizugeben. Wenn auf dem Computer weitere Firewalls installiert sind, stellen Sie sicher, dass diese so konfiguriert sind, dass Verbindungen über die angegebene Port zugelassen werden.

Sobald Sie alle Änderungen übernommen haben, können Sie eine Verbindung zu Ihrer Sage 50 UK -Software herstellen.

HTTPS-Unterstützung aktivieren

Der Sage SData-Dienst bietet sichere und verschlüsselte Verbindungen über HTTPS. Die Vertraulichkeit der Daten und die Authentizität des Servers werden durch digitale Zertifikate gewährleistet. Wenn Sie kein Zertifikat haben, generieren Sie mithilfe von IIS ein selbstsigniertes Zertifikat.

Sie können die folgenden Schritte ausführen, um den SData-Dienst für die Verwendung eines Zertifikats zu konfigurieren. Der Connector validiert dieses Zertifikat standardmäßig anhand des System-Truststores. Wenn Sie ein selbstsigniertes Zertifikat generiert haben, können Sie das Zertifikat diesem Zertifikatspeicher hinzufügen oder festlegen SSLServerCert.

Siehe Erweiterte Funktionen für weitere Informationen zur Konfiguration des Connectors für HTTPS.

Erfüllen Sie die Zertifikatsanforderungen

Das Zertifikat hat die folgenden Anforderungen:

• Das Zertifikat muss eine vollständig gültige Vertrauenskette aufweisen.
• Der allgemeine Name (CN) für das Zertifikat muss mit dem Computer-/Domänennamen übereinstimmen, auf dem der SData-Dienst ausgeführt wird. Um sicherzustellen, dass der CN korrekt ist, generieren Sie das selbstsignierte Zertifikat auf dem Computer, auf dem Sage 50 SData ausgeführt wird.
• Das Zertifikat muss dem persönlichen Zertifikatspeicher „Mein Zertifikat“ für das Konto „Lokaler Computer“ hinzugefügt werden.

Konfigurieren des SData-Dienstes für TLS/SSL

Anschließend können Sie den SData-Dienst für die Verwendung des Zertifikats konfigurieren:

1. Navigieren Sie zu C:\Programme (x86)\Gemeinsame Dateien\Sage SData und öffnen Sie Sage.SData.Service.Config.UI.exe.

2. Klicken Sie auf die Schaltfläche „Erweitert“. Das Fenster „SData-Konfiguration“ wird angezeigt.

3. Wählen Sie die Option „HTTPS-Zugriff aktivieren“ und wählen Sie den gewünschten Port aus.

4. Wenn auf Ihrem Computer eine Firewall installiert ist, stellen Sie sicher, dass die angegebenen Ports nicht blockiert sind.

5. Klicken Sie auf die Schaltfläche neben dem Feld „Zertifikat“.

6. Wählen Sie im angezeigten Dialogfeld das Zertifikat aus. Wenn Sie ein Zertifikat auswählen und der Zertifikatsname im Textfeld „Zertifikat“ nicht angezeigt wird, liegt dies höchstwahrscheinlich an fehlenden erweiterten Eigenschaften im Zertifikat. Zu den erweiterten Eigenschaften gehören Fingerabdruck, Fingerabdruckalgorithmus, Schlüsselverwendung und erweiterte Schlüsselverwendung.

   Verwenden Sie IIS, um dieses Problem zu vermeiden: IIS füllt diese Felder automatisch aus, wenn ein selbstsigniertes Zertifikat generiert wird.

7. Klicken Sie auf „OK“, um den Server neu zu starten.

8. Stellen Sie sicher, dass die Option „HTTPS aktivieren“ im SData-Konfigurationsfenster ausgewählt ist.

Fehlerbehebung

Wenn das SData-Konfigurationsfenster geschlossen und erneut geöffnet wird, die Option HTTPS aktivieren jedoch nicht aktiviert ist, liegt dies höchstwahrscheinlich daran, dass die Datei Sage.SData.Service.exe.config nicht ordnungsgemäß aktualisiert wurde. Befolgen Sie die nachstehenden Schritte, um die alternative Konfigurationsdatei unten zu verwenden.

Sie benötigen den Fingerabdruck des Zertifikats. Beachten Sie, dass die Fingerabdruckdaten Leerzeichen enthalten. Die Fingerabdruckdaten können mithilfe von Windows Diensten abgerufen werden. Sie können auch im SData-Konfigurationsfenster auf den Fingerabdruck zugreifen:

1. Sofern noch nicht geschehen, öffnen Sie die Anwendung Sage.SData.Service.Config.UI.exe und öffnen Sie die erweiterten Einstellungen.
2. Klicken Sie auf die Schaltfläche neben dem Feld „Zertifikat“.
3. Klicken Sie im Windows Sicherheitsdialogfeld auf „Klicken Sie hier, um die Zertifikatseigenschaften anzuzeigen“. Das Fenster „Zertifikatdetails“ wird angezeigt.
4. Kopieren Sie auf der Tab „Details“ den Wert im Feld „Fingerabdruck“.

Verwenden Sie diesen Wert im CertificateLookupValue Einstellung in der Konfigurationsdatei. Beispiel:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="Sage.SData.Service.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
<section name="Sage.Integration.Server.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
<section name="Sage.Common.Syndication.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
</sectionGroup>
</configSections>
<applicationSettings>
<Sage.SData.Service.Properties.Settings>
<setting name="DigestTimeout" serializeAs="String">
<value>12000000000</value>
</setting>
<setting name="EnableBasicAuthentication" serializeAs="String">
<value>True</value>
</setting>
<setting name="WebAppPath" serializeAs="String">
<value />
</setting>
<setting name="EnableSSL" serializeAs="String">
<value>True</value>
</setting>
<setting name="Port" serializeAs="String">
<value>443</value>
</setting>
</Sage.SData.Service.Properties.Settings>
<Sage.Integration.Server.Properties.Settings>
<setting name="EnableBroadcast" serializeAs="String">
<value>False</value>
</setting>
</Sage.Integration.Server.Properties.Settings>
<Sage.Common.Syndication.Properties.Settings>
<setting name="IPAddress" serializeAs="String">
<value />
</setting>
<setting name="Server" serializeAs="String">
<value>sdata</value>
</setting>
<setting name="EnableSSLPort" serializeAs="String">
<value>True</value>
</setting>
<setting name="Port" serializeAs="String">
<value>5493</value>
</setting>
<setting name="SettingsProviderType" serializeAs="String">
<value>Sage.Common.Syndication.ConfigurationSyndicationSettings, Sage.Common.Syndication</value>
</setting>
<setting name="PathPrefix" serializeAs="String">
<value />
</setting>
<setting name="DoNotUseRegistry" serializeAs="String">
<value>False</value>
</setting>
<setting name="EnableStandardPort" serializeAs="String">
<value>True</value>
</setting>
<setting name="SSLPort" serializeAs="String">
<value>5494</value>
</setting>
<setting name="CertificateLookupValue" serializeAs="String">
<value>ENTER YOUR CERTIFICATE THUMBPRINT HERE</value>
</setting>
<setting name="CertificateLookupType" serializeAs="String">
<value>Thumbprint</value>
</setting>
</Sage.Common.Syndication.Properties.Settings>
</applicationSettings>
</configuration>

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

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Sage 50 UK -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 TradingAccounts 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

Der Sage 50 UK -Connector modelliert Sage 50 UK Entitäten in relationalen Tabellen und Ansichten.

Tabellen

Tabellen beschreibt die verfügbaren Tabellen.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können. Normalerweise werden schreibgeschützte Daten als Ansichten angezeigt.

Tabellen

Der Connector modelliert die Daten in Sage 50 UK als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Sage 50 UK Verbindungstabellen

Rohstoffe

Erstellen, Aktualisieren und Abfragen von Waren (Produkten und Dienstleistungen) innerhalb von Sage UK 50-Konten.

Tabellenspezifische Informationen

Mithilfe der Tabelle „Rohstoffe“ können Sie Rohstoffe (Produkte und Dienstleistungen) in einem Sage 50 UK -Unternehmensdatensatz auswählen, einfügen und aktualisieren.

Wählen

Die Tabelle „Commodities“ gibt die Produkte und Dienstleistungen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM Commodities WHERE ProductCode LIKE 'ABC%'

Einfügen

Um einen neuen Warendatensatz zu erstellen, ist das Beschreibungsfeld erforderlich.

INSERT INTO Commodities (ProductCode, Description, SupplierReference, CatalogueNumber, WebDescription, Cost)

VALUES ('MNP', 'MyNewProduct', 'UNI001', 'U143', 'My Web Description', 5.49)

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden.

UPDATE Commodities SET Description = 'My New Description' WHERE CommodityUUID = '8c47b43a-7115-7419-9679-7c72586e67d1'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kontakte

Kontakte in Sage UK 50-Konten erstellen, aktualisieren, löschen und abfragen.

Tabellenspezifische Informationen

Mithilfe der Tabelle „Kontakte“ können Sie Kontakte in einem Sage 50 UK Unternehmensdatensatz auswählen, einfügen, aktualisieren und löschen.

Wählen

Die Tabelle „Kontakte“ gibt die Kontakte zurück, die in einem Sage 50 UK Unternehmensdatensatz enthalten sind.

SELECT * FROM Contacts WHERE TradingAccountReference = 'ABC123'

Einfügen

Um einen neuen Kontaktdatensatz zu erstellen, sind die Felder TradingAccountReference und Type erforderlich.

INSERT INTO Contacts (Title, FirstName, MiddleName, FamilyName, Suffix, TradingAccountReference, Type, PostalAddressAddress1, PostalAddressTownCity, PostalAddressStateRegion, PostalAddressZipPostCode, PostalAddressType, PostalAddressDescription, Phone1Text, Phone1Type, Phone2Text, Phone2Type, EmailAddress)

VALUES (True, 'Dr.', 'INSERT', 'ME', 'NOW', 'Jr.', 'CNTCTEST', 'Customer Delivery Contact', '123 Main St', 'Durham', 'NC', '12345', 'Shipping', 'NEW Description', '123-456-7890', 'Business Phone', '555-444-1111', 'Fax', 'test@cdata.com')

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden. Für einige Felder eines Kontaktdatensatzes gelten Anforderungen:

• Um eine vorhandene Postanschrift zu aktualisieren, ist PostalAddressUUID erforderlich. Andernfalls, wenn die Postanschrift null ist, geben Sie die Details an und lassen Sie die UUID leer.
• Um ein vorhandenes Phone1 zu aktualisieren, ist Phone1UUID erforderlich. Andernfalls, wenn Phone1 leer ist, geben Sie die Details an und lassen Sie die UUID leer.
• Um ein vorhandenes Phone2 zu aktualisieren, ist Phone2UUID erforderlich. Andernfalls, wenn Phone2 leer ist, geben Sie die Details an und lassen Sie die UUID leer.
• Um eine vorhandene Email-Adresse zu aktualisieren, ist EmailUUID erforderlich. Andernfalls, wenn die Email leer ist, geben Sie die Details an und lassen Sie die UUID leer.

UPDATE Contacts SET EmailAddress = 'test@server.com', Phone1Text = '999-999-9999'
WHERE ContactUUID = '96df2e1e-72c6-4b52-b39a-eeb42c840f87' AND Phone1UUID = 'bd621624-f78e-4dec-abf3-b8b94d8fe7a3' AND EmailUUID = 'a3f6ff1b-a80b-4019-ae5e-b1fa1bb4044d'

Löschen

Beim Löschen eines Kontaktdatensatzes werden auch alle mit dem Kontakt verknüpften Postanschriften, Telefonnummern und Emails gelöscht.

DELETE FROM Contacts WHERE ContactUUID = '96df2e1e-72c6-4b52-b39a-eeb42c840f87'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bestellungen

Erstellen, Aktualisieren, Löschen und Abfragen von Bestellungen innerhalb von Sage UK 50 Accounts.

Tabellenspezifische Informationen

Mithilfe der Tabelle „PurchaseOrders“ können Sie Bestellungen in einem Sage 50 UK -Unternehmensdatensatz auswählen, einfügen, aktualisieren und löschen.

Wählen

Die Tabelle „PurchaseOrders“ gibt die Bestellungen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM PurchaseOrders WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Einfügen

Um einen neuen PurchaseOrder-Datensatz zu erstellen, ist das Feld TradingAccountUUID erforderlich.

Bestellpositionen werden über ein XML-Aggregat in der Spalte ItemsAggregate angegeben. Die Spalten, die in diesen Aggregaten verwendet werden können, sind in PurchaseOrderLineItems definiert Tabelle.

Das folgende Beispiel zeigt, wie eine neue Bestellung mit zwei Positionen eingefügt wird:

INSERT INTO PurchaseOrders (TradingAccountUUID, DeliveryDate, PostalAddressName, PostalAddressType, PostalAddressAddress1, PostalAddressTownCity, PostalAddressStateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', '05/05/2015', 'Purchase Order Billing Address', 'Billing', '123 Main St', 'Chapel Hill', 'NC',
'<PurchaseOrderLineItems>
<Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53123e67c8</CommodityUUID><Quantity>1</Quantity><ActualPrice>1.99</ActualPrice></Row>
<Row><CommodityUUID>586df2bb-7702-4228-b464-e8d509148547</CommodityUUID><Quantity>4</Quantity><ActualPrice>4.99</ActualPrice></Row>
</PurchaseOrderLineItems>')

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden.

Beim Aktualisieren eines PurchaseOrder-Datensatzes ist PostalAddressUUID erforderlich, wenn eine Postanschrift aktualisiert wird. Beachten Sie, dass Bestellpositionen weder aktualisiert noch gelöscht werden können.

UPDATE PurchaseOrders SET PostalAddressZipPostCode = '12345'

WHERE PurchaseOrderUUID = '1b47b43a-7115-4863-9679-1a78636e67c1' AND PostalAddressUUID = '28915e09-b2a1-47e1-b193-741b32ba8ba0'

Löschen

Wenn Sie einen Bestelldatensatz löschen, werden auch alle mit der Bestellung verknüpften Positionen und Postanschriften gelöscht.

DELETE FROM PurchaseOrders WHERE PurchaseOrderUUID = '1b47b43a-7115-4863-9679-1a78636e67c1'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufscredits

SalesCredits innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Mit der Tabelle „SalesCredits“ können Sie Verkaufsgutschriften in einem Sage 50 UK -Unternehmensdatensatz auswählen, einfügen, aktualisieren und löschen.

Wählen

Die Tabelle „SalesCredits“ gibt die Verkaufsgutschriften für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesCredits WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Einfügen

Um einen neuen SalesCredits-Datensatz zu erstellen, ist das Feld TradingAccountUUID erforderlich.

Verkaufskreditpositionen werden über ein XML-Aggregat in der Spalte ItemsAggregate angegeben. Die Spalten, die in diesen Aggregaten verwendet werden können, sind in SalesCreditLineItems definiert Tabelle.

Das folgende Beispiel zeigt, wie eine neue Bestellung mit zwei Positionen eingefügt wird:

INSERT INTO SalesCredits (TradingAccountUUID, Type,  PostalAddress1Name, PostalAddress1Type, PostalAddress1Address1, PostalAddress1TownCity, PostalAddress1StateRegion, PostalAddress2Name, PostalAddress2Type, PostalAddress2Address1, PostalAddress2TownCity, PostalAddress2StateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', 'Product Credit Note',  'Sales Order Delivery Address', 'Shipping', '123 Main St', 'Chapel Hill', 'NC', 'Sales Order Billing Address', 'Billing', '987 Center Road', 'Chapel Hill', 'NC',
'<SalesCreditLineItems>
<Row><CommodityUUID>03ecf74f-0f08-4667-8a59-07e6338a8b32</CommodityUUID><Quantity>1</Quantity><ActualPrice>2.99</ActualPrice></Row>
<Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53123e67c8</CommodityUUID><Quantity>2</Quantity><ActualPrice>3.99</ActualPrice></Row>
</SalesCreditLineItems>')

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden.

Beim Aktualisieren eines SalesCredits-Datensatzes sind PostalAddress1UUID oder PostalAddress2UUID erforderlich, wenn die jeweilige Postanschrift aktualisiert wird. Beachten Sie, dass Verkaufsguthabenpositionen weder aktualisiert noch gelöscht werden können.

UPDATE SalesCredits SET PostalAddress2ZipPostCode = '12345'

WHERE SalesCreditUUID = '392235af-f45a-4c43-a275-897130e4fdc4' AND PostalAddress2UUID = '28915e09-b2a1-47e1-b193-741b32ba8ba0'

Löschen

Wenn Sie einen SalesCredit-Datensatz löschen, werden auch alle mit dem SalesCredit verknüpften Einzelposten und Postanschriften gelöscht.

DELETE FROM SalesCredits WHERE SalesCreditUUID = '392235af-f45a-4c43-a275-897130e4fdc4'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufsrechnungen

Verkaufsrechnungen innerhalb von Sage UK 50 Accounts abfragen.

Tabellenspezifische Informationen

Mit der Tabelle „SalesInvoices“ können Sie Verkaufsrechnungen in einem Sage 50 UK -Unternehmensdatensatz auswählen, einfügen, aktualisieren und löschen.

Wählen

Die Tabelle „SalesInvoices“ gibt die Verkaufsrechnungen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesInvoices WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Einfügen

Um einen neuen SalesInvoices-Datensatz zu erstellen, ist das Feld TradingAccountUUID erforderlich.

Verkaufsrechnungspositionen werden über ein XML-Aggregat in der Spalte ItemsAggregate angegeben. Die Spalten, die in diesen Aggregaten verwendet werden können, sind in SalesInvoiceLineItems definiert Tisch.

Das folgende Beispiel zeigt, wie eine neue Verkaufsrechnung mit zwei Positionen eingefügt wird:

INSERT INTO SalesInvoices (TradingAccountUUID, Type, PostalAddress1Name, PostalAddress1Type, PostalAddress1Address1, PostalAddress1TownCity, PostalAddress1StateRegion, PostalAddress2Name, PostalAddress2Type, PostalAddress2Address1, PostalAddress2TownCity, PostalAddress2StateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', 'Product Invoice', 'Sales Order Delivery Address', 'Shipping', '123 Main St', 'Chapel Hill', 'NC', 'Sales Order Billing Address', 'Billing', '987 Center Road', 'Chapel Hill', 'NC', '<SalesInvoiceLineItems> <Row><CommodityUUID>03ecf74f-0f08-4667-8a59-07e6338a8b32</CommodityUUID><Quantity>2</Quantity><ActualPrice>2.99</ActualPrice></Row> <Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53123e67c8</CommodityUUID><Quantity>1</Quantity><ActualPrice>4.99</ActualPrice></Row>
</SalesInvoiceLineItems>')

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden.

Beim Aktualisieren eines SalesInvoices-Datensatzes sind PostalAddress1UUID und PostalAddress2UUID erforderlich, wenn eine Postanschrift aktualisiert wird (bzw.). Beachten Sie, dass Verkaufsrechnungspositionen weder aktualisiert noch gelöscht werden können.

UPDATE SalesInvoices SET PostalAddress2ZipPostCode = '12345'

WHERE SalesInvoiceUUID = '392235af-f45a-4c43-a275-897130e4fdc4' AND PostalAddress2UUID = '28915e09-b2a1-47e1-b193-741b32ba8ba0'

Löschen

Wenn Sie einen SalesInvoice-Datensatz löschen, werden auch alle mit der SalesInvoice verknüpften Einzelposten und Postanschriften gelöscht.

DELETE FROM SalesInvoices WHERE SalesInvoiceUUID = '392235af-f45a-4c43-a275-897130e4fdc4'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufsaufträge

Verkaufsaufträge in Sage UK 50-Konten erstellen, aktualisieren, löschen und abfragen.

Tabellenspezifische Informationen

Mit der Tabelle „SalesOrders“ können Sie Verkaufsaufträge in einem Sage 50 UK -Unternehmensdatensatz auswählen, einfügen, aktualisieren und löschen.

Wählen

Die Tabelle „SalesOrders“ gibt die Verkaufsaufträge für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesOrders WHERE Date >= '1/1/2015' AND Date < '2/1/2015'

Einfügen

Um einen neuen SalesOrder-Datensatz zu erstellen, ist das Feld TradingAccountUUID erforderlich.

Verkaufsauftragspositionen werden über ein XML-Aggregat in der Spalte ItemsAggregate angegeben. Die Spalten, die in diesen Aggregaten verwendet werden können, sind in SalesOrderLineItems definiert-Tabelle. Hinweis: Beim Hinzufügen eines SalesOrderLineItem muss eine CommodityUUID festgelegt werden, da nur auf vorhandene Commodities verwiesen werden kann (um eine neue Commodity zu erstellen, muss die Commodities Tabelle kann verwendet werden).

Das folgende Beispiel zeigt, wie eine neue Verkaufsbestellung mit zwei Positionen eingefügt wird:

INSERT INTO SalesOrders (TradingAccountUUID, DueDate, PostalAddress1Name, PostalAddress1Type, PostalAddress1Address1, PostalAddress1TownCity, PostalAddress1StateRegion, ItemsAggregate)
VALUES ('b83c940f-9d2b-4a35-bf42-28bbe07ef994', True, '05/05/2015', 'Sales Order Delivery Address', 'Shipping', '123 Main St', 'Chapel Hill', 'NC',
'<SalesOrderLineItems>
<Row><CommodityUUID>0a47b43d-7115-4863-9689-1a53123e67c8</CommodityUUID><Quantity>1</Quantity><ActualPrice>1.99</ActualPrice></Row>
<Row><CommodityUUID>586df2bb-7702-4228-b464-e8d509148547</CommodityUUID><Quantity>4</Quantity><ActualPrice>4.99</ActualPrice></Row>
</SalesOrderLineItems>')

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden.

Beim Aktualisieren eines SalesOrder-Datensatzes sind PostalAddress1UUID und PostalAddress2UUID erforderlich, wenn die jeweilige Postanschrift aktualisiert wird. Beachten Sie, dass Verkaufsauftragspositionen weder aktualisiert noch gelöscht werden können.

UPDATE SalesOrders SET PostalAddress1ZipPostCode = '12345'

WHERE SalesOrderUUID = '957af245-4678-4ca9-904a-162dcce87e5b' AND PostalAddress1UUID = '28915e09-b2a1-47e1-b193-741b32ba8ba0'

Löschen

Wenn Sie einen SalesOrder-Datensatz löschen, werden auch alle mit dem SalesOrder verknüpften Positionen und Postanschriften gelöscht.

DELETE FROM SalesOrders WHERE SalesOrderUUID = '957af245-4678-4ca9-904a-162dcce87e5b'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Handelskonten

Handelskonten innerhalb von Sage UK 50 Accounts erstellen, aktualisieren, löschen und abfragen.

Tabellenspezifische Informationen

Mit der Tabelle „TradingAccounts“ können Sie Handelskonten in einem Sage 50 UK -Unternehmensdatensatz auswählen, einfügen und aktualisieren.

Wählen

Die Tabelle „TradingAccounts“ gibt die Handelskontoinformationen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM TradingAccounts

Einfügen

Um einen neuen Handelskontodatensatz zu erstellen, sind die Felder „Name“ und „CustomerSupplierFlag“ erforderlich.

INSERT INTO TradingAccounts (Name, CustomerSupplierFlag, OpenedDate, Website, FinanceBalance, FinanceLimit, Analysis1, Analysis2, Analysis3)

VALUES ('My Trading Account', 'Customer', '05/10/2015', 'www.cdata.com', 100.00, 1000.00, 'Trade', 'Jenkins', 'National')

Aktualisieren

Jedes Feld, das nicht schreibgeschützt ist, kann aktualisiert werden.

UPDATE TradingAccounts SET Analysis3 = 'International' WHERE TradingAccountUUID = '90c7afb4-ad34-41a2-b71d-ef49cc489872'

Löschen

DELETE FROM TradingAccounts WHERE TradingAccountUUID = '90c7afb4-ad34-41a2-b71d-ef49cc489872'

Hinweis: Wenn zusätzliche Ressourcen an das Konto gebunden sind, wird der Datensatz nicht gelöscht. Die Sage API gibt jedoch weiterhin eine

OK-Antwort, die anzeigt, dass der Datensatz gelöscht wurde. Die eigentliche Fehlermeldung kann angezeigt werden, indem versucht wird, das Konto innerhalb der Software selbst zu löschen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Sage 50 UK Connector-Ansichten

Bankkonten

Bankkonten innerhalb von Sage UK 50 Accounts abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „Bankkonten“ gibt die Bankkonten für einen Sage 50 UK Unternehmensdatensatz zurück.

SELECT * FROM BankAccounts

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Finanzbuchhaltung

Finanzkonten innerhalb von Sage UK 50 Accounts abfragen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Interaktionen

Abfrageinteraktionen innerhalb von Sage UK 50-Konten.

Tabellenspezifische Informationen

Wählen

Die Tabelle „Interaktionen“ gibt die Kundeninteraktionsinformationen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM Interactions

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Preise

Preise innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „Preise“ gibt die Preisinformationen zu Produkten und Dienstleistungen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM Prices WHERE Price < 10.00

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Projekte

Projekte innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „Projekte“ gibt Projektinformationen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM Projects

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

BestellungLieferungen

PurchaseOrderDeliveries innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „PurchaseOrderDeliveries“ gibt Lieferinformationen zu Bestellungen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM PurchaseOrderDeliveries

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

BestellungLieferpositionen

PurchaseOrderDeliveryLineItems innerhalb von Sage UK 50 Accounts abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „PurchaseOrderDeliveryLineItems“ gibt Informationen zu den Lieferpositionen von Bestellungen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM PurchaseOrderDeliveryLineItems WHERE GoodsReceivedNumber = '123'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bestellpositionen

PurchaseOrderLines innerhalb von Sage UK 50 Accounts abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „PurchaseOrderLineItems“ gibt Informationen zu Bestellpositionen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM PurchaseOrderLineItems WHERE PurchaseOrderNumber = 'PO123'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Quittungen

Querfragen zu Quittungen innerhalb von Sage UK 50-Konten.

Tabellenspezifische Informationen

Wählen

Die Tabelle „Quittungen“ gibt die Quittungsinformationen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM Receipts

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufskreditpositionen

SalesCreditLineItems innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „SalesCreditLineItems“ gibt Informationen zu Verkaufskreditpositionen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesCreditLineItems WHERE CreditNumber = 'CR123'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufsrechnungspositionen

Abfrage von Verkaufsrechnungspositionen innerhalb von Sage UK 50-Konten.

Tabellenspezifische Informationen

Wählen

Die Tabelle „SalesInvoiceLineItems“ gibt Informationen zu den Einzelposten der Verkaufsrechnung für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesInvoiceLineItems WHERE InvoiceNumber = 'INV123'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufsauftragslieferungen

Fragen Sie SalesOrderDeliveries innerhalb von Sage UK 50-Konten ab.

Tabellenspezifische Informationen

Wählen

Die Tabelle „SalesOrderDeliveries“ gibt Lieferinformationen zu Verkaufsaufträgen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesOrderDeliveries

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufsauftragslieferungspositionen

SalesOrderDeliveryLineItems innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „SalesOrderDeliveryLineItems“ gibt Informationen zu Lieferpositionen von Verkaufsaufträgen für einen Sage 50 UK Unternehmensdatensatz zurück.

SELECT * FROM SalesOrderDeliveryLineItems WHERE GoodsDespatchedNumber = '987'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Verkaufsauftragspositionen

SalesOrderLineItems innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „SalesOrderLineItems“ gibt Informationen zu Verkaufsauftragspositionen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM SalesOrderLineItems WHERE SalesOrderNumber = 'SO123'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Steuercodes

Steuercodes in Sage UK 50-Konten abfragen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Handelsaktivitäten

Handelsaktivitäten innerhalb von Sage UK 50-Konten abfragen.

Tabellenspezifische Informationen

Wählen

Die Tabelle „TradingActivities“ gibt die Handelsaktivitätsinformationen für einen Sage 50 UK -Unternehmensdatensatz zurück.

SELECT * FROM TradingActivities

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Sage 50 UK hinaus erweitern.

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

Gespeicherte Prozeduren für den Sage 50 UK Connector

Preis berechnen

Berechnet den Preis auf Grundlage eines Handelskontos und einer bereitgestellten Ware.

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 50 UK 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 „TradingAccounts“ zurück:

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

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 „TradingAccounts“ ab:

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

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

Schema

Verschiedenes

Authentifizierung

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

AuthScheme

Das zur Authentifizierung verwendete Schema. Akzeptierte Einträge sind Basic, Digest oder None.

Mögliche Werte

Basic, Digest, None

Datentyp

string

Standardwert

Basic

Hinweise

Zusammen mit Passwort und Benutzer, wird dieses Feld zur Authentifizierung gegenüber dem Sage 50 UK Accounts-Dienst verwendet. „Basic“ ist die Standardoption.

• Basic: Legen Sie dies fest, um die HTTP-Basic-Authentifizierung zu verwenden.
• Digest: Legen Sie dies fest, um die HTTP-Digest-Authentifizierung zu verwenden.

URL

URL zum Sage 50 UK SData-Dienst. Beispiel: http://MySite:5493/sdata/accounts50/GCRM/MyDatasetId/.

Datentyp

string

Standardwert

""

Hinweise

URL zum Sage 50 UK SData-Dienst. Beispiel: http://MySite:5493/sdata/accounts50/GCRM/MyDatasetId/.

Die URL erhalten Sie direkt aus Ihrer Sage 50 UK Accounts-Software, indem Sie zu Extras > Internetoptionen > SData-Einstellungen > Details (neben Sage 50 UK Accounts) navigieren. Die Adresse kann dann für den gewünschten Unternehmensdatensatz kopiert werden.

Benutzer

Zur Authentifizierung wird das Sage 50 UK -Benutzerkonto verwendet.

Datentyp

string

Standardwert

""

Hinweise

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

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

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

Seitengröße

Die maximale Anzahl der pro Seite von Sage 50 UK zurückzugebenden Ergebnisse.

Datentyp

int

Standardwert

1000

Hinweise

Der Pagesize Die Eigenschaft beeinflusst die maximale Anzahl der Ergebnisse, die pro Seite von Sage 50 UK zurückgegeben werden. Das Festlegen eines höheren Wertes kann zu einer besseren Leistung führen, allerdings auf Kosten des zusätzlichen Speichers, der pro verbrauchter Seite zugewiesen wird.

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. „*=*“.

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