🔨 Integrasjoner
AppWrite in Illa er en databaseintegrasjon som lar deg koble til og kommunisere med en AppWrite database. Appwrite er et populært relasjonssystem for database med åpen kildekode som er kjent for sin hastighet, pålitelighet og bruksfrihet.
Med integrasjonen Appwrite i Illa, kan du spørre, innstille, oppdatere og slette data fra en skrivedatabase ved å bruke SQL-kommandoer. Du kan også opprette egendefinerte SQL-spørringer og kjøre dem i Illa. Dette gjør det enkelt å bygge data-drevne programmer og dashbord som viser sanntidsdata fra en Appwrite database.
Denne veiledningen viser prosessen med å lage et Admin-panel ved hjelp av ILLA Builder og Appwrite i noen enkle trinn. ILLA er en lavkode-plattform for utviklere som gjør det mulig å raskt utvikle og ta i bruk interne verktøy. Det åpner for å opprette sider ved å dra og slippe UI komponenter, koble til database eller API, og skrive JavaScript. For å lære mer om Appwrite, besøk nettsiden deres på https://appwrite.io/ La oss begynne!
Etter å ha logget deg inn på Appwrite dashboard, klikk **Create project**
og la navnet First Project
.
Da kan vi navigere til prosjektsiden. Appwrite tilbyr flere plattformer for bygging av appen din og integrasjoner.
Her velger vi Web App som et eksempel.
Etter at vi har opprettet nett-appprosjektet vårt, kan vi gå til databasesiden siden siden vi bare bruker Appwrite som en databaseintegrasjon så langt.
Da kan vi lage databasen og opprette samlinger i databasen
Fra her kan vi lage attributter og data i samlingen.
For å hente dokumenter fra attributter, må vi gjøre tilsvarende indekser for hvert attributt.
Denne databasen er nå klar til å integrere med Illa.
Det er to måter å lage en ressurs i Illa etter å ha logget på din Illa-konto.
Logg deg på din Illa konto, velg **Ressurser**
på toppen av siden, og klikk **Opprett ny
-knappen.
Velg AppWrite
fra databaselisten.
Koble til databasen med de nødvendige parametrene beskrevet i “Tilkoblingsinnstillinger” nedenfor.
Klikk **Test oppkobling**
for å se om vi har lykkes i å koble til databasen. Hvis ja, klikk Lagre ressurser
, eller dobbeltsjekk vertsnavn, port, brukernavn og passord er riktig.
Etter oppretting av en ressurs, vil AppWrite vises som vist.
Logg deg på din Illa konto, opprett et prosjekt i Illa Builder på **
siden, og naviger til Handlingslisten
nederst på siden. Klikk **new**
, og velg AppWrite
fra databaselisten. Deretter kan du koble til databasen med nødvendige parametere beskrevet i “Tilkoblingsinnstillinger” nedenfor.
Klikk **Test oppkobling**
for å se om vi har lykkes i å koble til databasen. Hvis ja, klikk Lagre ressurser
, eller dobbeltsjekk vertsnavn, port, brukernavn og passord er riktig.
Her må vi gi informasjon for å koble til AppWrite database.
Egenskaper | Påkrevd | Beskrivelse |
---|---|---|
Navn | obligatorisk | Navnet på ressursen når det skapes handlinger i ILLA. |
Vert | obligatorisk | URL-adressen eller IP-adressen for databasen din |
Database ID | obligatorisk | unik identifikator som er tilordnet hver database opprettet i Appwrite |
Prosjekt ID | obligatorisk | unik identifikator som representerer hele Appwrite prosjektet |
API nøkkel | obligatorisk | et hemmelig token som fungerer som et slags autentisering når du oppretter API forespørsler til Appwrite serveren |
For å finne den nødvendige Vert
, Database ID
, prosjektID
, og API key
i Appwrite, vi går først til **innstilling**
knappen nederst til venstre på prosjektsiden.
Kopierer prosjekt ID
for prosjekt ID
og API Endpoint
for Host
i Appwrite konfigurasjonen i Illa.
Da kan vi klikke på Vis API-nøkler
-knappen på samme side. Hvis du ikke har laget noen API for dette prosjektet, Klikk Opprett API Key
** knappen og velg kun Database
mappen siden det er hva vi vil bruke fra Appwrite.
Kopier API Key Secret
for API key
i Illa konfigurasjon. Den kan kopieres for disse to søkene.
Det vi har igjen er Database ID
som vi finner i Database
-siden. Kopiering og lim inn på appwrite konfigurasjonen i Illa.
Det endelige produktet skal se omtrent slik ut.
Vi har laget en AppWrite resource, vi kan legge til handlingen ved å velge AppWrite fra handlingslisten og velge Create action
knappen.
Nå har vi lagt til AppWrite server som en handling på byggesiden vår.
Metodenavn (Automatic Translation) | Beskrivelse |
---|---|
Metode | Opprett et dokument, Få et dokument, oppdater et dokument, Slett et dokument, Liste over dokumenter |
Samling ID | en unik identifikator som er tilordnet en databasesamling |
Transformator | transformerer data til stilen du ønsker å bruke JavaScript |
opprett et nytt dokument i en samling
Input
Egenskaper | Påkrevd | Beskrivelse |
---|---|---|
Dokument ID | obligatorisk | en unik identifikator som er knyttet til et databasesamlingsdokument |
Data | valgfritt | et objekt som inneholder feltene og verdiene i det nye dokumentet. |
For eksempel for å opprette et nytt dokument i en samling med to felt - name
og age
, du kan bruke 1 som document ID
og {{ {"navn": "David", "Age": 18}}
for data
.
** utgang
et svarobjekt som inkluderer ID til det nyopprettede dokumentet, i tillegg til ekstra metadata som for eksempel dato og klokkeslett.
hente et spesifikt dokument fra en samling i databasen
Input
Egenskaper | Påkrevd | Beskrivelse |
---|---|---|
Dokument ID | obligatorisk | en unik identifikator som er knyttet til et databasesamlingsdokument |
For eksempel, kan vi få dokumentet med id 1
.
** utgang
et svarobjekt som omfatter dataene til det forespurte dokumentet
Bruk `{{appwrite1.data}}for å få all returnert verdi.
oppdatere dataene til et eksisterende dokument i en innsamling.
Input
Egenskaper | Påkrevd | Beskrivelse |
---|---|---|
Dokument ID | obligatorisk | en unik identifikator som er knyttet til et databasesamlingsdokument |
Data | valgfritt | Et objekt som inneholder de oppdaterte feltene og verdiene som du ønsker å tilordne dokumentet. |
For eksempel for å oppdatere et dokument i en samling ved hjelp av updateDocument
-metode, du kan putte 1
for dokument-ID og {{{"Name":"Fred"}}}
for data.
** utgang
et svarobjekt som omfatter dataene til det forespurte dokumentet
η app_update)data](https://cdn.illacloud.com/official-website/img/docs/app_update_data.png)
slette et spesifikt dokument fra samlingen i databasen
Input
Egenskaper | Påkrevd | Beskrivelse |
---|---|---|
Dokument ID | obligatorisk | en unik identifikator som er knyttet til et databasesamlingsdokument |
For eksempel kan vi slette dokumentet med id 1
.
** utgang
et svarobjekt som bekrefter vellykket sletting av dokumentet.
hente flere dokumenter fra en samling i databasen
Input
Egenskaper | Påkrevd | Beskrivelse |
---|---|---|
Filtrer | valgfritt | angi vilkår for filtrering av dokumentene basert på spesifikke felter og verdier |
Sorter etter | valgfritt | angi feltet som de resulterende dokumentene bør sorteres etter |
Grense | valgfritt | begrense antallet dokumenter som er returnert i resultatsettet |
For eksempel, for å liste opp alle dokumenter med Name = James.
** utgang
En rekke dokumenter som tilfredsstiller filteret.
Bruk `{{appwrite1.data[0].documents}}for å bli returnert verdi.