Tally Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8936 des Connectors.

Erste Schritte

Tally Versionsunterstützung

Der Connector nutzt die Tally API, um den Zugriff auf Tally zu ermöglichen. Der Connector unterstützt sowohl Tally ERP 9 als auch Tally Prime.

Herstellen einer Verbindung

Mit Tally verbinden

Legen Sie die folgenden Verbindungseigenschaften fest, um eine Verbindung mit der Tally Instanz herzustellen:

• URL (Legen Sie dies auf die URL für die Tally Instanz fest. Beispiel: http://localhost:9000 ).

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

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

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

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

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

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Überblick

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

Hauptmerkmale

• Der Connector modelliert Tally Entitäten wie Dokumente, Ordner und Gruppen als relationale Ansichten, sodass Sie SQL schreiben können, um Tally Daten Abfrage.
• Gespeicherte Prozeduren ermöglichen die Ausführung von Operationen an Tally
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Tally-Konto bei Verwendung des Connectors sofort angezeigt werden.

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten sind statisch für Entitäten wie Unternehmen, Mitarbeiter und Hauptbücher definiert.

Gespeicherte Prozeduren

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

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.

Tally Connector-Ansichten

Unternehmen

Firmendetails abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• String unterstützt die Vergleiche '=, !=,<, <=, >, >=, LIKE, ORDER BY'.

Diese Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM Company WHERE Name LIKE 'cdata%'

SELECT * FROM Company WHERE CompanyFBTAssesseeType != 'Default'

SELECT * FROM Company WHERE StateName = 'Karnataka' AND PINCode >= '560034'

SELECT * FROM Company WHERE CountryName = 'India' OR CountryName = 'US'

SELECT * FROM Company WHERE PINCode > '560034'

SELECT * FROM Company ORDER BY DBName ASC

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.

Mitarbeiter

Mitarbeiterdetails abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• String unterstützt die Vergleiche '=, !=,<, <=, >, >=, LIKE, ORDER BY'.

Diese Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM Employees WHERE EMailID LIKE '%cdata%'

SELECT * FROM Employees WHERE BloodGroup != 'A Positive'

SELECT * FROM Employees WHERE Gender = 'Male' AND FatherName >= 'abc'

SELECT * FROM Employees WHERE BankBranch = 'Delhi' OR BankBranch = 'Bangalore'

SELECT * FROM Employees WHERE ForPayroll > 'No'

SELECT * FROM Employees ORDER BY Guid ASC

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.

Hauptbuch

Hauptbuchdetails abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• String unterstützt die Vergleiche '=, !=,<, <=, >, >=, LIKE, ORDER BY'.

Diese Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM Ledger WHERE TaxType LIKE '%GST%'

SELECT * FROM Ledger WHERE GSTType != 'Applicable'

SELECT * FROM Ledger WHERE GSTTypeofSupply = 'Goods' AND GSTDutyHead = 'Central Tax'

SELECT * FROM Ledger WHERE Parent = 'Sales Accounts' OR Parent = 'Bank Accounts'

SELECT * FROM Ledger WHERE IsChequePrintingEnabled > 'No'

SELECT * FROM Ledger ORDER BY Guid Desc

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.

Zahlkopf

Lohndetails abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• String unterstützt die Vergleiche '=, !=,<, <=, >, >=, LIKE, ORDER BY'.

Diese Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM PayHead WHERE Parent LIKE '%Maruti%'

SELECT * FROM PayHead WHERE RemoteAltGUID != NULL

SELECT * FROM PayHead WHERE TCSApplicable = 'True' AND OpeningValue > '0.00'

SELECT * FROM PayHead WHERE BaseUnits = 'Nos' OR BaseUnits = 'POS'

SELECT * FROM PayHead ORDER BY BaseUnits Desc

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.

Preisliste

Preisliste abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• String unterstützt die Vergleiche '=, !=,<, <=, >, >=, LIKE, ORDER BY'.

Diese Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM PriceList WHERE Guid LIKE '%4da0-b84f5%'

SELECT * FROM PriceList WHERE RemoteGUID != NULL

SELECT * FROM PriceList WHERE GSTApplicable = 'Applicable' AND CostingMethod = 'Avg. Cost'

SELECT * FROM PriceList WHERE Parent = 'Ashok Leyland' OR Parent = 'Maruti Limited'

SELECT * FROM PriceList WHERE IsBatchWiseOn > 'No'

SELECT * FROM PriceList ORDER BY Guid Asc

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.

Bericht_Bilanz

Bilanzbericht von Tally

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.

Report_BankGroupSummary

Zusammenfassender Tally-Bericht der Bankgruppe

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.

Report_BillsPayable

Bericht über zahlbare Rechnungen von Tally

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.

Report_BillsReceivable

Rechnungserhaltbericht von Tally

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.

Report_GodownZusammenfassung

Godown-Zusammenfassungsbericht der Tally

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der DspGodownName ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• DspGodownName unterstützt die '='-Vergleiche.
• FromDate unterstützt die '='-Vergleiche.
• ToDate unterstützt die '='-Vergleiche.

Diese Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM Report_GodownSummary WHERE DspGodownName = 'Karnataka'

SELECT * FROM Report_GodownSummary WHERE DspGodownName = 'Karnataka' AND FromDate = '01/01/2019' AND ToDate = '01/01/2020'

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.

Report_GroupOutstandings

Gruppen-Ausstandsbericht von Tally

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Tally API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Gruppenname ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• GroupName unterstützt die '='-Vergleiche.
• FromDate unterstützt die '='-Vergleiche.
• ToDate unterstützt die '='-Vergleiche.

Diese Abfragen werden beispielsweise serverseitig verarbeitet: