🔨 Integrări
AppWrite in Illa este o integrare a bazei de date care vă permite să vă conectaţi şi să interacţionaţi cu o bază de date AppWrit. Appwrite este un sistem popular de management al bazelor de date relaționale open-source cunoscut pentru viteza, fiabilitatea și ușurința de utilizare.
Cu integrarea Appwrite în Illa, puteți interoga, insera, actualiza și șterge date dintr-o bază de date Appwrite folosind comenzile SQL. De asemenea, poți crea interogări SQL personalizate și să le rulezi în Illa. Acest lucru facilitează construirea de aplicații și tablouri de bord bazate pe date care afișează date în timp real dintr-o bază de date Appwrite
Acest tutorial subliniază procesul de creare a unui Panou Administrator folosind ILLA Builder și Appwrite în câțiva pași simpli. ILLA este o platformă cu coduri joase pentru dezvoltatori, care permite dezvoltarea și implementarea rapidă a instrumentelor interne. Permite crearea de pagini prin glisarea și fixarea componentelor UI, conectarea la orice bază de date sau API și scrierea JavaScript. Pentru a afla mai multe despre Appwrite, vizitați site-ul web la https://appwrite.io/ Hai să începem!
După ce te conectezi în contul tău Appwrite de pe tabloul de bord Appwrite dă click pe **Creează proiect**
și setează numele în First Project
.
Apoi putem naviga la pagina proiectului. Appwrite oferă mai multe platforme pentru construirea aplicației tale și integrări.
Aici alegem Web App ca exemplu.
După crearea proiectului nostru Web app, putem merge la pagina bazei de date, deoarece folosim Appwrite ca integrare a bazei de date până acum.
Apoi putem crea baza de date și crea colecții în baza de date
De aici putem crea atribute și date în colectare.
Pentru a putea prelua documentele după atribute, trebuie să facem indexuri corespunzătoare pentru fiecare atribut.
Această bază de date este acum gata să se integreze cu Illa.
Există două modalități de a crea o resursă în Illa după ce te autentifici în contul tău Illa.
Conectează-te la contul tău Illa, selectează **Resurse**
din partea de sus a paginii și apasă butonul **Creează nou**
.
Selectați AppWrite
din lista de baze de date.
Conectați-vă la baza de date cu parametrii necesari descriși în Setări conexiuni
de mai jos.
Faceți clic pe **Test Connection**
pentru a vedea dacă ne putem conecta cu succes la baza de date. Dacă da, apasă pe Salvează Resurse
, în caz contrar, verifică de două ori numele gazdei, portul, numele de utilizator și parola sunt corecte.
Dupa crearea unei resurse, AppWrite gata va fi afisat ca afisat.
Conectează-te la contul tău Illa, creează un proiect în Illa Builder în pagina **App**
, şi navighează la Lista de Acţiuni
în partea de jos a paginii. Faceți clic pe **nou**
, apoi selectați AppWrite
din lista de baze de date. Apoi, conectați-vă la baza de date cu parametrii necesari descriși în Setări conexiuni
de mai jos.
Faceți clic pe **Test Connection**
pentru a vedea dacă ne putem conecta cu succes la baza de date. Dacă da, apasă pe Salvează Resurse
, în caz contrar, verifică de două ori numele gazdei, portul, numele de utilizator și parola sunt corecte.
Aici trebuie să furnizăm informaţii pentru conectarea la baza de date AppWrit.
Proprietăți | Necesar | Descriere |
---|---|---|
Nume | necesar | Numele pentru resurse la crearea de acțiuni în ILLA. |
Gazdă | necesar | Adresa URL sau adresa IP a bazei de date |
ID-ul bazei de date | necesar | identificator unic atribuit fiecărei baze de date create în Appwrite |
ID Proiect | necesar | identificator unic care reprezintă întregul dvs. proiect Appwrite |
Cheie API | necesar | un simbol secret care servește ca formă de autentificare atunci când fac cereri API către serverul Appwrite |
Pentru a găsi Host
, Database ID
, ID proiect
şi API key
în Appwrite, mai întâi mergem la butonul **setări**
din colțul din stânga jos al paginii proiectului.
Se copiază ID-ul proiectului
pentru ID-ul proiectului
și punctul de sfârșit API
pentru Host
în configurația Appwrite din Illa.
Apoi putem da click pe butonul Vezi API Keys
de pe aceeași pagină. Dacă nu ați creat un API pentru acest proiect, faceţi clic pe butonul Creează API Key
şi selectaţi doar folderul Database
deoarece acesta este ceea ce vom folosi de la Appwrite.
Copiați API Key Secre
pentru API key
în configurația Illa. Acesta poate fi copiat în aceste două locuri.
Ceea ce am mai rămas este ID-ul bazei de date
pe care îl putem găsi în pagina Database
. Se copiază și se lipește la configurația Appwrite din Illa.
Produsul final ar trebui să arate cam așa.
Am creat o resursă AppWrite , putem adăuga acțiunea selectând AppWrite din lista de acțiuni și alegând butonul Creare acțiune
.
Acum am adăugat serverul AppWrite ca acțiune la pagina noastră de construcție.
Numele metodei | Descriere |
---|---|
Metodă | Creați un document, obțineți un document, actualizați un document, ștergeți un document, listă de documente |
ID colecție | un identificator unic atribuit unei baze de date |
Transformator | Transformarea datelor în stilul care îți place să folosești JavaScript |
creează un nou document într-o colecție
Input
Proprietăți | Necesar | Descriere |
---|---|---|
ID document | necesar | un identificator unic atribuit unui document de colectare a bazei de date |
Date | opţional | un obiect care conține câmpurile și valorile documentului nou. |
De exemplu, pentru a crea un nou document într-o colecție cu două câmpuri - nume
și age
, puteţi utiliza 1 ca document ID
şi {{"Name": "David", "Age": 18}}
pentru data
.
** Rezultat
un obiect de răspuns care include ID-ul documentului nou creat, precum și metadate suplimentare, cum ar fi data și ora creării.
preia un document specific dintr-o colecție din baza de date
Input
Proprietăți | Necesar | Descriere |
---|---|---|
ID document | necesar | un identificator unic atribuit unui document de colectare a bazei de date |
De exemplu, putem obține documentul cu id-ul 1
.
** Rezultat
un obiect de răspuns care include datele din documentul solicitat
Utilizaţi {{appwrite1.data}}
pentru a obţine toată valoarea returnată.
actualizează datele unui document existent într-o colecție.
Input
Proprietăți | Necesar | Descriere |
---|---|---|
ID document | necesar | un identificator unic atribuit unui document de colectare a bazei de date |
Date | opţional | Un obiect care conține câmpurile și valorile actualizate pe care doriți să le atribuiți documentului. |
De exemplu, pentru a actualiza un document într-o colecție folosind metoda updateDocument
, puteţi pune 1
pentru id-ul documentului şi {{{"Name":"Fred"}}}
pentru date.
** Rezultat
un obiect de răspuns care include datele din documentul solicitat
şterge un document specific dintr-o colecţie din baza de date
Input
Proprietăți | Necesar | Descriere |
---|---|---|
ID document | necesar | un identificator unic atribuit unui document de colectare a bazei de date |
De exemplu, putem șterge documentul cu id-ul 1
.
** Rezultat
un obiect de răspuns care confirmă eliminarea cu succes a documentului.
recuperează mai multe documente dintr-o colecție din baza de date
Input
Proprietăți | Necesar | Descriere |
---|---|---|
Filtrare | opţional | să definească condițiile de filtrare a documentelor pe baza unor câmpuri și valori specifice |
Ordonare după | opţional | precizează câmpul prin care documentele rezultate trebuie sortate |
Limită | opţional | limitează numărul de documente returnate în setul de rezultate |
De exemplu, pentru a afișa toate documentele cu Nume = James.
** Rezultat
O serie de documente care satisfac filtrul.
Utilizaţi {{appwrite1.data[0].documents}}
pentru a primi valoarea returnată.