# Connect

Mit Connect können Sie vertrauenswürdige, einseitige Verbindungen zwischen Organisationen einrichten, die die Polyteia-Plattform verwenden. So wird eine sichere Zusammenarbeit über Organisationsgrenzen hinweg möglich – bei voller Kontrolle über alle Zugriffe.

### Funktion einer Verbindung

Eine Verbindung ermöglicht es Ihnen:

* **Mitglieder Ihrer Organisation für eine andere Organisation sichtbar zu machen**
* **Der anderen Organisation zu erlauben, Ihre Mitglieder** zu Arbeitsbereichen, Lösungen und Datensätzen einzuladen
* **Die volle Kontrolle zu behalten**, wer sichtbar ist und wer geteilt wird

Es erfolgt **kein automatischer Zugriff** auf Inhalte oder Daten.

Stellen Sie sich das wie eine Tür vor, die Sie öffnen, damit die andere Organisation Ihre Personen finden und einladen kann – ohne selbst einzutreten.

### Funktionsweise

Verbindungen sind **einseitig**. Das bedeutet:

* Wenn **Organisation A eine Verbindung zu Organisation B herstellt**, dann werden **Mitglieder von A in B auffindbar**
* Wenn B dasselbe möchte, **muss sie selbst eine Verbindung zu A initiieren**

{% hint style="info" %}
Wenn gegenseitige Sichtbarkeit gewünscht ist, müssen beide Seiten eine eigene Verbindung einrichten.
{% endhint %}

### Beispiel

Angenommen:

* Sie sind Teil von **Organisation A (Mustergemeinde)**
* Sie verbinden sich mit **Organisation B (Datenstadt)**
* Sie geben 2 Mitglieder frei: **<daniela@mustergemeinde.de>** und **<simon@mustergemeinde.de>**

Dann passiert Folgendes:

* In Datenstadt (Organisation B):
  * Die freigegebenen Mitglieder sind **auffindbar** in Auswahlmenüs (z. B. für Einladungen zum Teilen)
  * Sie können zu Ressourcen, Arbeitsbereichen oder Lösungen eingeladen werden
* Die Mitglieder von Datenstadt sind **für Sie nicht sichtbar**, außer Datenstadt stellt selbst eine Verbindung zu Ihnen her

{% hint style="info" %}
Nur die freigegebenen Mitglieder werden sichtbar. Sie entscheiden, wer geteilt wird.
{% endhint %}

### Warum dieses Modell?

Dieses Modell gewährleistet:

| Vorteil                     | Erklärung                                                  |
| --------------------------- | ---------------------------------------------------------- |
| Datenschutzkonformes Teilen | Nur ausgewählte Mitglieder sind übergreifend sichtbar      |
| Granulare Zusammenarbeit    | Nur gezielt eingeladene Personen haben Zugriff             |
| Volle Kontrolle             | Es werden keine Inhalte oder Daten automatisch offengelegt |
| Einfache Struktur           | Eine Seite genügt für den Verbindungsaufbau                |

### Zentrale Eigenschaften

| Verhalten                     | Bedeutung                                                  |
| ----------------------------- | ---------------------------------------------------------- |
| Nur einseitig                 | Verbindungen wirken nicht automatisch in beide Richtungen  |
| Manuelle Auswahl erforderlich | Nur ausgewählte Mitglieder werden geteilt                  |
| Sichtbarkeit ohne Zugriff     | Die andere Organisation sieht Ihre Mitglieder – mehr nicht |
| Bestätigung erforderlich      | Die empfangende Organisation muss die Anfrage annehmen     |

{% hint style="info" %}
Um Mitglieder einer anderen Organisation zu sehen, muss diese eine Verbindung zu Ihnen aufbauen.
{% endhint %}

***

## Schritt-für-Schritt-Anleitung

{% stepper %}
{% step %}
**Connect öffnen**

Gehen Sie zu: **Einstellungen → Connect**

Klicken Sie auf **Neue Verbindung**.
{% endstep %}

{% step %}
**Organisation auswählen**

Nutzen Sie die Suchleiste, um die Organisation zu finden, mit der Sie sich verbinden möchten. Klicken Sie auf **Weiter**, sobald sie ausgewählt ist.

{% hint style="info" %}
Es werden nur Organisationen angezeigt, mit denen eine Verbindung möglich ist.
{% endhint %}
{% endstep %}

{% step %}
**Mitglieder auswählen**

Wählen Sie nun die Mitglieder Ihrer Organisation aus, die für die andere Organisation sichtbar sein sollen.

* Aktivieren Sie die Kontrollkästchen neben den gewünschten Personen
* Sie können Administratoren und Mitglieder auswählen
* Klicken Sie auf **Weiter**, wenn Sie fertig sind

{% hint style="info" %}
Nur die ausgewählten Personen werden in der anderen Organisation auffindbar.
{% endhint %}
{% endstep %}

{% step %}
**Überprüfen und absenden**

Sie sehen eine Zusammenfassung von:

* Der Organisation, mit der Sie sich verbinden
* Den ausgewählten Mitgliedern
* (Optional) Eine Nachricht zur Anfrage

Klicken Sie auf **Anfrage senden**.
{% endstep %}

{% step %}
**Auf Bestätigung warten**

Die andere Organisation erhält eine **E-Mail-Benachrichtigung**. Bis zur Annahme gilt:

* Die Verbindung erscheint als **Ausstehend**
* Noch erfolgt kein Teilen von Mitgliedern

Nach der **Annahme** wird der Status zu **Aktiv**.
{% endstep %}

{% step %}
**(Andere Organisation) Mitglieder verwenden**

In der empfangenden Organisation:

* Geteilte Mitglieder erscheinen in Dropdowns (z. B. für Arbeitsbereich-Administratoren)
* Sie sind mit einem kleinen **Extern**-Symbol gekennzeichnet
* Sie können wie eigene Mitglieder eingeladen werden
  {% endstep %}

{% step %}
**(Optional) Gegenseitige Verbindung aufbauen**

Für **beidseitiges Teilen** sollte die empfangende Organisation ebenfalls:

* Den Bereich **Connect** öffnen
* Eine **neue Verbindung** erstellen
* Ihre Organisation auswählen und Mitglieder freigeben

Sobald beide Verbindungen bestehen, können **beide Organisationen Mitglieder gegenseitig entdecken und einladen**.
{% endstep %}
{% endstepper %}

## Hinweise und Tipps

### Was möglich ist

* Ausgewählte Mitglieder teilen
* Mitglieder aus Verbindung entfernen
* Einladungen auf Arbeitsbereich-Ebene steuern

### Was nicht möglich ist

* Inhalte oder Daten automatisch teilen
* Mitglieder der anderen Organisation standardmäßig sehen
* Ohne Einladung Zugriff auf Ressourcen, Arbeitsbereiche oder Lösungen erhalten

Nach erfolgreichem Verbindungsaufbau steht einer sicheren, kontrollierten Zusammenarbeit über Organisationsgrenzen hinweg nichts mehr im Weg.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.polyteia.com/organisationen/polyteia-connect.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.