Zoho Projects Verbindungsdetails
Einführung
Connector-Version
Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.
Erste Schritte
Versionsunterstützung für Zoho Projects
Der Connector nutzt die Zoho Projects API (es werden sowohl RestaPi als auch die v3- API verwendet), um einen bidirektionalen Zugriff auf Projektmanagementdaten von Zoho Projects zu ermöglichen.
Herstellen einer Verbindung
Mit Zoho Projects verbinden
Zoho Projects bietet zwei Möglichkeiten, eine Verbindung zu Daten herzustellen:
-
Um über den Desktop eine Verbindung zu Ihren eigenen lokalen Daten herzustellen (keine Browserverbindung), verwenden Sie die
- bereitgestellte eingebettete OAuth-Anwendung.
-
Um über das Netzwerk eine Verbindung zu freigegebenen Daten herzustellen (Browserverbindung), verwenden Sie eine benutzerdefinierte OAuth-Anwendung.
Um diese Authentifizierung von allen OAuth-Flows (eingebettet oder benutzerdefiniert) zu aktivieren, müssen Sie festlegen AuthScheme
Zu OAuth
.
In den folgenden Unterabschnitten wird die Authentifizierung bei Zoho Projects über drei gängige Authentifizierungsabläufe beschrieben:
Desktop
: eine Verbindung zu einem Server auf dem lokalen Computer des Benutzers, die häufig zum Testen und Prototyping verwendet wird. Authentifiziert entweder über eingebettetes OAuth oder benutzerdefiniertes OAuth.Web
: Zugriff auf Daten über eine gemeinsam genutzte Website. Authentisierung nur über benutzerdefiniertes OAuth.Headless Server
: ein dedizierter Computer, der anderen Computern und ihren Benutzern Dienste bereitstellt und so konfiguriert ist, dass er ohne Monitor und Tastatur funktioniert. Authentifiziert über eingebettetes OAuth oder benutzerdefiniertes OAuth.
Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung und warum Sie möglicherweise eine solche sogar für Authentifizierungsabläufe mit eingebetteten OAuth-Anmeldeinformationen erstellen möchten, finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.
Eine vollständige Liste der in Zoho Projects verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Connection.
Desktop-Anwendungen
bietet eine eingebettete OAuth-Anwendung, die die Authentifizierung auf dem Desktop vereinfacht, also in Situationen, in denen der Benutzer einen lokalen Server verwendet, der nicht mit dem Internet verbunden ist.
Sie können sich auch vom Desktop aus über eine benutzerdefinierte OAuth-Anwendung authentifizieren, die Sie in der Zoho Projects-Konsole konfigurieren und registrieren. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.
Legen Sie vor dem Verbinden die folgenden Variablen fest:
InitiateOAuth
:GETANDREFRESH
. Wird verwendet, um automatisch die abzurufen und zu aktualisierenOAuthAccessToken
.Custom OAuth applications only
:OAuthClientId
: Die Client-ID, die Ihnen bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung zugewiesen wurde.OAuthClientSecret
: Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung zugewiesen wurde.CallbackURL
: Die Umleitungs-URI, die bei der Registrierung Ihrer benutzerdefinierten OAuth-Anwendung definiert wurde.
Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Zoho Projects 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:
- Der Connector erhält einen Zugriffstoken von Zoho Projects und verwendet ihn, um Daten anzufordern.
- 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:
Damit der Connector das OAuth-Zugriffstoken automatisch aktualisiert, gehen Sie wie folgt vor:
- Wenn Sie zum ersten Mal eine Verbindung zu Daten herstellen, legen Sie die folgenden 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.
- 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.
- Um das OAuthAccessToken nach dem ExpiresIn-Zeitraum (zurückgegeben von GetOAuthAccessToken manuell zu aktualisieren) abgelaufen ist, rufen Sie den RefreshOAuthAccessToken gespeicherte Prozedur.
- Legen Sie die folgenden Verbindungseigenschaften fest:
OAuthClientId
: Die Client-ID in Ihren Anwendungseinstellungen.OAuthClientSecret
: Das Client Secret in Ihren Anwendungseinstellungen.
- Rufen Sie RefreshOAuthAccessToken auf mit OAuthRefreshToken auf das von GetOAuthAccessToken zurückgegebene OAuth-Aktualisierungstoken gesetzt.
- Nachdem die neuen Token abgerufen wurden, setzen Sie das
OAuthAccessToken
Eigenschaft 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
bettet OAuth-Anwendungsanmeldeinformationen mit Branding ein, die bei der Verbindung mit Zoho Projects über eine Desktop-Anwendung oder eine Headless-Maschine verwendet werden können. Wenn Sie die eingebettete OAuth-Anwendung verwenden möchten, müssen Sie zur Verbindung nur Folgendes tun:
- Satz
AuthScheme
ZuOAuth
, - holen und setzen Sie die
OAuthAccessToken
, und - legen Sie die erforderlichen Konfigurationsparameter fest.
(Informationen zum Abrufen und Festlegen der OAuthAccessToken
und andere Konfigurationsparameter finden Sie im Abschnitt Desktop-Authentifizierung unter „Herstellen einer Verbindung“.)
Sie müssen jedoch eine benutzerdefinierte OAuth-Anwendung erstellen, um über das Web eine Verbindung zu Zoho Projects herzustellen. Und da benutzerdefinierte OAuth-Anwendungen alle drei häufig verwendeten Authentifizierungsabläufe nahtlos unterstützen, möchten Sie für diese Authentifizierungsabläufe möglicherweise ohnehin benutzerdefinierte OAuth-Anwendungen erstellen (verwenden Sie Ihre eigenen OAuth-Anwendungsanmeldeinformationen).
Benutzerdefinierte OAuth-Anwendungen sind nützlich, wenn Sie:
- das Branding des Authentifizierungsdialogs steuern;
- die Umleitungs-URI steuern, zu der die Anwendung den Benutzer nach seiner Authentifizierung umleitet; oder
- Passen Sie die Berechtigungen an, die Sie vom Benutzer anfordern.
Verfahren
So erstellen Sie eine benutzerdefinierte OAuth-Anwendung und erhalten die OAuthClientId
, OAuthClientSecret
, Und CallbackURL
:
- Navigieren Sie zur Zoho Developer Console.
- Klicken Sie auf „Client hinzufügen“ und dann auf „Serverbasierte Anwendung“.
- Geben Sie den Kundennamen, die Homepage URL und die Weiterleitungs URL ein.
- Wenn der Benutzer die Verbindung über den Desktop oder das Internet herstellt, legen Sie eine Rückruf-URL fest:
- Für Desktop-Anwendungen legen Sie die Rückruf-URL fest auf
http://localhost:33333
oder eine andere Port Ihrer Wahl. - Legen Sie für Webanwendungen eine Rückruf-URL fest, um anzugeben, auf welcher Seite der Benutzer landen soll, nachdem er Ihrer Anwendung Zugriff gewährt hat.
- Für Desktop-Anwendungen legen Sie die Rückruf-URL fest auf
- Klicken Sie auf
Create
.
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.
Datenmodell
Überblick
Der Connector stellt alle Portale und Projekte bereit, die mit Ihrem Zoho Projects-Konto verknüpft sind, sodass Sie mit einer einzigen Verbindung auf alle Ihre Zoho Projects Daten zugreifen können.
Sie haben Zugriff auf:
- portalspezifische Daten
- projektspezifische Daten
- Daten zu allen Portalen
Benutzerportale
Der Connector modelliert jedes mit Ihrem Konto verknüpfte Portal als einen nach dem Portal benannten Katalog, der ein portalspezifisches Schema namens „ZohoProjects“ enthält.
Die Benutzerportale ist ein allgemeines Beispiel für ein solches portalspezifisches Schema.
Benutzerprojekte
Der Connector modelliert jedes mit Ihrem Konto verknüpfte Portal als Katalog, der nach dem Portal benannt ist. Für jedes Projekt in jedem dieser Kataloge gibt es ein projektspezifisches Schema, das nach dem Projekt benannt ist.
Die Benutzerprojekte Abschnitt ist ein allgemeines Beispiel für ein solches projektspezifisches Schema.
Alle Portale
Die Alle Portale enthält Daten zu allen Portalen, die mit Ihrem Konto verknüpft sind.
Benutzerportale
Übersicht
Der Connector modelliert jedes mit Ihrem Konto verknüpfte Portal als einen nach dem Portal benannten Katalog, der ein portalspezifisches Schema namens „ZohoProjects“ enthält.
Tabellen
Tabellen beschreibt die verfügbaren Tabellen. Tabellen werden statisch definiert, um Zoho Projects Entitäten wie Kontakte, Teams, Projekte usw. zu modellieren.
Ansichten
Ansichten beschreibt die verfügbaren Ansichten. Ansichten sind schreibgeschützte Tabellen, die statisch definiert sind, um Zoho Projects Entitäten wie Projekt- und Aufgabenlayouts zu modellieren.
Tabellen
Der Connector modelliert die Entitäten, für die Zoho Projects vollständige oder eingeschränkte CRUD-Unterstützung bietet, als Tabellen.
Es modelliert jedes mit Ihrem Konto verknüpfte Portal als Schema mit den folgenden Tabellen.
Navigieren Sie zur Seite einer einzelnen Tabelle, um eine Aufschlüsselung ihrer Spalten sowie der unterstützten Filter und CRUD-Operationen anzuzeigen.
Zoho Projects Connector-Tabellen
Name | Beschreibung |
---|---|
Contacts | Holt alle Kundenkontakte von einem Portal. |
PortalClients | Gibt die Liste der Kundenunternehmen im Portal zurück. |
ProjectGroups | Ruft alle Gruppen für das angegebene Projekt ab. |
Projects | Ruft alle Projekte für den angemeldeten Benutzer ab. |
Tags | Ruft alle in einem bestimmten Portal vorhandenen Tags ab. |
Teams | Holen Sie sich die Teamdetails vom Portal. |
Users | Ruft die Details aller Benutzer in einem bestimmten Projekt ab. |
Kontakte
Holt alle Kundenkontakte von einem Portal ab.
Wählen
ClientId
ist zum Abrufen von Kontakten erforderlich.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Contacts WHERE ClientId = '123456000000045005'
Einfügen
Um einen neuen Kontakt zu erstellen, können Sie die folgenden Felder angeben:
- Kunden-ID
- Vorname
- Nachname
- E Email
- Rechnungssatz
- Arbeitsprojekte
INSERT INTO Contacts (WorkProjects, ClientId, FirstName, LastName, Email, Invoicerate)
VALUES ('123456000000031899', '123456000000039025', 'TestFirstname222', 'TestLastname222', 'testemail@example.com', '15')
Aktualisieren
Um einen Kontakt zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Contacts
SET FirstName = 'updatedname', LastName = 'updatedlastname', email = 'updatedemail@example.com'
WHERE ID = '166135000000038075'
Löschen
Kontakte können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Contacts WHERE ID = '123456000000040053'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
ClientId | String | Falsch | Kontakt-Client-ID. |
Id [KEY] | String | Falsch | Kontakt-ID. |
CrmContactId | String | Falsch | Kontakt-CRM-Kontakt-ID. |
DisplayName | String | Falsch | Anzeigename des Kontakts. |
FirstName | String | Falsch | Vorname des Kontakts. |
LastName | String | Falsch | Nachname des Kontakts. |
Email | String | Falsch | Kontakt-Email. |
InvoiceRate | String | Falsch | Kontaktrechnungssatz. |
WorkProjects | String | Falsch | Array von Projekt-IDs. Mehrere IDs können durch Kommas getrennt werden. |
PortalClients
Gibt die Liste der Kundenunternehmen im Portal zurück.
Wählen
Sie können die folgende Abfrage verwenden, um alle Portal-Clients abzurufen:
SELECT * FROM PortalClients
Einfügen
Um einen neuen PortalClient zu erstellen, können Sie die folgenden Felder angeben:
- Name
- Stadt
- Land
- Bundesland
- Erste Adresse
- Zweite Adresse
- Webadresse
- Postleitzahl
- Benutzer-E-Mail
- Arbeitsprojekte
- Primärer Client
INSERT INTO PortalClients (Name, UserEmail, WebAddress, FirstAddress, SecondAddress, City, State, Country, PrimaryClient, ZipCode)
VALUES ('Company12', 'email1@example.com', 'www.example.com', 'Address line 1', 'Address line 2', 'Budapest', 'Hungary', 'Hungary', 'Yes', '1025')
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Client-ID. |
Name | String | Falsch | Kundenname. |
City | String | Falsch | Stadt des Kunden. |
Country | String | Falsch | Kundenland. |
State | String | Falsch | Client-Status. |
CrmAccountId | String | Falsch | Kunden-CRM-Konto-ID. |
FirstAddress | String | Falsch | Erste Adresse des Kunden. |
SecondAddress | String | Falsch | Zweite Adresse des Kunden. |
WebAddress | String | Falsch | Client-Webadresse. |
ZipCode | String | Falsch | Postleitzahl des Kunden. |
UserId | String | Falsch | Client-Benutzer-ID. |
UserName | String | Falsch | Client-Benutzername. |
UserEmail | String | Falsch | Email des Client-Benutzers. |
UserZpuid | String | Falsch | Client-Benutzer Zpuid. |
WorkProjects | String | Falsch | Kundenarbeitsprojekte. |
PrimaryClient | String | Falsch | Kunde Primärer Kunde. Die zulässigen Werte sind Ja, Nein. |
Projektgruppen
Ruft alle Gruppen für das angegebene Projekt ab.
Wählen
Sie können die folgende Abfrage verwenden, um alle Projektgruppen abzurufen:
SELECT * FROM ProjectGroups
Einfügen
Um eine neue Projektgruppe zu erstellen, können Sie die folgende Abfrage verwenden:
INSERT INTO ProjectGroups (name) VALUES ('New Project Group')
Löschen
Projektgruppen können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM ProjectGroups WHERE ID = '123456000000045018'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Projektgruppen-ID. |
Name | String | Falsch | Name der Projektgruppe. |
Default | Boolean | Falsch | Ist die Standardprojektgruppe. |
Projekte
Ruft alle Projekte für den angemeldeten Benutzer ab.
Wählen
Spalten, die den =-Operator unterstützen:
- Ausweis
- Erstelldatum
- Status
- Letzte Änderungszeit
Spalten, die die Operatoren = und IN unterstützen:
- Gruppen-ID
- Bevollmächtigter
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Projects WHERE ID = '123456000000039053'
Einfügen
Um ein neues Projekt zu erstellen, können Sie die folgenden Felder angeben:
- Name
- Abrechnungsstatus
- Abrechnungstyp
- Währung
- Beschreibung
- Öffentlich
- Eigentümer-ID
- Budgettyp
- Budgetwert
- Rate
- Budgetverfolgungsmethode
- Fixkosten
- Vorlagen-ID
- Schwellenwert
- Startdatum
- Enddatum
- Rollup aktivieren
Um ein neues Projekt zu erstellen, geben Sie die folgenden Felder an:
INSERT INTO Projects (Name, BudgetType, BudgetValue, BillingStatus, BillingType, Currency, Description, Public, BudgetType, BudgetTrackingMethod)
VALUES ('New Project', '2', '2.5', 'Billable', '2', 'EUR', 'TestDescription 123', 'no', '2', '4')
Aktualisieren
Sie können die folgende Abfrage verwenden, um ein Projekt zu aktualisieren:
UPDATE Projects
SET Currency = 'USD', SingleLinCustomField = 'New Custom Field Value'
WHERE ID = '123456000000039053'
Löschen
Projekte können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Projects WHERE ID = '123456000000039053'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Projekt-ID. |
Name | String | Falsch | Projektname. |
Key | String | Falsch | Projektschlüssel. |
BugsEnabled | Boolean | Falsch | Projektfehler aktiviert. |
BillingStatus | String | Falsch | Abrechnungsstatus des Projekts. Die zulässigen Werte sind Abrechnungsfähig, Nicht abrechnungsfähig. |
BillingType | String | Falsch | Geben Sie die Abrechnungsmethode für die Rechnungsstellung an. (1 = Basierend auf Projektstunden, 2 = Basierend auf Mitarbeiterstunden, 3 = Fixkosten für Projekt, 4 = Basierend auf Aufgaben-/Problemstunden). Die zulässigen Werte sind 1, 2, 3, 4. |
BugClientPermission | String | Falsch | Client-Berechtigung für Projektfehler. |
BugsClosed | Integer | Falsch | Projektfehler geschlossen. |
BugsOpen | Integer | Falsch | Projektfehler offen. |
BugsDefaultView | String | Falsch | Standardansicht für Projektfehler. |
BugsPrefix | String | Falsch | Präfix für Projektfehler. |
CreatedDate | Date | Falsch | Projekterstellungsdatum. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Projekterstellung. |
CustomStatusColor | String | Falsch | Benutzerdefinierte Statusfarbe des Projekts. |
CustomStatusId | String | Falsch | Benutzerdefinierte Status-ID des Projekts. |
CustomStatusName | String | Falsch | Benutzerdefinierter Statusname des Projekts. |
Currency | String | Falsch | Die Standardwährung Ihres Projekts. Beispiel: USD, INR usw. |
CurrencySymbol | String | Falsch | Währungssymbol des Projekts. |
Description | String | Falsch | Projektbeschreibung. |
EnabledTabs | String | Falsch | Registerkarten für Projektaktivierung. |
ChatEnabled | Boolean | Falsch | Projekt-Chat aktiviert. |
ClientAssignBug | String | Falsch | Fehler bei der Projektclientzuweisung. |
Public | String | Falsch | Projekt öffentlich. Die zulässigen Werte sind ja, nein. |
SprintsProject | Boolean | Falsch | Projektsprints-Projekt. |
Strict | String | Falsch | Projekt streng. |
BugLayoutId | String | Falsch | Projektfehler-Layout-ID. |
BugLayoutName | String | Falsch | Name des Projektfehlerlayouts. |
ProjectLayoutId | String | Falsch | Projekt Projektlayout-ID. |
ProjectLayoutName | String | Falsch | Projekt Projektlayoutname. |
TaskLayoutId | String | Falsch | Projektaufgaben-Layout-ID. |
TaskLayoutName | String | Falsch | Name des Projektaufgabenlayouts. |
ActivityUrl | String | Falsch | Projektaktivitäts-URL. |
BugUrl | String | Falsch | Projektfehler-URL. |
DocumentUrl | String | Falsch | Projektdokument-URL. |
EventUrl | String | Falsch | Projektereignis-URL. |
FolderUrl | String | Falsch | Projektordner-URL. |
ForumUrl | String | Falsch | Projektforum-URL. |
MilestoneUrl | String | Falsch | Projekt-Meilenstein-URL. |
SelfUrl | String | Falsch | Eigene Projekt-URL. |
StatusUrl | String | Falsch | Projektstatus-URL. |
TaskUrl | String | Falsch | Projektaufgaben-URL. |
TasklistUrl | String | Falsch | URL der Projektaufgabenliste. |
TimesheetUrl | String | Falsch | URL des Projekt-Zeiterfassungsbogens. |
UserUrl | String | Falsch | Projektbenutzer-URL. |
MilestoneClosed | Integer | Falsch | Projektmeilenstein erreicht. |
MilestoneOpen | Integer | Falsch | Projektmeilenstein offen. |
OwnerId | String | Falsch | Projektbesitzer-ID. |
OwnerName | String | Falsch | Name des Projektbesitzers. |
OwnerZpUid | String | Falsch | Projektinhaber Zp Uid. |
ProfileId | Long | Falsch | Projektprofil-ID. |
ProjectPercent | String | Falsch | Projektprojektprozentsatz. |
Role | String | Falsch | Projektrolle. |
ShowProjectOverview | Boolean | False | Projekt Projektübersicht anzeigen. |
Status | String | Falsch | Projektstatus. Die zulässigen Werte sind aktiv, archiviert, Vorlage. |
SettingsDate | Boolean | Falsch | Datum der Projekteinstellungen. |
SettingsLogHours | Boolean | Falsch | Projekteinstellungen - Stunden protokollieren. |
SettingsPercentage | Boolean | Falsch | Prozentsatz der Projekteinstellungen. |
SettingsPlan | Boolean | Falsch | Projekteinstellungsplan. |
SettingsWorkHours | Boolean | Falsch | Projekteinstellungen Arbeitszeit. |
TaskClosed | Integer | Falsch | Projektaufgabe geschlossen. |
TaskOpen | Integer | Falsch | Projektaufgabe offen. |
TaskbugPrefix | String | Falsch | Projekt-Taskbug-Präfix. |
UpdatedDate | Date | Falsch | Aktualisierungsdatum des Projekts. |
UpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Projektaktualisierung. |
WorkspaceId | String | Falsch | Projektarbeitsbereichs-ID. |
BudgetType | String | Falsch | Art Ihres Budgets. Akzeptierte Werte: 0, 1, 2, 3, 4, 5 und 6. (0 = Keine, 1 = Basierend auf Betrag, 2 = Basierend auf Stunden, 3 = Basierend auf Meilensteinbetrag, 4 = Basierend auf Meilensteinstunden, 5 = Basierend auf Aufgabenbetrag und 6 = Basierend auf Aufgabenstunden). Die zulässigen Werte sind 1, 2, 3, 4, 5, 6. |
BudgetTypeValue | String | Falsch | Wert des Projektbudgettyps. |
BudgetValue | String | Falsch | Projektbudgetwert. |
Rate | String | Falsch | Projektrate. |
BudgetTrackingMethod | String | Falsch | Methode zur Nachverfolgung Ihres Projektbudgets. Akzeptierte Werte: 1, 2 und 4. (1 = Projektstunden, 2 = Mitarbeiterstunden, 4 = Aufgaben-/Problemstunden). |
FixedCost | String | Falsch | Fixkosten des Projekts. |
TemplateId | String | Falsch | Projektvorlagen-ID. |
Threshold | String | Falsch | Geben Sie den Budgetschwellenwert an (Betrag oder Stunden). |
StartDate | String | Falsch | Projektstartdatum. |
EndDate | String | Falsch | Projektenddatum. |
EnableRollup | String | Falsch | Projekt-Rollup aktivieren. Die zulässigen Werte sind Ja, Nein. |
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.
Name | Typ | Beschreibung |
---|---|---|
LastModifiedTime | Datetime | Uhrzeit der letzten Änderung des Projekts. |
GroupId | String | Projektgruppen-ID. |
Assignee | String | Projektverantwortlicher. |
Schlagwörter
Ruft alle in einem bestimmten Portal vorhandenen Tags ab.
Wählen
Sie können die folgende Abfrage verwenden, um alle Tags abzurufen:
SELECT * FROM Tags
Einfügen
Um ein neues Tag zu erstellen, können Sie die folgenden Felder angeben:
INSERT INTO Tags (Name, ColorClass) VALUES ('New Tag', 'bg-tag16')
Aktualisieren
Um ein Tag zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Tags SET Name = 'Updated Name', ColorClass = 'bg-tag99' WHERE ID = '123456000000043057'
Löschen
Tags können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Tags WHERE ID = '123456000000043057'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Tag-ID. |
Name | String | Falsch | Tag-Name. |
ColorClass | String | Falsch | Tag-Farbklasse. |
CreatedBy | String | Falsch | Tag erstellt von. |
CreatedByName | String | Falsch | Tag erstellt nach Name. |
CreatedByEmail | String | Falsch | Tag per Email erstellt. |
CreatedByFirstName | String | Falsch | Tag erstellt nach Vorname. |
CreatedByLastName | Unknown | Falsch | Tag nach Nachname erstellt. |
CreatedByIsClientUser | Boolean | Falsch | Tag erstellt von ist Client-Benutzer. |
CreatedByZpuid | String | Falsch | Tag erstellt von Zpuid. |
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.
Name | Typ | Beschreibung |
---|---|---|
Tags | String |
Teams
Holen Sie die Teamdetails aus dem Portal.
Wählen
Sie können die folgende Abfrage verwenden, um alle Teams abzurufen:
SELECT * FROM Teams
Einfügen
Um ein neues Team zu erstellen, können Sie die folgenden Felder angeben:
- Gruppenname
- E-Mail-Alias
- UserIdArr
- Projekt-IDs
- Teamleiter
INSERT INTO Teams (GroupName, UserIdArr, TeamLead, ProjIds)" +
VALUES ('TestTeam5', '["123456000000031003", "123456000000032055"]', '123456000000032055', '["123456000000031899"]
Aktualisieren
Um ein Team zu aktualisieren, geben Sie das Feld GroupId an.
UPDATE Teams
SET TeamLead = '123456000000031003',
UserIdArr = '["123456000000031003", "123456000000032055"]',
ProjIds = '["123456000000031899"]',
GroupName = 'TestTeam5'
WHERE GroupId = '123456000000036001'
Löschen
Teams können gelöscht werden, indem die Gruppen-ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Teams WHERE GroupId = '123456000000044025'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
GroupId [KEY] | String | False | Gruppen-ID des Teams. |
GroupName | String | Falsch | Gruppenname des Teams. |
CreatedBy | String | Falsch | Team erstellt von. |
CreatedTime | String | Falsch | Erstellungszeit des Teams. |
Description | String | Falsch | Beschreibung des Teams. |
EmailAlias | String | Falsch | Email ID des Teams. |
EmailVerified | Boolean | Falsch | Email des Teams verifiziert. |
OrgId | String | Falsch | Organisations-ID des Teams. |
OwnerEmail | String | Falsch | Email des Teambesitzers. |
OwnerName | String | Falsch | Besitzername des Teams. |
OwnerZpuid | String | Falsch | Besitzer Zpuid des Teams. |
OwnerZuid | String | Falsch | Besitzer Zuid des Teams. |
Prefix | String | Falsch | Präfix des Teams. |
UpdatedBy | String | Falsch | Aktualisiert vom Team. |
UpdatedTime | String | Falsch | Aktualisierte Zeit des Teams. |
HasGroupEdit | Boolean | Falsch | Hat Gruppenbearbeitung des Teams. |
ProjectCount | Integer | Falsch | Projektanzahl des Teams. |
UserCount | Integer | Falsch | Benutzeranzahl des Teams. |
UserIdArr | String | Falsch | Array aus mehreren Zpuid. |
UserObj | String | False | Benutzerobjekt des Teams. |
ProjIds | String | Falsch | Array mit mehreren Projekt-IDs. |
TeamLead | String | Falsch | ZPuid des Teamleiters. |
Benutzer
Ruft die Details aller Benutzer in einem bestimmten Projekt ab.
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Benutzer-ID. |
Name | String | Falsch | Benutzername. |
Active | Boolean | Falsch | Benutzer aktiv. |
ChatAccess | Boolean | Falsch | Chat-Zugriff des Benutzers. |
Email | String | Falsch | Benutzer-Email. |
PortalProfileName | String | Falsch | Name des Benutzerportalprofils. |
PortalRoleId | String | Falsch | Rollen-ID des Benutzerportals. |
PortalRoleName | String | Falsch | Rollenname des Benutzerportals. |
ProfileId | String | Falsch | Benutzerprofil-ID. |
ProfileType | String | Falsch | Benutzerprofiltyp. |
ProjectProfileId | String | Falsch | Benutzer-Projektprofil-ID. |
Role | String | Falsch | Benutzerrolle. Die zulässigen Werte sind Manager, Mitarbeiter, Auftragnehmer. |
RoleId | String | Falsch | Benutzerrollen-ID. |
RoleName | String | Falsch | Benutzerrollenname. |
Zpuid | String | Falsch | Benutzer Zpuid. |
WorkProjects | String | Falsch | Benutzerarbeitsprojekte. |
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.
Name | Typ | Beschreibung |
---|---|---|
UserType | String | Benutzertyp. Die zulässigen Werte sind aktiv, inaktiv. |
Ansichten
Der Connector modelliert die Entitäten, für die Zoho Projects nur schreibgeschützten Zugriff bereitstellt, als Ansichten.
Es stellt jedes mit Ihrem Konto verknüpfte Portal als Schema mit den folgenden Ansichten bereit.
Navigieren Sie zur Seite einer einzelnen Ansicht, um eine Aufschlüsselung der Spalten und unterstützten Filter anzuzeigen.
Zoho Projects Connector-Ansichten
Name | Beschreibung |
---|---|
MyBugs | Listet alle von Ihnen erstellten oder Ihnen zugewiesenen Fehler auf. |
MyMilestones | Alle Meilensteine abrufen, die einem bestimmten Benutzer im angegebenen Projekt zugewiesen sind. |
MyTasks | Ruft alle Ihre Aufgaben im Portal ab. |
MyTimelogs | Ruft die Zeitprotokolle unter einem bestimmten Fehler ab. |
ProjectCustomFields | Ruft alle benutzerdefinierten Felder des Projekts ab. |
ProjectCustomStatus | Ruft eine Liste aller benutzerdefinierten Projektstatus ab. |
ProjectLayouts | Ruft eine Liste der Projektlayouts ab. |
TaskLayouts | Zeigen Sie die Liste aller in Ihrem Portal verfügbaren Aufgabenlayouts an. |
TaskStatusHistory | Holt den Statusverlauf von Aufgaben vom Portal. |
TimesheetCustomFields | Alle benutzerdefinierten Felder der Arbeitszeittabelle im gesamten Projekt abrufen. |
PortalUsersRemaining | Ruft die Details aller Benutzer in einem bestimmten Portal ab. |
MeineBugs
Listet alle von Ihnen erstellten oder Ihnen zugewiesenen Fehler auf.
Wählen
Dies ist eine Ansicht auf Portalebene.
StatusType
,Owner
,ViewType
UndViewType
unterstützt den folgenden Operator: =.CreatedDate
UndLastModifiedTime
Unterstützung: BESTELLUNG
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM MyBugs WHERE Owner = '12345021738' AND ViewType = 'owned' AND StatusType = 'open' ORDER BY CreatedDate
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Fehler-ID. |
Key | String | Bug-Schlüssel. |
Title | String | Fehlertitel. |
AssigneeId | String | Fehler-Zuweisungs-ID |
AssigneeName | String | Name des Fehlerbearbeiters. |
AssigneeZpuid | String | Fehlerbearbeiter ZPUID. |
AttachmentCount | String | Anzahl der Fehleranhänge. |
BugPrefix | String | Fehlerpräfix. |
ClassificationId | Long | Fehlerklassifizierungs-ID. |
ClassificationType | String | Fehlerklassifizierungstyp. |
Closed | Boolean | Fehler geschlossen. |
CommentCount | String | Anzahl der Fehlerkommentare. |
CreatedDate | Date | Datum der Fehlererstellung. |
CreatedDateTime | Datetime | Datum und Uhrzeit der Fehlererstellung. |
Description | String | Fehlerbeschreibung. |
DueDate | Date | Fälligkeitsdatum für Fehler. |
DueDateTime | Date | Fälligkeitsdatum und Uhrzeit des Fehlers. |
Flag | String | Fehlerflagge. |
LinkSelfUrl | String | Eigene URL des Fehlerlinks. |
LinkTimesheetUrl | String | Fehler: Link zur Arbeitszeittabelle. |
ModuleId | Long | Fehlermodul-ID. |
ModuleName | String | Name des Fehlermoduls. |
ProjectId | Long | Fehler-Projekt-ID. |
ProjectIdString | String | Fehler-Projekt-ID-Zeichenfolge. |
ProjectName | String | Name des Fehlerprojekts. |
ReportedPerson | String | Von Person gemeldeter Fehler. |
ReporterId | String | Fehlerberichterstatter-ID. |
ReproducibleId | Long | Fehler reproduzierbarer ID. |
ReproducibleType | String | Fehler reproduzierbarer Typ. |
SeverityId | Long | ID des Schweregrads des Fehlers |
SeverityType | String | Schweregrad des Fehlers. |
StatusId | Long | Fehlerstatus-ID. |
StatusType | String | Fehlerstatustyp. Die zulässigen Werte sind offen, geschlossen. |
UpdatedDate | Date | Datum der Fehleraktualisierung. |
UpdatedDateTime | Datetime | Fehler aktualisiert am und um Datum. |
UpdatedTimeLong | Long | Bug-Aktualisierungszeit lang. |
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.
Name | Typ | Beschreibung |
---|---|---|
Owner | String | Bug-Besitzer. |
ViewType | String | Fehleransichtstyp. Die zulässigen Werte sind gemeldet, im Besitz. |
LastModifiedTime | Datetime | Zeitpunkt der letzten Änderung des Fehlers. |
MeineMeilensteine
Holen Sie sich alle Meilensteine, die einem bestimmten Benutzer im angegebenen Projekt zugewiesen sind.
Wählen
Dies ist eine Ansicht auf Portalebene.
ProjectId
UndFlag
unterstützt den folgenden Operator: =.ProjectId
unterstützt den Operator: INCreatedDate
UndLastModifiedTime
Unterstützung: BESTELLUNG
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM MyMilestones WHERE ProjectId IN ('12345000000030899', '12345000000033005') AND Flag = 'internal' ORDER BY CreatedDate
Spalten
Name | Typ | Beschreibung |
---|---|---|
ProjectId | String | Projekt-ID. |
Id [KEY] | String | Meilenstein-ID. |
Name | String | Meilensteinname. |
Closed | Boolean | Meilenstein erreicht. |
CreatedDate | Date | Meilenstein-Erstellungsdatum. |
CreatedDateTime | Datetime | Datum und Uhrzeit der Meilensteinerstellung. |
EndDate | Date | Enddatum des Meilensteins. |
EndDateTime | Datetime | Enddatum und -uhrzeit des Meilensteins. |
Flag | String | Meilensteinflagge. Die zulässigen Werte sind intern, extern. |
IsWorkfieldRemoved | Boolean | Das Feld „Meilenstein ist Arbeit“ wurde entfernt. |
LastUpdatedDate | Date | Datum der letzten Meilensteinaktualisierung. |
LastUpdatedDateTime | Datetime | Datum und Uhrzeit der letzten Aktualisierung des Meilensteins. |
SelfUrl | String | Meilenstein-Eigen-URL. |
StatusUrl | String | Meilensteinstatus-URL. |
OwnerId | String | Meilensteinbesitzer-ID. |
OwnerName | String | Name des Meilensteinbesitzers. |
OwnerZpuid | String | Meilensteinbesitzer ZPUID. |
ProjectName | String | Name des Meilensteinprojekts. |
Sequence | Integer | Meilensteinsequenz. |
StartDate | Date | Startdatum des Meilensteins. |
StartDateTime | Datetime | Startdatum und Uhrzeit des Meilensteins. |
Status | String | Meilensteinstatus. |
StatusColorCode | String | Farbcode für Meilensteinstatus. |
StatusId | String | Meilenstein-Status-ID. |
StatusName | String | Name des Meilensteinstatus. |
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.
Name | Typ | Beschreibung |
---|---|---|
LastModifiedTime | Datetime | Zeitpunkt der letzten Änderung des Meilensteins. |
Meine Aufgaben
Hol alle Ihre Aufgaben im Portal ab.
Wählen
Dies ist eine Ansicht auf Portalebene. Spalten, die den Operator = unterstützen:
- Ausweis
- Erstellt von
- Meilenstein-ID
- Priorität
- Aufgabenlisten-ID
- Eigentümer
- Status
- Zeit
- Letzte Änderungszeit
- Ansichts-ID
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM MyTasks WHERE MilestoneId = '12345600000123' AND Priority = 'High'
Spalten
Name | Typ | Beschreibung |
---|---|---|
ProjectId | String | Projekt-ID. |
Id [KEY] | String | Aufgaben-ID. |
Name | String | Aufgabenname. |
Key | String | Aufgabenschlüssel. |
BillingType | String | Aufgabenabrechnungsart. |
Completed | Boolean | Aufgabe abgeschlossen. |
CreatedBy | String | Aufgabe erstellt von. |
CreatedByEmail | String | Aufgabe per Email erstellt. |
CreatedByZpuid | String | Aufgabe erstellt von Zpuid. |
CreatedPerson | String | Aufgabe erstellt von Person. |
CreatedDate | Date | Aufgabe erstellt am. |
CreatedDateTime | Datetime | Datum und Uhrzeit der Aufgabenerstellung. |
Description | String | Aufgabenbeschreibung. |
Owners | String | Aufgabeneigentümer. |
Duration | String | Aufgabendauer. |
DurationType | String | Art der Aufgabendauer. |
EndDate | Date | Enddatum der Aufgabe. |
EndDateTime | Datetime | Enddatum und -zeit der Aufgabe. |
CommentAdded | Boolean | Aufgabenkommentar hinzugefügt. |
DocsAssociated | Boolean | Zugehörige Aufgabendokumente. |
ForumAssociated | Boolean | Aufgabenforum verbunden. |
RecurrenceSet | Boolean | Aufgabenwiederholungssatz. |
ReminderSet | Boolean | Aufgabenerinnerungsset. |
Parent | Boolean | Übergeordnete Aufgabe. |
LastUpdatedDate | Date | Datum der letzten Aktualisierung der Aufgabe. |
LastUpdatedDateTime | Datetime | Datum und Uhrzeit der letzten Aktualisierung der Aufgabe. |
LinkSelfUrl | String | Eigene URL des Aufgabenlinks. |
LinkTimesheetUrl | String | Aufgabenlink-Zeiterfassungs-URL. |
LinkWebUrl | String | Web-URL des Aufgabenlinks. |
LogHoursBillableHours | String | Aufgabenprotokollstunden, abrechenbare Stunden. |
LogHoursNonBillableHours | String | Aufgabenprotokollstunden, nicht abrechenbare Stunden. |
MilestoneId | String | Aufgaben-Meilenstein-ID |
OrderSequence | Integer | Reihenfolge der Aufgaben. |
PercentComplete | String | Prozent abgeschlossene Aufgabe. |
Priority | String | Aufgabenpriorität. Die zulässigen Werte sind keine, niedrig, mittel, hoch. |
StartDate | Date | Startdatum der Aufgabe. |
StartDateTime | Datetime | Startdatum und Uhrzeit der Aufgabe. |
StatusColorCode | String | Farbcode für den Aufgabenstatus. |
StatusId | String | Aufgabenstatus-ID. |
StatusName | String | Name des Aufgabenstatus. |
StatusType | String | Aufgabenstatustyp. |
Subtasks | Boolean | Aufgabenunteraufgaben. |
TaskFollowers | String | Aufgabe Aufgabe Follower. |
TaskFollowerSize | Integer | Größe der Aufgabe/des Task-Followers. |
TasklistId | String | Aufgabe Aufgabenlisten-ID |
TasklistIdString | String | Task-Tasklisten-ID-Zeichenfolge. |
TasklistName | String | Name der Aufgabenliste für die Aufgabe. |
Work | String | Aufgabenarbeit. |
WorkForm | String | Aufgabenarbeitsformular. |
WorkType | String | Aufgabenarbeitstyp. |
GroupNameAssociatedTeamsAnyTeam | String | Name der Aufgabengruppe. Zugehörige Teams. Beliebiges Team. |
GroupNameAssociatedTeamsCount | Integer | Name der Aufgabengruppe. Anzahl der zugehörigen Teams. |
GroupNameIsTeamUnassigned | Boolean | Name der Aufgabengruppe lautet: „Team nicht zugewiesen.“ |
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.
Name | Typ | Beschreibung |
---|---|---|
Owner | String | Aufgabenbesitzer. |
Status | String | Aufgabenstatus. Die zulässigen Werte sind abgeschlossen, nicht abgeschlossen. |
Time | String | Aufgabenzeit. Die zulässigen Werte sind überfällig, heute, morgen. |
LastModifiedTime | Datetime | Zeitpunkt der letzten Änderung der Aufgabe. |
CustomViewId | String | Benutzerdefinierte Aufgabenansichts-ID. |
MeineZeitprotokolle
Ruft die Zeitprotokolle unter einem bestimmten Fehler ab.
Wählen
Dies ist eine Ansicht auf Portalebene. Spalten, die den Operator = unterstützen:
- Rechnungsstatus
- Datum
- Benutzer
- Ansichtstyp
- Komponententyp
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM MyTimelogs WHERE User = '123450000123'
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Zeitprotokoll-ID. |
AddedByName | String | Zeitprotokoll nach Namen hinzugefügt. |
AddedByZpuid | String | Zeitprotokoll von Zpuid hinzugefügt. |
AddedByZuid | Long | Zeitprotokoll von Zuid hinzugefügt. |
ApprovalStatus | String | Genehmigungsstatus des Zeitprotokolls. |
ApproverName | String | Name des Zeitprotokoll-Genehmigers. |
BillStatus | String | Rechnungsstatus des Zeitprotokolls. Die zulässigen Werte sind alle, abrechenbar, nicht abrechenbar. |
CreatedDate | Date | Erstellungsdatum des Zeitprotokolls. |
CreatedDateTime | Datetime | Datum und Uhrzeit der Erstellung des Zeitprotokolls. |
StartTime | Datetime | Startzeit des Zeitprotokolls. |
EndTime | Datetime | Endzeit des Zeitprotokolls. |
Notes | String | Zeitprotokollnotizen. |
HoursDisplay | String | Anzeige der Stunden im Zeitprotokoll. |
Hours | Integer | Stundenprotokoll. |
Minutes | Integer | Zeitprotokollminuten. |
IsParent | Boolean | Zeitprotokoll ist übergeordnetes Protokoll. |
IsSubTask | Boolean | Zeitprotokoll ist Unteraufgabe. |
LastModifiedDate | Date | Datum der letzten Änderung im Zeitprotokoll. |
LastModifiedDateTime | Datetime | Datum und Uhrzeit der letzten Änderung im Zeitprotokoll. |
LinkSelfUrl | String | Eigene URL des Zeitprotokoll-Links. |
LogDate | Date | Zeitprotokolldatum. |
LogDateTime | Datetime | Zeitprotokoll Datum Uhrzeit. |
OwnerId | String | Zeitprotokoll-Besitzer-ID. |
OwnerName | String | Name des Zeitprotokollbesitzers. |
SubTaskLevel | String | Unteraufgabenebene des Zeitprotokolls. |
TaskName | String | Name der Zeitprotokollaufgabe. |
TaskListId | Long | Zeitprotokoll-Aufgabenlisten-ID. |
TaskListName | String | Name der Zeitprotokoll-Aufgabenliste. |
TotalMinutes | Integer | Gesamtminuten des Zeitprotokolls. |
ProjectId | String | Zeitprotokoll-Projekt-ID. |
ProjectName | String | Name des Zeitprotokollprojekts. |
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.
Name | Typ | Beschreibung |
---|---|---|
Date | Date | Zeitprotokolldatum. |
User | String | Zeitprotokollbenutzer. |
ViewType | String | Ansichtstyp des Zeitprotokolls. Die zulässigen Werte sind Tag, Woche, Monat. |
ComponentType | String | Zeitprotokoll-Komponententyp. Die zulässigen Werte sind Bug, Task, General. |
ProjektbenutzerdefinierteFelder
Ruft alle benutzerdefinierten Felder des Projekts ab.
Wählen
Sie können die folgende Abfrage verwenden, um alle benutzerdefinierten Projektfelder abzurufen:
SELECT * FROM ProjectCustomFields
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Benutzerdefinierte Feld-ID. |
Name | String | Benutzerdefinierter Feldname. |
FieldType | String | Benutzerdefinierter Feldtyp. |
FieldId | String | Feld-ID. |
PII | Boolean | Benutzerdefiniertes Feld PII. |
Encrypted | Boolean | Verschlüsselt. |
DefaultValue | String | Standardwert für benutzerdefiniertes Feld. |
PickList | String | Optionen für die Auswahlliste benutzerdefinierter Felder. |
ProjektCustomStatus
Erhält eine Liste aller benutzerdefinierten Projektstatus.
Wählen
Mit der folgenden Abfrage können Sie alle benutzerdefinierten Projektstatus abrufen:
SELECT * FROM ProjectCustomStatus
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Portal-ID. |
Name | String | Portalname. |
Closed | Boolean | Portal geschlossen. |
Default | Boolean | Portalstandard. |
HasDefaultValue | Boolean | Portal hat Standardwert. |
Sequence | Int | Portalsequenz. |
StatusColor | String | Portalstatusfarbe. |
StatusColorHexcode | String | Hex-Code der Portalstatusfarbe. |
ProjektLayouts
Ruft eine Liste der Projektlayouts ab.
Wählen
Sie können die folgende Abfrage verwenden, um alle Projektlayouts abzurufen:
SELECT * FROM ProjectLayouts
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Projektlayout-ID. |
Name | String | Name des Projektlayouts. |
Default | Boolean | Ist das Standardprojektlayout. |
Aufgabenlayouts
Sehen Sie sich die Liste aller in Ihrem Portal verfügbaren Aufgabenlayouts an.
Wählen
Dies ist eine Ansicht auf Portalebene. Sie können die folgende Abfrage verwenden, um alle Aufgabenlayouts abzurufen:
SELECT * FROM TaskLayouts
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Aufgabenlayout-ID. |
Name | String | Name des Aufgabenlayouts. |
Default | Boolean | Aufgabenlayout Standard. |
Aufgabenstatusverlauf
Ruft den Statusverlauf von Aufgaben vom Portal ab.
Wählen
Dies ist eine Ansicht auf Portalebene.
LastModifiedTime
unterstützt: ORDER
Sie können die folgende Abfrage verwenden, um alle Aufgabenlayouts abzurufen:
SELECT * FROM TaskStatusHistory ORDER BY LastModifiedTime
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Aufgabenstatus-Verlaufs-ID. |
Name | String | Name des Aufgabenstatusverlaufs. |
StatusId | String | Status-ID des Aufgabenstatusverlaufs. |
StatusName | String | Aufgabenstatusverlauf, Statusname. |
PreviousStatusId | String | Aufgabenstatusverlauf, vorherige Status-ID. |
PreviousStatusName | String | Aufgabenstatusverlauf Vorheriger Statusname. |
UpdatedStatusId | String | Aufgabenstatusverlauf, aktualisierte Status-ID. |
UpdatedStatusName | String | Aufgabenstatusverlauf, aktualisierter Statusname. |
TransitionTimeMillis | String | Aufgabenstatusverlauf, Übergangszeit in Millis. |
TransitionTimeDuration | String | Dauer der Übergangszeit im Aufgabenstatusverlauf. |
UpdatedBy | String | Aufgabenstatusverlauf aktualisiert von. |
UpdatedByName | String | Aufgabenstatusverlauf nach Namen aktualisiert. |
UpdatedByEmail | String | Aufgabenstatusverlauf per Email aktualisiert. |
UpdatedOn | Datetime | Aufgabenstatusverlauf aktualisiert am. |
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.
Name | Typ | Beschreibung |
---|---|---|
LastModifiedTime | Datetime | Uhrzeit der letzten Änderung im Aufgabenstatusverlauf. |
ArbeitszeitnachweisBenutzerdefinierteFelder
Alle benutzerdefinierten Arbeitszeittabellenfelder des gesamten Projekts abrufen.
Wählen
Dies ist eine Ansicht auf Portalebene. Sie können die folgende Abfrage verwenden, um alle benutzerdefinierten Felder des Arbeitszeitnachweises abzurufen:
SELECT * FROM TimesheetCustomFields
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | ID des benutzerdefinierten Felds im Arbeitszeitnachweis. |
FieldName | String | Name des benutzerdefinierten Felds im Arbeitszeitblatt. |
DataType | String | Datentyp für benutzerdefiniertes Arbeitszeitnachweisfeld. |
UniqueColumn | String | Benutzerdefiniertes Feld für die Arbeitszeittabelle, eindeutige Spalte. |
PortalUsersRemaining
Ruft die Details aller Benutzer in einem bestimmten Portal ab.
Spalten
Name | Typ | Beschreibung |
---|---|---|
AvailableUsersCount | String | Anzahl verfügbarer Benutzer. |
Benutzerprojekte
Übersicht
Der Connector modelliert jedes mit Ihrem Konto verknüpfte Portal als Katalog, der nach dem Portal benannt ist. Für jedes Projekt in jedem dieser Kataloge gibt es ein projektspezifisches Schema, das nach dem Projekt benannt ist.
Tabellen
Tabellen beschreibt die verfügbaren Tabellen. Tabellen werden statisch definiert, um Zoho Projects Entitäten wie Fehler, Ereignisse, Aufgaben usw. zu modellieren.
Ansichten
Ansichten beschreibt die verfügbaren Ansichten. Ansichten sind schreibgeschützte Tabellen, die statisch definiert sind, um Zoho Projects Entitäten wie Aktivitäten, Kunden, Dokumente usw. zu modellieren.
Tabellen
Der Connector modelliert die Entitäten, für die Zoho Projects vollständige oder eingeschränkte CRUD-Unterstützung bietet, als Tabellen.
Es modelliert jedes mit Ihrem Konto verknüpfte Projekt als Schema mit den folgenden Tabellen.
Navigieren Sie zur Seite einer einzelnen Tabelle, um eine Aufschlüsselung ihrer Spalten sowie der unterstützten Filter und CRUD-Operationen anzuzeigen.
Zoho Projects Connector-Tabellen
Name | Beschreibung |
---|---|
BugAssociatedTasks | Ruft die Details der mit einem Fehler verbundenen Aufgabe ab. |
BugComments | Kommentare zum Fehler abrufen. |
BugEntityProperties | Ruft die für eine Entität gespeicherten Daten ab. Das Argument dieser Methode sollte der Schlüssel sein, der beim Speichern derselben Daten verwendet wurde. |
BugFollowers | Liste der Follower für den Fehler abrufen. |
Bugs | Ruft alle Aufgaben im angegebenen Projekt ab. Es werden nur die Hauptaufgaben und nicht die Unteraufgaben abgerufen. |
BugTimelogs | Ruft die Zeitprotokolle unter einem bestimmten Fehler ab. |
Events | Ruft alle in einem bestimmten Portal vorhandenen Tags ab. |
ForumCategories | Ruft alle Forenkategorien ab. |
ForumComments | Ruft alle Forumskommentare ab. |
Forums | Ruft alle Foren im angegebenen Projekt ab. |
Milestones | Ruft eine Liste der Projektlayouts ab. |
ProjectEntityProperties | Ruft die für eine Entität gespeicherten Daten ab. Das Argument dieser Methode sollte der Schlüssel sein, der beim Speichern derselben Daten verwendet wurde. |
ProjectUsers | Ruft die Details aller Benutzer in einem bestimmten Projekt ab. |
Statuses | Ruft den Status für das angegebene Projekt ab. |
TaskActivities | Rufen Sie Details darüber ab, wer eine bestimmte Aufgabe geändert hat und wann. |
TaskComments | Alle Aufgabenkommentare abrufen. |
TaskCustomfields | Nutzungsinformationen für die Operation TaskCustomfields.rsd. |
TaskEntityProperties | Ruft die für eine Entität gespeicherten Daten ab. Das Argument dieser Methode sollte der Schlüssel sein, der beim Speichern derselben Daten verwendet wurde. |
Tasklists | Alle Aufgabenlisten im angegebenen Projekt abrufen. |
Tasks | Ruft alle Aufgaben im angegebenen Projekt ab. Es werden nur die Hauptaufgaben und nicht die Unteraufgaben abgerufen. |
TaskSubtasks | Alle Unteraufgaben der angegebenen Aufgabe anzeigen. |
TaskTimelogs | Ruft die Zeitprotokolle unter einer bestimmten Aufgabe ab. |
TeamUsers | Details zu einem bestimmten Team abrufen. |
Fehlerassoziierte Aufgaben
Ruft die Details der mit einem Fehler verbundenen Aufgabe ab.
Tabellenspezifische Informationen
Diese Tabelle zeigt Zusammenhänge zwischen Bugs und Aufgaben.
Wählen
BugId
unterstützt den folgenden Operator: =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM BugAssociatedTasks WHERE BugId = '123439000000045005'
Einfügen
Um eine neue Bug-Task-Verknüpfung hinzuzufügen, geben Sie die Felder BugId und TaskId an.
INSERT INTO BugAssociatedTasks (BugId, TaskId) VALUES ('123418000000045005', '["123418000000044005"]')
Löschen
Um eine bestehende Bug-Task-Zuordnung zu löschen, geben Sie die Felder BugId und TaskId an.
DELETE FROM BugAssociatedTasks WHERE BugId = '123418000000045005' AND TaskId = '123418000000044005'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
BugId | String | Falsch | Fehler-ID. |
TaskId | String | Falsch | Zugehörige Aufgaben-ID. |
TaskName | String | Falsch | Zugehöriger Aufgabenname. |
Prefix | String | Falsch | Zugehöriges Aufgabenpräfix. |
ProjectId | String | Falsch | Zugehörige Aufgabenprojekt-ID. |
TaskOwners | String | Falsch | Zugehörige Aufgabeneigentümer. |
TaskPercentageCompleted | String | Falsch | Prozentsatz der abgeschlossenen zugehörigen Aufgabe. |
TaskPriority | String | Falsch | Zugehörige Aufgabenpriorität. |
TaskListId | String | Falsch | Zugehörige Aufgabenlisten-ID. |
Fehlerkommentare
Kommentare zum Fehler abrufen.
Wählen
BugId
ist erforderlich, um Fehlerkommentare abzurufen.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM BugComments WHERE BugId = '123456000000045005'
Einfügen
Um einen Fehlerkommentar hinzuzufügen, geben Sie die Felder BugId und Kommentar an.
INSERT INTO BugComments (BugId, Comment) VALUES ('123456000000045005', 'Test Comment #1')
Löschen
Fehlerkommentare können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM BugComments WHERE BugId = '123456000000045005' AND ID = '123456000000045042'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
BugId [KEY] | String | Falsch | Fehler-ID. |
Id [KEY] | String | Falsch | Fehlerkommentar-ID. |
Comment | String | Falsch | Inhalt des Fehlerkommentars. |
AddedBy | String | Falsch | Fehlerkommentar hinzugefügt von. |
AddedPersonName | String | Falsch | Fehlerkommentar: Personenname hinzugefügt. |
CreatedDate | Date | Falsch | Erstellungsdatum des Fehlerkommentars. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Erstellung des Fehlerkommentars. |
UpdatedBy | String | Falsch | Fehlerkommentar aktualisiert von. |
UpdatedPerson | String | Falsch | Fehlerkommentar aktualisiert, Person. |
UpdatedDate | Date | Falsch | Aktualisierungsdatum des Fehlerkommentars. |
UpdatedDateTime | Datetime | Falsch | Aktualisierungsdatum und -uhrzeit des Fehlerkommentars. |
BugEntityProperties
Ruft die für eine Entität gespeicherten Daten ab. Das Argument dieser Methode sollte der Schlüssel sein, der beim Speichern derselben Daten verwendet wurde.
Tabellenspezifische Informationen
Entitätseigenschaften sind Key-Value Paare, die für die Fehlerentitäten gespeichert werden. Sie können zum Speichern von Details verwendet werden, die für API Integrationen benötigt werden, aber nicht in der Benutzeroberfläche sichtbar sein müssen. Der Schlüssel muss ein String sein und der Wert kann ein einfacher String oder ein JSON-Objekt sein. Sie können mehrere Key-Value Paar für eine einzelne Entität speichern. Diese Entitätseigenschaften können mit den folgenden Abfragen gespeichert/abgerufen/aktualisiert/gelöscht werden.
Wählen
BugId
UndPropertyKey
sind erforderlich, um Bug-Entitätseigenschaften abzurufen.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM BugEntityProperties WHERE BugId = '123456000000034087' AND PropertyKey = 'key1'
Einfügen
Um eine neue Bug-Entity-Eigenschaft hinzuzufügen, geben Sie die Felder BugId, PropertyKey und PropertyValue an.
INSERT INTO BugEntityProperties (BugId, PropertyKey, PropertyValue) VALUES ('123456000000034087', 'key1', 'This is a test value')
Aktualisieren
ZohoProjects ermöglicht Aktualisierungen für die Spalte „PropertyValue“.
UPDATE BugEntityProperties SET PropertyValue = 'This is an updated property value' WHERE BugId = '123456000000034087' AND PropertyKey = 'key1'
Löschen
Bug-Entity-Eigenschaften können gelöscht werden, indem Sie ID, BugId, PropertyKey angeben und eine DELETE-Anweisung ausführen.
DELETE FROM BugEntityProperties WHERE BugId = '166135000000034087' AND PropertyKey = 'key1' AND ID = '166135000000035001'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Bug-Entitätseigenschafts-ID. |
BugId [KEY] | String | Falsch | Fehler-ID. |
PropertyKey [KEY] | String | Falsch | Bug-Entitätseigenschaftsschlüssel. |
PropertyValue | String | Falsch | Wert der Bug-Entitätseigenschaft. |
BugFollower
Liste der Follower des Bugs abrufen.
Wählen
BugId
ist erforderlich, um Bug-Follower abzurufen.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM BugFollowers WHERE BugId = '123456000000042110'
Einfügen
Um einen Bug-Follower hinzuzufügen, geben Sie die Felder BugId und Follower an.
INSERT INTO BugFollowers (BugId, BugFollowers) VALUES ('123456000000042110', '12345649448')
Löschen
Bug-Follower können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM BugFollowers WHERE BugId = '123456000000042110' AND FollowerId = '12345649448'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
BugId [KEY] | String | Falsch | Fehler-ID. |
FollowerId | String | Falsch | Bug-Follower-ID. |
FollowerName | String | Falsch | Name des Bug-Followers. |
BugFollowers | String | Falsch | Bug-Follower. |
Insekten
Ruft alle Aufgaben im angegebenen Projekt ab. Es ruft nur die Hauptaufgaben ab, nicht die Unteraufgaben.
Wählen
Spalten, die den =-Operator unterstützen:
- Ausweis
- Erstellte Zeit
- Flagge
- Statustyp
- Benutzerdefinierte Ansichts-ID
Spalten, die die Operatoren = und IN unterstützen:
- Zugewiesene ID
- Klassifizierungs-ID
- Eskalationsstufe
- Modul-ID
- Schweregrad-ID
- Status-ID
- Reporter-ID
- Meilenstein-ID
- Betroffene Meilenstein-ID
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Bugs
WHERE ReporterId IN ('12341021738')
AND AssigneeId IN ('12341021738')
AND ClassificationId IN ('123456000000030015')
AND EscalationLevel IN ('0')
AND Flag = 'Internal'
AND ModuleId IN ('123456000000030145')
AND SeverityId IN ('123456000000030151')
AND StatusId IN ('123456000000030083')
Einfügen
Um einen neuen Fehler zu erstellen, können Sie die folgenden Felder angeben:
- Titel
- AssigneeId
- ClassificationId
- Beschreibung
- Fälligkeitsdatum
- Flag
- ModuleId
- ReproducibleId
- SeverityId
- HourlyRate
- BugFollowers
- MilestoneId
Um einen neuen Fehler zu erstellen, geben Sie die folgenden Felder an:
INSERT INTO Bugs (Title, Description, AssigneeId, flag, ClassificationId, DueDate, ModuleId, SeverityId, ReproducibleId, HourlyRate, CustomField1)
VALUES ('SQL Inserted Bug #5', 'Test Description', '12341249448', 'Internal', '123456000000031015', '2022-03-20', '123456000000031145', '123456000000031149', '123456000000031053', '2', 'TestCustomField')
Aktualisieren
Sie können die folgende Abfrage verwenden, um einen Fehler zu aktualisieren:
UPDATE Bugs
SET Title = 'SQL Inserted Bug #5',
Description = 'Another Test Description',
AssigneeId = '20081249448',
ClassificationId = '165818000000031015',
DueDate = '2022-03-20',
ModuleId = '165818000000031145',
SeverityId = '165818000000031149',
ReproducibleId = '165818000000031053',
HourlyRate = '2',
cf1 = 'Custom Field Edited #1'
WHERE ID = '165818000000042126'
Löschen
Fehler können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Bugs WHERE ID = '123456000000042126'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Fehler-ID. |
Key | String | Falsch | Fehlerschlüssel. |
Title | String | Falsch | Fehlertitel. |
AssigneeId | String | Falsch | Fehler-Zuweisungs-ID. |
AssigneeName | String | Falsch | Name des Fehlerbearbeiters. |
AssigneeZpuid | String | Falsch | Fehlerbearbeiter ZPUID. |
AttachmentCount | String | Falsch | Anzahl der Fehleranhänge. |
BugNumber | String | Falsch | Fehlernummer. |
BugPrefix | String | Falsch | Fehlerpräfix. |
ClassificationId | Long | Falsch | Fehlerklassifizierungs-ID. |
ClassificationType | String | Falsch | Fehlerklassifizierungstyp. |
Closed | Boolean | Falsch | Fehler geschlossen. |
CommentCount | String | Falsch | Anzahl der Fehlerkommentare. |
CreatedTime | Date | Falsch | Zeitpunkt der Fehlererstellung. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Fehlererstellung. |
Description | String | Falsch | Fehlerbeschreibung. |
DueDate | Date | Falsch | Fälligkeitsdatum des Fehlers. |
DueDateTime | Datetime | Falsch | Fälligkeitsdatum und Uhrzeit des Fehlers. |
EscalationLevel | String | Falsch | Fehler-Eskalationsstufe. |
Flag | String | Falsch | Fehlerflagge. Die zulässigen Werte sind intern, extern. |
LinkSelfUrl | String | Falsch | Fehler beim Link zur eigenen URL. |
LinkTimesheetUrl | String | Falsch | Fehler beim Link zur Arbeitszeittabelle. |
LinkWebUrl | String | Falsch | Fehler-Link-Web-URL. |
ModuleId | Long | Falsch | Fehlermodul-ID. |
ModuleName | String | Falsch | Name des Fehlermoduls. |
ReportedPerson | String | Falsch | Fehler von Person gemeldet. |
ReporterEmail | String | Falsch | Email zum Melden von Fehlern. |
ReporterId | String | Falsch | Fehlerberichterstatter-ID. |
ReporterNonZuser | String | Falsch | Fehlerberichterstatter, kein Benutzer. |
ReproducibleId | Long | Falsch | Fehler reproduzierbare ID. |
ReproducibleType | String | Falsch | Fehler reproduzierbarer Typ. |
SeverityId | Long | Falsch | Fehlerschweregrad-ID. |
SeverityType | String | Falsch | Schweregrad des Fehlers. |
StatusColorcode | String | Falsch | Farbcode für den Fehlerstatus. |
StatusId | String | Falsch | Fehlerstatus-ID. |
StatusType | String | Falsch | Fehlerstatustyp. Die zulässigen Werte sind offen, geschlossen. |
UpdatedDate | Date | Falsch | Datum der Fehleraktualisierung. |
UpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Fehleraktualisierung. |
GroupNameAssociatedTeamsAnyTeam | String | Falsch | Fehlergruppenname, verbundene Teams von jedem Team. |
GroupNameAssociatedTeamsCount | Integer | Falsch | Anzahl der zugehörigen Teams mit Fehlergruppenname. |
GroupNameIsTeamUnassigned | Boolean | Falsch | Name der Fehlergruppe ist „Team nicht zugewiesen“. |
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.
Name | Typ | Beschreibung |
---|---|---|
HourlyRate | String | Stundensatz für Fehler. |
BugFollowers | String | Bug Bug-Anhänger. |
CustomViewId | String | Fehler, benutzerdefinierte Ansichts-ID. |
MilestoneId | String | Fehler-Meilenstein-ID. |
AffectedMilestoneId | String | Vom Fehler betroffene Meilenstein-ID. |
Fehlerzeitprotokolle
Ruft die Zeitprotokolle unter einem bestimmten Fehler ab.
Wählen
BugId
ist erforderlich, um Bug Time Logs abzurufen.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM BugTimelogs WHERE BugId = '123456000000045005'
Einfügen
Um ein Bug-TimeLog hinzuzufügen, geben Sie die Felder BugId und Follower an.
INSERT INTO BugTimelogs (BugId, LogDate, BillStatus, HoursDisplay, Notes)
VALUES ('123456000000045005', '2022-03-03', 'Non Billable', '01:20', 'This is a test timelog')
Aktualisieren
Um ein Bug-TimeLog zu aktualisieren, geben Sie die Felder BugId und ID an.
UPDATE BugTimelogs
SET Notes = 'This is an updated SQL Note'
WHERE BugId = '165818000000045005' AND ID = '123456000000044025'
Löschen
Bug TimeLogs können gelöscht werden, indem die BugId und ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM BugTimelogs WHERE BugId = '123456000000045005' AND ID = '123456000000044025'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
BugId [KEY] | String | Falsch | Fehler-ID. |
Id [KEY] | String | Falsch | Fehlerzeitprotokoll-ID. |
AddedByName | String | Falsch | Fehlerzeitprotokoll nach Namen hinzugefügt. |
AddedByZpuid | String | Falsch | Fehlerzeitprotokoll von ZPUID hinzugefügt. |
AddedByZuid | Long | Falsch | Fehlerzeitprotokoll von ZUID hinzugefügt. |
ApprovalStatus | String | Falsch | Genehmigungsstatus des Fehlerzeitprotokolls. |
ApproverName | String | Falsch | Name des Genehmigers des Fehlerzeitprotokolls. |
BillStatus | String | Falsch | Rechnungsstatus des Fehlerzeitprotokolls. Die zulässigen Werte sind Abrechnungsfähig, Nicht abrechnungsfähig. |
BugTitle | String | Falsch | Fehlerzeitprotokoll Fehlertitel. |
CreatedDate | Date | Falsch | Erstellungsdatum des Fehlerzeitprotokolls. |
CreatedDateTime | Datetime | Falsch | Fehlerzeitprotokoll erstellt am und um Datum. |
Hours | Integer | Falsch | Stunden des Fehlerzeitprotokolls. |
Minutes | Integer | Falsch | Fehlerzeitprotokoll in Minuten. |
HoursDisplay | String | Falsch | Anzeige der Stunden im Fehlerzeitprotokoll. |
LastModifiedDate | Date | Falsch | Datum der letzten Änderung im Fehlerzeitprotokoll. |
LastModifiedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Änderung des Fehlerprotokolls. |
LinkSelfUrl | String | Falsch | Eigene URL des Bug-Zeitprotokoll-Links. |
LogDate | Date | Falsch | Fehlerzeitprotokolldatum. |
LogDateTime | Datetime | Falsch | Fehlerzeitprotokolldatum und -zeit. |
Notes | Unknown | Falsch | Fehlerzeitprotokollnotizen. |
OwnerId | String | Falsch | Bug-Zeitprotokoll-Besitzer-ID. |
OwnerName | String | Falsch | Name des Besitzers des Fehlerzeitprotokolls. |
TotalMinutes | Integer | Falsch | Gesamtminuten des Fehlerzeitprotokolls. |
Veranstaltungen
Ruft alle in einem bestimmten Portal vorhandenen Tags ab.
Wählen
Status
unterstützt den folgenden Operator =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Events WHERE Status = 'open'
Einfügen
Um ein neues Ereignis zu erstellen, können Sie die folgenden Felder angeben:
- Titel
- Dauer (Stunden)
- Dauer (Minuten)
- Ort
- Teilnehmer
- Erinnerung
- Wiederholung
- Geplant am
- Wiederholungszeiten
INSERT INTO Events (Title, ScheduledOn, DurationHour, DurationMinutes, Participants, Reminder, Repeat, Location)
VALUES ('SQL Event #2', '2022-03-20T18:00:00', '2', '30', '20081249448', '15 mins', 'only once', 'Test Location 2')
Aktualisieren
Um ein Ereignis zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Events
SET title = 'Updated Title #1', DurationHour = '4', DurationMinutes = '10', ScheduledOn = '2022-05-01T23:12:00', Participants = '20081249448'
WHERE ID = '123456000000045018'
Löschen
Ereignisse können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Events WHERE ID = '123456000000045018'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Ereignis-ID. |
Title | String | Falsch | Veranstaltungstitel. |
CreatedBy | String | Falsch | Ereignis erstellt von. |
CreatedByZpuid | String | Falsch | Ereignis erstellt von ZPUID. |
CreatedOn | Long | Falsch | Ereignis erstellt am. |
DurationHour | String | Falsch | Dauer der Veranstaltung in Stunden. |
DurationMinutes | String | Falsch | Dauer des Ereignisses in Minuten. |
Location | String | Falsch | Veranstaltungsort. |
Occurred | Integer | Falsch | Ereignis aufgetreten. |
Occurrences | Integer | Falsch | Ereignisauftreten. |
Participants | String | Falsch | Veranstaltungsteilnehmer. |
ProjectName | String | Falsch | Name des Ereignisprojekts. |
Reminder | String | Falsch | Ereigniserinnerung. Die zulässigen Werte sind pünktlich, 15 Min., 30 Min., 1 Std., 2 Std., 6 Std., 12 Std., 1 Tag. |
Repeat | String | Falsch | Ereigniswiederholung. Die zulässigen Werte sind nur einmal, jeden Tag, jede Woche, jeden Monat, jedes Jahr. |
ScheduledOn | String | Falsch | Ereignis geplant am. |
ScheduledOnLong | String | Falsch | Ereignis geplant am Long. |
ScheduledOnTo | String | Falsch | Ereignis geplant am. |
ScheduledOnToLong | String | Falsch | Ereignis zu lange geplant. |
RepeatTimes | String | Falsch | Wiederholungshäufigkeit des Ereignisses. Die zulässigen Werte sind 2, 3, 4, 5, 6, 7, 8, 9, 10. |
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.
Name | Typ | Beschreibung |
---|---|---|
Status | String | Ereignisstatus. Die zulässigen Werte sind offen, geschlossen. |
ForumKategorien
Ruft alle Forenkategorien ab.
Wählen
Sie können die folgende Abfrage verwenden, um alle Forumkategorien abzurufen:
SELECT * FROM ForumCategories
Einfügen
Um eine neue Forumkategorie zu erstellen, können Sie die folgende Abfrage verwenden:
INSERT INTO ForumCategories (name) VALUES ('New Forum Category')
Löschen
Forumkategorien können durch Angabe der ID und Ausgeben einer DELETE-Anweisung gelöscht werden.
DELETE FROM ForumCategories WHERE ID = '123456000000045018'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Forum-Kategorie-ID. |
Name | String | Falsch | Name der Forumkategorie. |
ForumKommentare
Erhält alle Forumskommentare.
Wählen
ForumId
ist erforderlich, um Forenkommentare abzurufen.
Sie können die folgende Abfrage verwenden, um alle Forumskommentare abzurufen:
SELECT * FROM ForumComments WHERE ForumId = '123456000000045018'
Einfügen
Um einen neuen Forumskommentar zu erstellen, können Sie die folgende Abfrage verwenden:
INSERT INTO ForumComments (ForumId, Content, ParentId)
VALUES ('123456000000045028', 'Forum Comment Reply', '123456000000043083')
Löschen
Forumskommentare können gelöscht werden, indem die ID und die ForumID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM ForumComments WHERE ID = '123456000000043083' AND ForumId = '123456000000045028'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
ForumId [KEY] | Long | Falsch | Forum-ID. |
Id [KEY] | String | Falsch | Forum-Kommentar-ID. |
Content | String | Falsch | Inhalt von Forum-Kommentaren. |
Type | String | Falsch | Forum-Kommentartyp. |
Attachments | String | Falsch | Anhänge für Forumkommentare. |
IsBestAnswer | Boolean | Falsch | Forumkommentar ist die beste Antwort. |
Level | String | Falsch | Forum-Kommentarebene. |
ParentId | String | Falsch | Übergeordnete ID des Forumkommentars. |
ParentPostedBy | String | Falsch | Übergeordneter Forum-Kommentar Gepostet von. |
ParentPostedByZpuid | String | Falsch | Übergeordneter Forumskommentar, gepostet von ZPUID. |
PostDate | Date | Falsch | Datum der Veröffentlichung des Forumkommentars. |
PostDateTime | Datetime | Falsch | Datum und Uhrzeit des Forum-Kommentars. |
PostedBy | String | Falsch | Forum-Kommentar gepostet von. |
PostedByZpuid | String | Falsch | Forumskommentar gepostet von Zpuid. |
PostedPerson | String | Falsch | Von einer Person geposteter Forumkommentar. |
RootId | String | Falsch | Stamm-ID des Forumkommentars. |
ThirdPartyAttachments | String | Falsch | Forum-Kommentare zu Anhängen von Drittanbietern. |
Foren
Ruft alle Foren im angegebenen Projekt ab.
Wählen
Id
UndCategoryId
unterstützt den folgenden Operator: =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Forums WHERE ID = '123456000000043771'
Einfügen
Um ein neues Forum zu erstellen, können Sie die folgenden Felder angeben:
- Name
- Typ
- Kategorie-ID
- Inhalt
- Flagge
- IstAnnouncementPost
- IstStickyPost
- Benachrichtigen
Um ein neues Forum zu erstellen, können Sie die folgende Abfrage verwenden:
INSERT INTO Forums (Name, Type, CategoryId, Content, Flag, IsAnnouncementPost, IsStickyPost)
VALUES ('Forum Post', 'normal', '123456000000039039', 'Content for Forum Post', 'internal', false, false)
Aktualisieren
Um ein Forum zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Forums
SET Name = 'Updated Post Name', CategoryId = '123456000000093039', Content = 'Updated forum post content'
WHERE ID = '123456000000043771'
Löschen
Foren können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Forums WHERE ID = '123456000000043771'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Forum-ID. |
Name | String | Falsch | Forumname. |
Type | String | Falsch | Forumtyp. Die zulässigen Werte sind normal, Frage. |
Attachments | String | Falsch | Forum-Anhänge. |
CategoryId | String | Falsch | Forum-Kategorie-ID. |
CategoryName | String | Falsch | Name der Forumkategorie. |
CommentCount | Integer | Falsch | Anzahl der Forum-Kommentare. |
Content | String | Falsch | Forum-Inhalt. |
Flag | String | Falsch | Forum-Flagge. |
IsAnnouncementPost | Boolean | Falsch | Forum ist ein Ankündigungsbeitrag. |
IsStickyPost | Boolean | Falsch | Forum ist angehefteter Beitrag. |
LastActivityDate | Date | Falsch | Datum der letzten Aktivität im Forum. |
LastActivityDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Aktivität im Forum. |
LastModifiedDate | Date | Falsch | Datum der letzten Änderung im Forum. |
LastModifiedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Änderung im Forum. |
LinkSelfUrl | String | Falsch | Eigene URL des Forum-Links. |
PostDate | Date | Falsch | Datum des Beitrags im Forum. |
PostDateTime | Datetime | Falsch | Datum und Uhrzeit des Forumbeitrags. |
PostedBy | String | Falsch | Im Forum gepostet von. |
PostedByZpuid | String | Falsch | Im Forum gepostet von ZPUID. |
PostedPerson | String | Falsch | Im Forum gepostete Person. |
ThirdPartyAttachments | String | Falsch | Forum-Anhänge von Drittanbietern. |
Notify | String | Falsch | Geben Sie die E-Mail-IDs der Benutzer ein, die benachrichtigt werden sollen (mehrere Emails können durch Kommas getrennt werden). |
Meilensteine
Ruft eine Liste der Projektlayouts ab.
Wählen
Spalten, die den =-Operator unterstützen:
- Ausweis
- Flagge
- Besitzer-ID
- Status Anzeigetyp
- Letzte Änderungszeit
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Milestones WHERE ID = '123456000000043771' WHERE flag = 'internal'
Einfügen
Um einen neuen Meilenstein zu erstellen, können Sie die folgenden Felder angeben:
- Name
- Flagge
- Startdatum
- Enddatum
- Besitzer-ID
Um einen neuen Meilenstein zu erstellen, können Sie die folgende Abfrage verwenden:
INSERT INTO Milestones (name, StartDate, EndDate, OwnerId, flag)
VALUES ('New Milestone name', '2022-03-01', '2022-03-10', '1234567890', 'internal')
Aktualisieren
Um einen Meilenstein zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Milestones
SET Name = 'Updated Name',
Flag = 'external',
StartDate = '2022-02-01',
EndDate = '2022-03-01',
OwnerId = '1234567890' " +
WHERE ID = '123456000000043021'
Löschen
Meilensteine können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Milestones WHERE ID = '123456000000043021'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Projektmeilenstein-ID. |
Name | String | Falsch | Name des Projektmeilensteins. |
Flag | String | Falsch | Meilensteinflagge. Die zulässigen Werte sind intern, extern. |
Closed | Boolean | Falsch | Meilenstein erreicht. |
CreatedDate | Date | Falsch | Meilenstein-Erstellungsdatum. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Meilensteinerstellung. |
StartDate | Date | Falsch | Meilenstein-Startdatum. |
StartDateTime | Datetime | Falsch | Startdatum und Uhrzeit des Meilensteins. |
EndDate | Date | Falsch | Enddatum des Meilensteins. |
EndDateTime | Datetime | Falsch | Enddatum und -zeit des Meilensteins. |
Actual | Integer | Falsch | Meilenstein tatsächlich. |
ActualCostFormatted | String | Falsch | Tatsächliche Meilensteinkosten formatiert. |
ActualHoursFormatted | String | Falsch | Tatsächliche Meilensteinstunden formatiert. |
Balance | Integer | Falsch | Meilensteinsaldo. |
BalanceCostFormatted | String | Falsch | Meilensteinsaldokosten formatiert. |
BcyActual | Integer | Falsch | Meilenstein Bcy Tatsächlich. |
BcyActualCost | String | Falsch | Meilenstein Bcy: Tatsächliche Kosten. |
BcyForecasted | Integer | Falsch | Meilenstein Bcy prognostiziert. |
BcyForecastedCost | String | Falsch | Meilenstein Bcy prognostizierte Kosten. |
BcyPlanned | Integer | Falsch | Meilenstein Bcy geplant. |
BcyPlannedCost | String | Falsch | Meilenstein BCY Geplante Kosten. |
BudgetType | Integer | Falsch | Meilenstein-Budgettyp. |
CurrencyCode | String | Falsch | Meilenstein-Währungscode. |
Difference | Integer | Falsch | Meilensteinunterschied. |
DifferenceFormatted | String | Falsch | Meilensteinunterschied formatiert. |
Forecasted | Integer | Falsch | Meilenstein prognostiziert. |
ForecastedCostFormatted | String | Falsch | Voraussichtliche Meilensteinkosten formatiert. |
ForecastedHoursFormatted | String | Falsch | Voraussichtliche Meilensteinstunden formatiert. |
LastCalculatedTime | String | Falsch | Zuletzt berechnete Zeit des Meilensteins. |
Planned | Integer | Falsch | Meilenstein geplant. |
PlannedCostFormatted | String | Falsch | Geplante Meilensteinkosten formatiert. |
PlannedHoursFormatted | String | Falsch | Für Meilensteine geplante Stunden formatiert. |
IsWorkfieldRemoved | Boolean | Falsch | Das Feld „Meilenstein ist Arbeit“ wurde entfernt. |
LastUpdatedDate | Date | Falsch | Datum der letzten Aktualisierung des Meilensteins. |
LastUpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Aktualisierung des Meilensteins. |
SelfUrl | String | Falsch | Meilenstein-Eigen-URL. |
StatusUrl | String | Falsch | Meilensteinstatus-URL. |
OwnerId | String | Falsch | Meilensteinbesitzer-ID. |
OwnerName | String | Falsch | Name des Meilensteinbesitzers. |
OwnerZpuid | String | Falsch | Meilensteinbesitzer ZPUID. |
ProjectId | String | Falsch | Projekt-ID. |
ProjectName | String | Falsch | Projektname. |
Sequence | Integer | Falsch | Meilensteinsequenz. |
Status | String | Falsch | Status. Die zulässigen Werte sind abgeschlossen, nicht abgeschlossen. |
StatusColorCode | String | Falsch | Status-Farbcode. |
StatusId | String | Falsch | Status-ID. |
StatusName | String | Falsch | Statusname. |
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.
Name | Typ | Beschreibung |
---|---|---|
DisplayType | String | Meilenstein-Anzeigetyp. Die zulässigen Werte sind bevorstehend, verzögert. |
LastModifiedTime | Datetime | Zeitpunkt der letzten Änderung des Meilensteins. |
ProjektEntityProperties
Ruft die für eine Entität gespeicherten Daten ab. Das Argument dieser Methode sollte der Schlüssel sein, der beim Speichern derselben Daten verwendet wurde.
Tabellenspezifische Informationen
Entitätseigenschaften sind Key-Value Paare, die für die Projektentitäten gespeichert werden. Sie können zum Speichern von Details verwendet werden, die für API Integrationen benötigt werden, aber nicht in der Benutzeroberfläche sichtbar sein müssen. Der Schlüssel muss eine Zeichenfolge sein und der Wert kann eine einfache Zeichenfolge oder ein JSON-Objekt sein. Sie können mehrere Key-Value Paar für eine einzelne Entität speichern. Diese Entitätseigenschaften können mit den folgenden Abfragen gespeichert/abgerufen/aktualisiert/gelöscht werden.
Wählen
PropertyKey
ist erforderlich, um ProjectEntityProperties abzurufen.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM ProjectEntityProperties WHERE PropertyKey = 'key1'
Einfügen
Um eine neue Projektentitätseigenschaft hinzuzufügen, geben Sie die Felder PropertyKey und PropertyValue an.
INSERT INTO ProjectEntityProperties (PropertyKey, PropertyValue) VALUES ('key1', 'This is a test value')
Aktualisieren
ZohoProjects ermöglicht Aktualisierungen für die Spalte „PropertyValue“.
UPDATE ProjectEntityProperties SET PropertyValue = 'This is an updated property value' WHERE PropertyKey = 'key1'
Löschen
Projektentitätseigenschaften können durch Angabe von ID und PropertyKey sowie durch Ausgabe einer DELETE-Anweisung gelöscht werden.
DELETE FROM ProjectEntityProperties WHERE PropertyKey = 'key1' AND ID = '166135000000035001'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Projektentitätseigenschafts-ID. |
PropertyKey [KEY] | String | Falsch | Projektentitätseigenschaftsschlüssel. |
PropertyValue | String | Falsch | Eigenschaftswert der Projektentität. |
ProjektBenutzer
Ruft die Details aller Benutzer in einem bestimmten Projekt ab.
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Benutzer-ID. |
Name | String | Falsch | Benutzername. |
Active | Boolean | Falsch | Benutzer aktiv. |
ChatAccess | Boolean | Falsch | Chat-Zugriff des Benutzers. |
Email | String | Falsch | Benutzer-Email. |
PortalProfileName | String | Falsch | Name des Benutzerportalprofils. |
PortalRoleId | String | Falsch | Rollen-ID des Benutzerportals. |
PortalRoleName | String | Falsch | Rollenname des Benutzerportals. |
ProfileId | String | Falsch | Benutzerprofil-ID. |
ProfileType | String | Falsch | Benutzerprofiltyp. |
ProjectProfileId | String | Falsch | Benutzer-Projektprofil-ID. |
Role | String | Falsch | Benutzerrolle. Die zulässigen Werte sind Manager, Mitarbeiter, Auftragnehmer. |
RoleId | String | Falsch | Benutzerrollen-ID. |
RoleName | String | Falsch | Benutzerrollenname. |
Zpuid | String | Falsch | Benutzer-ZPUID. |
WorkProjects | String | Falsch | Benutzerarbeitsprojekte. |
UserType | String | Falsch | Benutzer Benutzertyp. Die zulässigen Werte sind aktiv, inaktiv. |
Status
Ruft den Status für das angegebene Projekt ab.
Wählen
Sie können die folgende Abfrage verwenden, um alle Status abzurufen:
SELECT * FROM Statuses
Einfügen
Um einen neuen Status zu erstellen, können Sie die folgenden Felder angeben:
INSERT INTO Statuses (Content) VALUES ('My Custom Status')
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Status-ID. |
Content | String | Falsch | Statusinhalt. |
PostedBy | String | Falsch | Status Gepostet von. |
PostedPerson | String | Falsch | Status Gepostete Person. |
PostedDate | Date | Falsch | Status Veröffentlichungsdatum. |
PostedDateTime | Datetime | Falsch | Datum und Uhrzeit der Veröffentlichung des Status. |
Aufgabenaktivitäten
Rufen Sie Details darüber ab, wer eine bestimmte Aufgabe geändert hat und wann.
Wählen
TaskId
ist erforderlich, um Forenkommentare abzurufen.
Sie können die folgende Abfrage verwenden, um alle Aktivitäten für eine bestimmte Aufgabe abzurufen:
SELECT * FROM TaskActivities WHERE TaskId = '123456789'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
TaskId | String | Falsch | Aufgaben-ID. |
Id [KEY] | String | Falsch | Aufgabenaktivitäts-ID. |
Name | String | Falsch | Name der Aufgabenaktivität. |
ActivityBy | String | Falsch | Aufgabenaktivität von. |
OldValue | Unknown | Falsch | Alter Wert der Aufgabenaktivität. |
NewValue | Unknown | Falsch | Neuer Wert für Aufgabenaktivität. |
State | String | Falsch | Status der Aufgabenaktivität. |
Time | Date | Falsch | Aufgabenaktivitätszeit. |
DateTime | Datetime | Falsch | Datum und Uhrzeit der Aufgabenaktivität. |
Zuid | String | Falsch | Aufgabenaktivität ZUID. |
Aufgabenkommentare
Alle Aufgabenkommentare abrufen.
Wählen
TaskId
ist erforderlich, um Aufgabenkommentare abzurufen.LastModifiedTime
unterstützt den folgenden Operator: =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM TaskComments WHERE TaskId = '123456000000040013'
Einfügen
Um einen Aufgabenkommentar hinzuzufügen, geben Sie die Felder „TaskId“ und „Kommentar“ an.
INSERT INTO TaskComments (TaskId, content) VALUES ('123456000000040013', 'SQL Comment #6')
Aktualisieren
Um einen Aufgabenkommentar zu aktualisieren, geben Sie das ID-Feld an.
UPDATE TaskComments
SET Content = 'Updated forum post content'
WHERE ID = '123456000000043771' AND TaskId = '123456000000040013'
Löschen
Aufgabenkommentare können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM TaskComments WHERE TaskId = '123456000000045005' AND ID = '123456000000045042'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
TaskId [KEY] | String | Falsch | Aufgaben-ID. |
Id [KEY] | String | Falsch | Aufgabenkommentar-ID. |
Content | String | Falsch | Inhalt des Aufgabenkommentars. |
AddedPersonId | String | Falsch | Aufgabenkommentar hinzugefügt Personen-ID. |
AddedPersonName | String | Falsch | Aufgabenkommentar hinzugefügt: Personenname. |
AddedVia | String | Falsch | Aufgabenkommentar hinzugefügt über. |
Attachments | String | Falsch | Aufgabenkommentaranhänge. |
CreatedDate | Date | Falsch | Erstellungsdatum des Aufgabenkommentars. |
CreatedDateTime | Datetime | Falsch | Aufgabenkommentar - Erstellungsdatum und -uhrzeit. |
LastModifiedDate | Date | Falsch | Datum der letzten Änderung des Aufgabenkommentars. |
LastModifiedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Änderung des Aufgabenkommentars. |
ProjectName | String | Falsch | Aufgabenkommentar Projektname. |
SprintsNotesId | Integer | Falsch | Aufgabenkommentar Sprints Notizen-ID. |
ThirdPartyAttachments | String | Falsch | Aufgabenkommentar: Anhänge von Drittanbietern. |
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.
Name | Typ | Beschreibung |
---|---|---|
LastModifiedTime | Datetime | Zeitpunkt der letzten Änderung des Aufgabenkommentars. |
Aufgabenbenutzerdefinierte Felder
Nutzungsinformationen für die Operation TaskCustomfields.rsd.
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
ColumnName [KEY] | String | Falsch | Spaltenname des benutzerdefinierten Aufgabenfelds. |
ColumnType [KEY] | String | Falsch | Spaltentyp des benutzerdefinierten Aufgabenfelds. |
DisplayName [KEY] | String | Falsch | Anzeigename des benutzerdefinierten Aufgabenfelds. |
IsDefault [KEY] | String | Falsch | Benutzerdefiniertes Aufgabenfeld ist Standard. |
IsEncrypted [KEY] | String | Falsch | Benutzerdefiniertes Aufgabenfeld ist verschlüsselt. |
IsMandatory | String | Falsch | Benutzerdefiniertes Aufgabenfeld ist obligatorisch. |
TaskEntityProperties
Ruft die zu einer Entität gespeicherten Daten ab. Das Argument dieser Methode sollte der Schlüssel sein, der beim Speichern derselben Daten verwendet wurde.
Tabellenspezifische Informationen
Entitätseigenschaften sind Key-Value Paare, die für die Aufgabenentitäten gespeichert werden. Sie können zum Speichern von Details verwendet werden, die für API Integrationen benötigt werden, aber nicht in der Benutzeroberfläche sichtbar sein müssen. Der Schlüssel muss eine Zeichenfolge sein und der Wert kann eine einfache Zeichenfolge oder ein JSON-Objekt sein. Sie können mehrere Key-Value Paar für eine einzelne Entität speichern. Diese Entitätseigenschaften können mit den folgenden Abfragen gespeichert/abgerufen/aktualisiert/gelöscht werden.
Wählen
TaskId
UndPropertyKey
sind zum Abrufen von Task-Entitätseigenschaften erforderlich.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM TaskEntityProperties WHERE TaskId = '123456000000034087' AND PropertyKey = 'key1'
Einfügen
Um eine neue Task-Entity-Eigenschaft hinzuzufügen, geben Sie die Felder TaskId, PropertyKey und PropertyValue an.
INSERT INTO TaskEntityProperties (TaskId, PropertyKey, PropertyValue) VALUES ('123456000000034087', 'key1', 'This is a test value')
Aktualisieren
ZohoProjects ermöglicht Aktualisierungen für die Spalte „PropertyValue“.
UPDATE TaskEntityProperties SET PropertyValue = 'This is an updated property value' WHERE TaskId = '123456000000034087' AND PropertyKey = 'key1'
Löschen
Task-Entity-Eigenschaften können gelöscht werden, indem Sie ID, TaskId, PropertyKey angeben und eine DELETE-Anweisung ausführen.
DELETE FROM TaskEntityProperties WHERE TaskId = '166135000000034087' AND PropertyKey = 'key1' AND ID = '166135000000035001'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Aufgabenentitätseigenschafts-ID. |
TaskId [KEY] | String | Falsch | Aufgaben-ID. |
PropertyKey [KEY] | String | Falsch | Schlüssel der Aufgabenentitätseigenschaft. |
PropertyValue | String | Falsch | Eigenschaftswert der Aufgabenentität. |
Aufgabenlisten
Alle Aufgabenlisten im angegebenen Projekt abrufen.
Wählen
MilestoneId
UndFlag
unterstützt den folgenden Operator: =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Tasklists WHERE MilestoneId = '12345600000123' AND Flag = 'internal'
Einfügen
Um eine neue Aufgabenliste zu erstellen, können Sie die folgenden Felder angeben:
- Name
- Meilenstein-ID
- Aufgabenvorlagen-ID
- Schichttage
- Flagge
INSERT INTO Tasklists (name, flag, ShiftDays)
VALUES ('New Tasklist #2', 'internal', '2022-03-10T01:00:00Z')
Aktualisieren
Um eine Aufgabenliste zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Tasklists SET Name = 'SQL Updated tasklist #7' WHERE ID = '123456000000041033'
Löschen
Aufgabenlisten können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Tasklists WHERE ID = '123456000000041033'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Aufgabenlisten-ID. |
Name | String | Falsch | Name der Aufgabenliste. |
Completed | Boolean | Falsch | Aufgabenliste abgeschlossen. |
CreatedDate | Date | Falsch | Aufgabenliste erstellt am. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Aufgabenliste erstellt. |
LastUpdatedDate | Date | Falsch | Datum der letzten Aktualisierung der Aufgabenliste. |
LastUpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Aktualisierung der Aufgabenliste. |
LinkSelfUrl | String | Falsch | Eigene URL des Tasklist-Links. |
LinkTaskUrl | String | Falsch | Aufgabenlisten-Link-Aufgaben-URL. |
MilestoneClosed | Boolean | Falsch | Aufgabenlisten-Meilenstein geschlossen. |
MilestoneCreatedDate | Date | Falsch | Erstellungsdatum des Aufgabenlisten-Meilensteins. |
MilestoneCreatedDateTime | Datetime | Falsch | Erstellungsdatum und -uhrzeit des Aufgabenlisten-Meilensteins. |
MilestoneEndDate | Date | Falsch | Enddatum des Aufgabenlisten-Meilensteins. |
MilestoneEndDateTime | Datetime | Falsch | Enddatum und -zeit des Aufgabenlisten-Meilensteins. |
MilestoneFlag | String | Falsch | Aufgabenlisten-Meilensteinflagge. |
MilestoneId | String | Falsch | Aufgabenlisten-Meilenstein-ID. |
MilestoneIsWorkfieldRemoved | Boolean | Falsch | Aufgabenlisten-Meilenstein ist Arbeitsfeld entfernt. |
MilestoneLastUpdatedDate | Date | Falsch | Datum der letzten Aktualisierung des Aufgabenlisten-Meilensteins. |
MilestoneLastUpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Aktualisierung des Aufgabenlisten-Meilensteins. |
MilestoneLinkSelfUrl | String | Falsch | Eigene URL des Tasklist-Meilensteinlinks. |
MilestoneLinkStatusUrl | String | Falsch | URL des Aufgabenlisten-Meilenstein-Linkstatus. |
MilestoneName | String | Falsch | Name des Aufgabenlisten-Meilensteins. |
MilestoneOwnerId | String | Falsch | Aufgabenlisten-Meilensteinbesitzer-ID. |
MilestoneOwnerName | String | Falsch | Name des Eigentümers des Aufgabenlisten-Meilensteins. |
MilestoneOwnerZpuid | String | Falsch | Eigentümer des Aufgabenlisten-Meilensteins Zpuid. |
MilestoneProjectId | String | Falsch | Aufgabenliste, Meilenstein-Projekt-ID. |
MilestoneProjectName | String | Falsch | Aufgabenlisten-Meilenstein-Projektname. |
MilestoneSequence | Integer | Falsch | Aufgabenliste - Meilensteinsequenz. |
MilestoneStartDate | Date | Falsch | Startdatum des Aufgabenlisten-Meilensteins. |
MilestoneStartDateTime | Datetime | Falsch | Startdatum und Uhrzeit des Aufgabenlisten-Meilensteins. |
MilestoneStatus | String | Falsch | Meilensteinstatus der Aufgabenliste. |
MilestoneStatusDetColorcode | String | Falsch | Tasklist-Meilensteinstatus-Det-Farbcode. |
MilestoneStatusDetId | String | Falsch | Tasklist-Meilensteinstatus-Det-ID. |
MilestoneStatusDetName | String | Falsch | Aufgabenlisten-Meilensteinstatus-Det-Name. |
Rolled | Boolean | Falsch | Aufgabenliste erstellt. |
Sequence | Integer | Falsch | Aufgabenlistensequenz. |
TaskCountOpen | Integer | Falsch | Aufgabenliste Aufgabenanzahl offen. |
TaskTemplateId | String | Falsch | ID der Aufgabenlistenvorlage. |
ShiftDays | Datetime | Falsch | Das ISO 8601-Datum und die Uhrzeit, aus denen das Startdatum der Aufgabe basierend auf Schichttagen berechnet wird. |
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.
Name | Typ | Beschreibung |
---|---|---|
Flag | String | Tasklist-Flag. Die zulässigen Werte sind intern, extern. |
Aufgaben
Ruft alle Aufgaben im angegebenen Projekt ab. Es ruft nur die Hauptaufgaben ab, nicht die Unteraufgaben.
Wählen
Spalten, die den Operator = unterstützen:
- Id
- Erstellt von
- Meilenstein-ID
- Priorität
- Aufgabenlisten-ID
- Eigentümer
- Status
- Zeit
- Letzte Änderungszeit
-
Ansichts-ID
-
CreatedDate
UndLastModifiedTime
Unterstützung: BESTELLUNG
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Tasks WHERE MilestoneId = '12345600000123' AND Priority = 'High' ORDER BY CreatedDate
Einfügen
Um eine neue Aufgabe zu erstellen, können Sie die folgenden Felder angeben:
- Name
- Beschreibung
- Eigentümer
- Dauer
- Dauertyp
- Enddatum
- Priorität
- Startdatum
- Aufgabenlisten-ID
- Arbeit
- GruppennameZugehörige TeamsBeliebiges Team
- Stundensatz
- Erinnerungszeichenfolge
- Wiederholung
- Budgetwert
- Budgetschwelle
INSERT INTO Tasks (Name, Description, Duration, DurationType, Priority, BudgetValue)
VALUES ('New Task #2', 'This is a test description', '5', 'hrs', 'High', '1000')
Aktualisieren
Um eine Aufgabe zu aktualisieren, geben Sie das ID-Feld an.
UPDATE Tasks SET Priority = 'Low' WHERE ID = '123456000000034003'
Löschen
Aufgaben können gelöscht werden, indem die ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM Tasks WHERE ID = '123456000000034003'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Aufgaben-ID. |
Name | String | Falsch | Aufgabenname. |
Key | String | Falsch | Aufgabenschlüssel. |
BillingType | String | Falsch | Aufgabenabrechnungstyp. |
Completed | Boolean | Falsch | Aufgabe abgeschlossen. |
CreatedBy | String | Falsch | Aufgabe erstellt von. |
CreatedByEmail | String | Falsch | Aufgabe per Email erstellt. |
CreatedByZpuid | String | Falsch | Aufgabe erstellt von Zpuid. |
CreatedPerson | String | Falsch | Aufgabe erstellt von Person. |
CreatedDate | Date | Falsch | Aufgabe erstellt am. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Aufgabenerstellung. |
Description | String | Falsch | Aufgabenbeschreibung. |
Owners | String | Falsch | Aufgabeneigentümer. |
Duration | String | Falsch | Aufgabendauer. |
DurationType | String | Falsch | Aufgabendauertyp. Die zulässigen Werte sind Tage, Std.. |
EndDate | Date | Falsch | Enddatum der Aufgabe. |
EndDateTime | Datetime | Falsch | Enddatum und -zeit der Aufgabe. |
CommentAdded | Boolean | Falsch | Aufgabenkommentar hinzugefügt. |
DocsAssociated | Boolean | Falsch | Aufgabendokumente zugeordnet. |
ForumAssociated | Boolean | Falsch | Aufgabenforum zugeordnet. |
RecurrenceSet | Boolean | Falsch | Aufgabenwiederholung festgelegt. |
ReminderSet | Boolean | Falsch | Aufgabenerinnerung festgelegt. |
Parent | Boolean | Falsch | Übergeordnete Aufgabe. |
LastUpdatedDate | Date | Falsch | Datum der letzten Aktualisierung der Aufgabe. |
LastUpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Aktualisierung der Aufgabe. |
LinkSelfUrl | String | Falsch | Eigene URL des Aufgabenlinks. |
LinkTimesheetUrl | String | Falsch | Aufgabenlink-Stundenzettel-URL. |
LinkWebUrl | String | Falsch | Web-URL des Aufgabenlinks. |
LogHoursBillableHours | String | Falsch | Aufgabenprotokollstunden, abrechenbare Stunden. |
LogHoursNonBillableHours | String | Falsch | Nicht abrechenbare Stunden im Aufgabenprotokoll. |
MilestoneId | String | Falsch | Aufgaben-Meilenstein-ID. |
OrderSequence | Integer | Falsch | Reihenfolge der Aufgaben. |
PercentComplete | String | Falsch | Prozent der Aufgabe abgeschlossen. |
Priority | String | Falsch | Aufgabenpriorität. Die zulässigen Werte sind keine, niedrig, mittel, hoch. |
StartDate | Date | Falsch | Startdatum der Aufgabe. |
StartDateTime | Datetime | Falsch | Startdatum und Uhrzeit der Aufgabe. |
StatusColorCode | String | Falsch | Farbcode für den Aufgabenstatus. |
StatusName | String | Falsch | Name des Aufgabenstatus. |
StatusId | String | Falsch | Aufgabenstatus-ID. |
StatusType | String | Falsch | Aufgabenstatustyp. |
Subtasks | Boolean | Falsch | Aufgabenunteraufgaben. |
TaskFollowers | String | Falsch | Aufgabe Aufgaben-Follower. |
TaskFollowerSize | Integer | Falsch | Größe der Task-Task-Follower. |
TasklistId | String | Falsch | Aufgabenlisten-ID. |
TasklistName | String | Falsch | Name der Aufgabenliste. |
Work | String | Falsch | Aufgabenarbeit. |
WorkForm | String | Falsch | Aufgabenarbeitsformular. |
WorkType | String | Falsch | Aufgabenarbeitstyp. Die zulässigen Werte sind Arbeitsstunden pro Tag. |
GroupNameAssociatedTeamsAnyTeam | String | Falsch | Name der Aufgabengruppe. Zugehörige Teams. Beliebiges Team. |
GroupNameAssociatedTeamsCount | Integer | Falsch | Name der Aufgabengruppe. Anzahl der zugehörigen Teams. |
GroupNameIsTeamUnassigned | Boolean | Falsch | Name der Aufgabengruppe ist „Team nicht zugewiesen“. |
RatePerHour | String | Falsch | Aufgabenrate pro Stunde. |
ReminderString | String | Falsch | Aufgabenerinnerungszeichenfolge. |
Recurrence | String | Falsch | Aufgabenwiederholung. |
BudgetValue | String | Falsch | Aufgabenbudgetwert. |
BudgetThreshold | String | Falsch | Aufgabenbudgetschwelle. |
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.
Name | Typ | Beschreibung |
---|---|---|
Owner | String | Aufgabeneigentümer. |
Status | String | Aufgabenstatus. Die zulässigen Werte sind abgeschlossen, nicht abgeschlossen. |
Time | String | Aufgabenzeit. Die zulässigen Werte sind überfällig, heute, morgen. |
LastModifiedTime | Datetime | Zeitpunkt der letzten Änderung der Aufgabe. |
ViewId | String | Aufgabenansichts-ID. |
AufgabeUnteraufgaben
Alle Unteraufgaben der angegebenen Aufgabe anzeigen.
Wählen
TaskId
ist erforderlich, um Task-Unteraufgaben abzurufen.
Sie können die folgende Abfrage verwenden, um alle Aufgabenunteraufgaben abzurufen:
SELECT * FROM TaskSubtasks WHERE TaskId = '12345600000123'
Einfügen
Um eine neue Aufgabe zu erstellen, können Sie die folgenden Felder angeben:
- Aufgaben-ID
- Name
- Beschreibung
- Dauer
- Dauertyp
- Priorität
- Startdatum
- Enddatum
- Verantwortliche Person
INSERT INTO TaskSubtasks (TaskId, Name, StartDate, EndDate, Duration, DurationType, Priority, Description)
VALUES ('165818000000040013', 'Sql Subtask #4', '2022-03-01', '2022-03-10', '2', 'hrs', 'High', 'Test description of the subtask')
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
TaskId | String | Falsch | Aufgaben-ID. |
Id [KEY] | String | Falsch | Unteraufgaben-ID. |
Name | String | Falsch | Name der Unteraufgabe. |
Key | String | Falsch | Unteraufgabenschlüssel. |
BillingType | String | Falsch | Abrechnungsart für Unteraufgaben. |
Completed | Boolean | Falsch | Unteraufgabe abgeschlossen. |
CreatedBy | String | Falsch | Unteraufgabe erstellt von. |
CreatedByEmail | String | Falsch | Unteraufgabe per Email erstellt. |
CreatedByZpuid | String | Falsch | Unteraufgabe von Zpuid erstellt. |
CreatedPerson | String | Falsch | Unteraufgabe wurde von Person erstellt. |
CreatedTime | Date | Falsch | Erstellungszeit der Unteraufgabe. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Erstellung der Unteraufgabe. |
Depth | Integer | Falsch | Unteraufgabentiefe. |
Description | String | Falsch | Beschreibung der Unteraufgabe. |
DetailsOwners | String | Falsch | Eigentümer der Unteraufgabendetails. |
Duration | String | Falsch | Dauer der Unteraufgabe. |
DurationType | String | Falsch | Dauertyp der Unteraufgabe. Die zulässigen Werte sind Tage, Std.. |
IsCommentAdded | Boolean | Falsch | Unteraufgabe ist Kommentar hinzugefügt. |
IsDocsAssociated | Boolean | Falsch | Unteraufgabe ist mit Dokumenten verknüpft. |
IsForumAssociated | Boolean | Falsch | Unteraufgabe ist mit Forum verknüpft. |
IsRecurrenceSet | Boolean | Falsch | Wiederholung der Unteraufgabe ist eingestellt. |
IsReminderSet | Boolean | Falsch | Für Unteraufgabe ist eine Erinnerung festgelegt. |
IsParent | Boolean | Falsch | Unteraufgabe ist übergeordnete Aufgabe. |
LastUpdatedTime | Date | Falsch | Zeitpunkt der letzten Aktualisierung der Unteraufgabe. |
LastUpdatedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Aktualisierung der Unteraufgabe. |
LinkSelfUrl | String | Falsch | Eigene URL des Unteraufgabenlinks. |
LinkTimesheetUrl | String | Falsch | URL des Arbeitszeitnachweises für Unteraufgabenlink. |
LinkWebUrl | String | Falsch | Web-URL des Unteraufgabenlinks. |
LogBillableHours | String | Falsch | Abrechenbare Stunden des Unteraufgabenprotokolls. |
LogNonBillableHours | String | Falsch | Unteraufgabenprotokoll für nicht abrechenbare Stunden. |
MilestoneId | String | Falsch | Meilenstein-ID der Unteraufgabe |
OrderSequence | Integer | Falsch | Reihenfolge der Unteraufgaben. |
ParentTaskId | String | Falsch | ID der übergeordneten Unteraufgabe. |
PercentComplete | String | Falsch | Unteraufgabe in Prozent abgeschlossen. |
Priority | String | Falsch | Unteraufgabenpriorität. Die zulässigen Werte sind keine, niedrig, mittel, hoch. |
RootTaskId | String | Falsch | Unteraufgabe - Stammaufgaben-ID. |
StatusColorCode | String | Falsch | Farbcode für den Unteraufgabenstatus. |
StatusId | String | Falsch | Unteraufgabenstatus-ID. |
StatusName | String | Falsch | Name des Unteraufgabenstatus. |
StatusType | String | Falsch | Unteraufgabenstatustyp. |
Subtasks | Boolean | Falsch | Unteraufgabe Unteraufgaben. |
TaskFollowers | String | Falsch | Unteraufgabe, Aufgaben-Follower. |
TaskFollowerSize | Integer | Falsch | Größe des Unteraufgaben-Task-Followers. |
TasklistId | String | Falsch | Unteraufgabe Aufgabenlisten-ID. |
TasklistName | String | Falsch | Name der Unteraufgabe-Aufgabenliste. |
Work | String | Falsch | Unteraufgabe Arbeit. |
WorkForm | String | Falsch | Unteraufgaben-Arbeitsformular. |
WorkType | String | Falsch | Arbeitstyp der Unteraufgabe. |
GroupNameAssociatedTeamsAnyTeam | String | Falsch | Name der Unteraufgabegruppe. Zugehörige Teams. Beliebiges Team. |
GroupNameAssociatedTeamsCount | Integer | Falsch | Name der Unteraufgabegruppe - Anzahl der zugehörigen Teams. |
GroupNameIsTeamUnassigned | Boolean | Falsch | Name der Unteraufgabengruppe ist „Team nicht zugewiesen“. |
StartDate | Date | Falsch | Startdatum der Unteraufgabe. |
EndDate | Date | Falsch | Enddatum der Unteraufgabe. |
PersonResponsible | String | Falsch | Verantwortlicher für Unteraufgabe. |
AufgabenZeitprotokolle
Ruft die Zeitprotokolle unter einer bestimmten Aufgabe ab.
Wählen
TaskId
ist erforderlich, um Task-Zeitprotokolle abzurufen.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM TaskTimelogs WHERE TaskId = '123456000000045005'
Einfügen
Um ein neues Aufgabenzeitprotokoll zu erstellen, können Sie die folgenden Felder angeben:
- TaskId
- BillStatus
- Notes
- HoursDisplay
- LogDate
- OwnerId
INSERT INTO TaskTimelogs (TaskId, LogDate, BillStatus, HoursDisplay, Notes) " +
VALUES ('123456000000040013', '2022-03-03', 'Non Billable', '01:20', 'This is a test timelog')
Aktualisieren
Um ein Task-TimeLog zu aktualisieren, geben Sie die Felder TaskId und ID an.
UPDATE TaskTimelogs
SET Notes = 'This is an updated SQL Note'
WHERE TaskId = '165818000000040013' AND ID = '165818000000045001'
Löschen
Task-TimeLogs können gelöscht werden, indem Sie die TaskId und ID angeben und eine DELETE-Anweisung ausführen.
DELETE FROM TaskTimelogs WHERE TaskId = '123456000000045005' AND ID = '123456000000044025'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
TaskId [KEY] | String | Falsch | Aufgaben-ID. |
Id [KEY] | String | Falsch | Aufgabenzeitprotokoll-ID. |
AddedByName | String | Falsch | Aufgabenzeitprotokoll nach Name hinzugefügt. |
AddedByZpuid | String | Falsch | Aufgabenzeitprotokoll von Zpuid hinzugefügt. |
AddedByZuid | Long | Falsch | Aufgabenzeitprotokoll von Zuid hinzugefügt. |
ApprovalStatus | String | Falsch | Genehmigungsstatus des Aufgabenzeitprotokolls. |
ApproverName | String | Falsch | Name des Genehmigers des Aufgabenzeitprotokolls. |
BillStatus | String | Falsch | Abrechnungsstatus des Aufgabenzeitprotokolls. Die zulässigen Werte sind Abrechnungsfähig, Nicht abrechnungsfähig. |
CreatedDate | Date | Falsch | Erstellungsdatum des Aufgabenzeitprotokolls. |
CreatedDateTime | Datetime | Falsch | Datum und Uhrzeit der Erstellung des Aufgabenzeitprotokolls. |
StartTime | Datetime | Falsch | Startzeit des Aufgabenzeitprotokolls. |
EndTime | Datetime | Falsch | Endzeit des Aufgabenzeitprotokolls. |
Notes | String | Falsch | Notizen im Aufgabenzeitprotokoll. |
HoursDisplay | String | Falsch | Anzeige der Stunden im Aufgabenzeitprotokoll. |
Hours | Integer | Falsch | Stunden des Aufgabenzeitprotokolls. |
Minutes | Integer | Falsch | Aufgabenzeitprotokoll in Minuten. |
IsParent | Boolean | Falsch | Aufgabenzeitprotokoll ist übergeordnetes Element. |
IsSubTask | Boolean | Falsch | Aufgabenzeitprotokoll ist Unteraufgabe. |
LastModifiedDate | Date | Falsch | Datum der letzten Änderung im Aufgabenzeitprotokoll. |
LastModifiedDateTime | Datetime | Falsch | Datum und Uhrzeit der letzten Änderung des Aufgabenzeitprotokolls. |
LinkSelfUrl | String | Falsch | Eigene URL des Links zum Aufgabenzeitprotokoll. |
LogDate | Date | Falsch | Datum des Aufgabenzeitprotokolls. |
LogDateTime | Datetime | Falsch | Datum und Uhrzeit des Aufgabenzeitprotokolls. |
OwnerId | String | Falsch | Besitzer-ID des Aufgabenzeitprotokolls. |
OwnerName | String | Falsch | Name des Eigentümers des Aufgabenzeitprotokolls. |
SubTaskLevel | String | Falsch | Unteraufgabenebene des Aufgabenzeitprotokolls. |
TaskName | String | Falsch | Name der Aufgabe Zeitprotokollaufgabe. |
TaskListId | Long | Falsch | Aufgabenzeitprotokoll-Aufgabenlisten-ID. |
TaskListName | String | Falsch | Name der Aufgabenliste des Aufgabenzeitprotokolls. |
TotalMinutes | Integer | Falsch | Gesamtminuten des Aufgabenzeitprotokolls. |
TeamBenutzer
Details zu einem bestimmten Team abrufen.
Wählen
GroupId
ist erforderlich, um Teambenutzer abzurufen.
Sie können die folgende Abfrage verwenden, um alle Teambenutzer abzurufen:
SELECT * FROM TeamUsers WHERE GroupId = '123456000000033021'
Einfügen
Um ein neues Team zu erstellen, müssen Sie die folgenden Felder angeben:
- GroupId
- Zpuid
INSERT INTO TeamUsers (GroupId, ZPUID)
VALUES ('123456000000034163', '123456000000031003')
Löschen
TeamUsers können gelöscht werden, indem die GroupId und ID angegeben und eine DELETE-Anweisung ausgegeben wird.
DELETE FROM TeamUsers WHERE GroupId = '123456000000034163' AND ID = '123456000000031003'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
ProjectId | String | Falsch | Projekt-ID. |
GroupId | String | Falsch | Team-ID. |
Id [KEY] | String | Falsch | Benutzer-ID. |
Name | String | Falsch | Benutzername. |
AddedBy | String | Falsch | Benutzer hinzugefügt von. |
AddedTime | String | Falsch | Vom Benutzer hinzugefügte Zeit. |
Confirmed | String | Falsch | Benutzer bestätigt. |
CreatedBy | String | Falsch | Benutzer erstellt von. |
CreatedTime | String | Falsch | Vom Benutzer erstellte Zeit. |
CreatedUser | String | Falsch | Vom Benutzer erstellter Benutzer. |
Description | String | Falsch | Benutzerbeschreibung. |
DisplayName | String | Falsch | Anzeigename des Benutzers. |
Email | String | Falsch | Benutzer-Email. |
EntityType | String | Falsch | Benutzerentitätstyp. |
FirstName | String | Falsch | Vorname des Benutzers. |
IsClient | Boolean | Falsch | Benutzer ist Client. |
IsDefault | Boolean | Falsch | Benutzer ist Standard. |
LastAccessedTime | String | Falsch | Uhrzeit des letzten Zugriffs durch den Benutzer. |
LastName | String | Falsch | Nachname des Benutzers. |
LastUpdatedTime | String | Falsch | Uhrzeit der letzten Aktualisierung durch den Benutzer. |
RoleId | String | Falsch | Benutzerrollen-ID. |
RoleName | String | Falsch | Benutzerrollenname. |
Type | String | Falsch | Benutzertyp. |
UpdatedBy | String | Falsch | Benutzer aktualisiert von. |
UpdatedDate | String | Falsch | Vom Benutzer aktualisiertes Datum. |
UpdatedDateTime | String | Falsch | Vom Benutzer aktualisiertes Datum und Uhrzeit. |
UserStatus | String | Falsch | Benutzer Benutzerstatus. |
Zpuid | String | Falsch | Benutzer Zpuid. |
Zuid | String | Falsch | Benutzer Zuid. |
Ansichten
Der Connector modelliert die Entitäten, für die Zoho Projects nur schreibgeschützten Zugriff bereitstellt, als Ansichten.
Es stellt jedes mit Ihrem Konto verknüpfte Projekt als Schema mit den folgenden Ansichten bereit.
Navigieren Sie zur Seite einer einzelnen Ansicht, um eine Aufschlüsselung der Spalten und unterstützten Filter anzuzeigen.
Zoho Projects Connector-Ansichten
Name | Beschreibung |
---|---|
Activities | Listet alle aktuellen Aktivitäten des Projekts auf. |
BugActivities | Ruft alle Aktivitäten für den angegebenen Fehler ab. |
BugAttachments | Details zu Anhängen für einen Fehler abrufen. |
BugCustomFields | Ruft alle benutzerdefinierten Felder im angegebenen Projekt ab. |
BugResolution | Lösung des Fehlers erhalten. |
Clients | Gibt die Liste der Kundenunternehmen zurück, die mit einer bestimmten Projekt-ID verknüpft sind. |
Documents | Listet alle aktuellen Aktivitäten des Projekts auf. |
TaskAttachments | Details zu den mit der Aufgabe verknüpften Anhängen abrufen. |
Timelogs | Ruft die Zeitprotokolle unter einem bestimmten Fehler ab. |
Aktivitäten
Listen Sie alle aktuellen Aktivitäten des Projekts auf.
Wählen
Dies ist eine Ansicht auf Projektebene. Sie können die folgende Abfrage verwenden, um alle Aktivitäten abzurufen:
SELECT * FROM Activities
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Projektaktivitäts-ID. |
Name | String | Name der Projektaktivität. |
Activity By | String | Autor der Projektaktivität. |
Activity For | String | Projektaktivität für Entität. |
Display Time | String | Anzeigezeit der Projektaktivität. |
State | String | Status der Projektaktivität. |
Time | String | Projektaktivitätszeit. |
Fehleraktivitäten
Ruft alle Aktivitäten für den angegebenen Fehler ab.
Wählen
Dies ist eine Ansicht auf Fehlerebene.
BugId
ist zum Abrufen von BugActivities erforderlich.
Sie können die folgende Abfrage verwenden, um alle BugActivities abzurufen:
SELECT * FROM BugActivities WHERE BugId = '12345600001'
Spalten
Name | Typ | Beschreibung |
---|---|---|
BugId | String | Fehler-ID. |
Action | String | Fehleraktivitätsaktion. |
Type | String | Fehleraktivitätstyp. |
PreviousValue | String | Vorheriger Wert der Fehleraktivität. |
CurrentValue | String | Aktueller Wert der Fehleraktivität. |
ActionBy | String | Fehleraktivitätsaktion von. |
ActionField | String | Aktionsfeld für Fehleraktivität. |
ActionDate | Date | Datum der Fehleraktivitätsaktion. |
ActionDateTime | Datetime | Fehleraktivität, Aktion, Datum und Uhrzeit. |
Zuid [KEY] | String | Fehleraktivität ZUID. |
Fehleranhänge
Erhalten Sie Details zu Anhängen für einen Fehler.
Spalten
Name | Typ | Beschreibung |
---|---|---|
BugId | String | Fehler-ID. |
AttachmentId | Long | Anhangs-ID. |
FileName | String | Name der angehängten Datei. |
FileType | String | Angehängter Dateityp. |
FileSize | Integer | Größe der angehängten Datei. |
FileEncAttachParam | String | Angehängte Datei enc Anhängeparameter |
FileUri | String | Angehängte Datei-URI. |
AttachedDate | Date | Angefügtes Datum. |
AttachedDateTime | Datetime | Angefügtes Datum und Uhrzeit. |
AuthorId | String | Autor-ID des Anhangs |
AuthorName | String | Name des Anhangautors. |
IsDocsAttachment | Boolean | Ist ein Dokumentenanhang. |
Fehlerbenutzerdefinierte Felder
Ruft alle benutzerdefinierten Felder im angegebenen Projekt ab.
Wählen
Dies ist eine Ansicht auf Projektebene. Sie können die folgende Abfrage verwenden, um alle BugCustomFields abzurufen:
SELECT * FROM BugCustomFields WHERE BugId = '12345600001'
Spalten
Name | Typ | Beschreibung |
---|---|---|
LabelName | String | Name der benutzerdefinierten Feldbezeichnung für Fehler. |
ColumnName | String | Fehler: Name der benutzerdefinierten Feldspalte. |
DefaultValue | String | Fehler im benutzerdefinierten Feld - Standardwert. |
FieldType | String | Fehler, benutzerdefinierter Feldtyp. |
IsEnc | Boolean | Fehler: Benutzerdefiniertes Feld ist eingeschlossen. |
IsMandatory | Boolean | Das benutzerdefinierte Feld „Bug“ ist obligatorisch. |
IsPi | Boolean | Fehler: Benutzerdefiniertes Feld ist Pi. |
IsVisible | Boolean | Fehler: Benutzerdefiniertes Feld ist sichtbar. |
NewColumnName | String | Fehler Benutzerdefiniertes Feld: Neuer Spaltenname. |
PicklistValues | String | Fehler bei benutzerdefinierten Auswahllistenfeldern. |
Fehlerbehebung
Lösung des Fehlers erhalten.
Spalten
Name | Typ | Beschreibung |
---|---|---|
BugId | String | Fehler-ID. |
Resolver | String | Fehlerbeseitiger. |
ResolverId | String | Fehlerbeseitigungs-ID. |
Resolution | String | Fehlerbehebung. |
ResolutionThirdPartyAttachments | String | Fehlerbehebung - Anhänge von Drittanbietern. |
ResolvedDate | Date | Datum der Fehlerbehebung. |
ResolvedDateTime | Datetime | Datum und Uhrzeit der Fehlerbehebung. |
ResolverZpuid | String | Fehlerbeseitiger ZPUID. |
Kunden
Gibt die Liste der Kundenunternehmen zurück, die mit einer bestimmten Projekt-ID verknüpft sind.
Wählen
Dies ist eine Ansicht auf Projektebene.
Id
unterstützt den folgenden Operator: =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Clients WHERE ID = '12345600001'
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Kunden-ID. |
Name | String | Kundenname. |
City | String | Stadt des Kunden. |
Country | String | Kundenland. |
CrmAccountId | String | Kunden-CRM-Konto-ID. |
FirstAddress | String | Ansprache des Kunden an erster Stelle. |
SecondAddress | String | Zweite Adresse des Kunden. |
State | String | Client-Status. |
WebAddress | String | Webadresse des Kunden. |
ZipCode | String | Postleitzahl des Kunden. |
UserId | String | Client-Benutzer-ID. |
UserName | String | Client-Benutzername. |
UserEmail | String | Email des Client-Benutzers. |
UserZpuid | String | Client-Benutzer ZPUID. |
Dokumente
Listen Sie alle aktuellen Aktivitäten des Projekts auf.
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Projektaktivitäts-ID. |
Name | String | Name der Projektaktivität. |
Activity By | String | Autor der Projektaktivität. |
Activity For | String | Projektaktivität für. |
Display Time | String | Anzeigezeit der Projektaktivität. |
State | String | Status der Projektaktivität. |
Time | String | Projektaktivitätszeit. |
Aufgabenanhänge
Details zu den mit der Aufgabe verknüpften Anhängen abrufen.
Wählen
Dies ist eine Ansicht auf Projektebene.
TaskId
ist zum Abrufen von TaskAttachments erforderlich.
Sie können die folgende Abfrage verwenden, um alle TaskAttachments abzurufen:
SELECT * FROM TaskAttachments WHERE TaskId = '123456000000112'
Spalten
Name | Typ | Beschreibung |
---|---|---|
TaskId | String | Aufgaben-ID. |
Id [KEY] | String | Aufgabenanhang-ID. |
AuthorId | String | Autoren-ID des Aufgabenanhangs |
ContentType | String | Inhaltstyp des Aufgabenanhangs. |
DocsDownloadUrl | String | URL zum Herunterladen von Dokumenten im Aufgabenanhang. |
DownloadUrl | String | Aufgabenanhang herunterladen. |
Extension | String | Erweiterung für Aufgabenanhänge. |
Filename | String | Dateiname des Aufgabenanhangs. |
Owner | String | Besitzer der Aufgabenanlage. |
Size | Integer | Größe des Aufgabenanhangs in Bytes.. |
TaskId | Long | Aufgabenanhang Aufgaben-ID. |
ThumbnailUrl | String | URL der Miniaturansicht des Aufgabenanhangs. |
UploadedTime | Long | Hochladezeit des Aufgabenanhangs. |
Zeitprotokolle
Ruft die Zeitprotokolle unter einem bestimmten Fehler ab.
Wählen
Dies ist eine Ansicht auf Projektebene. Spalten, die den Operator = unterstützen:
- Rechnungsstatus
- Datum
- Benutzer
- Ansichtstyp
- Komponententyp
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM ProjectLayouts
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id [KEY] | String | Zeitprotokoll-ID. |
AddedByName | String | Zeitprotokoll nach Namen hinzugefügt. |
AddedByZpuid | String | Zeitprotokoll von Zpuid hinzugefügt. |
AddedByZuid | Long | Zeitprotokoll von Zuid hinzugefügt. |
ApprovalStatus | String | Genehmigungsstatus des Zeitprotokolls. |
ApproverName | String | Name des Zeitprotokoll-Genehmigers. |
BillStatus | String | Rechnungsstatus des Zeitprotokolls. Die zulässigen Werte sind alle, abrechenbar, nicht abrechenbar. |
CreatedDate | Date | Erstellungsdatum des Zeitprotokolls. |
CreatedDateTime | Datetime | Datum und Uhrzeit der Erstellung des Zeitprotokolls. |
StartTime | Datetime | Startzeit des Zeitprotokolls. |
EndTime | Datetime | Endzeit des Zeitprotokolls. |
Notes | String | Zeitprotokollnotizen. |
HoursDisplay | String | Anzeige der Stunden im Zeitprotokoll. |
Hours | Integer | Stunden des Zeitprotokolls. |
Minutes | Integer | Zeitprotokollminuten. |
IsParent | Boolean | Zeitprotokoll ist übergeordnetes Protokoll. |
IsSubTask | Boolean | Zeitprotokoll ist Unteraufgabe. |
LastModifiedDate | Date | Datum der letzten Änderung im Zeitprotokoll. |
LastModifiedDateTime | Datetime | Datum und Uhrzeit der letzten Änderung im Zeitprotokoll. |
LinkSelfUrl | String | Eigene URL des Zeitprotokoll-Links. |
LogDate | Date | Zeitprotokolldatum. |
LogDateTime | Datetime | Zeitprotokoll Datum Uhrzeit. |
OwnerId | String | Zeitprotokoll-Besitzer-ID. |
OwnerName | String | Name des Zeitprotokollbesitzers. |
SubTaskLevel | String | Unteraufgabenebene des Zeitprotokolls. |
TaskName | String | Name der Zeitprotokollaufgabe. |
TaskListId | Long | Zeitprotokoll-Aufgabenlisten-ID. |
TaskListName | String | Name der Zeitprotokoll-Aufgabenliste. |
TotalMinutes | Integer | Gesamtminuten des Zeitprotokolls. |
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.
Name | Typ | Beschreibung |
---|---|---|
Date | Date | Zeitprotokolldatum. |
User | String | Zeitprotokollbenutzer. |
ViewType | String | Ansichtstyp des Zeitprotokolls. Die zulässigen Werte sind Tag, Woche, Monat. |
ComponentType | String | Zeitprotokoll-Komponententyp. Die zulässigen Werte sind Bug, Task, General. |
Alle Portale
Übersicht
Der Connector modelliert Informationen zu allen Portalen, die Ihrem Konto im Schema „ZohoProjects“ im Katalog „“ zugeordnet sind.
Tabellen
Die Tabellen enthält eine einzelne Tabelle, Portale, in der Informationen zu den Portalen Ihres Kontos gespeichert sind, z. B. Firmennamen, Profilnamen und Portalrollen.
Gespeicherte Prozeduren
Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Zoho Projects. Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Zoho Projects, einschließlich der Genehmigung von Zeitprotokollen und der Neuanordnung von Aufgaben.
Tabellen
Der Connector modelliert Informationen auf Kontoebene über alle Portale als eine einzige „Portale“-Tabelle.
Zoho Projects Connector-Tabellen
Name | Beschreibung |
---|---|
Portals | Ruft alle Portale für den angemeldeten Benutzer ab. |
Portale
Ruft alle Portale für den angemeldeten Benutzer ab.
Wählen
Der Connector verwendet die Zoho Projects 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
UndViewId
unterstützt den folgenden Operator: =.
Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:
SELECT * FROM Portals WHERE ID = '20081021809'
Spalten
Name | Typ | Nur Lesen | Beschreibung |
---|---|---|---|
Id [KEY] | String | Falsch | Portal-ID. |
Name | String | Falsch | Portalname. |
CompanyName | String | Falsch | Name des Portalunternehmens. |
AvailableClients | Integer | Falsch | Im Portal verfügbare Clients. |
AvailableUsers | Integer | Falsch | Verfügbare Portalbenutzer. |
AvailableProjects | Integer | Falsch | Im Portal verfügbare Projekte. |
BugPlan | String | Falsch | Portal-Bug-Plan. |
BugPlural | String | Falsch | Bug Plural. |
BugSingular | String | Falsch | Bug Singular. |
CanAddTemplate | Boolean | Falsch | Portalvorlage kann hinzugefügt werden. |
CanCreateProject | Boolean | Falsch | Kann Portalprojekt erstellen. |
Default | Boolean | Falsch | Standardportal. |
ExtensionsAppSettings | String | Falsch | App-Einstellungen für Portalerweiterungen und Standorte. |
ExtensionsAttachmentPicker | String | Falsch | Anhangsauswahl für Portalerweiterungsstandorte. |
ExtensionsBlueprintDuring | String | Falsch | Portalerweiterungen-Standorte-Blaupause während. |
ExtensionsIssueTab | String | Falsch | Registerkarte „Problem mit Portalerweiterungsstandorten“. |
ExtensionsIssuedetailsRightpanel | String | Falsch | Rechtes Feld mit Details zum Problem der Portalerweiterungsstandorte. |
ExtensionsProjectTab | String | Falsch | Registerkarte „Projekt“ für Portalerweiterungsstandorte. |
ExtensionsTaskTab | String | Falsch | Registerkarte „Aufgabenstandorte“ der Portalerweiterungen. |
ExtensionsTaskTransition | String | Falsch | Aufgabenübergang für Portalerweiterungsstandorte. |
ExtensionsTaskdetailsRightpanel | String | Falsch | Portalerweiterungen - Standorte - Aufgabendetails - rechter Bereich. |
ExtensionsTopBand | String | Falsch | Portalerweiterungen Standorte Top Band. |
GmtTimeZone | String | Falsch | GMT-Zeitzone des Portals. |
GmtTimeZoneOffset | Integer | Falsch | GMT-Zeitzonenverschiebung des Portals. |
MeetingEnabled | Boolean | Falsch | Portalbesprechung aktiviert. |
PeopleEnabled | Boolean | Falsch | Portal-Personen aktiviert. |
CrmPartner | Boolean | Falsch | Portal-CRM-Partner. |
DisplayProjectPrefix | Boolean | Falsch | Projektpräfix zur Portalanzeige. |
DisplayTaskPrefix | Boolean | Falsch | Präfix für die Portalanzeigeaufgabe. |
NewPlan | Boolean | Falsch | Portal neuer Plan. |
SprintsIntegrated | Boolean | Falsch | Portal Sprints integriert. |
TagsAvailable | Boolean | Falsch | Portal-Tags verfügbar. |
TimeLogRestricted | Boolean | Falsch | Portalzeitprotokoll eingeschränkt. |
ProjectsModuleId | String | Falsch | Portalprojekte-Modul-ID. |
TasksModuleId | String | Falsch | Portalaufgaben-Modul-ID. |
ProjectUrl | String | Falsch | Portal-Projekt-URL. |
LocaleCode | String | Falsch | Portal-Gebietsschemacode. |
LocaleCountry | String | Falsch | Portal-Gebietsschema Land. |
Language | String | Falsch | Portalsprache. |
LoginZpuid | Long | Falsch | Portal-Login ZPUID. |
MaxClients | Integer | Falsch | Portal Max-Clients. |
MaxUsers | Integer | Falsch | Portal Max-Benutzer. |
NewUserPlan | Boolean | Falsch | Portal-Plan für neue Benutzer. |
PercentageCalculation | String | Falsch | Berechnung des Portalprozentsatzes. |
Plan | String | Falsch | Portalplan. |
ProfileId | Long | Falsch | Portalprofil-ID. |
ProfileName | String | Falsch | Portalprofilname. |
ProfileType | Integer | Falsch | Portalprofiltyp. |
ActiveProjects | Integer | Falsch | Aktive Projekte im Portal. |
ProjectPrefix | String | Falsch | Portal-Projektpräfix. |
Role | String | Falsch | Portalrolle. |
RoleId | String | Falsch | Portalrollen-ID. |
RoleName | String | Falsch | Portalrollenname. |
BusinessHoursEnd | Integer | Falsch | Ende der Portal-Geschäftszeiten. |
BusinessHoursStart | Integer | Falsch | Beginn der Portal-Geschäftszeiten. |
DateFormat | String | Falsch | Portal-Datumsformat. |
DefaultCurrency | String | Falsch | Standardwährung des Portals. |
DefaultDependencyType | String | Falsch | Standardabhängigkeitstyp des Portals. |
BudgetPermission | Boolean | Falsch | Portal-Budgetberechtigung. |
Holidays | String | Falsch | Portalferien. |
BudgetEnabled | Boolean | Falsch | Portalbudget aktiviert. |
LastSyncTime | String | Falsch | Letzte Synchronisierungszeit des Portals. |
StartDayOfWeek | String | Falsch | Wochentag, an dem das Portal startet. |
TaskDateFormat | String | Falsch | Datumsformat der Portalaufgabe. |
TaskDurationType | String | Falsch | Dauertyp der Portalaufgabe. |
TimeZone | String | Falsch | Portal-Zeitzone. |
EditTimeLogRestricted | Boolean | Falsch | Portal-Bearbeitungszeitprotokoll eingeschränkt. |
LogFutureTimeAllowed | Boolean | Falsch | Portal-Log: Zukünftiger Zeitpunkt zulässig. |
LogPastTimeAllowed | Boolean | Falsch | Portal-Log-Zeitüberschreitung zulässig. |
DefaultBillingStatus | String | Falsch | Standardabrechnungsstatus des Portals. |
TimesheetApprovalEnabled | Boolean | Falsch | Portal-Zeiterfassungsgenehmigung aktiviert. |
WorkingDays | String | Falsch | Portalarbeitstage. |
SprintsProjectPermission | Boolean | Falsch | Portal Sprints-Projektberechtigung. |
StorageType | String | Falsch | Portal-Speichertyp. |
TrialEnabled | Boolean | Falsch | Portal-Testversion aktiviert. |
LogHrRestrictedByWorkHr | Boolean | Falsch | Portal-Log-Stunden durch Arbeitsstunden eingeschränkt. |
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.
Name | Typ | Beschreibung |
---|---|---|
ViewId | String |
Gespeicherte Prozeduren
Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die es dem Connector ermöglichen, Aktionen auszuführen, die über den Umfang des grundlegenden Datenzugriffs hinausgehen. Sie akzeptieren eine Liste von Parametern, führen eine Aktion aus und geben Antwortdaten von Zoho Projects und/oder eine Bestätigung des Erfolgs oder Misserfolgs der Prozedur zurück.
Die vollständige Liste der Verfahren finden Sie unten. Navigieren Sie zur Seite eines einzelnen Verfahrens, um eine Aufschlüsselung seiner Funktionalität, Eingaben und Ausgaben zu erhalten.
Gespeicherte Prozeduren für den Zoho Projects Connector
Name | Beschreibung |
---|---|
AddUserToClientCompany | Fügt einen Benutzer zu einem bestehenden Kundenunternehmen hinzu. |
ApproveTimelog | Allgemeines/Fehler-/Aufgabenzeitprotokoll genehmigen. |
AssociateBugs | Ordnen Sie zugehörige Fehler einer Aufgabe zu. |
AssociateContacts | Verknüpft ein Tag mit einer bestimmten Entität in einem bestimmten Projekt. |
AssociateTags | Verknüpft ein Tag mit einer bestimmten Entität in einem bestimmten Projekt. |
DissociateBugs | Ordnen Sie zugehörige Fehler einer Aufgabe zu. |
DissociateContacts | Einen Kundenkontakt von einem Projekt trennen. |
DissociateTags | Trennt ein Tag von einer bestimmten Entität in einem bestimmten Projekt. |
ForumFollow | Einem Forenbeitrag folgen. |
ForumSelectBestAnswer | Einem Forenbeitrag nicht mehr folgen. |
ForumUnfollow | Einem Forenbeitrag nicht mehr folgen. |
ForumUnselectBestAnswer | Einem Forenbeitrag nicht mehr folgen. |
GetOAuthAccessToken | Ruft ein Authentifizierungstoken von ZohoProjects ab. |
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 den OAuthAccessToken von dieser URL an. |
RefreshOAuthAccessToken | Aktualisiert den OAuth-Zugriffstoken, der für die Authentifizierung bei ZohoProjects verwendet wird. |
SelectTeamLead | Aktualisieren Sie den Teamleiter. |
TaskFollow | Verfolgen Sie eine Aufgabe im angegebenen Projekt. |
TaskMove | Verschiebt eine Aufgabe von einer Aufgabenliste in eine andere. Die Zielaufgabenliste kann zum selben oder zu einem anderen Projekt gehören. |
TaskReorder | Ordnet die Aufgaben im angegebenen Projekt neu an. Die Aufgaben werden zwischen zwei Aufgaben basierend auf den IDs der vorherigen und nächsten Aufgabe neu angeordnet. |
TaskUnfollow | Einer Aufgabe im angegebenen Projekt nicht mehr folgen. |
Benutzer zur Clientfirma hinzufügen
Fügt einen Benutzer zu einem bestehenden Kundenunternehmen hinzu.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC AddUserToClientCompany PortalId = '12345317133', CompanyId = '123456000000039025', ContactEmail = 'test@example.com'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
CompanyId | String | True | Geben Sie die Firmen-ID des Kunden an. |
ContactEmail | String | True | Email ID des Client-Benutzers. |
WorkProjects | String | Falsch | Mehrere Projekt-IDs werden durch Kommas getrennt. |
ProfileId | String | Falsch | Geben Sie die Profil-ID an. Die Profil-ID wird über die API„Portalbenutzer abrufen“ abgerufen. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
Zeitprotokoll genehmigen
Allgemeines/Fehler-/Aufgabenzeitprotokoll genehmigen.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC ApproveTimelog PortalId = '12345317133', ProjectId = '123456000000031899', LogId = '123456000000031977', Approval = 'approve', Reason = 'Submitted timelog is approved', EntityType = 'general', EntityId = '1234560001'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
LogId | String | True | Geben Sie die Protokoll-ID an. |
EntityType | String | Falsch | Geben Sie den Entitätstyp an, um die Protokollzeit zu genehmigen. Die zulässigen Werte sind Task, Bug, General. |
EntityId | String | Falsch | ID der Entität, angegeben durch Parameter „EntityType“ |
Approval | String | True | Das Zeitprotokoll wird genehmigt, wenn der angegebene Wert „approve“ lautet. Die zulässigen Werte sind „approve“, „pending“ und „reject“*. |
Reason | String | Falsch | Es muss ein Grund angegeben werden, wenn das Zeitprotokoll abgelehnt wird. Der Grund darf 250 Zeichen nicht überschreiten. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
MitarbeiterBugs
Verknüpfen Sie zugehörige Fehler mit einer Aufgabe.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC AssociateBugs PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000031977', BugId = '123456000000034087'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TaskId | String | True | Geben Sie die Aufgaben-ID an. |
BugId | String | True | IDs für mehrere Fehler müssen durch Kommas getrennt werden. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
MitarbeiterKontakte
Verknüpft ein Tag mit einer bestimmten Entität in einem bestimmten Projekt.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC AssociateContacts PortalId = '12345317133', ProjectId = '123456000000031899', ContactId = '1234560000000123456'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
ContactId | String | True | Array von Client-Kontakt-IDs. Mehrere IDs können durch Kommas getrennt werden. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
MitarbeiterTags
Verknüpft ein Tag mit einer bestimmten Entität in einem bestimmten Projekt.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC AssociateTags PortalId = '12345317133', ProjectId = '123456000000031899', TagId = '123456000000031977', EntityType = 'Task', EntityId = '123456000000034087'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TagId | String | True | Geben Sie die Tag-ID an. |
EntityType | String | True | Geben Sie den Entitätstyp an, um die Protokollzeit zu genehmigen. Die zulässigen Werte sind Projekt, Meilenstein, Aufgabenliste, Aufgabe, Fehler, Forum, Status. |
EntityId | String | True | ID der Entität, angegeben durch Parameter „EntityType“ |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
Fehler trennen
Verknüpfen Sie zugehörige Fehler mit einer Aufgabe.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC DissociateBugs PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000031977', BugId = '123456000000034087'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TaskId | String | True | Geben Sie die Aufgaben-ID an. |
BugId | String | True | IDs für mehrere Fehler müssen durch Kommas getrennt werden. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
Kontakte trennen
Einen Kundenkontakt von einem Projekt trennen.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC DissociateContacts PortalId = '12345317133', ProjectId = '123456000000031899', ContactId = '1234560000000123456'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
ContactId | String | True | Array von Client-Kontakt-IDs. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
TrennenTags
Trennen Sie ein Tag von einer bestimmten Entität in einem bestimmten Projekt.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC DissociateTags PortalId = '12345317133', ProjectId = '123456000000031899', TagId = '123456000000031977', EntityType = 'Task', EntityId = '123456000000034087'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TagId | String | True | Geben Sie die Tag-ID an. |
EntityType | String | True | Geben Sie den Entitätstyp an, um die Protokollzeit zu genehmigen. Die zulässigen Werte sind Projekt, Meilenstein, Aufgabenliste, Aufgabe, Fehler, Forum, Status. |
EntityId | String | True | ID der Entität, angegeben durch Parameter „EntityType“ |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
ForumFolgen
Folgen Sie einem Forenbeitrag.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC ForumFollow PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
ForumId | String | True | Geben Sie die Tag-ID an. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
ForumSelectBestAnswer
Einem Forenbeitrag nicht mehr folgen.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC ForumSelectBestAnswer PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053', CommentId = '123456000000039021'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
ForumId | String | True | Geben Sie die Forum-ID an. |
CommentId | String | True | Geben Sie die Kommentar-ID an. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
ForumNicht mehr folgen
Einem Forenbeitrag nicht mehr folgen.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC ForumUnfollow PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
ForumId | String | True | Geben Sie die Tag-ID an. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
ForumAuswahl aufhebenBesteAntwort
Einem Forenbeitrag nicht mehr folgen.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC ForumUnselectBestAnswer PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053', CommentId = '123456000000039021'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
ForumId | String | True | Geben Sie die Forum-ID an. |
CommentId | String | True | Geben Sie die Kommentar-ID an. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
GetOAuthAccessToken
Erhält ein Authentifizierungstoken von ZohoProjects.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
AuthMode | String | Falsch | Der zu verwendende Authentifizierungsmodustyp. Wählen Sie „App“, um Authentifizierungstoken über eine Desktop-App abzurufen. Wählen Sie „Web“, um Authentifizierungstoken über eine Web-App abzurufen. Die zulässigen Werte sind APP, WEB. Der Standardwert ist APP. |
Scope | String | Falsch | Eine durch Kommas getrennte Liste von Berechtigungen, die vom Benutzer angefordert werden sollen. Eine Liste der verfügbaren Berechtigungen finden Sie in der ZohoProjects API. Der Standardwert ist ZohoProjects.portals.ALL,ZohoProjects.projects.ALL,ZohoProjects.status.ALL,ZohoProjects.milestones.ALL,ZohoProjects.tasklists.ALL,ZohoProjects.tasks.ALL,ZohoProjects.tags.ALL,ZohoProjects.bugs.ALL,ZohoProjects.events.ALL,ZohoProjects.forums.ALL,ZohoProjects.users.ALL,ZohoProjects.clients.ALL,ZohoProjects.documents.ALL,ZohoProjects.search.READ,ZohoProjects.entity_properties.ALL,ZohoProjects.activities.READ,ZohoProjects.timesheets.ALL. |
CallbackUrl | String | Falsch | Die URL, zu der der Benutzer nach der Autorisierung Ihrer Anwendung weitergeleitet wird. Dieser Wert muss mit der Weiterleitungs URL übereinstimmen, die Sie in den App-Einstellungen von ZohoProjects angegeben haben. Nur erforderlich, wenn der Authmode-Parameter „Web“ ist. |
Verifier | String | Falsch | Der von ZohoProjects zurückgegebene Prüfer, nachdem der Benutzer Ihrer App den Zugriff auf seine Daten gestattet hat. Dieser Wert wird als Parameter an die Rückruf-URL zurückgegeben. |
State | String | Falsch | Zeigt einen beliebigen Status an, der für Ihre Anwendung nach Erhalt der Antwort nützlich sein kann. Ihre Anwendung erhält denselben Wert, den sie gesendet hat, da dieser Parameter einen Hin- und Rückweg zum Autorisierungsserver von ZohoProjects und zurück durchführt. Zu den Verwendungsmöglichkeiten gehören die Umleitung des Benutzers zur richtigen Ressource auf Ihrer Site, Nonces und die Abwehr von Cross-Site-Request-Forgery. |
AccountsServer | String | Falsch | Die vollständige Kontoserver-URL, die zum Abrufen des OAuth-Zugriffstokens verwendet wird. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
OAuthAccessToken | String | Der Zugriffstoken, der für die Kommunikation mit ZohoProjects verwendet wird. |
OAuthRefreshToken | String | Ein Token, der zum Abrufen eines neuen Zugriffstokens verwendet werden kann. |
ExpiresIn | String | Die verbleibende Lebensdauer des Zugriffstokens. Eine -1 bedeutet, dass es nicht abläuft. |
AccountsServer | String | Die vollständige Kontoserver-URL. |
APIDomain | String | Die vollständige URL der API Domäne. |
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 den OAuthAccessToken von dieser URL an.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
CallbackUrl | String | Falsch | Die URL, zu der der Benutzer nach der Autorisierung Ihrer Anwendung weitergeleitet wird. Dieser Wert muss mit der Weiterleitungs-URL in den App-Einstellungen von ZohoProjects übereinstimmen. |
Scope | String | Falsch | Eine durch Kommas getrennte Liste von Bereichen, die vom Benutzer angefordert werden sollen. Eine Liste der verfügbaren Berechtigungen finden Sie in der ZohoProjects API Dokumentation. Der Standardwert ist ZohoProjects.portals.ALL,ZohoProjects.projects.ALL,ZohoProjects.status.ALL,ZohoProjects.milestones.ALL,ZohoProjects.tasklists.ALL,ZohoProjects.tasks.ALL,ZohoProjects.tags.ALL,ZohoProjects.bugs.ALL,ZohoProjects.events.ALL,ZohoProjects.forums.ALL,ZohoProjects.users.ALL,ZohoProjects.clients.ALL,ZohoProjects.documents.ALL,ZohoProjects.search.READ,ZohoProjects.entity_properties.ALL,ZohoProjects.activities.READ,ZohoProjects.timesheets.ALL. |
State | String | Falsch | Zeigt einen beliebigen Status an, der für Ihre Anwendung nach Erhalt der Antwort nützlich sein kann. Ihre Anwendung erhält denselben Wert, den sie gesendet hat, da dieser Parameter einen Hin- und Rückweg zum Autorisierungsserver von ZohoProjects und zurück durchführt. Zu den Verwendungsmöglichkeiten gehören die Umleitung des Benutzers zur richtigen Ressource auf Ihrer Site, Nonces und die Abwehr von Cross-Site-Request-Forgery. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
URL | String | Die Autorisierungs-URL, die in einen Webbrowser eingegeben wird, um das Prüftoken zu erhalten und Ihre App zu autorisieren. |
Aktualisieren Sie das OAuthAccessToken
Aktualisiert den OAuth-Zugriffstoken, der für die Authentifizierung bei ZohoProjects verwendet wird.
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
OAuthRefreshToken | String | True | Das vom ursprünglichen Autorisierungscode-Austausch zurückgegebene Aktualisierungstoken. |
AccountsServer | String | Falsch | Die vollständige Kontoserver-URL, die zum Abrufen eines neuen Zugriffstokens verwendet wird. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
OAuthAccessToken | String | Das von ZohoProjects zurückgegebene Zugriffstoken. Dieses kann in nachfolgenden Aufrufen anderer Vorgänge für diesen bestimmten Dienst verwendet werden. |
OAuthRefreshToken | String | Ein Token, der zum Abrufen eines neuen Zugriffstokens verwendet werden kann. |
ExpiresIn | String | Die verbleibende Lebensdauer des Zugriffstokens. |
Wählen SieTeamLead
Aktualisieren Sie den Teamleiter.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC SelectTeamLead PortalId = '12345317133', ProjectId = '123456000000031899', UserId = '123456000000033053'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | Falsch | Geben Sie die Portal-ID an. |
TeamId | String | Falsch | Geben Sie die Gruppen-ID an. |
UserId | String | Falsch | ZPUID des Teamleiters. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob das Update erfolgreich war. |
AufgabeFolgen
Verfolgen Sie eine Aufgabe im angegebenen Projekt.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC TaskFollow PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', UserId = '123456000000039021'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TaskId | String | True | Geben Sie die Aufgaben-ID an. |
UserId | String | True | Benutzer-IDs für mehrere Follower müssen durch Kommas getrennt werden. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
Aufgaben verschieben
Verschiebt eine Aufgabe von einer Aufgabenliste in eine andere. Die Zielaufgabenliste kann zum selben oder einem anderen Projekt gehören.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC TaskMove PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', FromTasklist = '123456000000031932', ToTasklist = '123456000000031941'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TaskId | String | True | Geben Sie die Aufgaben-ID an. |
FromTasklist | String | True | ID der Aufgabenliste, in der die Aufgabe vorhanden ist. |
ToTasklist | String | True | ID der Aufgabenliste, in die die Aufgabe verschoben werden soll. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
Aufgabenneuordnung
Ordnet die Aufgaben im angegebenen Projekt neu an. Die Aufgaben werden zwischen zwei Aufgaben basierend auf den IDs der vorherigen und nächsten Aufgabe neu angeordnet.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC TaskReorder PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', PreviousTaskId = '123456000000031932', NextTaskId = '123456000000031941'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TaskId | String | True | Geben Sie die Aufgaben-ID an. |
PreviousTaskId | String | True | Geben Sie die vorherige Task-ID an. |
NextTaskId | String | True | Geben Sie die nächste Task-ID an. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob das Update erfolgreich war. |
AufgabeNicht mehr folgen
Eine Aufgabe im angegebenen Projekt nicht mehr verfolgen.
Verfahrensspezifische Informationen
Unten sehen Sie eine Abfrage zum Ausführen dieser gespeicherten Prozedur:
EXEC TaskUnfollow PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', UserId = '123456000000039021'
Eingang
Name | Typ | Erforderlich | Beschreibung |
---|---|---|---|
PortalId | String | True | Geben Sie die Portal-ID an. |
ProjectId | String | True | Geben Sie die Gruppen-ID an. |
TaskId | String | True | ZPUID des Teamleiters. |
UserId | String | True | Benutzer-IDs für mehrere Follower müssen durch Kommas getrennt werden. |
Ergebnissatzspalten
Name | Typ | Beschreibung |
---|---|---|
Success | String | Gibt an, ob die Ausführung erfolgreich war. |
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 Zoho Projects zurück:
- sys_catalogs: Listet die verfügbaren Datenbanken auf.
- sys_schemas: Listet die verfügbaren Schemata auf.
- sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
- sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
- sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
- sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
- sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
- sys_indexes: Beschreibt die verfügbaren Indizes.
Datenquellentabellen
Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:
- sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
- sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.
Abfrageinformationstabellen
Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:
- Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.
Sys_catalogs
Listet die verfügbaren Datenbanken auf.
Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:
SELECT * FROM sys_catalogs
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Datenbankname. |
Sys_schemas
Listet die verfügbaren Schemas auf.
Die folgende Abfrage ruft alle verfügbaren Schemata ab:
SELECT * FROM sys_schemas
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Datenbankname. |
SchemaName | String | Der Schema. |
Sys_tables
Listet die verfügbaren Tabellen auf.
Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:
SELECT * FROM sys_tables
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Die Datenbank, die die Tabelle oder Ansicht enthält. |
SchemaName | String | Das Schema, das die Tabelle oder Ansicht enthält. |
TableName | String | Der Name der Tabelle oder Ansicht. |
TableType | String | Der Tabellentyp (Tabelle oder Ansicht). |
Description | String | Eine Beschreibung der Tabelle oder Ansicht. |
IsUpdateable | Boolean | Ob die Tabelle aktualisiert werden kann. |
Sys_tablecolumns
Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Portale“ zurück:
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Portals'
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die die Tabelle oder Ansicht enthält. |
SchemaName | String | Das Schema, das die Tabelle oder Ansicht enthält. |
TableName | String | Der Name der Tabelle oder Ansicht, die die Spalte enthält. |
ColumnName | String | Der Spaltenname. |
DataTypeName | String | Der Name des Datentyps. |
DataType | Int32 | Eine Ganzzahl, die den Datentyp angibt. Dieser Wert wird zur Laufzeit basierend auf der Umfeld bestimmt. |
Length | Int32 | Die Speichergröße der Spalte. |
DisplaySize | Int32 | Die normale Maximalbreite der angegebenen Spalte in Zeichen. |
NumericPrecision | Int32 | Die maximale Anzahl von Ziffern in numerischen Daten. Die Spaltenlänge in Zeichen für Zeichen- und Datums-/Uhrzeitdaten. |
NumericScale | Int32 | Die Spaltenskala oder Anzahl der Ziffern rechts vom Dezimalpunkt. |
IsNullable | Boolean | Ob die Spalte Null enthalten kann. |
Description | String | Eine kurze Beschreibung der Spalte. |
Ordinal | Int32 | Die Sequenznummer der Spalte. |
IsAutoIncrement | String | Ob der Spaltenwert in festen Schritten zugewiesen wird. |
IsGeneratedColumn | String | Ob die Spalte generiert wird. |
IsHidden | Boolean | Ob die Spalte ausgeblendet ist. |
IsArray | Boolean | Ob die Spalte ein Array ist. |
IsReadOnly | Boolean | Ob die Spalte schreibgeschützt ist. |
IsKey | Boolean | Gibt an, ob ein von sys_tablecolumns zurückgegebenes Feld der Primärschlüssel der Tabelle ist. |
Sys_procedures
Listet die verfügbaren gespeicherten Prozeduren auf.
Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:
SELECT * FROM sys_procedures
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Die Datenbank, die die gespeicherte Prozedur enthält. |
SchemaName | String | Das Schema, das die gespeicherte Prozedur enthält. |
ProcedureName | String | Der Name der gespeicherten Prozedur. |
Description | String | Eine Beschreibung der gespeicherten Prozedur. |
ProcedureType | String | Der Typ der Prozedur, z. B. PROZEDUR oder FUNKTION. |
Sys_procedureparameters
Beschreibt Parameter gespeicherter Prozeduren.
Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur „ApproveTimelog“ zurück:
SELECT * FROM sys_procedureparameters WHERE ProcedureName='ApproveTimelog' AND Direction=1 OR Direction=2
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die die gespeicherte Prozedur enthält. |
SchemaName | String | Der Name des Schema, das die gespeicherte Prozedur enthält. |
ProcedureName | String | Der Name der gespeicherten Prozedur, die den Parameter enthält. |
ColumnName | String | Der Name des gespeicherten Prozedurparameters. |
Direction | Int32 | Eine Ganzzahl, die dem Typ des Parameters entspricht: Eingabe (1), Eingabe/Ausgabe (2) oder Ausgabe (4). Parameter vom Typ Eingabe/Ausgabe können sowohl Eingabe- als auch Ausgabeparameter sein. |
DataTypeName | String | Der Name des Datentyps. |
DataType | Int32 | Eine Ganzzahl, die den Datentyp angibt. Dieser Wert wird zur Laufzeit basierend auf der Umfeld bestimmt. |
Length | Int32 | Die Anzahl der für Zeichendaten zulässigen Zeichen. Die Anzahl der für numerische Daten zulässigen Ziffern. |
NumericPrecision | Int32 | Die maximale Genauigkeit für numerische Daten. Die Spaltenlänge in Zeichen für Zeichen- und Datums-/Uhrzeitdaten. |
NumericScale | Int32 | Die Anzahl der Ziffern rechts vom Dezimalkomma in numerischen Daten. |
IsNullable | Boolean | Ob der Parameter Null enthalten kann. |
IsRequired | Boolean | Ob der Parameter zur Ausführung der Prozedur erforderlich ist. |
IsArray | Boolean | Ob der Parameter ein Array ist. |
Description | String | Die Beschreibung des Parameters. |
Ordinal | Int32 | Der Index des Parameters. |
Sys_keycolumns
Beschreibt die Primär- und Fremdschlüssel.
Die folgende Abfrage ruft den Primärschlüssel für die Tabelle „Portale“ ab:
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Portals'
Spalten
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Schlüssel enthält. |
SchemaName | String | Der Name des Schema, das den Schlüssel enthält. |
TableName | String | Der Name der Tabelle, die den Schlüssel enthält. |
ColumnName | String | Der Name der Schlüsselspalte. |
IsKey | Boolean | Ob die Spalte ein Primärschlüssel in der Tabelle ist, auf die im Feld „TableName“ verwiesen wird. |
IsForeignKey | Boolean | Ob die Spalte ein Fremdschlüssel ist, auf den im Feld TableName verwiesen wird. |
PrimaryKeyName | String | Der Name des Primärschlüssels. |
ForeignKeyName | String | Der Name des Fremdschlüssels. |
ReferencedCatalogName | String | Die Datenbank, die den Primärschlüssel enthält. |
ReferencedSchemaName | String | Das Schema, das den Primärschlüssel enthält. |
ReferencedTableName | String | Die Tabelle, die den Primärschlüssel enthält. |
ReferencedColumnName | String | Der Spaltenname des Primärschlüssels. |
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
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Schlüssel enthält. |
SchemaName | String | Der Name des Schema, das den Schlüssel enthält. |
TableName | String | Der Name der Tabelle, die den Schlüssel enthält. |
ColumnName | String | Der Name der Schlüsselspalte. |
PrimaryKeyName | String | Der Name des Primärschlüssels. |
ForeignKeyName | String | Der Name des Fremdschlüssels. |
ReferencedCatalogName | String | Die Datenbank, die den Primärschlüssel enthält. |
ReferencedSchemaName | String | Das Schema, das den Primärschlüssel enthält. |
ReferencedTableName | String | Die Tabelle, die den Primärschlüssel enthält. |
ReferencedColumnName | String | Der Spaltenname des Primärschlüssels. |
ForeignKeyType | String | Gibt an, ob der Fremdschlüssel ein Importschlüssel (zeigt auf andere Tabellen) oder ein Exportschlüssel (referenziert von anderen Tabellen) ist. |
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
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Schlüssel enthält. |
SchemaName | String | Der Name des Schema, das den Schlüssel enthält. |
TableName | String | Der Name der Tabelle, die den Schlüssel enthält. |
ColumnName | String | Der Name der Schlüsselspalte. |
KeySeq | String | Die Sequenznummer des Primärschlüssels. |
KeyName | String | Der Name des Primärschlüssels. |
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
Name | Typ | Beschreibung |
---|---|---|
CatalogName | String | Der Name der Datenbank, die den Index enthält. |
SchemaName | String | Der Name des Schema, das den Index enthält. |
TableName | String | Der Name der Tabelle, die den Index enthält. |
IndexName | String | Der Indexname. |
ColumnName | String | Der Name der mit dem Index verknüpften Spalte. |
IsUnique | Boolean | Wahr, wenn der Index eindeutig ist. Andernfalls falsch. |
IsPrimary | Boolean | Wahr, wenn der Index ein Primärschlüssel ist. Andernfalls falsch. |
Type | Int16 | Ein ganzzahliger Wert, der dem Indextyp entspricht: Statistik (0), gruppiert (1), gehasht (2) oder Sonstiges (3). |
SortOrder | String | Die Sortierreihenfolge: A für aufsteigend oder D für absteigend. |
OrdinalPosition | Int16 | Die Sequenznummer der Spalte im Index. |
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:zohoprojects: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
Name | Typ | Beschreibung |
---|---|---|
Name | String | Der Name der Verbindungseigenschaft. |
ShortDescription | String | Eine kurze Beschreibung. |
Type | String | Der Datentyp der Verbindungseigenschaft. |
Default | String | Der Standardwert, sofern nicht explizit einer festgelegt wurde. |
Values | String | Eine durch Kommas getrennte Liste möglicher Werte. Wenn ein anderer Wert angegeben wird, wird ein Validierungsfehler ausgegeben. |
Value | String | Der von Ihnen festgelegte Wert oder ein vorkonfigurierter Standard. |
Required | Boolean | Ob für die Immobilie eine Verbindung erforderlich ist. |
Category | String | Die Kategorie der Verbindungseigenschaft. |
IsSessionProperty | String | Ob die Eigenschaft eine Sitzungseigenschaft ist, die zum Speichern von Informationen zur aktuellen Verbindung verwendet wird. |
Sensitivity | String | Die Vertraulichkeitsstufe der Eigenschaft. Diese gibt Aufschluss darüber, ob die Eigenschaft in Protokollierungs- und Authentifizierungsformularen verschleiert wird. |
PropertyName | String | Eine verkürzte Form des Verbindungseigenschaftsnamens in Camel-Case-Schreibweise. |
Ordinal | Int32 | Der Index des Parameters. |
CatOrdinal | Int32 | Der Index der Parameterkategorie. |
Hierarchy | String | Zeigt zugehörige abhängige Eigenschaften an, die zusammen mit dieser festgelegt werden müssen. |
Visible | Boolean | Informiert, ob die Eigenschaft in der Verbindungs-Benutzeroberfläche sichtbar ist. |
ETC | String | Verschiedene sonstige Informationen zum Objekt. |
Sys_sqlinfo
Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.
Entdecken der SELECT-Funktionen der Datenquelle
Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden. Andernfalls enthält die Spalte NO.
Name | Beschreibung | Mögliche Werte |
---|---|---|
AGGREGATE_FUNCTIONS | Unterstützte Aggregatfunktionen. | AVG , COUNT , MAX , MIN , SUM , DISTINCT |
COUNT | Ob die COUNT-Funktion unterstützt wird. | YES , NO |
IDENTIFIER_QUOTE_OPEN_CHAR | Das öffnende Zeichen, das zum Escapen eines Bezeichners verwendet wird. | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | Das abschließende Zeichen, das zum Escapen eines Bezeichners verwendet wird. | ] |
SUPPORTED_OPERATORS | Eine Liste unterstützter SQL-Operatoren. | = , > , < , >= , <= , <> , != , LIKE , NOT LIKE , IN , NOT IN , IS NULL , IS NOT NULL , AND , OR |
GROUP_BY | Ob GROUP BY unterstützt wird und wenn ja, in welchem Umfang. | NO , NO_RELATION , EQUALS_SELECT , SQL_GB_COLLATE |
STRING_FUNCTIONS | Unterstützte String-Funktionen. | LENGTH , CHAR , LOCATE , REPLACE , SUBSTRING , RTRIM , LTRIM , RIGHT , LEFT , UCASE , SPACE , SOUNDEX , LCASE , CONCAT , ASCII , REPEAT , OCTET , BIT , POSITION , INSERT , TRIM , UPPER , REGEXP , LOWER , DIFFERENCE , CHARACTER , SUBSTR , STR , REVERSE , PLAN , UUIDTOSTR , TRANSLATE , TRAILING , TO , STUFF , STRTOUUID , STRING , SPLIT , SORTKEY , SIMILAR , REPLICATE , PATINDEX , LPAD , LEN , LEADING , KEY , INSTR , INSERTSTR , HTML , GRAPHICAL , CONVERT , COLLATION , CHARINDEX , BYTE |
NUMERIC_FUNCTIONS | Unterstützte numerische Funktionen. | ABS , ACOS , ASIN , ATAN , ATAN2 , CEILING , COS , COT , EXP , FLOOR , LOG , MOD , SIGN , SIN , SQRT , TAN , PI , RAND , DEGREES , LOG10 , POWER , RADIANS , ROUND , TRUNCATE |
TIMEDATE_FUNCTIONS | Unterstützte Datums-/Uhrzeitfunktionen. | NOW , CURDATE , DAYOFMONTH , DAYOFWEEK , DAYOFYEAR , MONTH , QUARTER , WEEK , YEAR , CURTIME , HOUR , MINUTE , SECOND , TIMESTAMPADD , TIMESTAMPDIFF , DAYNAME , MONTHNAME , CURRENT_DATE , CURRENT_TIME , CURRENT_TIMESTAMP , EXTRACT |
REPLICATION_SKIP_TABLES | Zeigt an, dass während der Replikation Tabellen übersprungen wurden. | |
REPLICATION_TIMECHECK_COLUMNS | Ein Zeichenfolgenarray mit einer Liste von Spalten, die (in der angegebenen Reihenfolge) zur Überprüfung verwendet werden, ob sie während der Replikation als geänderte Spalte verwendet werden sollen. | |
IDENTIFIER_PATTERN | Zeichenfolgenwert, der angibt, welche Zeichenfolge für einen Bezeichner gültig ist. | |
SUPPORT_TRANSACTION | Gibt an, ob der Anbieter Transaktionen wie Commit und Rollback unterstützt. | YES , NO |
DIALECT | Gibt den zu verwendenden SQL-Dialekt an. | |
KEY_PROPERTIES | Gibt die Eigenschaften an, die die einheitliche Datenbank identifizieren. | |
SUPPORTS_MULTIPLE_SCHEMAS | Gibt an, ob für den Anbieter mehrere Schemas vorhanden sein können. | YES , NO |
SUPPORTS_MULTIPLE_CATALOGS | Gibt an, ob für den Anbieter mehrere Kataloge vorhanden sein können. | YES , NO |
DATASYNCVERSION | Die für den Zugriff auf diesen Treiber erforderliche Data Sync-Version. | Standard , Starter , Professional , Enterprise |
DATASYNCCATEGORY | Die Kategorie „Datensynchronisierung“ dieses Treiber. | Source , Destination , Cloud Destination |
SUPPORTSENHANCEDSQL | Ob erweiterte SQL-Funktionen über das hinaus, was die API bietet, unterstützt werden. | TRUE , FALSE |
SUPPORTS_BATCH_OPERATIONS | Ob Charge Operationen unterstützt werden. | YES , NO |
SQL_CAP | Alle unterstützten SQL-Funktionen für diesen Treiber. | SELECT , INSERT , DELETE , UPDATE , TRANSACTIONS , ORDERBY , OAUTH , ASSIGNEDID , LIMIT , LIKE , BULKINSERT , COUNT , BULKDELETE , BULKUPDATE , GROUPBY , HAVING , AGGS , OFFSET , REPLICATE , COUNTDISTINCT , JOINS , DROP , CREATE , DISTINCT , INNERJOINS , SUBQUERIES , ALTER , MULTIPLESCHEMAS , GROUPBYNORELATION , OUTERJOINS , UNIONALL , UNION , UPSERT , GETDELETED , CROSSJOINS , GROUPBYCOLLATE , MULTIPLECATS , FULLOUTERJOIN , MERGE , JSONEXTRACT , BULKUPSERT , SUM , SUBQUERIESFULL , MIN , MAX , JOINSFULL , XMLEXTRACT , AVG , MULTISTATEMENTS , FOREIGNKEYS , CASE , LEFTJOINS , COMMAJOINS , WITH , LITERALS , RENAME , NESTEDTABLES , EXECUTE , BATCH , BASIC , INDEX |
PREFERRED_CACHE_OPTIONS | Ein Zeichenfolgenwert gibt die bevorzugten Cacheoptionen an. | |
ENABLE_EF_ADVANCED_QUERY | Gibt an, ob der Treiber erweiterte Abfragen aus dem Entity Framework direkt unterstützt. Wenn nicht, werden die Abfragen clientseitig verarbeitet. | YES , NO |
PSEUDO_COLUMNS | Ein Zeichenfolgenarray, das die verfügbaren Pseudospalten angibt. | |
MERGE_ALWAYS | Wenn der Wert „true“ ist, wird der Merge-Modus in der Datensynchronisierung zwangsweise ausgeführt. | TRUE , FALSE |
REPLICATION_MIN_DATE_QUERY | Eine Abfrage zum Zurückgeben des Startdatums und der Startzeit der Replikation. | |
REPLICATION_MIN_FUNCTION | Ermöglicht einem Anbieter, den Formelnamen anzugeben, der zum Ausführen eines serverseitigen Minimums verwendet werden soll. | |
REPLICATION_START_DATE | Ermöglicht einem Anbieter, ein Replikationsstartdatum anzugeben. | |
REPLICATION_MAX_DATE_QUERY | Eine Abfrage zum Zurückgeben des Enddatums und der Endzeit der Replikation. | |
REPLICATION_MAX_FUNCTION | Ermöglicht einem Anbieter, den Formelnamen anzugeben, der zur Ausführung eines serverseitigen Max. verwendet werden soll. | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | Eine Liste von Tabellen, bei denen das Aufteilen der Replikation in Blöcke bei der ersten Replikation übersprungen wird. | |
CHECKCACHE_USE_PARENTID | Gibt an, ob die CheckCache-Anweisung für die übergeordnete Schlüsselspalte ausgeführt werden soll. | TRUE , FALSE |
CREATE_SCHEMA_PROCEDURES | Gibt gespeicherte Prozeduren an, die zum Generieren von Schema verwendet werden können. |
Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:
SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'
Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; siehe Datenmodell Abschnitt für weitere Informationen.
Spalten
Name | Typ | Beschreibung |
---|---|---|
NAME | String | Eine Komponente der SQL-Syntax oder eine Funktion, die auf dem Server verarbeitet werden kann. |
VALUE | String | Details zum unterstützten SQL bzw. zur SQL-Syntax. |
Systemidentität
Gibt Informationen zu versuchten Änderungen zurück.
Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:
SELECT * FROM sys_identity
Spalten
Name | Typ | Beschreibung |
---|---|---|
Id | String | Die von einer Operation zurückgegebene, von der Datenbank generierte ID. |
Batch | String | Eine Kennung für den Charge. 1 für einen einzelnen Operation. |
Operation | String | Das Ergebnis der Operation im Charge: EINGEFÜGT, AKTUALISIERT oder GELÖSCHT. |
Message | String | SUCCESS oder eine Fehlermeldung, wenn das Update im Charge fehlgeschlagen ist. |
Erweiterte Konfigurationseigenschaften
Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.
Eigenschaft | Beschreibung |
---|---|
Region | Die Top-Level-Domäne in der Server-URL. |
Eigenschaft | Beschreibung |
---|---|
PortalId | Beschränken Sie die angezeigten Entitäten auf Grundlage der Portal-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt. |
ProjectId | Beschränken Sie die angezeigten Entitäten auf Grundlage der Projekt-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt. |
Eigenschaft | Beschreibung |
---|---|
InitiateOAuth | Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten. |
OAuthClientId | Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthClientSecret | Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthAccessToken | Der Zugriffstoken für die Verbindung mittels OAuth. |
OAuthSettingsLocation | Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH gesetzt ist. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://' . |
CallbackURL | Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben. |
OAuthVerifier | Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. |
OAuthRefreshToken | Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken. |
OAuthExpiresIn | Die Lebensdauer des OAuth AccessToken in Sekunden. |
OAuthTokenTimestamp | Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde. |
Eigenschaft | Beschreibung |
---|---|
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
Eigenschaft | Beschreibung |
---|---|
Location | Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren. |
BrowsableSchemas | Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA, TabelleB, TabelleC. |
Views | Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA, AnsichtB, AnsichtC. |
Eigenschaft | Beschreibung |
---|---|
AccountsServer | Die vollständige Kontoserver-URL. |
APIDomain | Die vollständige URL der API Domäne. |
MaxRows | Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln. |
Other | Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet. |
Pagesize | Die maximale Anzahl der Ergebnisse, die pro Seite von Zoho Projects zurückgegeben werden sollen. |
PseudoColumns | Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
UserDefinedViews | Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält. |
Authentifizierung
Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
Region | Die Top-Level-Domäne in der Server-URL. |
Region
Die Top-Level-Domäne in der Server-URL.
Mögliche Werte
US
, Europe
, India
, Australia
Datentyp
string
Standardwert
US
Hinweise
Wenn sich Ihr Konto in einer anderen Domäne als den USA befindet, ändern Sie die Region entsprechend. Diese Tabelle listet alle möglichen Werte auf:
Region | Domäne |
---|---|
US | .com |
Europe | .eu |
India | .im |
Australia | .com.au |
Verbindung
Dieser Abschnitt enthält eine vollständige Liste der Verbindungseigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
PortalId | Beschränken Sie die angezeigten Entitäten auf Grundlage der Portal-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt. |
ProjectId | Beschränken Sie die angezeigten Entitäten auf Grundlage der Projekt-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt. |
PortalId
Beschränken Sie die angezeigten Entitäten auf Grundlage der Portal-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt.
Datentyp
string
Standardwert
""
Hinweise
Beschränken Sie die angezeigten Entitäten auf Grundlage der Portal-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt.
ProjektID
Beschränken Sie die angezeigten Entitäten auf Grundlage der Projekt-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt.
Datentyp
string
Standardwert
""
Hinweise
Beschränken Sie die angezeigten Entitäten auf Grundlage der Projekt-ID. Wenn Sie das Feld leer lassen, werden alle verfügbaren Portale angezeigt.
OAuth
Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
InitiateOAuth | Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten. |
OAuthClientId | Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthClientSecret | Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren. |
OAuthAccessToken | Der Zugriffstoken für die Verbindung mittels OAuth. |
OAuthSettingsLocation | Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH gesetzt ist. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://' . |
CallbackURL | Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben. |
OAuthVerifier | Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. |
OAuthRefreshToken | Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken. |
OAuthExpiresIn | Die Lebensdauer des OAuth AccessToken in Sekunden. |
OAuthTokenTimestamp | Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde. |
OAuth initiieren
Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten.
Mögliche Werte
OFF
, GETANDREFRESH
, REFRESH
Datentyp
string
Standardwert
OFF
Hinweise
Folgende Optionen stehen zur Verfügung:
OFF
: Gibt an, dass der OAuth-Flow vollständig vom Benutzer gehandhabt wird. Zur Authentifizierung ist ein OAuthAccessToken erforderlich.GETANDREFRESH
: Gibt an, dass der gesamte OAuth-Flow vom Connector verarbeitet wird. Wenn derzeit kein Token vorhanden ist, wird es durch eine entsprechende Aufforderung an den Benutzer über den Browser abgerufen. Wenn ein Token vorhanden ist, wird es bei Bedarf aktualisiert.REFRESH
: Gibt an, dass der Connector nur das Aktualisieren des OAuthAccessToken übernimmt. Der Benutzer wird vom Connector nie aufgefordert, sich über den Browser zu authentifizieren. Der Benutzer muss zunächst das Abrufen des OAuthAccessToken und des OAuthRefreshToken übernehmen.
OAuthClientId
Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.
Datentyp
string
Standardwert
""
Hinweise
Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId
-Wert, manchmal auch Consumer-Schlüssel genannt, und ein Client-Geheimnis, das OAuthClientSecret.
OAuthClientSecret
Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.
Datentyp
string
Standardwert
""
Hinweise
Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId, auch Consumer-Schlüssel genannt. Sie erhalten außerdem ein Client-Geheimnis, auch Consumer-Geheimnis genannt. Legen Sie das Client-Geheimnis im OAuthClientSecret
Eigentum.
OAuth-Zugriffstoken
Der Zugriffstoken für die Verbindung per OAuth.
Datentyp
string
Standardwert
""
Hinweise
Der OAuthAccessToken
Eigenschaft wird für die Verbindung über OAuth verwendet. Die OAuthAccessToken
wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es hat ein serverabhängiges Timeout und kann zwischen Anfragen wiederverwendet werden.
Das Zugriffstoken wird anstelle Ihres Benutzernamens und Passworts verwendet. Das Zugriffstoken schützt Ihre Anmeldeinformationen, indem es sie auf dem Server speichert.
OAuthSettingsLocation
Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH eingestellt ist. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://'
.
Datentyp
string
Standardwert
%APPDATA%\ZohoProjects Data Provider\OAuthSettings.txt
Hinweise
Wenn InitiateOAuth ist auf gesetzt GETANDREFRESH
oder REFRESH
, der Connector speichert OAuth-Werte, damit der Benutzer die OAuth-Verbindungseigenschaften nicht manuell eingeben muss und die Anmeldeinformationen über Verbindungen oder Prozesse hinweg gemeinsam genutzt werden können.
Anstatt einen Dateipfad anzugeben, können Sie den Speicher verwenden. Speicherorte werden durch einen Wert angegeben, der mit beginnt 'memory://'
gefolgt von einer eindeutigen Kennung für diesen Satz von Anmeldeinformationen (z. B. memory://user1). Die Kennung können Sie frei wählen, sie sollte jedoch für den Benutzer eindeutig sein. Im Gegensatz zur dateibasierten Speicherung, bei der die Anmeldeinformationen über Verbindungen hinweg bestehen bleiben, werden die Anmeldeinformationen bei der Speicherspeicherung in den statischen Speicher geladen und die Anmeldeinformationen werden für die Dauer des Prozesses unter Verwendung derselben Kennung zwischen Verbindungen geteilt. Um die Anmeldeinformationen außerhalb des aktuellen Prozesses beizubehalten, müssen Sie die Anmeldeinformationen vor dem Schließen der Verbindung manuell speichern. Auf diese Weise können Sie sie in der Verbindung festlegen, wenn der Prozess erneut gestartet wird. Sie können OAuth-Eigenschaftswerte mit einer Abfrage an abrufen sys_connection_props
Systemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.
Der Standardspeicherort ist „%APPDATA%\ZohoProjects Data Provider\OAuthSettings.txt“ mit %APPDATA%
auf das Konfigurationsverzeichnis des Benutzers gesetzt. Die Standardwerte sind
- Windows: "
register://%DSN
" - Unix: "%AppData%..."
- Mac: "%AppData%..."
wobei DSN der Name des aktuellen DSN ist, der in der offenen Verbindung verwendet wird.
Die folgende Tabelle listet den Wert von auf %APPDATA%
nach Operationssystem:
Plattform | %APPDATA% |
---|---|
Windows | Der Wert der Umfeld APPDATA |
Mac | ~/Bibliothek/Anwendungsunterstützung |
Linux | ~/.config |
Rückruf-URL
Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.
Datentyp
string
Standardwert
""
Hinweise
Während des Authentifizierungsprozesses leitet der OAuth-Autorisierungsserver den Benutzer an diese URL weiter. Dieser Wert muss mit der Rückruf URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.
OAuthVerifier
Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode.
Datentyp
string
Standardwert
""
Hinweise
Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. Dieser kann auf Systemen verwendet werden, auf denen kein Browser gestartet werden kann, z. B. auf Headless-Systemen.
Authentifizierung auf Headless-Maschinen
Siehe, um die zu erhalten OAuthVerifier
Wert.
OAuthSettingsLocation festlegen zusammen mit OAuthVerifier
. Beim Verbinden tauscht der Connector die OAuthVerifier
für die OAuth-Authentifizierungstoken und speichert sie verschlüsselt am angegebenen Speicherort. Setzen Sie InitiateOAuth zu GETANDREFRESH, um den Austausch zu automatisieren.
Sobald die OAuth-Einstellungsdatei generiert wurde, können Sie entfernen OAuthVerifier
aus den Verbindungseigenschaften und verbinden Sie sich mit OAuthSettingsLocation festgelegt.
Um die OAuth-Tokenwerte automatisch zu aktualisieren, legen Sie OAuthSettingsLocation fest und setzen Sie zusätzlich InitiateOAuth zum AKTUALISIEREN.
OAuthRefreshToken
Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken.
Datentyp
string
Standardwert
""
Hinweise
Der OAuthRefreshToken
Eigenschaft wird verwendet, um den OAuthAccessToken zu aktualisieren bei Verwendung der OAuth-Authentifizierung.
OAuthLäuftAbIn
Die Lebensdauer des OAuth AccessToken in Sekunden.
Datentyp
string
Standardwert
""
Hinweise
Mit OAuthTokenTimestamp kombinieren, um zu bestimmen, wann der AccessToken abläuft.
OAuthTokenTimestamp
Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde.
Datentyp
string
Standardwert
""
Hinweise
Kombinieren Sie es mit OAuthExpiresIn, um zu bestimmen, wann das AccessToken abläuft.
SSL
Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
SSLServerCert
Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL.
Datentyp
string
Standardwert
""
Hinweise
Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.
Diese Eigenschaft kann folgende Formen annehmen:
Beschreibung | Beispiel |
---|---|
Ein vollständiges PEM-Zertifikat (Beispiel der Kürze halber gekürzt) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
Ein Pfad zu einer lokalen Datei, die das Zertifikat enthält | C:\\cert.cer |
Der öffentliche Schlüssel (Beispiel der Kürze halber gekürzt) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
Der MD5-Fingerabdruck (Hex-Werte können auch durch Leerzeichen oder Doppelpunkte getrennt sein) | ecadbdda5a1529c58a1e9e09828d70e4 |
Der SHA1-Fingerabdruck (Hexadezimalwerte können auch durch Leerzeichen oder Doppelpunkte getrennt sein) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.
Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).
Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.
Schema
Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
Location | Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren. |
BrowsableSchemas | Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA, TabelleB, TabelleC. |
Views | Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA, AnsichtB, AnsichtC. |
Standort
Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.
Datentyp
string
Standardwert
%APPDATA%\ZohoProjects Data Provider\Schema
Hinweise
Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location
-Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen möchten (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.
Wenn nichts angegeben wird, ist der Standardspeicherort „%APPDATA%\ZohoProjects Data Provider\Schema“ mit %APPDATA%
wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:
Plattform | %APPDATA% |
---|---|
Windows | Der Wert der Umfeld APPDATA |
Mac | ~/Bibliothek/Anwendungsunterstützung |
Linux | ~/.config |
DurchsuchbareSchemas
Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.
Datentyp
string
Standardwert
""
Hinweise
Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.
Tabellen
Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.
Datentyp
string
Standardwert
""
Hinweise
Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.
Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.
Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.
Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.
Ansichten
Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.
Datentyp
string
Standardwert
""
Hinweise
Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.
Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.
Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.
Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.
Verschiedenes
Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
AccountsServer | Die vollständige Kontoserver-URL. |
APIDomain | Die vollständige URL der API Domäne. |
MaxRows | Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln. |
Other | Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet. |
Pagesize | Die maximale Anzahl der Ergebnisse, die pro Seite von Zoho Projects zurückgegeben werden sollen. |
PseudoColumns | Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
UserDefinedViews | Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält. |
KontenServer
Die vollständige Kontoserver-URL.
Datentyp
string
Standardwert
""
Hinweise
Sie müssen dies nur angeben, wenn Sie die gespeicherte Prozedur RefreshOAuthAccessToken mit InitiateOAuth=Off ausführen. In den meisten Fällen ist der Wert dieser Eigenschaft https://accounts.zoho.com/
, aber wenn sich Ihr Konto an einem anderen Standort befindet, sollte die Domain entsprechend geändert werden (.eu, .in, .com.au, ...).
APIDomain
Die vollständige URL der API Domäne.
Datentyp
string
Standardwert
""
Hinweise
Sie müssen dies nur angeben, wenn Sie Ihr eigenes OAuth-Zugriffstoken mit InitiateOAuth=Off verwenden. Andernfalls wird die API Domäne aus dem OAuth-Flow abgerufen. In den meisten Fällen lautet der Wert dieser Eigenschaft https://www.zohoapis.com
, aber wenn sich Ihr Konto an einem anderen Standort befindet, sollte die Domain entsprechend geändert werden (.eu, .in, .com.au, ...).
MaxRows
Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.
Datentyp
int
Standardwert
-1
Hinweise
Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.
Andere
Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.
Datentyp
string
Standardwert
""
Hinweise
Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.
Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.
Integration und Formatierung
Eigenschaft | Beschreibung |
---|---|
DefaultColumnSize | Legt die Standardlänge von Zeichenfolgefeldern fest, wenn die Datenquelle keine Spaltenlänge in den Metadaten bereitstellt. Der Standardwert ist 2000. |
ConvertDateTimeToGMT | Bestimmt, ob Datums-/Uhrzeitwerte in GMT statt in die lokale Zeit des Computers konvertiert werden sollen. |
RecordToFile=filename | Protokolliert den zugrunde liegenden Socket-Datenübertragungsvorgang in die angegebene Datei. |
Seitengröße
Die maximale Anzahl der Ergebnisse, die pro Seite von Zoho Projects zurückgegeben werden sollen.
Datentyp
int
Standardwert
100
Hinweise
Der Pagesize
Die Eigenschaft beeinflusst die maximale Anzahl von Ergebnissen, die pro Seite von Zoho Projects zurückgegeben werden. Das Festlegen eines höheren Wertes kann zu einer besseren Leistung führen, allerdings auf Kosten des zusätzlichen Speichers, der pro verbrauchter Seite zugewiesen wird.
Pseudospalten
Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.
Datentyp
string
Standardwert
""
Hinweise
Diese Einstellung ist besonders hilfreich im Entity Framework, da Sie dort keinen Wert für eine Pseudospalte festlegen können, es sei denn, es handelt sich um eine Tabellenspalte. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das Zeichen „*“ verwenden, um alle Tabellen und alle Spalten einzuschließen, z. B. „*=*“.
Zeitüberschreitung
Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.
Datentyp
int
Standardwert
60
Hinweise
Wenn Timeout
= 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.
Wenn Timeout
abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.
BenutzerdefinierteAnsichten
Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.
Datentyp
string
Standardwert
""
Hinweise
Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json
. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.
Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews
Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.
Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:
- Jedes Stammelement definiert den Namen einer Ansicht.
- Jedes Stammelement enthält ein untergeordnetes Element namens
query
, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.
Zum Beispiel:
{
"MyView": {
"query": "SELECT * FROM Portals 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
Beachten Sie, dass der angegebene Pfad nicht in Anführungszeichen steht.