QuickBooks Time-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.9039 des Connectors.

Erste Schritte

TSheets-Versionsunterstützung

Der Connector nutzt die TSheets-API, um einen bidirektionalen Zugriff auf TSheets zu ermöglichen.

Herstellen einer Verbindung

Mit TSheets verbinden

TSheets unterstützt den OAuth-Standard zur Benutzerauthentifizierung. Um diese Authentifizierung von allen OAuth-Flows aus zu aktivieren, müssen Sie eine benutzerdefinierte OAuth-Anwendung erstellen und festlegen AuthScheme Zu OAuth.

Die folgenden Unterabschnitte beschreiben, wie Sie sich über drei gängige Authentifizierungsabläufe bei TSheets authentifizieren:

• Desktop: eine Verbindung zu einem Server auf dem lokalen Rechner des Benutzers, die häufig zum Testen und Prototyping verwendet wird.
• Web: Zugriff auf Daten über eine gemeinsam genutzte Website.
• Headless Server: ein dedizierter Computer, der anderen Computern und ihren Benutzern Dienste zur Verfügung stellt und so konfiguriert ist, dass er ohne Monitor und Tastatur funktioniert.

Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Eine vollständige Liste der in TSheets verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Connection.

Desktop-Anwendungen

Um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-Anwendung zu authentifizieren, müssen Sie das OAuth-Zugriffstoken abrufen und aktualisieren. Danach können Sie eine Verbindung herstellen.

OAuth-Zugriffstoken abrufen und aktualisieren:

• InitiateOAuth: GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken.
• OAuthClientId: Die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret: Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• CallbackURL: Die Umleitungs-URI, die bei der Registrierung Ihrer Anwendung definiert wurde.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von TSheets in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen.

Nachdem Sie der Anwendung Berechtigungen erteilt haben, schließt der Connector den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von TSheets und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden im in angegebenen Pfad gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Wenn das Zugriffstoken abläuft, aktualisiert der Connector es automatisch.

Automatische Aktualisierung des OAuth-Zugriffstokens:

So lässt der Connector das OAuth-Zugriffstoken automatisch aktualisieren:

1. Legen Sie vor der ersten Verbindung mit Daten diese Verbindungsparameter fest:
   • InitiateOAuth: REFRESH.
   • OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret: Das Client-Geheimnis in Ihren Anwendungseinstellungen.
   • OAuthAccessToken: Der von GetOAuthAccessToken zurückgegebene Zugriffstoken.
   • OAuthSettingsLocation: Der Pfad, in dem der Connector die OAuth-Werte speichern soll, die über Verbindungen hinweg bestehen bleiben.
2. Legen Sie bei nachfolgenden Datenverbindungen Folgendes fest:
   • InitiateOAuth
   • OAuthSettingsLocation

Manuelle Aktualisierung des OAuth-Zugriffstokens:

Der einzige Wert, der zur manuellen Aktualisierung des OAuth-Zugriffstokens benötigt wird, ist das OAuth-Aktualisierungstoken.

1. Um das OAuthAccessToken nach dem ExpiresIn-Zeitraum (zurückgegeben von GetOAuthAccessToken manuell zu aktualisieren) abgelaufen ist, rufen Sie den RefreshOAuthAccessToken gespeicherte Prozedur.
2. Legen Sie diese Verbindungseigenschaften fest:
   • OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret: Das Client Secret in Ihren Anwendungseinstellungen.
3. Rufen Sie RefreshOAuthAccessToken auf mit OAuthRefreshToken auf das von GetOAuthAccessToken zurückgegebene OAuth-Aktualisierungstoken gesetzt.
4. Nachdem die neuen Token abgerufen wurden, setzen Sie das OAuthAccessTokenEigenschaft auf den von RefreshOAuthAccessToken zurückgegebenen Wert. Dadurch wird eine neue Verbindung geöffnet.

Speichern Sie das OAuth-Aktualisierungstoken, damit Sie es verwenden können, um das OAuth-Zugriffstoken nach Ablauf manuell zu aktualisieren.

Erstellen einer benutzerdefinierten OAuth-Anwendung

Erstellen einer benutzerdefinierten OAuth-Anwendung

Durch das Erstellen einer benutzerdefinierten OAuth-Anwendung können Sie OAuth-Anmeldeinformationen generieren, die während der Benutzerauthentifizierung übergeben werden.

Verfahren

1. Melden Sie sich bei Ihrem TSheets-Konto an.

2. Wählen Sie im linken Navigationsbereich Feature Add-ons > Manage Add-ons.

3. Wählen Sie API Add-On.

4. Klicken Sie auf Install.

5. Wählen Sie Add a new application unten links. Wenn kein Folgefenster angezeigt wird, kehren Sie zum linken

   Navigationsbereich zurück Feature Add-onsBereich und AuswahlAPI.

6. Geben Sie einen Kurznamen und eine aussagekräftige Beschreibung für die neue Anwendung ein.

7. Setzen Sie die Weiterleitungs URL auf http://localhost:33333 (Standardeinstellung des Anschlusses) ODER legen Sie einen anderen Port Ihrer Wahl fest.
   Notieren Sie diesen Wert. Sie geben ihn als an CallbackURL.

8. Klicken Sie auf Save. Das Admin-Tool generiert die OAuth-Client-ID und das Client-Geheimnis.
   Notieren Sie diese Werte für die zukünftige Verwendung.

9. (Optional:) Wenn Sie jetzt Ihr Zugriffstoken generieren und sich mit verbinden möchten InitiateOAuth gesetzt auf OFF, klick Add Token im unteren linken Teil des Displays. Dadurch wird ein Token zur sofortigen Verwendung generiert.

Sie können auf die benutzerdefinierte OAuth-Anwendung (API Add-On genannt) über den linken Navigationsbereich zugreifen Feature Add-ons Abschnitt.

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 TSheets-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 möglichst viel der Verarbeitung der SELECT-Anweisung auf TSheets und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für TSheets 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 Timesheets WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

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

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

Definieren von Ansichten mit DDL-Anweisungen

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

Erstellen einer Ansicht

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

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

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

Ändern einer Ansicht

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

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

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

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

DROP LOCAL VIEW [MyViewName]

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

Schema für benutzerdefinierte Ansichten

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

Arbeiten mit benutzerdefinierten Ansichten

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

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

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

Daraus ergibt sich die effektive Abfrage an die Quelle:

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

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

SSL-Konfiguration

Anpassen der SSL-Konfiguration

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

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

Datenmodell

Überblick

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

Hauptmerkmale

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

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten werden statisch definiert, um Arbeitszeitnachweise, Benutzer, Dateien und mehr zu modellieren.

Tabellen

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

Jitterbit-Connector für TSheets-Tabellen

BenutzerdefinierteFeldelementfilter

Erstellen, Aktualisieren und Abfragen der benutzerdefinierten Feldelementfilter in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle CustomFieldItemFilters. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• Active unterstützt das '='
• JobCodeId unterstützt das '='
• UserId unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• GroupId unterstützt das '='
• IncludeUserGroup unterstützt das '='
• IncludeJobCodeFilters unterstützt das '='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFieldItemFilters
SELECT * FROM CustomFieldItemFilters WHERE ID = 11531340

Einfügen

Das Einfügen kann durch Angabe der Spalten CustomFieldId, CustomFieldItemId, Active, AppliesTo und AppliesToId ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO CustomFieldItemFilters (CustomFieldId, Name, ShortCode) VALUES (1140610, 15027812, true, 'jobcodes', 73209298)

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE CustomFieldItemFilters SET Active = true WHERE ID = '15011650'

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.

BenutzerdefinierteFeldelemente

Erstellen, Aktualisieren und Abfragen der benutzerdefinierten Feldelemente in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle CustomFieldItems. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• CustomFieldId unterstützt '=,IN'
• Name unterstützt '=,IN'
• Active unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFieldItems WHERE CustomFieldId=1140610
SELECT * FROM CustomFieldItems WHERE CustomFieldId=1140610 AND ID = 11531340

Einfügen

Das Einfügen kann durch Angabe der Spalten CustomFieldId, Name und ShortCode ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO CustomFieldItems (CustomFieldId, Name, ShortCode) VALUES (1140610, 'testField', 'cf')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE CustomFieldItems SET Name = 'yogesh_customfield', ShortCode='ycf' WHERE ID = '15011650'

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.

Benutzerdefinierte Felder

Erstellen, Aktualisieren und Abfragen der benutzerdefinierten Felder in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der CustomFields-Tabelle. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• Active unterstützt das '='
• AppliesTo unterstützt das '='
• Type unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFields
SELECT * FROM CustomFields WHERE ID = 24145

Einfügen

Das Einfügen kann durch Angabe der Spalten Name, Erforderlich, Aktiv, Gilt für, Typ, Für alle anzeigen und ShortCode ausgeführt werden. Die Spalten, die nicht erforderlich sind, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO CustomFields (Name, Required, Active, AppliesTo, Type, ShowToAll, ShortCode) VALUES ('Test', true, true, 'timesheet', 'managed-list', true, 'cstm')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE CustomFields SET Name = 'Updated name' WHERE ID = '1140410'

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.

Artikel schätzen

Erstellen, Aktualisieren und Abfragen des Kostenvoranschlagselements in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der EstimateItems-Tabelle. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• EstimateId unterstützt '=,IN'
• Active unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM EstimateItems
SELECT * FROM EstimateItems WHERE ID = '11531340'

Einfügen

Das Einfügen kann durch Angabe der Spalten EstimateId, Type und TypeId ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO EstimateItems (EstimateId, Type, TypeId) VALUES (47482, 'tag_clouds', 15011650)

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE EstimateItems SET EstimatedSeconds = 2 WHERE ID = '11531340'

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.

Schätzungen

Erstellen, Aktualisieren und Abfragen der Schätzungen in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „Estimations“. Der Connector verwendet die TSheets 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.

• Id unterstützt '=,IN'
• Active unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Estimates
SELECT * FROM Estimates WHERE ID = '11531340'

Einfügen

Das Einfügen kann durch Angabe der Spalten ProjectId und EstimatedBy ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Estimates (ProjectId, EstimatedBy) VALUES (2064876, 'none')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Estimates SET Active = true WHERE ID = '11531340'

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.

Dateien

Diese Tabelle enthält eine Liste von Dateiobjekten.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „Dateien“. Der Connector verwendet die TSheets-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.

• Id Und NameFelder unterstützen die Operatoren '=' und IN.
• ActiveStatus unterstützt die = Betreiber.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Files WHERE Name IN ('IMG_20181004_214839.png', 'healthy.jpg')

SELECT * FROM Files WHERE LastModified = '2019-01-01 15:30' AND ActiveStatus = 'both'

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Files SET FileDescription = 'test' WHERE ID = '3688644'

Löschen

Das Löschen kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Beispiel:

Delete FROM Files WHERE ID = '3688644'

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.

GeoStandorte

Ruft eine Liste aller Geofence-Konfigurationen ab.

Tabellenspezifische Informationen

Wählen

Abfrage der GeoLocations-Tabelle. Der Connector verwendet die TSheets-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.

• Id, UserId Und GroupIdFelder unterstützen die Operatoren '=' und IN.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM GeoLocations WHERE GroupId IN ('29474', '29474') AND LastModified <= '2020-01-01 00:00'

Einfügen

Das Einfügen kann durch Angabe der Spalten „Erstellt“, „Benutzer-ID“, „Genauigkeit“, „Höhe“, „Breitengrad“ und „Längengrad“ ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle.

INSERT INTO Geolocations (Created, UserId, Accuracy, Altitude, Latitude, Longitude) VALUES ('2018-08-19T11:30:09-06:00', '1242515', '20.375', '0', '43.68662580', '-116.35166460')

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.

Gruppen

Diese Tabelle enthält eine Liste aller mit Ihrem Unternehmen verbundenen Gruppen.

Tabellenspezifische Informationen

Wählen

Abfrage der Gruppentabelle. Der Connector verwendet die TSheets-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.

• Id Und NameFelder unterstützen die Operatoren '=' und IN.
• ActiveStatus unterstützt die = Betreiber.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Groups WHERE Name IN ('Group 1', 'Group 2') AND LastModified > '2019-01-01 15:30'

SELECT * FROM Groups WHERE ActiveStatus = 'both'

Einfügen

Das Einfügen kann durch Angabe der Spalte „Name“ ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Groups (Name) VALUES ('Group 1')
INSERT INTO Groups (Name, ManagerIds) VALUES ('Group 1', '300, 316')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Groups SET Name = 'Group 1a', Active = 'false'  WHERE ID = '10055'

Spalten

JobcodeAufgaben

Gibt eine Liste aller Jobcode-Zuweisungen zurück, die Benutzern zugeordnet sind.

Tabellenspezifische Informationen

Wählen

Abfrage der JobcodeAssignments-Tabelle. Der Connector verwendet die TSheets-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.

• Id Und UserId-Felder unterstützen die Operatoren '=' und IN.
• JobcodeId, JobCodeType, JobCodeParentId Felder und ActiveStatus Alle Filter unterstützen den '='-Operator.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM JobcodeAssignments WHERE UserId IN (1242515, 1242515)

SELECT * FROM JobcodeAssignments WHERE JobCodeParentId = 17285791

Einfügen

Das Einfügen kann durch Angabe der Spalten UserId und JobcodeId ausgeführt werden. Die nicht benötigten Spalten können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO JobcodeAssignments (UserId, JobcodeId) VALUES ('1234', '39')

Löschen

Das Löschen kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Beispiel:

DELETE FROM JobcodeAssignments WHERE Id = '41321421'

DELETE FROM JobcodeAssignments WHERE ID IN ('41321421', '41321435')

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.

JobCodes

Diese Tabelle enthält eine Liste der mit Ihrem Unternehmen verknüpften Jobcodes

Tabellenspezifische Informationen

Wählen

Abfrage der Jobcodes-Tabelle. Der Connector verwendet die TSheets-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.

• Id Und NameFelder unterstützen die Operatoren '=' und IN.
• Type Feld und ActiveStatus Filter unterstützen den '='-Operator.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Jobcodes WHERE Id IN (1242515, 1242515)

SELECT * FROM Jobcodes WHERE Type = 'unpaid_break'

Einfügen

Das Einfügen kann durch Angabe der Spalten Name und Typ ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Jobcodes (Name, Type) VALUES ('Group 1', 'pto')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Jobcodes SET Name = 'Group 2', Type = 'pto'  WHERE ID = '10055'

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.

Standorte

Ruft eine Liste aller Standorte ab, die mit Ihrem Unternehmen verknüpft sind.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „Standorte“. Der Connector verwendet die TSheets 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.

• Id Und GeoCodingStatus-Felder unterstützen die Operatoren '=' und IN.
• ActiveStatus unterstützt die = Betreiber.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Locations WHERE GeoCodingStatus IN ('in_progress', 'retry')

SELECT * FROM Locations WHERE ByJobcodeAssignment = true

Einfügen

Das Einfügen kann durch Angabe beliebiger Spalten ausgeführt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Locations (Address1, City, State, Country) VALUES (' office', 'Bangalore', 'KA', 'IN')

INSERT INTO Locations (Address1, City, State, Country, Zip) VALUES (' office', 'Bangalore', 'KA', 'IN', '560100')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Locations SET Address1 = 'Microsoft' WHERE ID = '10055'

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.

Benachrichtigungen

Ruft eine Liste der mit Ihrem Unternehmen verknüpften Benachrichtigungen ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Benachrichtigungstabelle. Der Connector verwendet die TSheets-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.

• Id Feld unterstützt die Operatoren '=' und IN.
• MessageTrackingId Und UserIdFelder unterstützen den Operator '='.
• DeliveryTime-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Notifications WHERE Id IN (94140223, 94140225) AND UserId = 37

SELECT * FROM Notifications WHERE MessageTrackingId = 'baabeb0ab03d62ce'

SELECT * FROM Notifications WHERE DeliveryTime = '2019-12-25 19:00'

Einfügen

Das Einfügen kann durch Angabe der Nachrichtenspalte ausgeführt werden. Die nicht benötigten Spalten können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Notifications (Message) VALUES ('Please clock Out!')

INSERT INTO Notifications (Message, UserId) VALUES ('Please clock Out!', '56329')

Löschen

Das Löschen kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Beispiel:

DELETE FROM Notifications WHERE Id = '41321421'

DELETE FROM Notifications WHERE ID IN ('41321421', '4132567')

Spalten

ProjektAktivitätAntworten

Erstellen, Aktualisieren und Abfragen der Projektaktivitätsantworten in TSheets.

Tabellenspezifische Informationen

Wählen

Fragen Sie die Tabelle ProjectActivityReplies ab. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• UserId unterstützt '=,IN'
• ProjectActivityId unterstützt das '='
• Active unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectActivityReplies WHERE ProjectActivityId = 8348378
SELECT * FROM ProjectActivityReplies WHERE ProjectActivityId = 8348378 AND ID = 2062894

Einfügen

Das Einfügen kann durch Angabe der ProjectActivityId und der Notizspalte ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO ProjectActivityReplies (ProjectActivityId, Note) VALUES (8348382, 'Test')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE ProjectActivityReplies SET Note = 'updated' WHERE ID = '2062894'

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.

Projektnotizen

Erstellen, Aktualisieren und Abfragen der Projektnotizen in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der ProjectNotes-Tabelle. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• UserId unterstützt '=,IN'
• ProjectId unterstützt das '='
• Active unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectNotes
SELECT * FROM ProjectNotes WHERE ProjectId = 203282

Einfügen

Das Einfügen kann durch Angabe der Projekt-ID und der Notizspalte ausgeführt werden. Die nicht benötigten Spalten können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO ProjectNotes (ProjectId, Note) VALUES (203282, 'Test note'))

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE ProjectNotes SET Note = 'Updated value' WHERE ID = '1675236'

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

Erstellen, Aktualisieren und Abfragen der Projekte in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „Projekte“. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• JobCodeId unterstützt '=,IN'
• ParentJobCodeId unterstützt das '='
• Name unterstützt das '='
• Active unterstützt das '='
• ByJobCodeAssignment unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Projects
SELECT * FROM Projects WHERE ID = 2056676

Einfügen

Das Einfügen kann durch Angabe der Spalte „Name“ ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Projects (Name, Description) VALUES ('ProjectTest', 'This is a test project')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Projects SET Status = 'complete' WHERE ID = '2062894'

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.

Erinnerung

Ruft eine Liste mit Erinnerungen ab, die mit Ihren Mitarbeitern oder Ihrem Unternehmen verknüpft sind.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „Erinnerungen“. Der Connector verwendet die TSheets-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.

• Id Und UserId-Felder unterstützen die Operatoren '=' und IN.
• ReminderType Feld und ActiveStatus Filter unterstützen den '='-Operator.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Reminders WHERE Id IN (72595, 72599) AND UserId = 37

SELECT * FROM Reminders WHERE ReminderType = 'clock-in'

Einfügen

Das Einfügen kann durch Angabe der Spalten UserId, ReminderType, DueTime, DueDaysOfWeek, DistributionMethods, Active und Enabled ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Reminders (UserId, ReminderType, DueTime, DueDaysOfWeek, DistributionMethods, Active, Enabled) VALUES ('37', 'clock-in', '08:10:00', 'Mon, Tue, Sat', 'Push', 'true', 'true')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Reminders SET DueTime = '08:10:00', DistributionMethods = 'Email'  WHERE ID = '10055'

Spalten

Name	Typ	Nur Lesen	Beschreibung
Id [KEY]	Integer	True	ID der Erinnerung.
UserId	Integer	True	Benutzer-ID des Benutzers, auf den sich diese Erinnerung bezieht. 0 gibt an, dass dies eine unternehmensweite Erinnerung ist.
ReminderType	String	True	Der Typ dieses Erinnerungsobjekts. Unterstützte Erinnerungstypen sind „Einstempeln“ und „Ausstempeln“.
DueTime	String	Falsch	Die 24-Stunden-Zeit, zu der die Erinnerung gesendet werden soll, ausgedrückt als „hhss“.
DueDaysOfWeek	String	Falsch	Eine durch Kommas getrennte Liste der Wochentage, an denen die Erinnerung gesendet werden soll. Der Wert kann eine beliebige Kombination aus „So“, „Mo“, „Di“, „Mi“, „Do“, „Fr“ und „Sa“ sein.
DistributionMethods	String	False	Der Nachrichtentext der Benachrichtigung. Die maximale Nachrichtenlänge beträgt 2000 Zeichen.
Active	Boolean	Falsch	Wenn wahr, ist diese Erinnerung aktiv und wird zur Fälligkeitszeit und an den Fälligkeitstagen der Woche ausgewertet. Wenn falsch, ist diese Erinnerung inaktiv und wird nicht ausgewertet. Wenn aktiv=false für benutzerspezifische Erinnerungen, dann gilt die unternehmensweite Erinnerung desselben Erinnerungstyps.
Enabled	Boolean	Falsch	Wenn wahr, ist die Erinnerung aktiviert und wird zur Fälligkeitszeit und an den Fälligkeitstagen der Woche gesendet. Wenn falsch, ist die Erinnerung deaktiviert und wird nicht gesendet. Ein Benutzer mit einer aktiven (aktiv = wahr), aber deaktivierten (aktiviert = falsch) Erinnerung erhält diesen Erinnerungstyp nicht, unabhängig davon, wie unternehmensweite Erinnerungen konfiguriert sind.
Created	Datetime	Wahr	Datum/Uhrzeit der Erstellung dieser Erinnerung
LastModified	Datetime	Wahr	Datum/Uhrzeit der letzten Änderung dieser Erinnerung,

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.

TermineVeranstaltungen

Ruft eine Liste der Termine ab, die mit Ihren Mitarbeitern oder Ihrem Unternehmen verknüpft sind.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle ScheduleEvents. Der Connector verwendet die TSheets-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.

• Id Und ScheduleCalendarId-Felder unterstützen die Operatoren '=' und IN.
• Start unterstützt die >= Betreiber.
• End unterstützt die <= Betreiber.
• ActiveStatus Filter und Draft Und TeamEventsFelder unterstützen den Operator '='.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ScheduleEvents WHERE TeamEvents = 'instance'

SELECT * FROM ScheduleEvents WHERE LastModified > '2019-01-01 18:30' AND Id IN (1, 2, 3)

SELECT * FROM ScheduleEvents WHERE End <= '2019-12-31 18:00'

Einfügen

Das Einfügen kann durch Angabe der Spalten ScheduleCalendarId, Start, End und AllDay ausgeführt werden. Die nicht benötigten Spalten können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO ScheduleEvents (ScheduleCalendarId, Start, End, AllDay) VALUES ('37', '2018-12-05T16:00:00+00:00', '2020-12-05T16:00:00+00:00', 'true')

INSERT INTO ScheduleEvents (ScheduleCalendarId, Start, End, AllDay, AssignedUserIds) VALUES ('37', '2018-12-05T16:00:00+00:00', '2020-12-05T16:00:00+00:00', 'true', '11, 1365, 729')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE ScheduleEvents SET Title = 'New Title'  WHERE ID = '14055'

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.

Freistellungsanforderungseinträge

Erstellen, Aktualisieren und Abfragen der Urlaubsanträge in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle TimeOffRequestEntries. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• TimeOffRequestId unterstützt '=,IN'
• Status unterstützt '=,IN'
• ApproverUserId unterstützt '=,IN'
• UserId unterstützt '=,IN'
• JobcodeId unterstützt '=,IN'
• Date unterstützt das '='
• StartTime unterstützt das '='
• EndTime unterstützt das '='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM TimeOffRequestEntries
SELECT * FROM TimeOffRequestEntries WHERE ID = 11531340

Einfügen

Das Einfügen kann durch Angabe von TimeOffRequestId, EntryMethod, Duration, JobcodeId und Date-Spalte ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO TimeOffRequestEntries (TimeOffRequestId, EntryMethod, Duration, JobcodeId, Date) VALUES (12345, 'manual', 3600, 10984254, '2024-05-29')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE TimeOffRequestEntries SET Duration = 500 WHERE ID = '15011650'

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.

Freizeitanfragen

Erstellen, Aktualisieren und Abfragen der Urlaubsanträge in TSheets.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle TimeOffRequests. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• UserId unterstützt '=,IN'
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM TimeOffRequests
SELECT * FROM TimeOffRequests WHERE ID = 11531340

Einfügen

Das Einfügen kann durch Angabe der Spalten TimeOffRequestNotes und TimeOffRequestEntries ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO TimeOffRequests (TimeOffRequestNotes, TimeOffRequestEntries) VALUES ('[{"note":"Taking a four day weekend to go on vacation."}]', '[{"date":"2024-05-29","start_time":"2024-01-17T00:00:00-06:00","end_time":"2024-04-17T00:00:00-06:00","entry_method":"regular","duration":28800,"jobcode_id":10984254}]')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE TimeOffRequests SET TimeOffRequestNotes = '[{"note":"Taking a four day weekend to go on vacation."}]' WHERE ID = '15011650'

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.

Arbeitszeitnachweise

Diese Tabelle enthält eine Liste von Dateiobjekten.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „Timesheets“. Der Connector verwendet die TSheets 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.

• Id, UserId, JobcodeId, PayrollIds, GroupIdsFelder unterstützen die Operatoren '=' und IN.
• OnTheClock Und JobCodeTypeFelder unterstützen den Operator '='.
• LastModified Und Date-Felder unterstützen die Operatoren <=,<=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Timesheets WHERE OnTheClock = false

SELECT * FROM Timesheets WHERE LastModified > '2019-01-01 18:30' AND GroupIds IN (1, 2, 3)

SELECT * FROM Timesheets WHERE JobcodeId IN (1, 2, 3)

Einfügen

Das Einfügen kann durch Angabe der Spalten UserId, JobcodeId, Typ und Startzeit, Endzeit im Fall von Typ = regulär oder UserId, JobcodeId, Typ und Dauer, Datum im Fall von Typ = manuell ausgeführt werden. Die Spalten, die nicht benötigt werden, können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Timesheets (UserId, JobcodeId, Type, StartTime, EndTime) VALUES ('1242123', '17288283', 'regular', '2019-12-05', '2019-12-05')

INSERT INTO Timesheets (UserId, JobcodeId, Type, Date, Duration) VALUES ('1242123', '17288283', 'manual', '2019-12-05', 600)

Aktualisieren

Die Aktualisierung kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Timesheets SET Date = '2018-08-08', EndTime = '2018-08-08T14:00:00-07:00'  WHERE ID = '1242123'

Löschen

Das Löschen kann durch Angabe der ID in der WHERE-Klausel ausgeführt werden. Beispiel:

DELETE FROM Timesheets WHERE ID = '41321421'

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.

Benutzer

Ruft eine Liste aller Benutzer ab, die mit Ihrem Unternehmen verknüpft sind.

Tabellenspezifische Informationen

Wählen

Abfrage der Benutzertabelle. Der Connector verwendet die TSheets-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.

• Id, GroupId, Username, PayrollId Und EmployeeNumber-Felder unterstützen die Operatoren '=' und IN.
• FirstName Und LastNameFelder unterstützen die Operatoren '=' und LIKE.
• ActiveStatus unterstützt die = Betreiber.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Users WHERE ActiveStatus = 'both'

SELECT * FROM Users WHERE LastModified > '2019-01-01 18:30' AND GroupId IN (1, 2, 3)

SELECT * FROM Users WHERE FirstName LIKE 'josh%' AND PayrollId IN ('562348', '45457')

Einfügen

Das Einfügen kann durch Angabe der Spalten Benutzername, Vorname und Nachname ausgeführt werden. Die nicht benötigten Spalten können optional eingefügt werden. Nachfolgend finden Sie ein Beispiel für das Einfügen in diese Tabelle

INSERT INTO Users (UserName, FirstName, LastName) VALUES ('cdatagroup@123', 'cdata', 'group')

Aktualisieren

Die Aktualisierung kann durch Angabe der ID oder des Benutzernamens in der WHERE-Klausel ausgeführt werden. Die Spalten, die nicht schreibgeschützt sind, können aktualisiert werden. Beispiel:

UPDATE Users SET FirstName = 'New Name'  WHERE Id = '14055'

UPDATE Users SET FirstName = 'New User Name', LastName = 'New Title' WHERE UserName = 'cdatagroup@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.

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.

Jitterbit-Connector für TSheets-Ansichten

AktuellerTotalsBericht

Bericht über die aktuellen Gesamtstunden (Schicht und Tag) zusammen mit zusätzlichen Informationen für diejenigen, die gerade im Dienst sind.

Tabellenspezifische Informationen

Wählen

Abfrage der CurrentTotalsReport-Tabelle. Der Connector verwendet die TSheets-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.

• GroupId, UserId Und OnTheClockFelder unterstützen die Operatoren „=“ und IN.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM CurrentTotalsReport

SELECT * FROM CurrentTotalsReport WHERE GroupId IN ('29474', '29474') AND OnTheClock IN (true, false)

SELECT * FROM CurrentTotalsReport WHERE UserId IN (1751136, 1738864) AND OnTheClock = false

Spalten

AktuellerBenutzer

Fragen Sie die aktuellen Benutzerdetails in TSheets ab.

Tabellenspezifische Informationen

Wählen

Abfrage der CurrentUser-Tabelle. Dabei werden die Bedingungen der WHERE-Klausel auf der API -Seite nicht unterstützt, nur eine einfache SELECT Abfrage funktioniert auf der API Seite. Die Filter werden clientseitig innerhalb des Connectors ausgeführt.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM CurrentUser

Spalten

BenutzerdefinierteFeldelementeJobCodeFilters

Fragen Sie die JobCode-Filter für benutzerdefinierte Feldelemente in TSheets ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle CustomFieldItemJobCodeFilters. Der Connector verwendet die TSheets-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.

• JobCodeId unterstützt '=,IN'
• LastModified unterstützt '<,<=,>,>='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFieldItemJobCodeFilters
SELECT * FROM CustomFieldItemJobCodeFilters WHERE JobCodeId = '679721'

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.

BenutzerdefinierteFeldelementeBenutzerfilter

Fragen Sie die Benutzerfilter für benutzerdefinierte Feldelemente in TSheets ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle CustomFieldItemUserFilters. Der Connector verwendet die TSheets-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.

• UserId unterstützt das '='
• GroupId unterstützt das '='
• IncludeUserGroup unterstützt das '='
• LastModified unterstützt '<,<=,>,>='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFieldItemUserFilters
SELECT * FROM CustomFieldItemUserFilters WHERE JobCodeId = '679721'

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.

AllgemeineEinstellungen

Ruft eine Liste aller effektiven Einstellungen ab, die einem einzelnen Benutzer zugeordnet sind.

Tabellenspezifische Informationen

Wählen

Frage die Tabelle „GeneralSettings“ ab. Alle Filter werden clientseitig innerhalb des Connectors ausgeführt.

Spalten

GeofenceKonfigurationen

Ruft eine Liste aller Geofence-Konfigurationen ab.

Tabellenspezifische Informationen

Wählen

Abfrage der GeofenceConfigs-Tabelle. Der Connector verwendet die TSheets-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.

• Id, TypeId Und Type-Felder unterstützen die Operatoren '=' und IN.
• Enabled Feld und ActiveStatus Filter unterstützen den '='-Operator.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM GeofenceConfigs WHERE TypeId IN (282316, 323445) AND Type = 'Locations'

SELECT * FROM GeofenceConfigs WHERE Enabled = false

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.

LastModifiedTimestamps

Ruft eine Liste der last_modified-Zeitstempel ab, die mit jedem angeforderten API Endpoint verknüpft sind.

Tabellenspezifische Informationen

Wählen

Fragen Sie eine Liste der Zeitstempel der letzten Änderung ab, die mit jedem angeforderten API Endpoint verknüpft sind.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM LastModifiedTimestamps WHERE endpoints = 'timesheets,current_user,groups'

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.

Standortkarten

Ruft eine Liste aller mit Ihrem Unternehmen verknüpften Standortkarten ab.

Tabellenspezifische Informationen

Wählen

Abfrage der LocationMaps-Tabelle. Der Connector verwendet die TSheets-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.

• Id Feld unterstützt die Operatoren '=' und IN.
• ByJobcodeAssignment unterstützt die = Betreiber.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM LocationMaps WHERE Id IN ('102839', '110761')

SELECT * FROM LocationMaps WHERE ByJobcodeAssignment = true

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.

Verwaltete Kunden

Ruft eine Liste der verwalteten Clients ab, die über Ihr Konto verfügbar sind.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle ManagedClients. Der Connector verwendet die TSheets-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.

• ActiveStatus unterstützt die = Operator.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ManagedClients WHERE ActiveStatus = 'both'

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.

Lohn- und Gehaltsabrechnung

Lohn- und Gehaltsabrechnung mit einem Zeitrahmen verknüpft.

Tabellenspezifische Informationen

Wählen

Fragen Sie die Tabelle „PayrollReport“ ab, um Gehaltsabrechnungen abzurufen, die einem bestimmten Zeitraum zugeordnet sind, und verwenden Sie Filter, um die Ergebnisse einzugrenzen. Der Connector verwendet die TSheets-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 enthält der Bericht Ergebnisse für einen Zeitraum innerhalb der letzten 30 Tage. Sie können nach StartDate- und EndDate-Filtern filtern, um einen Gehaltsabrechnungsbericht für einen anderen Zeitraum zu erhalten.

• UserId Und GroupId-Felder unterstützen die Operatoren '=' und IN.
• StartDate, EndDate Und IncludeZeroTime-Felder unterstützen den Operator '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PayrollReport WHERE GroupId IN ('29474', '29475') AND IncludeZeroTime = false
SELECT * FROM PayrollReport WHERE StartDate = '2019-11-01' AND EndDate = '2019-12-31'

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.

Gehaltsabrechnungsbericht nach Jobcode

Lohn- und Gehaltsabrechnung nach Stellenbezeichnung aufgeschlüsselt

Tabellenspezifische Informationen

Wählen

Fragen Sie die Tabelle PayrollReportByJobCode ab, um einen nach Jobcode aufgeschlüsselten Gehaltsabrechnungsbericht abzurufen, mit Filtern zum Eingrenzen der Ergebnisse. Der Connector verwendet die TSheets-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 enthält der Bericht Ergebnisse für einen Zeitraum innerhalb der letzten 30 Tage. Sie können nach den Filtern StartDate und EndDate filtern, um einen Gehaltsabrechnungsbericht für einen anderen Zeitraum abzurufen. Der durch StartDate und EndDate definierte Datumsbereich darf 31 Tage nicht überschreiten.

• GroupId Feld unterstützt die Operatoren '=' und IN.
• StartDate, EndDate Und IncludeAdvancedOvertime-Felder unterstützen den Operator '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PayrollReportByJobCode WHERE GroupId IN ('29474', '29474') AND IncludeAdvancedOvertime = false
SELECT * FROM PayrollReport WHERE StartDate = '2019-11-01' AND EndDate = '2019-12-31'

Basierend auf den in der Projektion explizit ausgewählten Spalten können sich die angezeigten aggregierten Daten ändern. Aggregierte Gehaltsabrechnungsmetriken aufgeschlüsselt nach Jobcode-ID:

SELECT * FROM PayrollReport WHERE StartDate = '2019-11-01' AND EndDate = '2019-12-31'

Gesamtzahlen der Gehaltsabrechnung aufgeschlüsselt nach Jobcode-ID für jeden Benutzer:

SELECT UserId, JobCodeId, TotalWorkSeconds, TotalReSeconds, TotalPtoSeconds, OvertimeSeconds FROM PayrollReportByJobCode

Gesamtzahlen der Gehaltsabrechnung aufgeschlüsselt nach Jobcode-ID und Datum für jeden Benutzer:

SELECT Date, UserId, JobCodeId, TotalWorkSeconds, TotalReSeconds, TotalPtoSeconds, OvertimeSeconds FROM PayrollReportByJobCode

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.

ProjektAktivitäten

Fragen Sie die Projektaktivitäten in TSheets ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „ProjectActivities“. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• ProjectId unterstützt das '='
• ActivityType unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectActivities WHERE ProjectId = 2056676
SELECT * FROM ProjectActivities WHERE ProjectId = 2056676 AND ID = 8375474

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.

ProjektAktivitätLeseZeiten

Aktualisieren und fragen Sie die Lesezeit von ProjectActivity in TSheets ab.

Tabellenspezifische Informationen

Wählen

Fragen Sie die Tabelle ProjectActivityReadTimes ab. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• LatestReadTime unterstützt '<,<=,>,>='
• SupplementalData unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectActivityReadTimes
SELECT * FROM ProjectActivities WHERE ID = 8375474

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.

ProjektschätzungDetailbericht

Ruft einen detaillierten Bericht zur Projektschätzung ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle „ProjectEstimateDetailReport“. Der Connector verwendet die TSheets-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.

• Id unterstützt das '='
• SupplementalData unterstützt das '='
• ResultsAsArray unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectEstimateDetailReport
SELECT * FROM ProjectEstimateDetailReport WHERE ID = 8375474

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.

ProjektKostenvoranschlagsbericht

Ruft einen Projektschätzungsbericht ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle ProjectEstimateReport. Der Connector verwendet die TSheets-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.

• JobcodeId unterstützt '=,IN'
• ProjectId unterstützt '=,IN'
• ParentJobcodeId unterstützt das '='
• Status unterstützt das '='
• Active unterstützt das '='
• SupplementalData unterstützt das '='
• ResultsAsArray unterstützt das '='
• HasTimeTracked unterstützt das '='
• TimeTrackedStartDate unterstützt das '='
• TimeTrackedEndDate unterstützt das '='

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectEstimateReport
SELECT * FROM ProjectEstimateReport WHERE ProjectId = 8375474

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.

ProjektBericht

Ruft einen Projektbericht ab.

Tabellenspezifische Informationen

Wählen

Fragen Sie die ProjectReport-Tabelle ab, um einen Projektbericht abzurufen, aufgeschlüsselt nach Benutzer, Gruppe oder Jobcode. Der Connector verwendet die TSheets-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 enthält der Bericht Ergebnisse für einen Zeitraum innerhalb der letzten 30 Tage. Sie können nach StartDate- und EndDate-Filtern filtern, um einen Gehaltsabrechnungsbericht für einen anderen Zeitraum zu erhalten.

• UserId, JobcodeId Und GroupId-Felder unterstützen die Operatoren '=' und IN.
• StartDate Und EndDate-Felder unterstützen den Operator '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectReport WHERE GroupId IN (29474, 29474)
SELECT * FROM ProjectReport WHERE StartDate = '2019-11-01' AND EndDate = '2019-12-31'

Basierend auf den in der Projektion explizit ausgewählten Spalten können sich die angezeigten aggregierten Daten ändern. Aggregierte Projektmetriken aufgeschlüsselt nach Benutzer-ID:

SELECT * FROM ProjectReport WHERE StartDate = '2019-11-01' AND EndDate = '2019-12-31'
SELECT UserId, TotalHours FROM ProjectReport WHERE StartDate = '2019-11-01' AND EndDate = '2019-12-31'

Aggregierte Projektmetriken aufgeschlüsselt nach Jobcode-ID:

SELECT JobCodeId, TotalHours FROM ProjectReport

Gesamtzahlen der Gehaltsabrechnung aufgeschlüsselt nach Gruppen-ID:

SELECT GroupId, TotalHours FROM ProjectReport

Spalten

ZeitplanKalender

Ruft eine Liste der Terminkalender Ihrer Mitarbeiter oder Ihres Unternehmens ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle ScheduleCalendars. Der Connector verwendet die TSheets-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.

• Id Feld unterstützt die Operatoren '=' und IN.
• LastModified-Feld unterstützt die Operatoren <=,<,>=,>,=.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ScheduleCalendars WHERE Id IN (72595, 72597)

SELECT * FROM ScheduleCalendars WHERE LastModified < '2019-01-01 18:30'

Spalten

ArbeitszeitnachweiseGelöscht

Fragen Sie die Projektnotizen in TSheets ab.

Tabellenspezifische Informationen

Wählen

Abfrage der Tabelle TimesheetsDeleted. Der Connector verwendet die TSheets-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.

• Id unterstützt '=,IN'
• UserId unterstützt '=,IN'
• JobcodeId unterstützt '=,IN'
• StartDate unterstützt das '='
• EndDate unterstützt das '='
• Type unterstützt das '='
• LastModified unterstützt '<,<=,>,>='
• GroupId unterstützt '=,IN'
• Username unterstützt das '='
• JobcodeType unterstützt das '='
• SupplementalData unterstützt das '='

Zum Abfrage der TimesheetsDeleted-Ansicht sind entweder StartDate und EndDate oder ID erforderlich. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet:

SELECT * FROM TimesheetsDeleted WHERE StartDate = '2023-02-01' AND EndDate = '2024-07-01'
SELECT * FROM TimesheetsDeleted WHERE ID = 8375474

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.

Benutzerberechtigungen

Die einem einzelnen Benutzer zuweisbaren Rechte.

Tabellenspezifische Informationen

Wählen

Frage die UserPermissions-Tabelle ab. Alle Filter werden clientseitig innerhalb des Connectors ausgeführt.

Spalten

Gespeicherte Prozeduren

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

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

Jitterbit-Connector für gespeicherte TSheets-Prozeduren

Einladung erstellen

Laden Sie einen oder mehrere Benutzer zu Ihrem Unternehmen ein.

Eingang

Datei herunterladen

Laden Sie die Datei im Rohbinärformat herunter.

Gespeicherte Prozedurspezifische Informationen

TSheets erlaubt nur die Verwendung einer kleinen Teilmenge von Spalten in der Exec Abfrage. Diese Spalten können normalerweise nur mit =-Vergleichen verwendet werden. Beispiel:

EXECUTE DownloadFile FileId = '3688662', DownloadLocation = 'D:\Desktop'

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Holt ein Authentifizierungstoken von TSheets.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern das Authentifizierungstoken von dieser URL an.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert das OAuth-Zugriffstoken, das für die Authentifizierung bei verschiedenen MSTeams-Diensten verwendet wird.

Eingang

Ergebnissatzspalten

Aktualisieren Sie die Projektaktivität, und lesen Sie die Zeit ein.

Aktualisieren Sie die letzte Lesezeit für ein oder mehrere Projekte.

Gespeicherte Prozedurspezifische Informationen

TSheets erlaubt nur die Verwendung einer kleinen Teilmenge von Spalten in der Exec Abfrage. Diese Spalten können normalerweise nur mit =-Vergleichen verwendet werden. Beispiel:

EXECUTE UpdateProjectActivityReadTime ProjectId = '10001'

EXECUTE UpdateProjectActivityReadTime ProjectId = '10001, 10002'

Eingang

Ergebnissatzspalten

Datei hochladen

Lädt die Datei hoch. Es sind nur die Dateiformate .png, .jpeg und .jpg zulässig.

Gespeicherte Prozedurspezifische Informationen

TSheets erlaubt nur die Verwendung einer kleinen Teilmenge von Spalten in der Exec Abfrage. Diese Spalten können normalerweise nur mit =-Vergleichen verwendet werden. Beispiel:

EXECUTE UploadFile FileLocation = 'D:\\Desktop\\Test.png'

EXECUTE UploadFile FileLocation = 'D:\Desktop\Test.png', FileDescription = 'Test file'

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 TSheets 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, einschließlich Charge:

• 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 „Timesheets“ zurück:

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

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

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateInvitation' 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 „Timesheets“ ab:

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

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