- AppWrite
:Hammer: Integrationen
AppWrite
ContributeWas ist AppWrite?
AppSchreiben in Illa ist eine Datenbank-Integration, mit der Sie sich mit einer AppWrite-Datenbank verbinden und interagieren können. Appwrite ist ein beliebtes Open-Source-relationales Datenbank-Management-System, das für seine Geschwindigkeit, Zuverlässigkeit und Benutzerfreundlichkeit bekannt ist.
Mit der Appwrite-Integration in Illa können Sie Daten aus einer Appwrite-Datenbank mittels SQL-Befehlen abfragen, einfügen, aktualisieren und löschen. Sie können auch benutzerdefinierte SQL-Abfragen erstellen und innerhalb von Illa ausführen. Dies macht es einfach, datengesteuerte Anwendungen und Dashboards zu erstellen, die Echtzeitdaten aus einer Appwrite-Datenbank anzeigen.
Dieses Tutorial beschreibt den Prozess der Erstellung eines Admin-Panels mit Hilfe von ILLA Builder und Appwrite in ein paar einfachen Schritten. ILLA ist eine Low-Code-Plattform für Entwickler, die die schnelle Entwicklung und den Einsatz von internen Tools ermöglicht. Es ermöglicht die Erstellung von Seiten durch Ziehen und Ablegen von UI-Komponenten, Verbindung zu jeder Datenbank oder API, und das Schreiben von JavaScript. Um mehr über Appwrite zu erfahren, besuchen Sie ihre Website unter https://appwrite.io/ Let’s beginnen!
Backend auf AppWrite einrichten
Nachdem Sie sich bei Ihrem Appwrite-Konto angemeldet haben, klicken Sie auf dem Appwrite-Dashboard auf **Projekt erstellen** und setzen Sie den Namen auf First Project.
Dann können wir zur Projektseite navigieren. Appwrite bietet mehrere Plattformen zum Aufbau Ihrer App sowie zum Aufbau von Integrationen.
Hier wählen wir die Web-App als Beispiel.
Nach der Erstellung unseres Web-App-Projekts können wir auf die Datenbankseite gehen, da wir Appwrite bisher nur als Datenbankintegration verwenden.
Dann können wir Datenbank erstellen und Sammlungen innerhalb der Datenbank erstellen
Von hier können wir Attribute und Daten in der Sammlung erstellen.
Um Dokumente anhand von Attributen abzurufen, müssen für jedes Attribut entsprechende Indizes erstellt werden.
Diese Datenbank ist nun bereit für die Integration in Illa.
App-Schreiben erstellen
Es gibt zwei Möglichkeiten, nach der Anmeldung in Ihrem Illa-Konto eine Ressource in Illa zu erstellen.
- In Ressourcen erstellen
Melde dich in dein Illa Konto an, wähle **Ressourcen** oben auf der Seite und klicke auf **Neu erstellen** Button.
Wähle AppWrite aus der Datenbankliste.
Verbinden Sie sich mit den erforderlichen Parametern, die in Verbindungseinstellungen unten beschrieben sind.
Klicke auf **Verbindung testen** um zu sehen, ob wir erfolgreich mit der Datenbank verbinden können. Wenn ja, klicke auf Ressourcen speichern, ansonsten überprüfe doppelt, ob der Hostname, der Port, der Benutzername und das Passwort korrekt sind.
Nach der Erstellung einer Ressource wird das fertige AppWrite wie angezeigt angezeigt.
- Im Builder erstellen
Melde dich bei deinem Illa Account an, erstelle ein Projekt in Illa Builder auf der **App** Seite und navigieren Sie zur Action List am unteren Ende der Seite. Klicke auf **new**, dann wähle AppWrite aus der Datenbankliste. Verbinden Sie sich dann mit der Datenbank mit den erforderlichen Parametern, die in Verbindungseinstellungen unten beschrieben sind.
Klicke auf **Verbindung testen** um zu sehen, ob wir erfolgreich mit der Datenbank verbinden können. Wenn ja, klicke auf Ressourcen speichern, ansonsten überprüfe doppelt, ob der Hostname, der Port, der Benutzername und das Passwort korrekt sind.
Verbindungseinstellungen
Hier müssen wir Informationen zur Verbindung mit der AppWrite Datenbank bereitstellen.
| Eigenschaften | Benötigt | Beschreibung |
|---|---|---|
| Name | benötigt | Der Name für die Ressource beim Erstellen von Aktionen in der ILLA. |
| Host | benötigt | Die URL oder IP-Adresse für Ihre Datenbank |
| Datenbank-ID | benötigt | eindeutige Kennung für jede Datenbank, die innerhalb von Appwrite erstellt wurde |
| Projekt-ID | benötigt | eindeutige Kennung, die Ihr gesamtes Appwrite-Projekt repräsentiert |
| API-Schlüssel | benötigt | ein geheimes Token, das als Form der Authentifizierung bei API-Anfragen an den Appwrite-Server dient |
Um die benötigte Host, Database ID, Project ID und API Schlüssel im Appwrite zu finden, gehen wir zuerst zum **Einstellung** Button in der unteren linken Ecke der Projektseite.
Kopieren der project ID für project ID und API Endpoint für Host in der Appwrite Konfiguration in Illa.
Dann klicken Sie auf die Schaltfläche API-Schlüssel anzeigen auf der gleichen Seite. Wenn Sie keine API für dieses Projekt erstellt haben Klicke auf den Erstelle API-Schlüssel Button und wähle nur den Database-Ordner, da das ist, was wir von Appwrite verwenden werden.
Kopiere das API Key Secret für API Key in die Illa Konfiguration. Es kann für diese beiden Stellen kopiert werden.
Was wir übrig haben, ist die Database ID die wir auf der Database Seite finden. Kopieren und Einfügen in die Appwrite Konfiguration in Illa.
Das Endprodukt sollte so aussehen.
Aktionen erstellen
Wir haben eine AppWrite-Ressource erstellt. Wir können die Aktion hinzufügen, indem wir AppWrite-Aktion aus der Aktionsliste auswählen und die Erstelle Aktion Schaltfläche auswählen.
Jetzt haben wir den AppWrite Server als Aktion zu unserer Bauseite hinzugefügt.
App-Schreiben konfigurieren
Übersicht
| Methodenname | Beschreibung |
|---|---|
| Methode | Erstellen Sie ein Dokument, holen Sie ein Dokument, aktualisieren Sie ein Dokument, löschen Sie ein Dokument |
| Sammlungs-ID | ein eindeutiger Identifikator, der einer Datenbanksammlung zugewiesen wird |
| Transformator | Umwandlung von Daten in den Stil, den Sie mögen, mit JavaScript |
Dokument erstellen
ein neues Dokument in einer Sammlung erstellen
Input
| Eigenschaften | Benötigt | Beschreibung |
|---|---|---|
| Dokument-ID | benötigt | ein eindeutiger Identifikator, der einem Datenbank-Sammlungsdokument zugewiesen wurde |
| Daten | optional | ein Objekt, das die Felder und Werte des neuen Dokuments enthält. |
Zum Beispiel, um ein neues Dokument in einer Sammlung mit zwei Feldern zu erstellen - name und age, du kannst 1 als document ID und {{ {"Name": "David", "Age": 18}}} für data verwenden.
Ausgabe
ein Antwortobjekt, das die ID des neu erstellten Dokuments sowie zusätzliche Metadaten wie Datum und Uhrzeit der Erstellung enthält.
Dokument erhalten
ein bestimmtes Dokument aus einer Sammlung in der Datenbank abrufen
Input
| Eigenschaften | Benötigt | Beschreibung |
|---|---|---|
| Dokument-ID | benötigt | ein eindeutiger Identifikator, der einem Datenbank-Sammlungsdokument zugewiesen wurde |
Zum Beispiel erhalten wir das Dokument mit der ID 1.
Ausgabe
ein Antwortobjekt, das die Daten des angeforderten Dokuments enthält
Verwende {{appwrite1.data}} um alle zurückgegebenen Werte zu erhalten.
Dokument aktualisieren
aktualisieren Sie die Daten eines vorhandenen Dokuments in einer Sammlung.
Input
| Eigenschaften | Benötigt | Beschreibung |
|---|---|---|
| Dokument-ID | benötigt | ein eindeutiger Identifikator, der einem Datenbank-Sammlungsdokument zugewiesen wurde |
| Daten | optional | Ein Objekt, das die aktualisierten Felder und Werte enthält, die dem Dokument zugewiesen werden sollen. |
Zum Beispiel, um ein Dokument in einer Sammlung mit der updateDocument Methode zu aktualisieren, du kannst 1 für Document-ID und {{{"Name":"Fred"}}} für Daten setzen.
Ausgabe
ein Antwortobjekt, das die Daten des angeforderten Dokuments enthält
Dokument löschen
ein bestimmtes Dokument aus einer Sammlung in der Datenbank löschen
Input
| Eigenschaften | Benötigt | Beschreibung |
|---|---|---|
| Dokument-ID | benötigt | ein eindeutiger Identifikator, der einem Datenbank-Sammlungsdokument zugewiesen wurde |
Zum Beispiel können wir das Dokument mit der ID 1 löschen.
Ausgabe
ein Antwortobjekt, das die erfolgreiche Löschung des Dokuments bestätigt.
Dokument auflisten
mehrere Dokumente aus einer Sammlung in der Datenbank abrufen
Input
| Eigenschaften | Benötigt | Beschreibung |
|---|---|---|
| Filtern | optional | definiere Bedingungen, um die Dokumente nach bestimmten Feldern und Werten zu filtern |
| Sortieren nach | optional | geben Sie das Feld an, nach dem die resultierenden Dokumente sortiert werden sollen |
| Limit | optional | die Anzahl der in der Ergebnismenge zurückgegebenen Dokumente einschränken |
Zum Beispiel, um alle Dokumente mit Name = James.
Ausgabe
Eine Reihe von Dokumenten, die den Filter erfüllen.
Verwende {{appwrite1.data[0].documents}} um den Wert zurückzugeben.
