Zum Inhalt springen

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 aktualisieren OAuthAccessToken.
  • 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:

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

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

Automatische Aktualisierung des OAuth-Zugriffstokens:

Damit der Connector das OAuth-Zugriffstoken automatisch aktualisiert, gehen Sie wie folgt vor:

  1. 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.
  2. Legen Sie bei nachfolgenden Datenverbindungen Folgendes fest:
    • InitiateOAuth
    • OAuthSettingsLocation

Manuelle Aktualisierung des OAuth-Zugriffstokens:

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

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

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

Erstellen einer benutzerdefinierten OAuth-Anwendung

Erstellen einer benutzerdefinierten OAuth-Anwendung

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 Zu OAuth,
  • 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:

  1. Navigieren Sie zur Zoho Developer Console.
  2. Klicken Sie auf „Client hinzufügen“ und dann auf „Serverbasierte Anwendung“.
  3. Geben Sie den Kundennamen, die Homepage URL und die Weiterleitungs URL ein.
  4. 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.
  5. 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 Und ViewType unterstützt den folgenden Operator: =.
  • CreatedDate Und LastModifiedTime 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 Und Flag unterstützt den folgenden Operator: =.
  • ProjectId unterstützt den Operator: IN
  • CreatedDate Und LastModifiedTime 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 Und PropertyKey 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 Und CategoryId 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 Und PropertyKey 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 Und Flag 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 Und LastModifiedTime 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 Und ViewId 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:

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.

Authentifizierung

Eigenschaft Beschreibung
Region Die Top-Level-Domäne in der Server-URL.

Verbindung

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.

OAuth

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.

SSL

Eigenschaft Beschreibung
SSLServerCert Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL.

Schema

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.

Verschiedenes

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:

  1. OFF: Gibt an, dass der OAuth-Flow vollständig vom Benutzer gehandhabt wird. Zur Authentifizierung ist ein OAuthAccessToken erforderlich.
  2. 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.
  3. 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.