Zum Inhalt springen

Kintone-Verbindung

Einführung

Eine Kintone-Verbindung, die mit dem Kintone-Connector erstellt wurde, ermöglicht den Zugriff auf Kintone. Diese Aktivitäten, einmal konfiguriert, interagieren über die Verbindung mit Kintone.

Erstellen oder Bearbeiten einer Kintone-Verbindung

Eine neue Kintone-Verbindung wird mit dem Kintone-Connector von einem dieser Standorte erstellt:

Eine vorhandene Kintone-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Kintone-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Kintone-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um eine Liste der vorhandenen Variablen anzuzeigen, aus der Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Kintone-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Kintone-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • URL: Geben Sie die URL ein.

  • Authentifizierungsschema: Wählen Sie das Authentifizierungsschema aus, eines von:

    • Passwort

      • Benutzer: Geben Sie den Benutzer ein.

      • Passwort: Geben Sie das Passwort ein.

    • APIToken

      • App-ID: Geben Sie die App-ID ein.

      • API-Token: Geben Sie den API-Token ein.

    • OAuth

      • OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine von:

        • AUS

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

        • GETANDREFRESH

        • REFRESH

          • OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.

      • OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.

      • OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.

      • OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.

  • Proxy-Einstellungen verwenden: Wählen Sie aus, um die Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Eigenschaften der erweiterten Konfigurationen angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen.

    • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
    • Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie über eine Zeile im Bearbeitungsmodus fahren.
    • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie über eine Zeile im Bearbeitungsmodus fahren.
    • Bearbeiten: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paares. Sichtbar, wenn Sie über eine vorhandene Zeile fahren.
    • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie über eine vorhandene Zeile fahren.
    • Alle löschen: Löscht alle Zeilen aus der Tabelle.

    Hinweis

    Kintone-Spalten- und Tabellennamen können Sonderzeichen enthalten, die von anderen Diensten nicht unterstützt werden. Fügen Sie die Konfigurationseigenschaft UseSimpleNames hinzu und setzen Sie sie auf true, um ein Benennungsschema durchzusetzen, das auf alphanumerischen Zeichen und Unterstrichen für Spalten und Tabellen beschränkt ist. Nicht-alphanumerische Zeichen werden bei Aktivierung in Unterstriche umgewandelt.

    Wichtig

    Felder in der Tabelle Erweiterte Konfigurationseigenschaften zeigen das Variablen-Symbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

    Felder in der Tabelle Erweiterte Konfigurationseigenschaften unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird {"success": "true"}; zu {\"success\": \"true\"};.

  • Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Auto Connector Update deaktivieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Verbindung zum Kintone-Connector erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Abfrage: Ruft Datensätze aus einer Tabelle in Kintone ab und ist als Quelle in einem Vorgang vorgesehen.

  • Erstellen: Fügt einen Datensatz in eine Tabelle in Kintone ein und ist als Ziel in einem Vorgang vorgesehen.

  • Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle in Kintone und ist als Ziel in einem Vorgang vorgesehen.

  • Löschen: Löscht einen Datensatz aus einer Tabelle in Kintone und ist als Ziel in einem Vorgang vorgesehen.

  • Ausführen: Führt ein Verfahren in Kintone aus und ist als Ziel in einem Vorgang vorgesehen.