Kintone-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8895 des Connectors.

Erste Schritte

Unterstützung der Kintone-Version

Der Connector modelliert die Kintone REST- APIs als relationale Datenbank.

Herstellen einer Verbindung

Verbinde dich mit Kintone

Legen Sie zusätzlich zu den Authentifizierungswerten die folgenden Parameter fest, um eine Verbindung herzustellen und Daten von Kintone abzurufen:

• URL: Die URL Ihres Kontos.
• GuestSpaceId: Optional. Legen Sie dies fest, wenn Sie einen Gastbereich verwenden.

Authentifizieren Sie sich bei Kintone

Kintone unterstützt die folgenden Authentifizierungsmethoden.

Kennwortauthentifizierung

Zur Authentifizierung bei Kintone müssen Sie Folgendes festlegen:

• User: Der Benutzername Ihres Kontos.
• Password: Das Passwort Ihres Kontos.
• AuthScheme: Setzen Sie AuthScheme auf Passwort.

API Token

Zur Authentifizierung bei Kintone müssen Sie Folgendes festlegen:

• APIToken: Das API Token. Um ein API Token zu generieren, greifen Sie auf die entsprechende App zu und klicken Sie auf das Zahnrad. Gehen Sie zur Tab „App-Einstellungen“ > „API Token“. Klicken Sie auf die Schaltfläche „Generieren“, ein API Token wird generiert. Sie können auch mehrere durch Kommas getrennte API-Tokens angeben.

• AppId: Die Anwendungs-IDs.

  Die AppId ist die Nummer dieser bestimmten App in der Sequenz unter Apps im Kintone UI-Dashboard. Sie können auch mehrere durch Kommas getrennte AppIds angeben.

• AuthScheme: AuthScheme auf APIToken setzen.

Zusätzliche Sicherheit

Zusätzlich zu den genannten Authentifizierungsschemata bietet Kintone zusätzliche Sicherheit in Form eines zusätzlichen Basic Auth-Header und eines SSL-Zertifikats.

Client-SSL verwenden

Zusätzlich zu Ihren Authentifizierungsinformationen kann Kintone so konfiguriert sein, dass zum Akzeptieren von Anfragen ein SSL-Zertifikat erforderlich ist. Legen Sie dazu Folgendes fest:

• SSLClientCert: Die Datei, die das Zertifikat des SSL-Zertifikats enthält. Oder alternativ der Name des Zertifikatsspeichers für das Client-Zertifikat.
• SSLClientCertType: Der Zertifikatstyp.
• SSLClientCertSubject: (Optional) Bei der Suche nach einem Zertifikat im Zertifikatsspeicher wird der Speicher nach Subjekten durchsucht, die den Wert der Eigenschaft enthalten.
• SSLClientCertPassword: Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort zum Öffnen des Zertifikatspeichers anzugeben.

Cookies-basis

Kintone-Umgebungen, die die Basisauthentifizierung verwenden, müssen zusätzliche Basisanmeldeinformationen übergeben. Geben Sie dazu Folgendes an:

• BasicAuthUser: Der grundlegende Anmeldename.
• BasicAuthPassword: Das Basispasswort.

OAuth-Authentifizierung

Wenn Sie keinen Zugriff auf den Benutzernamen und das Passwort haben oder diese nicht anfordern möchten, verwenden Sie den OAuth-Benutzereinwilligungsablauf. Um diese Authentifizierung von allen OAuth-Abläufen aus zu aktivieren, müssen Sie festlegen AuthScheme Zu OAuth und erstellen Sie eine benutzerdefinierte OAuth-Anwendung.

In den folgenden Unterabschnitten wird beschrieben, wie Sie sich über drei gängige Authentifizierungsabläufe bei Kintone authentifizieren. Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung. Eine vollständige Liste der in Kintone verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Connection.

Desktop-Anwendungen

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

OAuth-Zugriffstoken abrufen und aktualisieren:

• InitiateOAuth: GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken.
• OAuthClientId: Die Client-ID, die Ihnen bei der Registrierung Ihrer 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.
• UseCursor: false.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Kintone 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 Kintone und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden im in angegebenen Pfad gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

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

Automatische Aktualisierung des OAuth-Zugriffstokens:

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

1. Legen Sie vor der ersten Verbindung mit Daten diese Verbindungsparameter fest:
   • InitiateOAuth: REFRESH.
   • OAuthClientId: Die Client-ID in Ihren benutzerdefinierten OAuth-Anwendungseinstellungen.
   • OAuthClientSecret: Das Client-Geheimnis in Ihren benutzerdefinierten OAuth-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.
   • UseCursor: false.
2. Bei nachfolgenden Datenverbindungen setzen Sie:
   • InitiateOAuth
   • OAuthSettingsLocation

Manuelle Aktualisierung des OAuth-Zugriffstokens:

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

1. Um das OAuthAccessToken nach dem ExpiresIn-Zeitraum (zurückgegeben von GetOAuthAccessToken manuell zu aktualisieren) abgelaufen ist, rufen Sie den RefreshOAuthAccessToken gespeicherte Prozedur.
2. Legen Sie diese Verbindungseigenschaften fest:
   • OAuthClientId: Die Client-ID in Ihren benutzerdefinierten OAuth-Anwendungseinstellungen.
   • OAuthClientSecret: Das Client Secret in Ihren benutzerdefinierten OAuth-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

Wenn Sie keinen Zugriff auf den Benutzernamen und das Passwort haben oder diese nicht anfordern möchten, können Sie die OAuth-Authentifizierung verwenden. Kintone verwendet den OAuth-Authentifizierungsstandard, der erfordert, dass der authentifizierende Benutzer über den Browser mit Kintone interagiert. Die Authentifizierung über OAuth erfordert die Verwendung der OAuth-Clientanmeldeinformationen, der Client-ID und des Clientgeheimnisses.

So registrieren Sie eine benutzerdefinierte OAuth-Anwendung und erhalten die OAuth-Clientanmeldeinformationen, die Client-ID und das Clientgeheimnis:

1. Melden Sie sich bei Kintone an und navigieren Sie zu User & System Administration Seite.
2. Klicken Sie auf OAuth unter System Administration.
3. Klicken Sie auf das grüne Add OAuth Client button unter Set up Advanced Services.
4. Geben Sie die Details des OAuth-Clients ein.
5. Geben Sie einen Wert für die der Anwendung ein Redirect URI:
   • Wenn Sie eine Desktop-Anwendung erstellen, setzen Sie die Callback-URL auf http://localhost:33333 oder eine andere Port Ihrer Wahl.
   • Wenn Sie eine Webanwendung erstellen, legen Sie die Rückruf-URL auf eine Seite Ihrer Webanwendung fest, zu der der Benutzer nach der Autorisierung Ihrer Anwendung zurückgeleitet werden soll.
6. Wenn Sie alle erforderlichen Felder ausgefüllt haben, klicken Sie auf Save.

Aktivierte Anwendungen werden in der Liste angezeigt und der Vorgang wird abgeschlossen.

Die OAuthClientID und das ClientSecret werden zusammen mit den Informationen angezeigt, die Sie beim Einrichten der Anwendung angegeben haben. Notieren Sie die OAuthClientID und das ClientSecret für die zukünftige Verwendung.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Kintone-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

Proxy

So konfigurieren Sie den Connector mithilfe von privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Kintone und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Kintone-Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Comments WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

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

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

Definieren von Ansichten mit DDL-Anweisungen

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

Erstellen einer Ansicht

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

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

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

Ändern einer Ansicht

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

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

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

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

DROP LOCAL VIEW [MyViewName]

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

Schema für benutzerdefinierte Ansichten

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

Arbeiten mit benutzerdefinierten Ansichten

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

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

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

Daraus ergibt sich die effektive Abfrage an die Quelle:

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

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

Datenmodell

Der Connector modelliert die Kintone API als relationale Tabellen, Ansichten und Gespeicherte Prozeduren.

Tabellen

Mit dem Connector können Sie mit allen Tabellen in Ihrem Konto arbeiten. Die Tabellenschemata können statisch oder dynamisch sein. Die Tabelle „Kommentare“ hat ein statisches Schema mit festen Spalten, während andere Tabellen dynamisch sind und Änderungen in den Metadaten widerspiegeln. Wenn Sie eine Verbindung herstellen, ruft der Connector Tabellenmetadaten von Kintone ab, um die Tabellenschemata zu generieren.

Statische Schemata werden in Schema definiert, wodurch sie leicht erweiterbar sind. Bearbeiten Sie die Schema, um das Spaltenverhalten der statischen Kommentartabelle anzupassen, beispielsweise um den Datentyp zu ändern. Die Schema befinden sich im Unterordner db des Connector-Installationsordners.

Untertabellen

In einigen Kintone-Apps kann der Benutzer benutzerdefinierte Felder mit vielen Datensätzen hinzufügen. Der Connector modelliert diese Felder als dynamische Untertabellen, die Ihre Änderungen widerspiegeln.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Kintone. Sie können zum Suchen, Aktualisieren und Ändern von Informationen verwendet werden

in Kintone. Verwenden Sie beispielsweise gespeicherte Prozeduren, um Vorgänge an Apps auszuführen oder mit Dateien zu arbeiten.

Ansichten

Der Connector modelliert Apps in der statischen Apps-Ansicht.

Tabellen

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

Kintone Anschlusstabellen

Aktionseinstellungen

Aktualisieren und fragen Sie die verfügbaren Aktionseinstellungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ActionSettings WHERE AppId = 6
SELECT * FROM ActionSettings WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ActionSettings WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die ActionSettings zu aktualisieren, geben Sie die Aktionen als Aggregat an. Die Spalte AppId ist erforderlich, um die ActionSettings zu aktualisieren.

UPDATE ActionSettings SET Actions = '{"Action_Z":{"name":"Action_A","index":"0"}}' WO AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

App-Berechtigungen

Aktualisieren und fragen Sie die App-Berechtigungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM AppPermissions WHERE AppId = 6
SELECT * FROM AppPermissions WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die AppPermissions zu aktualisieren, geben Sie die Rechte als Aggregat an. Die Spalten AppId und IsPreview sind erforderlich, um die AppPermissions zu aktualisieren.

UPDATE AppPermissions SET Rights = '[{"entity":{"type":"CREATOR"},"appEditable":true,"recordViewable":true,"recordAddable":true,"recordEditable":true,"recordDeletable":true,"recordImportable":true,"recordExportable":true}]' WHERE AppId = 6 AND IsPreview = true

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kommentare

Fragen Sie die verfügbaren Kommentare in Kintone ab.

Wählen

Die Spalten RecordId und AppId sind in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach diesen Spalten zu filtern. Die Kintone APIs unterstützen auch Filter für die ID. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Comments WHERE RecordId = 1 AND AppId = 5 AND ID = 1

Einfügen

Die Spalten AppId und RecordId sind in der INSERT-Anweisung erforderlich.

INSERT INTO Comments (AppId, RecordId, Text, MentionsAggregate) VALUES (5, 1, 'To do', '[{"code": "Administrator","type": "USER"}]')

Löschen

Kommentare können durch Ausführen einer DELETE-Anweisung und Angabe von RecordId, AppId und Id gelöscht werden.

DELETE FROM Comments WHERE RecordId = 1 AND AppId = 5 AND ID = 1

Spalten

Feldberechtigungen

Aktualisieren und fragen Sie die verfügbaren Feldberechtigungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM FieldPermissions WHERE AppId = 6
SELECT * FROM FieldPermissions WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die FieldPermissions zu aktualisieren, geben Sie die Rechte als Aggregat an. Die Spalten AppId und IsPreview sind erforderlich, um die FieldPermissions zu aktualisieren.

UPDATE FieldPermissions SET Rights = 'Update FieldPermissions set Rights='[{"code":"Updated_by","entities":[{"accessibility":"READ","entity":{"type":"GROUP","code":"everyone"}}]}]' WO AppId = 6 UND IsPreview = true

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Formularfelder

Erstellen, aktualisieren, löschen und Abfrage die Formularfelder in Kintone.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM FormFields WHERE AppId = 6
SELECT * FROM FormFields WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM FormFields WHERE AppId = 6 AND IsPreview = false

Einfügen

Die Spalten AppId, Type, Code und Label sind in der INSERT-Anweisung erforderlich.

INSERT INTO FormFields (AppId, Type, Code, Label) VALUES (6, 'SINGLE_LINE_TEXT', 'Text__single_line_CRUD', 'Test')

Das Einfügen kann auch ausgeführt werden, indem die AppId-Spalte und die Eigenschaftenspalte als JSON-Aggregat bereitgestellt werden:

INSERT INTO FormFields (AppId, Properties) VALUES (6, '{"Text__single_line_TD":{"type":"SINGLE_LINE_TEXT","code":"Text__single_line_TD","label":"Test"}}')

The Kintone API supports Bulk Insert as well:

INSERT INTO FormFields#TEMP (AppId, Typ, Code, Label) VALUES (6, 'SINGLE_LINE_TEXT', 'Text__single_line_temp1', 'Label1')
INSERT INTO FormFields#TEMP (AppId, Typ, Code, Label) VALUES (6, 'SINGLE_LINE_TEXT', 'Text__single_line_temp2', 'Label2')
INSERT INTO FormFields (AppId, Typ, Code, Label) SELECT AppId, Typ, Code, Label FROM FormFields#TEMP

Aktualisieren

Um die Formularfelder zu aktualisieren, geben Sie die Eigenschaften als Aggregat an. Die Spalte „AppId“ ist erforderlich, um die Formularfelder zu aktualisieren.

UPDATE FormFields SET Properties = '{"Text__single_line_TT":{"code":"Text__single_line_PT","label":"text","type":"SINGLE_LINE_TEXT"}}' WO AppId = 6

Löschen

Sie müssen die durch Kommas getrennten Werte der Codespalte angeben, die Sie löschen möchten. Die AppId-Spalte wird zum Löschen der Formularfelder benötigt.

DELETE FROM FormFields WHERE Code = 'Text__single_line_CRUD, Text__single_line_TD' AND AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Formularlayout

Aktualisieren und fragen Sie das verfügbare Formularlayout in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM FormLayout WHERE AppId = 6
SELECT * FROM FormLayout WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM FormLayout WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um das FormLayout zu aktualisieren, geben Sie das Layout als Aggregat an. Alle Felder im Formular müssen im Aggregat angegeben werden. Die Spalte AppId ist erforderlich, um das FormLayout zu aktualisieren.

UPDATE FormLayout SET Layout = '[{"type":"ROW","fields":[{"type":"SPACER","code":"Table_0","size":{"width":"200"}}]}]' WO AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AllgemeineBenachrichtigungen

Aktualisieren und fragen Sie die verfügbaren GeneralNotifications in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM GeneralNotifications WHERE AppId = 6
SELECT * FROM GeneralNotifications WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die allgemeinen Benachrichtigungen zu aktualisieren, geben Sie die Benachrichtigungen als Aggregat an. Die Spalte AppId ist erforderlich, um die allgemeinen Benachrichtigungen zu aktualisieren.

UPDATE GeneralNotifications SET Notifications = '[{"entity":{"type":"FIELD_ENTITY","code":"Updated_by"},"includeSubs":false,"recordAdded":false,"commentAdded":true}],"notifyToCommenter":true' WHERE AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AllgemeineEinstellungen

Aktualisieren und Abfragen der allgemeinen Einstellungen in Kintone.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM GeneralSettings WHERE AppId = 6
SELECT * FROM GeneralSettings WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Sie müssen die AppId und den IconKey der zu aktualisierenden GeneralSetting angeben.

UPDATE GeneralSettings SET Name = 'UpdatedName', Description = 'Test Description', IconType = 'PRESET', IconKey = 'APP72' WHERE IconKey = 'APP72' AND AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

GraphEinstellungen

Aktualisieren und fragen Sie die verfügbaren Grapheinstellungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM GraphSettings WHERE AppId = 6
SELECT * FROM GraphSettings WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM GraphSettings WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die GraphSettings zu aktualisieren, stellen Sie die Berichte als Aggregat bereit. Die Spalte AppId ist erforderlich, um die GraphSettings zu aktualisieren.

UPDATE GraphSettings SET Reports = '{"Graph1":{"chartType":"BAR","chartMode":"PERCENTAGE","name":"Updated_Graph_Name","index":"0","groups":[{"code":"Created_by"}]}}' WO AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

PerRecordNotifications

Aktualisieren und fragen Sie die verfügbaren PerRecord-Benachrichtigungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PerRecordNotifications WHERE AppId = 6
SELECT * FROM PerRecordNotifications WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM PerRecordNotifications WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die PerRecordNotifications zu aktualisieren, geben Sie die Benachrichtigungen als Aggregat an. Die Spalte AppId ist erforderlich, um die PerRecordNotifications zu aktualisieren.

UPDATE PerRecordNotifications SET Notifications = '[{"filterCond":"Record_number = 18","title":"Test Title","targets":[{"entity":{"type":"FIELD_ENTITY","code":"Created_by"},"includeSubs":false}]}]' WHERE AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ProzessManagement

Aktualisieren und Abfragen des Prozessmanagements in Kintone.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProcessManagement WHERE AppId = 6
SELECT * FROM ProcessManagement WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ProcessManagement WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um das Prozessmanagement zu aktualisieren, geben Sie die Zustände und Aktionen als Aggregat an. Die Spalte AppId ist erforderlich, um das Prozessmanagement zu aktualisieren.

UPDATE ProcessManagement SET Enable = true, States = '{"In progress":{"name":"In progress","index":"1","assignee":{"type":"ONE","entities":[]}},"Bereit":{"name":"Bereit","index":"3","assignee":{"type":"ONE","entities":[]}},"Completed":{"name":"Completed","index":"2","assignee":{"type":"ONE","entities":[]}},"Nicht gestartet":{"name":"Nicht gestartet","index":"0","assignee":{"type":"ONE","entities":[{"entity":{"type":"FIELD_ENTITY","code":"Created_by"},"includeSubs":false}]}}}', Actions = '[{"name":"Start","from":"Not started","to":"In progress","filterCond":""},{"name":"Complete","from":"Completed","to":"Completed","filterCond":""}]' WHERE AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Datensatzberechtigungen

Aktualisieren und fragen Sie die verfügbaren RecordPermissions in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM RecordPermissions WHERE AppId = 6
SELECT * FROM RecordPermissions WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM RecordPermissions WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die AppPermissions zu aktualisieren, geben Sie die Rechte als Aggregat an. Die Spalten AppId und IsPreview sind erforderlich, um die RecordPermissions zu aktualisieren.

UPDATE RecordPermissions SET Rights = '[{"filterCond":"","entities":[{"entity":{"type":"GROUP","code":"everyone"},"viewable":false,"editable":false,"deletable":false,"includeSubs":true}]}]' WHERE AppId = 6 AND IsPreview = true

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ErinnerungBenachrichtigungen

Aktualisieren und fragen Sie die verfügbaren Erinnerungsbenachrichtigungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ReminderNotifications WHERE AppId = 6
SELECT * FROM ReminderNotifications WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ReminderNotifications WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die Erinnerungsbenachrichtigungen zu aktualisieren, geben Sie die Benachrichtigungen als Aggregat an. Die Spalte AppId ist erforderlich, um die Erinnerungsbenachrichtigungen zu aktualisieren.

UPDATE ReminderNotifications SET Notifications = '[{"timing":{"code":"Updated_datetime","daysLater":-2,"hoursLater":-5},"filterCond":"Record_number = 14","title":"Reminder: Tomorrow is the deadline.","targets":[{"entity":{"type":"FIELD_ENTITY","code":"Created_by"},"includeSubs":false}]}]' WHERE AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Raum

Erstellen, aktualisieren, löschen und abfragen Sie den verfügbaren Speicherplatz in Kintone.

Wählen

Die ID-Spalte ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Space WHERE ID = 7

Einfügen

Die Spalten SpaceTemplateID, Name und Members sind in der INSERT-Anweisung erforderlich.

INSERT INTO Space(SpaceTemplateID, Name, Members) Values(1, 'New_Space', '[{"entity":{"type":"USER","code":"cdataarc.handson@gmail.com"},"isAdmin":true}]')

Aktualisieren

Die ID-Spalte wird benötigt, um den Space zu aktualisieren.

UPDATE Space SET body='Space Body' WHERE ID = 16

Löschen

Die ID-Spalte wird benötigt, um den Space zu löschen.

DELETE FROM Space WHERE ID = 16

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

RaumMitglieder

Aktualisieren und fragen Sie die verfügbaren Space-Mitglieder in Kintone ab.

Wählen

Die ID-Spalte ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM SpaceMembers WHERE ID = 1

Aktualisieren

Um die SpaceMembers zu aktualisieren, geben Sie die Spalte „Members“ als Aggregat an. Die Spalte „ID“ ist erforderlich, um die SpaceMembers zu aktualisieren.

UPDATE SpaceMembers SET Members='[{"entity":{"type":"USER","code":"cdataarc.handson@gmail.com"},"isAdmin":true}]' WHERE ID = 1

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ansichten

Aktualisieren und fragen Sie die verfügbaren Ansichten in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Views WHERE AppId = 6
SELECT * FROM Views WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM Views WHERE AppId = 6 AND IsPreview = false

Aktualisieren

Um die Ansichten zu aktualisieren, geben Sie die Ansichten als Aggregat an. Ansichtsnamen, die nicht im Aggregat angegeben sind, werden gelöscht. Die Spalte AppId ist zum Aktualisieren der Ansichten erforderlich.

UPDATE VIEWS SET Views = '{"(Assigned to me)":{"index":0,"type":"LIST","name":"(Assigned to me)","filterCond":"Assignee in (LOGINUSER())","sort":"Record_number asc"},"subTableTest2":{"index":1,"type":"CALENDAR","name":"subTableTest","date":"Updated_datetime","filterCond":"","sort":"Record_number asc"}}' WO AppId = 6

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Kintone Connector-Ansichten

AktionEinstellungenEntitäten

Fragen Sie die verfügbaren Aktionseinstellungselemente in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ActionSettingsEntities WHERE AppId = 6
SELECT * FROM ActionSettingsEntities WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ActionSettingsEntities WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Aktionseinstellungszuordnungen

Fragen Sie die verfügbaren Aktionseinstellungszuordnungen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ActionSettingsMappings WHERE AppId = 6
SELECT * FROM ActionSettingsMappings WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ActionSettingsMappings WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Apps

Fragen Sie die verfügbaren Apps in Kintone ab.

Wählen

Standardmäßig verwendet der Connector die Kintone APIs, um Suchkriterien zu verarbeiten, die sich auf die folgenden Spalten beziehen, und verarbeitet andere Filter clientseitig innerhalb des Connectors: Die Kintone API unterstützt Suchvorgänge in den Spalten AppId, Code und SpaceId. Diese Spalten unterstützen die serverseitige Verarbeitung der Operatoren = und IN, während die Spalte Name nur den Operator LIKE unterstützt. Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Apps WHERE AppId IN (20, 21, 51, 56) AND Name LIKE '%To Do%'

Spalten

FeldberechtigungenEntitäten

Fragen Sie die Feldberechtigungsentitäten in kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM FieldPermissionsEntities WHERE AppId = 6
SELECT * FROM FieldPermissionsEntities WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

FormularLayoutFelder

Fragen Sie die verfügbaren Formularlayoutfelder in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM FormLayoutFields WHERE AppId = 6
SELECT * FROM FormLayoutFields WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM FormLayoutFields WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

PerRecordNotificationsTargets

Fragen Sie die PerRecord-Benachrichtigungsziele in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PerRecordNotificationsTargets WHERE AppId = 6
SELECT * FROM PerRecordNotificationsTargets WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM PerRecordNotificationsTargets WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ProzessManagementAktionen

Fragen Sie die Prozessmanagementaktionen in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProcessManagementActions WHERE AppId = 6
SELECT * FROM ProcessManagementActions WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ProcessManagementActions WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

DatensatzberechtigungenEntities

Fragen Sie die verfügbaren Datensatzberechtigungseinheiten in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM RecordPermissionsEntities WHERE AppId = 6
SELECT * FROM RecordPermissionsEntities WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM RecordPermissionsEntities WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ErinnerungBenachrichtigungenZiele

Fragen Sie die verfügbaren Erinnerungsbenachrichtigungsziele in Kintone ab.

Wählen

Die Spalte AppId ist in der WHERE-Klausel erforderlich. Der Connector verwendet die Kintone APIs, um die Ergebnisse nach dieser Spalte zu filtern. Standardmäßig verarbeitet der Connector andere Filter clientseitig innerhalb des Connectors.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ReminderNotificationsTargets WHERE AppId = 6
SELECT * FROM ReminderNotificationsTargets WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM ReminderNotificationsTargets WHERE AppId = 6 AND IsPreview = false

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

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

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

Gespeicherte Prozeduren für den Kintone Connector

Gäste hinzufügen

Fügt Gastbenutzer zu Kintone hinzu. Dadurch werden Gastbenutzer keinem Gastbereich zugeordnet und es werden keine Einladungs-Emails gesendet. Um einen Gastbenutzer einem Gastbereich zuzuordnen, verwenden Sie die gespeicherte Prozedur AddGuestsToSpace. Nur Kintone-Administratoren können diese API verwenden.

Gespeicherte Prozedurspezifische Informationen

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

Insert into GuestsAggregate#TEMP(Name, Code, Password, Timezone) Values('Jack', 'jack@gmail.com', '#jack@123', 'America/Los_Angeles')
Insert into GuestsAggregate#TEMP(Name, Code, Password, Timezone) Values('Geeky', 'geeky@gmail.com', '#geeky@321', 'America/Los_Angeles')
EXECUTE AddGuests GuestsAggregate = 'GuestsAggregate#TEMP'

Die zweite Möglichkeit, die gespeicherte Prozedur zu verwenden, besteht darin, das Aggregat selbst hinzuzufügen:

EXECUTE AddGuests GuestsAggregate = '[{"code":"ax@example.com","password":"#abcd@123","timezone":"America/Los_Angeles","locale":"en","name":"John Doe","company":"Company Name","division":"Sales","callto":"skypecallto"}]'

Eingang

Ergebnissatzspalten

Gäste zum Platz hinzufügen

Fügen Sie die Gastbenutzer mit einem Gastbereich hinzu. Nur der Administrator des Gastbereichs kann diese API verwenden.

Gespeicherte Prozedurspezifische Informationen

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

EXECUTE AddGuestsToSpace GuestSpaceId = '6', Guests = '["jackd@gmail.com","yogesh@gmail.com","harshm@gmail.com"]'

Eingang

Ergebnissatzspalten

Thread-Kommentar hinzufügen

Fügt einem Thread eines Spaces einen Kommentar hinzu.

Gespeicherte Prozedurspezifische Informationen

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

EXECUTE AddThreadComment SpaceId = 8, ThreadId = 8, Text = 'Test Comment'

Eingang

Ergebnissatzspalten

AppsDeployStatus

App-Bereitstellungsstatus abrufen.

Eingang

Ergebnissatzspalten

App erstellen

Erstellt Apps.

Eingang

Ergebnissatzspalten

Gäste löschen

Löscht einen Gastbenutzer aus Kintone. Nur Kintone-Administratoren können diese API verwenden.

Gespeicherte Prozedurspezifische Informationen

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

Geben Sie zum Löschen der Gäste die durch Kommas getrennten Werte der Gäste ein.

EXECUTE DeleteGuests Guests = '["jackd@gmail.com","harshm@gmail.com"]'

Eingang

Ergebnissatzspalten

Bereitstellen von Apps

Stellt Apps bereit.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für das Verfahren.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Um mehrere Instanzen eines indexierten Parameters wie diesen einzugeben, führen Sie Folgendes aus:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

In der folgenden Tabelle sind indexierte Parameter mit einem gekennzeichnet #-Zeichen am Ende ihrer Namen.

Eingang

Ergebnissatzspalten

Datei herunterladen

Lädt Dateien aus einem Anhangsfeld in einer App herunter.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Asana ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

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

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert den OAuth-Zugriffstoken, der für die Authentifizierung bei Asana verwendet wird.

Eingang

Ergebnissatzspalten

Bevollmächtigte aktualisieren

Aktualisiert Beauftragte.

Eingang

Ergebnissatzspalten

UpdateStatus

Aktualisiert den Status eines App-Datensatzes.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für das Verfahren.

Nehmen wir an, es gibt einen Eingabeparameter mit dem Namen Param#. Um mehrere Instanzen eines indexierten Parameters wie diesen einzugeben, führen Sie Folgendes aus:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

In der folgenden Tabelle sind indexierte Parameter mit einem gekennzeichnet #-Zeichen am Ende ihrer Namen.

Eingang

Ergebnissatzspalten

UpdateThread

Aktualisiert einen Thread eines Spaces.

Gespeicherte Prozedurspezifische Informationen

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

EXECUTE UpdateThread ThreadId = 13, Name = 'Test Thread', Body = 'This is for testing'

Eingang

Ergebnissatzspalten

Datei hochladen

Lädt ein Dokument in Kintone hoch.

Eingang

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für Kintone zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück, einschließlich Charge:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Kommentare“ zurück:

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

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur DownloadFile zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='DownloadFile' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Tabelle „Kommentare“ ab:

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

Spalten

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Sys_primarykeys

Beschreibt die Primärschlüssel.

Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:

SELECT * FROM sys_primarykeys

Spalten

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

Sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:kintone: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

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.

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

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

Systeminformationen

Beschreibt die verfügbaren Systeminformationen.

Die folgende Abfrage ruft alle Spalten ab:

SELECT * FROM sys_information

Spalten

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

OAuth

SSL

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

AuthScheme

Ob die Verbindung zu Kintone mit Benutzer/Passwort oder APIToken oder OAuth hergestellt werden soll.

Mögliche Werte

Password, APIToken, OAuth

Datentyp

string

Standardwert

Password

Hinweise

• Passwort: Legen Sie dies fest, um eine Passwortauthentifizierung durchzuführen.

• APIToken: Legen Sie dies fest, um eine APIToken-Authentifizierung durchzuführen.

• OAuth: Legen Sie dies fest, um eine OAuth 2.0-Authentifizierung durchzuführen.

URL

Die Kintone URL. Beispiel: https://SUBDOMAIN_NAME.cybozu.com.

Datentyp

string

Standardwert

""

Hinweise

Die Kintone URL. Beispiel:

https://SUBDOMAIN_NAME.cybozu.com

Benutzer

Das zur Authentifizierung verwendete Kintone-Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, dieses Feld wird zur Authentifizierung gegenüber dem Kintone-Server verwendet.

Passwort

Das zur Authentifizierung des Benutzers verwendete Passwort.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer Und Password werden zusammen zur Authentifizierung beim Server verwendet.

Basisauthentifzierung

Der zusätzliche Benutzername, der für Domänen mit Basisauthentifizierung erforderlich ist.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzername für die Basisauthentifizierung, der für die Verbindung mit Domänen mit aktivierter Basisauthentifizierung verwendet wird. Die Basisauthentifizierung bietet eine doppelte Authentifizierung: Wenn Sie eine Verbindung mit einer Domäne mithilfe der Basisauthentifizierung herstellen, setzen Sie BasicAuthUser und BasicAuthPassword zusätzlich zu Benutzer und Passwort.

Grundlegendes Auth-Passwort

Das zusätzliche Passwort, das für Domänen mit Basisauthentifizierung erforderlich ist.

Datentyp

string

Standardwert

""

Hinweise

Das grundlegende Authentifizierungskennwort, das zum Herstellen einer Verbindung mit Domänen mit aktivierter grundlegender Authentifizierung verwendet wird. Die grundlegende Authentifizierung bietet eine doppelte Authentifizierung: Wenn Sie eine Verbindung mit einer Domäne mithilfe der grundlegenden Authentifizierung herstellen, legen Sie BasicAuthUser fest Und BasicAuthPassword zusätzlich zu Benutzer und Passwort.

AppId

Die AppId, die zusammen mit dem APIToken zur Authentifizierung verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Die AppId ist die Nummer dieser bestimmten App in der Sequenz unter Apps im Kintone UI-Dashboard.

Sie können auch mehrere durch Kommas getrennte AppIds angeben.

APIToken

Der zur Authentifizierung verwendete APIToken.

Datentyp

string

Standardwert

""

Hinweise

Das zur Authentifizierung verwendete API-Token. So erstellen Sie ein API Token: Rufen Sie die jeweilige App auf, für die Sie die API Token erstellen möchten, und klicken Sie auf das Zahnrad. Gehen Sie zur Tab „App-Einstellungen“ > „API -Token“ > klicken Sie auf die Schaltfläche „Generieren“. Ein API Token wird generiert.

Sie können bei Vorgängen mit Nachschlagefeldern oder zugehörigen Datensatzfeldern auch mehrere durch Kommas getrennte API-Tokens angeben.

OAuth

Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.

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%\Kintone 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_propsSystemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.

Der Standardspeicherort ist „%APPDATA%\ Kintone 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:

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.

SSLClientCert

Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL).

Datentyp

string

Standardwert

""

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat.

Der SSLClientCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an SSLClientCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSLClientCertPassword an.

SSLClientCert wird in Verbindung mit SSLClientCertSubject verwendet, um Client-Zertifikate anzugeben. Wenn SSLClientCert hat einen Wert und SSLClientCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Siehe SSLClientCertSubject für weitere Informationen.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei gesetzt werden (z. B. PKCS12-Zertifikatsspeicher).

SSLClientCertType

Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

USER

Hinweise

Diese Eigenschaft kann einen der folgenden Werte annehmen:

SSLClientCertPassword

Das Passwort für das TLS/SSL-Client-Zertifikat.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort zum Öffnen des Zertifikatspeichers anzugeben.

SSLClientCertSubject

Der Betreff des TLS/SSL-Client-Zertifikats.

Datentyp

string

Standardwert

*

Hinweise

Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.

Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten. Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.

Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Beispiel: „CN=www.server.com, OU=test, C=US, E=support@company.com“. Die allgemeinen Felder und ihre Bedeutungen werden unten angezeigt.

Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

Schema

Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\Kintone 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 Die Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen (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%\ Kintone Data Provider\Schema" mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

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.

Sonderzeichen zulassen

Bestimmt, ob Sonderzeichen zulässig sind oder nicht. Wenn dies der Fall ist, werden Sonderzeichen nicht ersetzt.

Datentyp

bool

Standardwert

false

Hinweise

Bestimmt, ob Sonderzeichen zulässig sind oder nicht. Wenn dies der Fall ist, werden Sonderzeichen nicht ersetzt.

CheckForSubtablesIn

Eine durch Kommas getrennte Liste von Kintone-Apps, aus denen Untertabellen abgerufen werden sollen.

Datentyp

string

Standardwert

*

Hinweise

Setzen Sie dieses Feld auf *, um in allen Kintone Apps nach Untertabellen zu suchen. Setzen Sie dieses Feld auf „Keine“, um nicht nach Untertabellen zu suchen. Kintone-Untertabellen werden als separate Tabellen angezeigt und das Abrufen der Liste aller Untertabellen aus der API ist ein zeitaufwändiger Operation. Indem Sie in diesem Feld nur einige App-Namen angeben, erhöht sich die Leistung des Connectors. Sie können dieses Feld auch auf * setzen, um in allen Kintone-Apps nach Untertabellen zu suchen. Beachten Sie jedoch, dass das Auflisten der Tabellen bei einer großen Anzahl von Apps viel länger dauert.

Gastbereichs-ID

Beschränken Sie die Abfrage auf einen Gastbereich.

Datentyp

string

Standardwert

""

Hinweise

Diese Verbindungseigenschaft beschränkt die Abfrage auf den angegebenen Gastbereich.

Sie finden die GuestSpaceId vom Connector in der Spalte „SpaceId“ der Tabelle „Apps“. Oder rufen Sie die GuestSpaceId aus der URL ab, wenn Sie zum erstellten Bereich navigieren. In der folgenden URL wäre die GuestSpaceId beispielsweise „3“:

https://xlqc1.cybozu.com/k/guest/3/#/space/3/thread/3

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.

NumberMapToDouble

Bestimmt, ob der Datentyp von Zahlenfeldern von Dezimal auf Double geändert werden soll oder nicht.

Datentyp

bool

Standardwert

false

Hinweise

Bestimmt, ob der Datentyp von Zahlenfeldern von Dezimal auf Double geändert werden soll oder nicht. Wenn „true“, wird der Datentyp von Dezimal auf Double geändert.

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

Seitengröße

Die maximale Anzahl der Ergebnisse, die pro Seite von Kintone zurückgegeben werden sollen.

Datentyp

int

Standardwert

500

Hinweise

Der Pagesize Die Eigenschaft beeinflusst die maximale Anzahl von Ergebnissen, die pro Seite von Kintone 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. „*=*“.

Untertabellentrennzeichen

Das zum Trennen von Tabellen und Untertabellen verwendete Zeichen im Format Tabellenname + Zeichen + Untertabelle.

Datentyp

string

Standardwert

_

Hinweise

Wenn eine App eine Untertabelle hat, wird diese als separate Tabelle dargestellt. Ihr Name lautet AppName + Untertabellentrennzeichen + Untertabellenname. Verwenden Sie diese Eigenschaft, um ein benutzerdefiniertes Zeichen als Trennzeichen festzulegen und Untertabellen einfach von Apps zu unterscheiden. Mit dieser Eigenschaft können Sie verschiedene Sonderzeichen im Namen der Untertabelle festlegen, ohne die Namenskonventionen Ihrer App zu verletzen.

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.

CodeFürFeldnameVerwenden

Bestimmt, ob für den Feldnamen eine Bezeichnung oder ein Code verwendet werden soll.

Datentyp

bool

Standardwert

false

Hinweise

Wenn wahr, wird Code für Feldname verwendet.

Verwenden Sie den Cursor

Boolescher Wert, der bestimmt, ob Cursor zum Abrufen von Datensätzen verwendet werden sollen.

Datentyp

bool

Standardwert

true

Hinweise

Boolescher Wert, der bestimmt, ob Cursor zum Abrufen von Datensätzen verwendet werden sollen.

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

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

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

Beachten Sie, dass der angegebene Pfad nicht in Anführungszeichen steht.

UseSimpleNames

Boolescher Wert, der bestimmt, ob einfache Namen für Tabellen und Spalten verwendet werden sollen.

Datentyp

bool

Standardwert

false

Hinweise

Kintone-Tabellen und-Spalten können Sonderzeichen in Namen verwenden, die in Standarddatenbanken normalerweise nicht zulässig sind. UseSimpleNames macht den Connector mit herkömmlichen Datenbanktools einfacher zu verwenden.

Einstellung UseSimpleNames auf true vereinfacht die Namen der zurückgegebenen Tabellen und Spalten. Es wird ein Benennungsschema erzwungen, sodass nur alphanumerische Zeichen und der Unterstrich für die angezeigten Tabellen- und Spaltennamen gültig sind. Alle nicht alphanumerischen Zeichen werden in einen Unterstrich umgewandelt.

EinheitFürNumerischesFeldVerwenden

Bestimmt, ob die Einheit mit dem Feldnamen angezeigt werden soll.

Datentyp

bool

Standardwert

true

Hinweise

Wenn auf „false“ gesetzt, wird die Einheit nicht mit dem Feldnamen angezeigt.