> For the complete documentation index, see [llms.txt](https://docs.ninox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ninox.com/builder-hub/de/manage-your-organization-and-workspace/organize-your-workspace/api-and-connections/manage-workspace-level-connections.md). # Verbindungen auf Arbeitsbereichsebene verwalten Verbinde externe Systeme mit deinem Arbeitsbereich und verwalte ihre Funktionen. Konnektoren verbinden deinen Arbeitsbereich mit unterstützten externen Systemen. Du kannst ihre Fähigkeiten in Ninox Skript verwenden, um Daten zu lesen und zu schreiben. {% hint style="info" %} Ein Konnektor ist nur in dem Arbeitsbereich verfügbar, in dem du ihn erstellst. Organisationweite Konnektoren erstellst und verwaltest du unter [Organisationsweite Verbindungen verwalten.](/builder-hub/de/manage-your-organization-and-workspace/manage-your-organization/manage-organization-wide-connections.md) {% endhint %} Unterstützte Konnektoren sind beispielsweise Google Sheets, Microsoft Excel, Lexware Office, sevdesk, weclapp, Xentral und Sage Accounting. Du kannst auch einen eigenen, benutzerdefinierten Konnektor erstellen. {% hint style="info" %} Die Verfügbarkeit und Limits von Konnektoren hängen von deinem Plan ab. Öffne in den Organisationseinstellungen **Abonnement und Nutzung**, um die Anzahl der **Verbindungen** und **Konnektoraufrufe** zu prüfen. {% endhint %} {% hint style="warning" %} Ein Konnektor im Arbeitsbereich kann Daten des verbundenen Systems für alle verfügbar machen, die Skripte in diesem Arbeitsbereich ausführen können. Verbinde nur Accounts mit Daten, auf die alle relevanten Nutzer im Arbeitsbereich zugreifen dürfen. {% endhint %} ### Einen Konnektor erstellen Erstelle einen Konnektor in den Einstellungen des Arbeitsbereichs oder direkt in einer App. {% tabs %} {% tab title="Über die Arbeitsbereichseinstellungen" %} {% stepper %} {% step %} #### Verbindungen öffnen Öffne **Einstellungen** in der Hauptnavigation. Wähle unter **ARBEITSBEREICH** **API und Verbindungen**. Wähle den Tab **Verbindungen**. {% endstep %} {% step %} #### Verbindung starten Klicke auf **+Verbindung erstellen**. Wähle den Konnektor für das externe System aus, das du verbinden möchtest. {% endstep %} {% step %} #### Externes System verbinden Klicke auf **Verbinden**. Gib einen **Verbindungsnamen** ein und vervollständige die erforderliche Einrichtung für das ausgewählte System. Klicke erneut auf **Verbinden**, um die Einrichtung abzuschließen. {% endstep %} {% endstepper %} {% endtab %} {% tab title="Über eine App" %} {% stepper %} {% step %} #### Erstellungsmenü öffnen Öffne die App, in der du den Konnektor verwenden möchtest. Klicke auf den Pfeil neben **Tabelle erstellen**. Alternativ klickst du in der Top-Bar auf :ellipsis-vertical: **Mehr**. {% endstep %} {% step %} #### Konnektor auswählen Wähle zunächst **Live-Daten verbinden**. Wähle dann **Google Sheets** oder **Microsoft Excel**. Wähle **Weitere Verbindungen**, um einen anderen Konnektor auszuwählen. Wähle anschließend den gewünschten Konnektor. {% endstep %} {% step %} #### Verbindung konfigurieren Gib einen **Verbindungsnamen** ein und vervollständige die erforderliche Einrichtung für das ausgewählte System. Klicke auf **Verbinden**, um die Einrichtung abzuschließen. Die Verbindung wird dem aktuellen Arbeitsbereich hinzugefügt. {% endstep %} {% endstepper %} {% endtab %} {% endtabs %} ### Einen Konnektor authentifizieren Die Anforderungen für die Authentifizierung hängen vom Konnektor ab. Folge den Einrichtungsanweisungen und gib die erforderlichen Angaben für das ausgewählte System ein. #### Authentifizierung mit API-Key * **Lexware Office:** Erstelle einen privaten API-Key in den [Lexware Office API-Einstellungen](https://app.lexware.de/addons/public-api). Weitere Informationen findest du in der [Lexware API-Dokumentation](https://developers.lexware.io/docs/#lexware-api-documentation). * **sevdesk:** Erstelle einen API-Token. Weitere Informationen findest du in der [sevdesk-Dokumentation zur Authentifizierung](https://api.sevdesk.de/#section/Authentication-and-Authorization). * **weclapp:** Gib eine Mandanten-ID und einen API-Key an. Die Mandanten-ID ist der erste Teil deiner weclapp-URL. Erstelle einen API-Token unter **My settings** > **API token**. Weitere Informationen findest du in der [weclapp API-Dokumentation](https://www.weclapp.com/api/). * **Xentral:** Gib eine Mandanten-ID und einen API-Key an. Die Mandanten-ID ist der erste Teil deiner Xentral-URL. Erstelle einen Personal Access Token unter **Developer Settings > Personal Access Tokens**. Weitere Informationen findest du unter [Creating personal access tokens](https://help.xentral.com/hc/en-us/articles/6575192352796-Creating-personal-access-tokens-Legacy). #### OAuth-Authentifizierung * **Google Sheets:** Authentifiziere dich über eine Weiterleitung oder registriere eine eigene OAuth-Anwendung. Weitere Informationen findest du unter [Create an OAuth 2.0 client ID](https://support.google.com/cloud/answer/15549257?sjid=13234270053207448225-EU). * **Microsoft Excel:** Authentifiziere dich über eine Weiterleitung und autorisiere die Verbindung mit deinem Account. * **Sage Accounting:** Authentifiziere dich über eine Weiterleitung und autorisiere die Verbindung mit deinem Account. ### Konnektoren in den Arbeitsbereichseinstellungen verwalten Öffne **Einstellungen** in der Hauptnavigation. Wähle unter **ARBEITSBEREICH** **API und Verbindungen** und anschließend den Tab **Verbindungen**. Der Screen enthält Konnektoren, die im aktuellen Arbeitsbereich erstellt wurden, sowie organisationweite Konnektoren, die für ihn verfügbar sind. Nutze das Suchfeld, um eine Verbindung anhand ihres Namens zu finden. Die Liste enthält für jeden Konnektor: * **Verbindungsname:** Den Verbindungsnamen und ein Symbol für das verbundene System. * **Wer sich anmeldet:** Den bei der Erstellung gewählten Account-Typ: **Individuell**, **Organisation** oder **Arbeitsbereich**. * **Status:** Den Status der Verbindung: * **Nicht verbunden:** Die Verbindung ist im Arbeitsbereich verfügbar, benötigt aber noch einen Account des externen Systems. Klicke auf :link:, um sie zu verbinden. * **Aktiv:** Die Anmeldedaten funktionieren. Die letzte Verbindung oder der letzte Aufruf war erfolgreich. * **Erneute Verbindung erforderlich:** Der Anbieter hat die Anmeldedaten abgelehnt. Melde dich erneut an. * **Einrichtung unvollständig**: Die Einrichtung des Anbieters für diese Verbindung fehlt oder ist unvollständig. Prüfe die Client-ID und das Secret. * **Nicht verfügbar:** Dein Plan enthält den Konnektor nicht oder der Anbieter stellt keine nutzbaren Funktionen bereit. * Bei **Individual**-Verbindungen bedeutet **Inaktiv**, dass sich noch kein Mitglied verbunden hat. **Aktiv** bedeutet, dass sich mindestens ein Mitglied verbunden hat. * **Erstellt am:** Datum und Uhrzeit der Erstellung. Um verfügbare **Fähigkeiten** und Beispiele für die Verwendung des Konnektors in Ninox Skript anzuzeigen, klicke am Ende der Zeile auf :rectangle-list:**Fähigkeiten**. Weitere Informationen zur Verwendung von Konnektoren in Ninox Skript findest du [hier](#einen-konnektor-in-ninox-script-verwenden). Klicke auf :trash: **Löschen** in der Zeile, um eine Verbindung auf Arbeitsbereichsebene zu löschen. Klicke auf :link-slash: in der Zeile, um eine aktive Verbindung zu trennen. Durch das Trennen entfernst du die Authentifizierung beim externen System. Die Verbindung bleibt verfügbar und kann erneut verbunden werden. Durch das Löschen entfernst du eine Verbindung auf Arbeitsbereichsebene vollständig. {% hint style="info" %} Löschen und Trennen sind nur für Konnektoren verfügbar, die in diesem Arbeitsbereich erstellt wurden. Wenn eines der Symbole nicht verfügbar ist, wurde der Konnektor auf Organisationsebene erstellt. Lösche oder trenne ihn auf dem Screen **Verbindungen** der Organisation. {% endhint %} ### Einen Konnektor in Ninox Skript verwenden Rufe eine Fähigkeit eines Konnektors mit `connectionInvoke()` auf. Verwende den Verbindungsnamen, den du bei der Konfiguration festgelegt hast, sowie eine unter **Fähigkeiten** angezeigte Fähigkeit. ```ninox connectionInvoke({ connection: "Lexware Office", capability: "customers.list" }) ``` Dieses Beispiel ruft die Fähigkeit `customers.list` für die Verbindung mit dem Namen "Lexware Office" auf. Die Namen der Fähigkeiten sind systemspezifisch. Ein Konnektor kann zum Beispiel getrennte Fähigkeiten zum Lesen und Schreiben von Kunden, Lieferanten oder Rechnungen bereitstellen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.ninox.com/builder-hub/de/manage-your-organization-and-workspace/organize-your-workspace/api-and-connections/manage-workspace-level-connections.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.