@christophEFG-GI
Hallo Christoph,

Unsere Instanz ist von CT gehostet mit aktivierten LDAP Dienst.
Habe hier im Forum eine gute Beschreibung zur Konfiguration der Nextcloud Instanz gefunden:
https://forum.church.tools/topic/5651/churchtools-ldap-nextcloud

Vorbedingung ist aber ein funktionierender LDAP Dienst, den du gemeinsam mit dem CT Service konfigurierst.
Anschließend die Anleitung von @aschild folgen.

... oder alternativ unsere Einstellung versuchst:
site == eure CT Instanz

Tab: Server:
LDAP-Server: ldaps://ldap.church.tools:636
Basis-DN: dc=ldap,dc=church,dc=tools
Benutzer-DN: cn=root,ou=users,o=site
Passwort: das von dir vergebene Passwort für deinen CT LDAP Benutzer
LDAP-Filter manuell: aktiviert!

Tab: Benutzer:
Filter: (|(objectclass=CTPerson))

Tab: Anmelde-Attribute
Filter: (&(&(|(objectclass=CTPerson)))(|(uid=%uid)(|(mailPrimaryAddress=%uid)(mail=%uid))))

Tab: Gruppen
Filter: (&(|(objectclass=CTGroupDienst)(objectclass=CTGroupKleingruppe)))
(Damit können sich alle Mitglieder vom Gruppen-Typ Dienst und Kleingruppe anmelden)

Tab: Fortgeschritten
-> Ordnereinstellungen
Feld für den Anzeigenamen des Benutzers: displayname
Basis-Benutzerbaum: ou=users,o=site
Feld für den Anzeigenamen der Gruppe: cn
Basis-Gruppenbaum: ou=groups,o=site
Assoziation zw. Gruppe und Benutzer: uniqueMember

Vorbedingung für die Anmeldung bei Nextcloud ist die erfolgreiche Einladung der Mitglieder bei CT mitzuarbeiten. Erst dann existiert ein Benutzername.

Wir haben dann nach erfolgreicher Kopplung Ordner im Home des Admins angelegt mit den Gruppennamen und diese dann geshared mit der Gruppe selbst. Alle Mitglieder einer Dienstgruppe oder Kleingruppe sehen dann nur die Ordner zu denen sie Berechtigung haben.

Mit was ich gerade teste sind Ablaufpläne, die ich nach Songbeamer überspielen will. Da existiert bereits ein Tool: https://gitlab.com/PublicCode/churchtools-to-songbeamer
Leider ist das nicht ausreichend, da die Bibelstellen immer noch manuell eingetragen werden müssen.
Ich arbeite gerade an einer speziellen Anpassung des Migrations-Tools, das die Notiz in Spalte "Programm" des Ablaufplans nutzt, um die Bibelstellen der jeweiligen Predigt/Einleitung auch zum Songbeamer migriert.

Bei allem anderen sind wir selber noch auf der Suche nach einer guten Lösung 🙂

Ich hoffe dir damit helfen zu können. Viel Erfolg.
Johannes.

@davidschilling
ah, habe es selbst lösen können:

files = { "Content-Disposition": "form-data", "filename": "asdf.pdf", "Content-Type": "application/pdf", 'files[]': open('asdf.pdf', 'rb') } response = s.post(url, files=files)

Das Feld in dem die Datei übergeben wird muss"files[]", nicht "files" heissen.

Danke trotzdem fürs mitdenken!

Nein, du bist nicht blind. Diese Filterfunktion nach Bereich gibt es zurzeit noch nicht.

@Silas-K sagte in Beispiel Login REST API:

Nachtrag:
Bzw. Anders gefragt, von wo darf denn ein Zugriff auf die API stattfinden, wenn Postman es schafft, aber meine PWA nicht?

Kurze Ergänzung dazu. CORS (Mozilla MDN) ist ein Schutzmechanismus im Web. Ganz einfach gesprochen: Der Browser verhindert das nachladen von Daten (Skripts, CSS, API Calls, etc.) wenn der Origin (in diesem Fall ChurchTools) diese Seite nicht explizit das Laden erlaubt. Damit soll verhindert werden, dass im Frontend Schadcode von fremden Quellen einfach so geladen werden kann.

Wenn du PHP verwendest, dann läuft das auf einem Server. Backend also hier kannst du die ChurchTools API ohne Probleme aufrufen. Dass dein Server gehackt wurde und Schadecode ausliefert ist eher unwahrscheinlich.

Es lohnt sich das Thema CORS anzugucken. So ist es doch ein wichtiges Sicherheitskonzept im Web.

@philipptrenz Das ist richtig tolle Arbeit!

Da bei uns die Fakten die Ordner eintragen, wäre es für uns besser, sowas in einer Intranet-Seite zu haben und über einen Raspberry oder eine NAS hosten zu lassen. Am besten auch schön responsive, dass jeder Ordner es auf seinem Handy nutzen kann.

Aber als Eigenentwicklung an sich: Hut ab! Weiter so!

@rena Da ich das damals primär über die Konsole ausgeführt habe, weil das bisschen zu viele Lieder waren bei uns, hatte ich normale Zeilenumbrüche \n rein gemacht und keine <br>.. aber ja.. vll. kann man das ja konditional oder beides machen.. 🙂

@holunder
Wir haben glaub nicht die aktuelle Version auf der Homepage laufen.

ok, danke für die Info.
Dann hätte ich noch eine andere (Off-Topic-)Frage:
Welche Bedeutung hat die Eigenschaft "valid_yn" bei den "services" wenn ich über die alte API "getAllEventData" aufrufe?

@DNie sagte in Frage zu einem API-Call des Kalenders:

@aschild sagte in Frage zu einem API-Call des Kalenders:

https://github.com/vineyardkoeln/churchtools-api

Was macht man, wenn man nicht mit PHP unterwegs ist? Ich verstehe nicht, warum der Kalender noch nicht über die REST API abrufbar ist. Ist doch essenziell. Warum die Templates, aber die Events nicht?

Weil Gott die Welt auch nicht an einem Tag schuf? 😉

Die REST Api wurde im ersten Schritt gestartet um die App anbinden zu können, darum waren zuerst nur Personen und Dienste in der neuen Api zu finden.

In der Zwischenzeit ist vieles dazu gekommen aber der Kalender noch nicht.

Und wenn du nicht mit PHP unterwegs bist, du kannst die alte API ja trotzdem nutzen, musst halt mehr Wrappercode selber schreiben...

Die Doku dazu findest du hier:
https://api.church.tools/class-CTChurchCalModule.html
und als Funktion wirst du wohl getCalendarEvents benötigen.

Wie man die alte API nutzt, musst/kannst du dann im php code "spicken"

Noch ein weiteres Feld welches NULL sein darf:

/groups/{id}/members/ ->memberEndDate string($date) -> nullable

Das Ende der Gruppenteilnahme ist ja sehr oft noch leer 😉

@davidschilling Ja, das ist schon klar.

Mein Problem ist folgendes:

Die Client Klassen werden automatisch auf Basis der openapi.json Definition erstellt, somit habe ich im Client alle Standardfelder in meinen Klassen Mit dem /api/fields erhalte ich ALLE Felder zurück Nun sollte ich für die "Pro Instanz Klassen" herausfinden, welches davon Standardfelder sind, und welches zusätzlich sind, denn diese zusätzlichen Felder werden dann in einer neuen Klasse für diese CT Instanz in einer Vererbten Klasse hinzugefügt

So wie ich das sehe, muss ich aktuell dazu entweder eine Liste der Standardfelder manuell führen, oder via Reflection/Classinspection schauen welche Felder in der Basisklasse sind.

Beides nicht wirklich coole Optionen, aber wenn das Api die Informationen nicht hat, dann bleibt mir wohl nicht's anderes übrig.

LG André

@andrea-schulz sagte in API für Dummies:

Hallo
Ich finde die hier diskutierte API Themen super spannend. Da gibt es also noch unendlich viele Möglichkeiten... Kann vielleicht jemand mal ein Webinar „API für Dummies“ anbieten und das ein bisschen vorstellen?

@andrea-schulz Die API ist für Softwareentwickler gedacht. Da bringt eigentlich ein solches Webinar vermutlich nicht viel.
Als SW Entwickler ist die Doku sehr gut und man kann damit eigentlich sofort loslegen.
Aktuell hat es noch einige Kinderkrankheiten, aber da wurde schon einiges Ergänzt/Korrigiert 🙂

@davidschilling sagte in Fehler in openapi.json definition der privacyPolicyAgreement?:

Wenn ich das richtig sehe ist das ein PHP Problem 🙂

Also, normalerweise kommt da ein Objekt zurück, aber wenn das leer ist kommt ein Array zurück.

Das liegt daran, dass in PHP Arrays auch als Maps verwendet werden.

Beispiel:

Map: ['foo' => 'bar']
Array: ['bar']

Wenn jetzt die Map oder das Array leer sind sehen beide so aus: []
Das führt dazu, dass beim Konvertieren der Struktur ein Array bei einer leeren Map rauskommt.
Ich hab das jetzt nicht überprüft, aber sieht mir stark nach dem Problem aus.

So wie ich das sehe, passend hier Definition und Rückgabewert nicht zusammen, wenn bei der Person keine privacyPolicyAgreement gespeichert ist.

Die Definition erwartet ein Objekt mit den 3 properties date/typeId/whoId, die zwar alle null sein dürfen, aber das objekt selbst sollte in der JSON Anwort daherkommen.

Wenn keine privacyPolicyAgreement vorhanden ist, dann sollte doch das Feld privacyPolicyAgreement als Nullable definiert sein und auch als null zurückgeliefert werden...

Wir als Schweizer dürfen dieses Feld glücklicherweise noch für 2-3 Jahre ignorieren, daher ist es bei uns noch Leer und führt zu diesem Stolpern...

Als Hoster Info an den Support, als Selfhoster kann man das selber eintragen.

Vielen Dank für die beiden Antworten.

@hbuerger Ich kann die Schätzung gut nachvollziehen. Alles klar.
@aschild Ich hatte bereits eure REST-API gesehen. Da ich aber mit NodeJS direkt mit der offiziellen API rede, ist für mich PHP keine Option. Ich könnte mir eher vorstellen, einen ähnlichen Wrapper für Node anzubieten (abhängig davon, wieviel andere Schnittstellen ich noch ansprechen werde)

Dann werde ich erstmal die alte API ausprobieren.

@JuniOr sagte in API Nutzung, Webseite (Wordpress):

Deswegen vielleicht auch etwas Teils dumme Fragen.

nur keine Scheu! 😉
Hier hilft man gerne und i. d. R. auch recht zügig.

@mriedel Dann trag' doch einfach in den Einstellungen den Mandanten richtig ein:

Unbenannt.png

Alternativ direkt die churchdbsync.ini editieren:

optigem_mandant=01