Sage Intacct-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8707 des Connectors.

Erste Schritte

Unterstützung für Sage Intacct-Version

Der Sage Intacct-Connector stellt eine Verbindung mit der Sage Intacct Web Services API her.

Herstellen einer Verbindung

Verbindung zu Sage Intacct

Um eine Verbindung zu Web Services herzustellen, müssen Sie zunächst das Web Services-Abonnement aktivieren. Navigieren Sie zu Company > Admin Tab > Subscriptions und aktivieren Web Services.

Intacct empfiehlt außerdem die Erstellung eines Nur-Web-Services-Benutzers. Navigieren Sie dazu zu Company > Admin Tab und klicken Sie auf + Zeichen daneben Web Services users.

Sie können entweder mit den eingebetteten Anmeldeinformationen oder mit Ihren eigenen Anmeldeinformationen eine Verbindung zu Sage Intacct herstellen.

Authentifizieren bei Sage Intacct

Zur Authentifizierung setzen Sie CompanyID und setze User Und Password zu den Anmeldeinformationen, die Sie zum Anmelden bei Sage Intacct verwenden. Darüber hinaus müssen Sie entweder Ihre eigenen SenderID Und SenderPassword, oder verwenden Sie die eingebetteten Anmeldeinformationen im Sage Intacct-Connector.

EinfachLesen

Der Connector verfügt über eingebettete Webdienst-Anmeldeinformationen, die beim Lesen von Daten aus Intacct verwendet werden.

Befolgen Sie diese Schritte zur Authentifizierung:

• AuthScheme: Setzen Sie dies auf BasicReadOnly.
• Stellen Sie sicher, dass Sie have not hat ein angegeben SenderID oder SenderPassword.
• Navigieren Sie in Ihrem Web Services-Dashboard zu Company > Company Info > Security Tab.
• Fügen Sie "" zu Ihren Web Services-Autorisierungen hinzu. Dabei wird die Groß- und Kleinschreibung beachtet. Navigieren Sie dazu zu Company > Company Info (Configuration > Company in new UI) > Security > Web Services Authorizations / Edit.

Cookies-basis

Sie können Ihre eigenen Web Services-Anmeldeinformationen verwenden, um Daten in Intacct zu schreiben. Legen Sie zur Authentifizierung Folgendes fest:

• AuthScheme: Setzen Sie dies auf Basic.
• SenderID: Legen Sie hier die Web Services Sender ID fest, die Ihnen von Sage Intacct zugewiesen wurde.
• SenderPassword: Setzen Sie dies auf Ihr registriertes Webservices-Passwort.

Okta

Die folgenden Verbindungseigenschaften werden für die Verbindung mit Okta verwendet:

• AuthScheme: Setzen Sie dies auf Okta.
• User: Stellen Sie dies auf den Okta-Benutzer ein.
• Password: Legen Sie hier das Okta-Passwort für den Benutzer fest.
• SSOLoginURL: Legen Sie dies auf die vom SSO-Anbieter verwendete Anmelde URL fest.

Legen Sie außerdem Folgendes fest: SSOProperties:

• IntacctUserID: Legen Sie diesen Wert auf die Intacct-Benutzer-ID fest, die dem Okta-Benutzer zugeordnet ist, den Sie in der Benutzerverbindungseigenschaft festgelegt haben.
• APIToken (optional): Legen Sie hier das API Token fest, das der Kunde aus der Okta-Organisation erstellt hat. Es sollte verwendet werden, wenn ein Benutzer über eine vertrauenswürdige Anwendung oder einen Proxy authentifiziert wird, der den Okta Client-Anforderungskontext überschreibt.

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme=Okta; SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46'; User=oktaUserName; Password=oktaPassword; SSOProperties='IntacctUserID=intacct_user';

Optimieren des Datenzugriffs

Optimieren des Datenzugriffs

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

• LocationsID: Um eine Verbindung zu einem gemeinsam genutzten Tochterunternehmen herzustellen, geben Sie dessen Standort-ID an.
• ClientID: Um eine Verbindung zu einem verteilten Tochterunternehmen herzustellen, geben Sie dessen Client-ID an.

LocationsID Und ClientID können nicht gleichzeitig angegeben werden.

Neue Sage Intacct API

Unterstützung für die neue Sage Intacct API wurde hinzugefügt.

Die neue API unterstützt zusätzlich serverseitige Filterung, ORDERBY, Offset und Aggregatfunktionen, einschließlich Anzahl, Durchschnitt, Minimum, Maximum und Summe.

Aktivieren Sie diese Unterstützung durch die Einstellung UseLegacy Zu False.

Die neue API unterstützt auch die Anzeige von Attributen, die sich auf Objekte beziehen, mithilfe von IncludeRelatedAttributes.

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

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

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

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

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

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 Intacct-Connector modelliert Sage Intacct-Entitäten in relationalen Tabellen.

Tabellendefinitionen werden dynamisch abgerufen. Wenn Sie über den Connector eine Verbindung herstellen, werden alle Änderungen, die Sie vornehmen (z. B. das Hinzufügen einer neuen Tabelle, das Hinzufügen neuer Spalten oder das Ändern des Datentyps einer Spalte), sofort übernommen.

Die Tabellen und Ansichten in der Dokumentation sind Beispiele dafür, worauf Sie in Ihrem Intacct-Konto Zugriff haben können.

Sage Intacct bietet Unterstützung für verschiedene Dokumenttabellen, die mit einem bestimmten Dokumenttyp übereinstimmen. Standardmäßig enthalten die Dokumenttabellen keine benutzerdefinierten Felder, die mit der Tabelle verknüpft sind. Der Benutzer kann jedoch auf die folgenden Tabellen zugreifen, um alle benutzerdefinierten Felder abzurufen, die mit dem Dokumenttyp verknüpft sind.

Dokumententabellen

Nachfolgend sehen Sie ein Beispiel der Dokumenttabellen und der zugehörigen Dokumenttyptabellen.

Tabellen mit separaten erforderlichen Primärschlüsseln für INSERT und DELETE

Die folgende Tabelle listet Tabellen auf, die separate erforderliche Primärschlüssel für INSERT und DELETE sowie deren zusammengesetzte Primärschlüssel haben:

Tabellen

Der Connector modelliert die Daten in Sage Intacct in einer Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Sage Intacct-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Abfrage erfolgen muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Sage Intacct Connector-Tabellen

KontobezeichnungSteuergruppe

Ruft AcctLabelTaxGroup-Berichtsdaten ab.

Spalten

Kontobereich

Ruft AcctRange-Berichtsdaten ab.

Spalten

Aktivitätsprotokoll

Ruft ActivityLog-Berichtsdaten ab.

Spalten

Gang

Ruft Gangberichtsdaten ab.

Spalten

Zuteilung

Ruft Daten aus dem Zuordnungsbericht ab.

Spalten

APKontobezeichnung

Ruft APAccountLabel-Berichtsdaten ab.

Spalten

AP-Anpassung

Ruft APAdjustment-Berichtsdaten ab.

Spalten

APBill

Ruft APBill-Berichtsdaten ab.

Spalten

APBillBatch

Ruft APBillBatch-Berichtsdaten ab.

Spalten

APPymt

Ruft APPymt-Berichtsdaten ab.

Spalten

APRecurBill

Ruft APRecurBill-Berichtsdaten ab.

Spalten

APTERM

Ruft APTerm-Berichtsdaten ab.

Spalten

ARKontobezeichnung

Ruft ARAccountLabel-Berichtsdaten ab.

Spalten

ARAnpassung

Ruft ARAdjustment-Berichtsdaten ab.

Spalten

ARRechnung

Ruft ARInvoice-Berichtsdaten ab.

Spalten

ARRechnungsBatch

Ruft ARInvoiceBatch-Berichtsdaten ab.

Spalten

ARPaymentBatch

Ruft ARPaymentBatch-Berichtsdaten ab.

Spalten

ARTerm

Ruft ARTerm-Berichtsdaten ab.

Spalten

Teilnehmer

Ruft Teilnehmerberichtsdaten ab.

Spalten

Rechnungskontakt

Ruft Daten aus dem Billing_Contact-Bericht ab.

Spalten

Bin

Ruft Bin-Berichtsdaten ab.

Spalten

Girokonto

Ruft Daten aus dem Girokontobericht ab.

Spalten

Klasse

Ruft Klassenberichtsdaten ab.

Spalten

Kommentare

Ruft Daten aus dem Kommentarbericht ab.

Spalten

Kontakt

Ruft Kontaktberichtsdaten ab.

Spalten

Vertrag

Eine Sammlung von Vertragsgegenständen.

Spalten

Kreditkarte

Ruft Kreditkartenberichtsdaten ab.

Spalten

Kunde

Ruft Kundenberichtsdaten ab.

Spalten