Avalara Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8936 des Connectors.

Erste Schritte

Avalara Versionsunterstützung

Der Connector nutzt die Avalara Avatax API, um bidirektionalen Zugriff auf Avalara zu ermöglichen.

Herstellen einer Verbindung

Verbinde dich mit Avalara

Standardmäßig stellt der Connector eine Verbindung zu einer Umfeld her. Set UseSandbox Zu true um den Connector für die Verbindung mit einer Avalara Sandbox Umfeld zu konfigurieren.

Authentifizieren Sie sich bei Avalara

Für die Verbindung mit der Avalara Datenquelle stehen zwei Authentifizierungsmethoden zur Verfügung: Basic und LicenseKey.

Anmeldeinformationen

Um Anmeldeinformationen zur Authentifizierung zu verwenden, legen Sie Folgendes fest:

• AuthScheme: Setzen Sie dies auf Basic.
• User: Legen Sie hier Ihren Avalara-Benutzernamen fest.
• Password: Legen Sie hier Ihr Avalara-Passwort fest.

Kontonummer und Lizenzschlüssel

Alternativ können Sie sich mit Ihrer Kontonummer und Ihrem Lizenzschlüssel authentifizieren. Stellen Sie wie folgt eine Verbindung zur Datenquelle her:

• AuthScheme: Setzen Sie dies auf LicenseKey.
• AccountId: Setzen Sie dies auf Ihre Avalara-Konto-ID. Die Konto-ID finden Sie in der oberen rechten Ecke der Avalara Administratorkonsole.
• LicenseKey: Setzen Sie dies auf Ihren Avalara-Lizenzschlüssel. Sie können einen Lizenzschlüssel generieren, indem Sie sich als Kontoadministrator bei Avalara anmelden und zu navigieren Settings > Reset License Key.

Optimieren des Datenzugriffs

Optimieren des Datenzugriffs

Sie können die folgenden Eigenschaften verwenden, um mehr Kontrolle über die von Avalara zurückgegebenen Daten zu erhalten:

• CompanyCode: Es werden nur Transaktionsinformationen zurückgegeben, die mit diesem Firmencode verknüpft sind.
• IncludeAdjustedTransactions: Setzen Sie dies auf true um angepasste Transaktionen in die Transaktionsliste aufzunehmen.

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 Avalara-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 mithilfe der Privater Agent Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Avalara und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Avalara-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 Transactions 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"

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

Dieser Abschnitt zeigt die verfügbaren API Objekte und bietet weitere Informationen zur Ausführung von SQL für Avalara APIs.

Hauptmerkmale

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

Tabellen

Tabellen beschreibt die verfügbaren Tabellen. Tabellen werden statisch definiert, um Konten, Transaktionen, Benutzer und mehr zu modellieren.

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten werden statisch definiert, um Berichte, Abonnements und mehr zu modellieren.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Avalara. Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Operationen an Avalara, einschließlich dem Herunterladen von Dokumenten und dem Verschieben von Umschlägen.

Tabellen

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

Avalara Connector-Tabellen

Konten

Kontentabelle für den AvalaraAvatax-Datenanbieter.

Wählen

Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die meisten Spalten unterstützen serverseitiges Filtern mit den folgenden Operatoren: =,>,<,<=,>=,IN,NOT,IN,AND,OR,LIKE. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Accounts WHERE accountStatusId = 'Active' AND accountTypeId = 'Regular1'

Einfügen

So fügen Sie ein Konto hinzu.

INSERT INTO Accounts (id, name, effectiveDate, accountStatusId, accountTypeId) VALUES ('12345', 'Test Account', '2019-06-24T00:00:00+00:00', 'Test', 'Regular')

Aktualisieren

Avalara ermöglicht die Aktualisierung von Kontospalten.

UPDATE Accounts SET crmid = '0010b000Ardit' WHERE ID = 2000137504

Um AccountsSubscriptions zu aktualisieren, sollte die Tabelle #TEMP verwendet werden.

INSERT INTO AccountsSubscriptions#TEMP (subscriptionDescription, id) VALUES ('Avacert2', '567961')
UPDATE Accounts SET linkedSubscriptions = 'AccountsSubscriptions#TEMP', crmid = '0010b000Ardit' WHERE ID = 2000137504

Löschen

Konten können gelöscht werden, indem die ID der Adresse angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM Accounts WHERE ID = 100

Spalten

Chargen

Batchtabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Erstellen Sie Charge-Objekte, die an ein Unternehmen angehängt sind. Jedes Charge-Objekt muss ein Dateiobjekt haben. Wenn ein Charge erstellt wird, wird es zur AvaTax-Batch-Warteschlange hinzugefügt und so schnell wie möglich in der Reihenfolge verarbeitet, in der es empfangen wurde. Als Ergebnis dieser Operation erhalten Sie den Status eines Charge. Fügen Sie zuerst die Datei ein und verweisen Sie mithilfe der Tabelle #TEMP auf den lokalen Pfad der Datei auf Ihrem Computer:

INSERT INTO File#TEMP (Name, FileLocalPath, ContentType) VALUES ('samplebatch.csv', 'C:\Users\User\Desktop\BatchFile.csv', 'text/csv')

Dann in die Haupttabelle „Chargen“ einfügen. Die folgenden Felder sind erforderlich:

INSERT INTO Batches (CompanyId, Name, LinkedFiles, Type) VALUES ('247015', 'TestBatch2', 'File#TEMP', 'TransactionImport')

Aktualisieren

Der UPDATE Operation wird für die Batches-Tabelle nicht unterstützt.

Löschen

Wenn Sie versuchen, einen Charge zu löschen, der gerade verarbeitet wird, erhalten Sie eine Fehlermeldung. Durch das Löschen eines Charge werden keine Transaktionen gelöscht, die durch das Importieren des Charge erstellt wurden. Zum Löschen eines Charge ist eine der folgenden Benutzerrollen erforderlich: CSPAdmin, CSPTester, SSTAdmin, SystemAdmin, SystemOperator, TechnicalSupportAdmin; Companyid und ID müssen in der WHERE-Klausel angegeben werden.

DELETE FROM Batches WHERE ID = 9030440 AND CompanyId = 247015

Spalten

Unternehmen

Unternehmenstabelle für den Datenanbieter AvalaraAvatax.

Einfügen

Um einem bestehenden Konto ein neues Unternehmen hinzuzufügen, müssen Sie die Felder „AccountId“, „CompanyCode“, „Name“ und „DefaultCountry“ angeben.

INSERT INTO Companies (AccountId, CompanyCode, Name, defaultCountry) VALUES ('2000137504', 'SAB', 'SAB&Co', 'US')

Aktualisieren

Avalara erlaubt UPDATES für Firmenspalten, außer für aggregierte Spalten. Aggregierte Spalten können nicht aktualisiert werden.

UPDATE Companies SET Name = 'UpdatedName' WHERE ID = 283040

Löschen

Ein Unternehmen kann gelöscht werden, indem die ID des Unternehmens angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM Companies WHERE ID = 283040

Spalten

Kontakte

Kontakttabelle für den AvalaraAvatax-Datenanbieter.

Wählen

Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die meisten Spalten unterstützen serverseitiges Filtern mit den folgenden Operatoren: =,>,<,<=,>=,IN,NOT,IN,AND,OR,LIKE. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Contacts WHERE companyid = 247015
SELECT * FROM Contacts WHERE companyid = 247015 AND region = 'NY'

Einfügen

Um einen Kontakt hinzuzufügen, ist „ContactCode“ ein Pflichtfeld.

INSERT INTO Contacts (companyId, contactCode, firstName, lastName, title, line1, city, region, postalCode, country, email, phone) VALUES ('247015', 'TestContactc7356131ca2442', " +
"'Bob', 'McExample', 'Owner', '2000 Main Street', 'Irvine', 'CA', '92614', 'US', 'bob@example.org', '714 555-1212')

Aktualisieren

Avalara ermöglicht die Aktualisierung von Kontaktspalten. Um einen Kontakt zu aktualisieren, müssen ID und CompanyId in der WHERE-Klausel der Update-Anweisung angegeben werden.

UPDATE Contacts SET firstName = 'tidra' WHERE CompanyId = 247015 AND ID = 175596

Löschen

Kontakte können gelöscht werden, indem Sie die Firmen-ID und die ID des Kontakts angeben und eine DELETE-Anweisung ausführen.

DELETE FROM Contacts WHERE ID = 100

Spalten

Kunden

Kundentabelle für den AvalaraAvatax-Datenanbieter.

Wählen

Um Kundendatensätze aus der Tabelle „Kunden“ abzurufen, müssen in der WHERE-Klausel mindestens CompanyId oder CompanyId und CustomerCode angegeben werden. Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die Felder CompanyId und CustomerCode unterstützen serverseitiges Filtern mit dem Operator =. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Customers WHERE CompanyId = '247015'
SELECT * FROM Contacts WHERE CompanyId = 247015 AND CustomerCode = 'CC001'

Spalten

Datenquellen

DataSources-Tabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Um eine Datenquelle zu erstellen, müssen mindestens CompanyId und Source angegeben werden.

INSERT INTO DataSources (CompanyId, Source) VALUES (247015, 'Amazon v2 Extractor')

Aktualisieren

Um eine Datenquelle zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE DataSources SET isEnabled = true WHERE ID = 297 AND CompanyId = 247015

Löschen

Um einen Benutzer zu löschen, müssen Sie ID und AccountId in der WHERE-Klausel angeben.

DELETE FROM DataSources WHERE ID = 297 AND CompanyId = 247015

Spalten

DistanzSchwellenwerte

DistanceThresholds-Tabelle für den Datenanbieter AvalaraAvatax.

Ein Unternehmens-Distanzschwellenwertmodell gibt die Distanz zwischen einem Unternehmen und den Steuergrenzen verschiedener Länder an. Distanzschwellenwerte sind erforderlich, um einige Mehrwertsteuern korrekt zu berechnen.

Einfügen

Um ein Distanzschwellenwertobjekt zu erstellen, benötigen Sie eine der folgenden Benutzerrollen: AccountAdmin, CompanyAdmin, CSPAdmin, CSPTester, SiteAdmin, SSTAdmin, SystemAdmin, TechnicalSupportAdmin. Mindestens die folgenden Felder sollten angegeben werden:

INSERT INTO DistanceThresholds (companyId, originCountry, destinationCountry, type) VALUES (283040, 'FR', 'BR', 'Purchase')

Aktualisieren

Um einen Entfernungsschwellenwert zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE DistanceThresholds SET EffDate = '2019/11/08' WHERE ID = 11785 AND CompanyId = 283040

Löschen

Um einen Distanzschwellenwert zu löschen, müssen Sie ID und AccountId in der WHERE-Klausel angeben.

DELETE FROM DistanceThresholds WHERE ID = 11785 AND CompanyId = 283040

Spalten

AblageKalender

FilingCalendars-Tabelle für den AvalaraAvatax-Datenanbieter.

Wählen

Um Datensätze aus der FilingCalendar-Tabelle abzurufen, muss in der WHERE-Klausel mindestens CompanyId angegeben werden. Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die meisten Spalten unterstützen serverseitiges Filtern mit den folgenden Operatoren: =,>,<,<=,>=,IN,NOT,IN,AND,OR,LIKE. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM FilingCalendars WHERE CompanyId = '247015' AND Success = False

Spalten

Artikel

Artikeltabelle für den AvalaraAvatax-Datenanbieter.

Wählen

Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die meisten Spalten unterstützen serverseitiges Filtern mit den folgenden Operatoren: =,>,<,<=,>=,IN,NOT,IN,AND,OR,LIKE. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Items WHERE CompanyId = 247015 AND Description LIKE '%MUG'
SELECT * FROM Items WHERE CompanyId = 247015 AND ModifiedUserId IN (289767, 1354)

Einfügen

Um einen Artikel hinzuzufügen.

INSERT INTO Items (companyId, itemCode, taxCode, description, itemGroup) VALUES ('247015', 'CERMUG1', 'P0000000', 'Ceramic Mug', 'Mugs')")

Um einen Artikel mit ItemsClassifications hinzuzufügen, muss die Tabelle #TEMP verwendet werden

INSERT INTO Itemsclassifications#TEMP (productCode, systemCode) VALUES ('P0000000', 'TARIC')")
INSERT INTO Items (companyId, itemCode, taxCode, description, itemGroup, Linkedclassifications) VALUES ('247015', 'CERMUG', 'P0000000', 'Ceramic Mug', 'Mugs', 'Itemsclassifications#TEMP')")
INSERT INTO Items (companyId, itemCode, taxCode, description, itemGroup) VALUES ('247015', 'CERMUG1', 'P0000000', 'Ceramic Mug', 'Mugs')")

Aktualisieren

Avalara ermöglicht Aktualisierungen von Artikelspalten.

UPDATE Items SET Description = 'description', itemcode = 'CERMUG' WHERE ID = '189117938' AND CompanyId = '247015'

Um ItemsClassifications zu aktualisieren, sollte eine #TEMP-Tabelle verwendet werden.

INSERT INTO Itemsclassifications#TEMP (systemcode, productcode) VALUES ('P0000001', 'AVATAXCEDE')")
UPDATE items SET description = 'description', itemcode = 'CERMUG', linkedclassifications = 'Itemsclassifications#TEMP' WHERE ID = '189117938' AND companyId = '247015'")

Löschen

Elemente können gelöscht werden, indem die ID der Adresse angegeben und eine DELETE-Anweisung ausgegeben wird.

DELETE FROM Items WHERE ID = 100

Spalten

Standorte

Standorttabelle für den Datenanbieter AvalaraAvatax.

Einfügen

Um einen Standort zu erstellen, müssen mindestens die folgenden Felder angegeben werden.

INSERT INTO Locations (CompanyId, Line1, LocationCode, AddressTypeId, AddressCategoryId, PostalCode, Country) VALUES (247015, '2000 Main Street', 'L001', 'Location', 'MainOffice', 92614, 'US')

Aktualisieren

Um einen Standort zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE Locations SET City = 'Irvine' WHERE ID = 56789 AND CompanyId = 247015

Löschen

Um einen Standort zu löschen, müssen Sie ID und AccountId in der WHERE-Klausel angeben.

DELETE FROM Locations WHERE ID = 56789 AND CompanyId = 247015

Spalten

Mehrere Dokumente

MultiDocument-Tabelle für den AvalaraAvatax-Datenanbieter.

Spalten

Nexus

Nexus-Tabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Um eine Nexus-Erklärung für Ihr Unternehmen zu erstellen, müssen Sie zunächst eine Liste der von Avalara definierten Nexus abrufen, indem Sie die NexusDefinitions-Tabelle abfragen. Sobald Sie bestimmt haben, welchen Nexus Sie erklären möchten, sollten Sie nur die benutzerwählbaren Felder in diesem Objekt anpassen. Die benutzerwählbaren Felder für das Nexus-Objekt sind CompanyId, EffectiveDate, EndDate, LocalNexusTypeId, TaxId, NexusTypeId, HasPermanentEstablishment und IsSellerImporterOfRecord. Beim Aufrufen von CreateNexus oder UpdateNexus müssen alle Werte in Ihrem Nexus-Objekt mit Ausnahme der benutzerwählbaren Felder mit einem von Avalara definierten System-Nexus-Objekt übereinstimmen. Wenn einige Daten nicht übereinstimmen, erkennt AvaTax Ihre Nexus-Erklärung möglicherweise nicht. Um einen Nexus zu erstellen, müssen Sie Land, Region, JurisdictionTypeId, JurisCode, JurisName, ShortName, NexusTaxTypeGroup eines vorhandenen, von Avalara definierten System-Nexus-Objekts und optional jedes andere auswählbare Feld angeben.

INSERT INTO Nexus (CompanyId, Country, Region, JurisdictionTypeId, JurisCode, JurisName, ShortName, NexusTaxTypeGroup, EffectiveDate) VALUES (283040, 'US', 'US', 'Country', 'US', 'UNITED STATES', 'UNITED STATES', 'Hospitality', '2019-11-08')

Aktualisieren

Nur vom Benutzer auswählbare Felder können aktualisiert werden. Um ein Nexus-Objekt zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE Nexus SET HasPermanentEstablishment = true WHERE ID = 20684351 AND CompanyId = 283040

Löschen

Um ein Nexus-Objekt zu löschen, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

DELETE FROM Nexus WHERE ID = 20684351 AND CompanyId = 283040

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.

Hinweise

Hinweistabelle für den Datenanbieter AvalaraAvatax.

Spalten

Benachrichtigungen

Benachrichtigungstabelle für den AvalaraAvatax-Datenanbieter.

Spalten

Einstellungen

Einstellungstabelle für den Datenanbieter AvalaraAvatax.

Das Unternehmenseinstellungssystem ist ein Metadatensystem, das Sie verwenden können, um zusätzliche Informationen über ein Unternehmen zu speichern. Ihre Integration oder Ihr Connector könnte diesen Datenspeicher verwenden, um Präferenzinformationen, Erinnerungen oder andere Daten zu verfolgen, die auch dann bestehen bleiben müssen, wenn der Kunde Ihre Anwendung deinstalliert.

Einfügen

Eine Einstellung kann sich auf jede Art von Daten beziehen, die Sie sich zu diesem Firmenobjekt merken müssen. Beim Erstellen dieses Objekts können Sie Ihre eigenen Parameter für Set, Name und Wert definieren. Um Ihre eigenen Werte zu definieren, wählen Sie bitte einen Setnamen, der mit X- beginnt, um eine Erweiterung anzugeben. CompanyId, Set und Name sind Pflichtfelder.

INSERT INTO Settings (CompanyId, Set, Name) VALUES (283040, 'ItemsToRemember', 'Texas')

Aktualisieren

Um eine Einstellung zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE Settings SET Value = 'Alamo' WHERE ID = 297847 AND CompanyId = 283040

Löschen

Um eine Einstellung zu löschen, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

DELETE FROM Settings WHERE ID = 297847 AND CompanyId = 283040

Spalten

Steuercodes

TaxCodes-Tabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Erstellen Sie ein oder mehrere neue Steuercodeobjekte, die einem Unternehmen zugeordnet sind, und geben Sie dabei mindestens CompanyId, TaxCode und TaxCodeTypeId an:

INSERT INTO TaxCodes (TaxCode, taxCodeTypeId, CompanyId) VALUES ('PS081283', 'P', '283040')

Aktualisieren

Avalara erlaubt eine der folgenden Benutzerrollen: AccountAdmin, CompanyAdmin, CSPTester, SSTAdmin, TechnicalSupportAdmin, um TaxCode-Objekte zu aktualisieren. CompanyId und ID sollten in der WHERE-Klausel angegeben werden.

UPDATE TaxCodes SET Description = 'Yarn' WHERE ID = 85083 AND CompanyId = 283040

Löschen

Um ein TaxCode-Objekt zu löschen, müssen CompanyId und ID in der WHERE-Klausel angegeben werden:

DELETE FROM TaxCodes WHERE ID = 85083 AND CompanyId = 283040

Spalten

Steuerregeln

TaxRules-Tabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Sie können benutzerdefinierte Steuerregeln erstellen, um das Verhalten von AvaTax an die spezifischen Regeln Ihres Unternehmens anzupassen. Wenn Sie von einem Steuerprüfer eine Entscheidung erhalten haben, die benutzerdefinierte Steuerberechnungen erfordert, können Sie benutzerdefinierte Steuerregeln verwenden, um das Verhalten für Ihr Unternehmen oder Ihren Artikel neu zu definieren.

INSERT INTO TaxRules (CompanyId, JurisCode, JurisName, JurisdictionTypeId, TaxRuleTypeId, Country, TaxTypeId, TaxCode, TaxCodeId, TaxTypeGroup, TaxSubType) VALUES ('283040', '013', 'MARICOPA', 'County', 'ProductTaxabilityRule', 'US', 'BothSalesAndUseTax', 'PS081283', '85083', 'SalesAndUse', 'ALL')

Aktualisieren

Um eine Steuerregel zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE TaxRules SET Description = 'Freight' WHERE ID = 56789 AND CompanyId = 247015

Löschen

Um eine Steuerregel zu löschen, müssen Sie ID und AccountId in der WHERE-Klausel angeben.

DELETE FROM TaxRules WHERE ID = 56789 AND CompanyId = 247015

Spalten

Transaktionslinien

TransactionLines-Ansicht für den AvalaraAvatax-Datenanbieter.

Wählen

Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Standardmäßig werden die Zeilen der angepassten Transaktionen nicht aufgelistet. Wenn Sie sie einschließen möchten, müssen Sie IncludeAdjustedTransactions auf „true“ setzen.

• TrsnactionId, TransactionCode unterstützt den '=', IN-Operator.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM TransactionLines WHERE TransactionCode IN ('Code1', 'Code2')

Löschen

Um ein TransactionLine-Element zu löschen, müssen Sie den TransactionCode und die LineNumber in der WHERE-Klausel angeben.

DELETE FROM TransactionLines WHERE TransactionCode = 'TC001' AND LineNumber = 1

Spalten

Transaktionen

Transaktionstabelle für den AvalaraAvatax-Datenanbieter.

Wählen

Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die meisten Spalten unterstützen serverseitiges Filtern mit den folgenden Operatoren: =,>,<,<=,>=,IN,NOT,IN,AND,OR,LIKE. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Standardmäßig werden die angepassten Transaktionen nicht aufgelistet. Wenn Sie sie einschließen möchten, müssen Sie IncludeAdjustedTransactions auf „true“ setzen. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Transactions WHERE AdjustmentReason = 'PriceAdjusted'
SELECT * FROM Items WHERE Status = 'Cancelled'

Einfügen

Um ein neues Transaktionselement hinzuzufügen, müssen die folgenden Spalten angegeben werden: CustomerCode, Date, Type, LinkedLines, Code, LinkedAddresses. Wenn Sie die Transaktion bestätigen möchten, setzen Sie das Commit-Flag in der Anfrage auf „true“. Die verknüpften Spalten können mithilfe einer #TEMP-Tabelle oder durch Übergeben des Aggregatwerts eingefügt werden.

Das LinkedAddresses-Aggregat muss Informationen zur Ursprungs- und Zieladresse enthalten. Wenn diese Transaktion an einem Einzelhandels-Point-of-Sale-Standort stattgefunden hat, geben Sie diese einzelne Adresse hier an und lassen Sie alle anderen Adresstypen null. Wenn Ursprung und Ziel abweichen, geben Sie sowohl die Adresstypen ShipFrom als auch ShipTo ein. Wenn Sie die Adresse eines vorhandenen Standorts für das tatsächliche Unternehmen verwenden möchten, geben Sie die Adresse im Feld addressType_locationCode an.

Die folgenden Beispiele veranschaulichen die oben genannten Szenarien.

Einfügen des LinkedAddresses-Aggregats über die #TEMP-Tabelle mit SingleLocation:

INSERT INTO Addresses#TEMP (SingleLocation_line1, SingleLocation_City, SingleLocation_County, SingleLocation_PostalCode) VALUES ('2000 Main Street', 'Irvine', 'US', 92614)")
INSERT INTO Addresses#TEMP (SingleLocation_locationCode) VALUES ('LC001')")

Einfügen des LinkedAddresses-Aggregats durch die Tabelle #TEMP mit den Lieferorten „ShipFrom“ und „ShipTo“:

INSERT INTO Addresses#TEMP (shipTo_line1, shipTo_City, shipTo_County, shipTo_PostalCode, shipFrom_line1, shipFrom_City, shipFrom_Country, shipFrom_PostalCode) VALUES ('2000 Main Street', 'Irvine', 'US', 92614, '', '', 'US', '')")
INSERT INTO Addresses#TEMP (shipTo_locationCode, shipFrom_locationCode) VALUES ('LC001', 'LC002')")

Fügen Sie mithilfe der Tabelle #TEMP aggregierte Einzelposten ein. Eine Liste der Spalten, die Sie in die temporäre Tabelle einfügen können, finden Sie in der Tabelle TransactionLines.

INSERT INTO TransactionLines#TEMP (ItemCode, Quantity, LineAmount) VALUES ('IC005', 3, 300)")

In die Haupttabelle „Transaktionen“ einfügen:

INSERT INTO Transactions (LinkedLines, LinkedAddresses, Code, CompanyId, CustomerCode, Date, Type, Commit, TotalTax) VALUES (TransactionLines#TEMP, Addresses#TEMP, DC008, 247015, 'CC002', '09/30/2019', 'SalesInvoice', true, 12.0)")

Aktualisieren

Avalara ermöglicht Aktualisierungen von Transaktionen. Um eine Transaktion zu aktualisieren, sind die Felder „Anpassungsgrund“ und „Anpassungsbeschreibung“ Pflichtfelder. Zusätzlich müssen Sie den Code der Transaktion angeben, die Sie in der WHERE-Klausel aktualisieren.

Ähnlich wie beim Einfügen können Sie Zeilenelemente mithilfe temporärer Tabellen aktualisieren. Um eine vorhandene Zeile zu aktualisieren, geben Sie die Zeilennummer der Zeile an, die Sie aktualisieren möchten. Um eine neue Zeile in die Transaktion einzufügen, setzen Sie die Zeilennummer auf einen neuen, nicht vorhandenen Wert.

Wenn eine Transaktion aktualisiert wird, ändert sich der Status der eigentlichen Transaktion in „Angepasst“ und es wird eine neue Transaktion mit den aktualisierten Informationen erstellt. Die neue Transaktion hat denselben Dokumentcode, aber eine andere ID und einen anderen Status: „Gespeichert“ oder „Übernommen“. Wenn Sie die neue aktualisierte Transaktion übernommen möchten, setzen Sie das Flag „Übernommen“ in der Anfrage auf „true“.

INSERT INTO TransactionLines#TEMP (ItemCode, Quantity, LineAmount, LineNumber) VALUES (IC007, 3, 300, 3)
UPDATE Transactions SET LinkedLines = 'TransactionLines#TEMP', AdjustmentDescription = 'MyDescription', AdjustmentReason = 'PriceAdjusted' WHERE Code = '051349'

Spalten

UPCs

Upcs-Tabelle für den Datenanbieter AvalaraAvatax.

Ein UPC stellt einen einzelnen Universal Product Code in Ihrem Katalog dar und ordnet dieses Produkt dem durch diesen UPC identifizierten Steuercode zu.

Einfügen

Um ein UPC-Objekt zu erstellen, sind CompanyId, UPC und Beschreibung Pflichtfelder.

INSERT INTO Upcs (CompanyId, Upc, Description) VALUES (283040, '023032550992', 'Yarn')

Aktualisieren

Um einen UPC zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE Upcs SET LegacyTaxCode = 'PS081282' WHERE ID = 123456789 AND CompanyId = 283040

Löschen

Um einen UPC zu löschen, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

DELETE FROM Upcs WHERE ID = 123456789 AND CompanyId = 283040

Spalten

Benutzer

Benutzertabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Um einen neuen Benutzer zu erstellen, müssen die folgenden Felder angegeben werden. Ein neu erstellter Benutzer erhält eine Email mit der Aufforderung, sein Passwort zu erstellen. Dies bedeutet, dass Sie für alle erstellten Benutzerkonten eine gültige Email-Adresse angeben müssen.

INSERT INTO Users (AccountId, UserName, FirstName, LastName, Email, securityRoleId) VALUES (2000137504, 'user123', 'James', 'Smith', 'smith@gmail.com', 'AccountUser')

Aktualisieren

Nur vom Benutzer auswählbare Felder können aktualisiert werden. Um einen Benutzer zu aktualisieren, müssen Sie ID und AccountId in der WHERE-Klausel angeben.

UPDATE Users SET IsActive = true WHERE ID = 332668 AND AccountId = 2000137504

Löschen

Um einen Benutzer zu löschen, müssen Sie ID und AccountId in der WHERE-Klausel angeben.

DELETE FROM Users WHERE ID = 332668 AND AccountId = 2000137504

Spalten

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.

Avalara Connector-Ansichten

Batchdateien

BatchFiles-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

KundenspezifischeFelder

CustomerCustomFields-Ansicht für den AvalaraAvatax-Datenanbieter.

Wählen

Um Datensätze aus der Ansicht „CustomerCustomFields“ abzurufen, müssen in der WHERE-Klausel mindestens CompanyId oder CompanyId und CompanyCode angegeben werden. Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. CompanyId und CompanyCode unterstützen serverseitiges Filtern mit dem Operator =. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM CustomerCustomFields WHERE CompanyId = '247015' AND CustomerCode = 'CC001'

Spalten

Kunden-ExposureZones

CustomerExposureZones-Ansicht für den AvalaraAvatax-Datenanbieter.

Wählen

Um Datensätze aus der Ansicht „CustomerExposureZones“ abzurufen, müssen in der WHERE-Klausel mindestens CompanyId oder CompanyId und CompanyCode angegeben werden. Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. CompanyId und CompanyCode unterstützen serverseitiges Filtern mit dem Operator =. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM CustomerExposureZones WHERE CompanyId = '247015' AND CustomerCode = 'CC001'

Spalten

EinreichungKalenderVerfügbarPOA

FilingCalendarAvailablePOA-Ansicht für AvalaraAvatax-Datenanbieter.

Spalten

Artikelklassifizierungen

ItemClassifications-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Artikelparameter

ItemParameters-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Standorteinstellungen

LocationSettings-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Nexus

Nexus-Tabelle für den AvalaraAvatax-Datenanbieter.

Einfügen

Um eine Nexus-Erklärung für Ihr Unternehmen zu erstellen, müssen Sie zunächst eine Liste der von Avalara definierten Nexus abrufen, indem Sie die NexusDefinitions-Tabelle abfragen. Sobald Sie bestimmt haben, welchen Nexus Sie erklären möchten, sollten Sie nur die benutzerwählbaren Felder in diesem Objekt anpassen. Die benutzerwählbaren Felder für das Nexus-Objekt sind CompanyId, EffectiveDate, EndDate, LocalNexusTypeId, TaxId, NexusTypeId, HasPermanentEstablishment und IsSellerImporterOfRecord. Beim Aufrufen von CreateNexus oder UpdateNexus müssen alle Werte in Ihrem Nexus-Objekt mit Ausnahme der benutzerwählbaren Felder mit einem von Avalara definierten System-Nexus-Objekt übereinstimmen. Wenn einige Daten nicht übereinstimmen, erkennt AvaTax Ihre Nexus-Erklärung möglicherweise nicht. Um einen Nexus zu erstellen, müssen Sie Land, Region, JurisdictionTypeId, JurisCode, JurisName, ShortName, NexusTaxTypeGroup eines vorhandenen, von Avalara definierten System-Nexus-Objekts und optional jedes andere auswählbare Feld angeben.

INSERT INTO Nexus (CompanyId, Country, Region, JurisdictionTypeId, JurisCode, JurisName, ShortName, NexusTaxTypeGroup, EffectiveDate) VALUES (283040, 'US', 'US', 'Country', 'US', 'UNITED STATES', 'UNITED STATES', 'Hospitality', '2019-11-08')

Aktualisieren

Nur vom Benutzer auswählbare Felder können aktualisiert werden. Um ein Nexus-Objekt zu aktualisieren, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

UPDATE Nexus SET HasPermanentEstablishment = true WHERE ID = 20684351 AND CompanyId = 283040

Löschen

Um ein Nexus-Objekt zu löschen, müssen Sie ID und CompanyId in der WHERE-Klausel angeben.

DELETE FROM Nexus WHERE ID = 20684351 AND CompanyId = 283040

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.

HinweisKommentare

NoticeComments-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

HinweisFinanzen

NoticeFinances-Ansicht für den Datenanbieter AvalaraAvatax.

Spalten

HinweisVerantwortung

HinweisVerantwortungsansicht für AvalaraAvatax-Datenanbieter.

Spalten

HinweisUrsache

NoticeRootCause-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Berichtsparameter

ReportParameters-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Berichte

Berichtstabelle für den AvalaraAvatax-Datenanbieter.

Spalten

Abonnements

Abonnementtabelle für den Datenanbieter AvalaraAvatax.

Wählen

Der Connector verwendet die Avalara API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Die meisten Spalten unterstützen serverseitiges Filtern mit den folgenden Operatoren: =,>,<,<=,>=,IN,NOT,IN,AND,OR,LIKE. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Subscriptions WHERE SubscriptionDescription LIKE 'AVA%'

Spalten

Transaktionsadressen

TransactionAddresses-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

TransaktionRechnungNachrichten

TransactionInvoicemessages-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Transaktionsstandorttypen

TransactionLocationTypes-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Transaktionsnachrichten

TransactionMessages-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Transaktionsparameter

TransactionParameters-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Transaktionszusammenfassung

TransactionSummary-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Transaktionssteuerdetails nach Steuerart

TransactionTaxdetailsbytaxtype-Ansicht für den AvalaraAvatax-Datenanbieter.

Spalten

Gespeicherte Prozeduren

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

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

Gespeicherte Prozeduren des Avalara Konnektors

Transaktions-Commit

Eine Transaktion zur Berichterstattung festschreiben.

Eingang

Batch herunterladen

Laden Sie eine einzelne Charge herunter.

Eingang

Ergebnissatzspalten

RückerstattungTransaktion

Eine Transaktion zurückerstatten.

Eingang

Ungültige Transaktion

Eine Transaktion stornieren.

Eingang

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 Avalara 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 „Transaktionen“ zurück:

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

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

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

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