ILLA home page
  1. AppWrite

AppWrite in Illa är en databasintegration som låter dig ansluta och interagera med en AppWrite databas. Appwrite är ett populärt relationssystem med öppen källkod som är känt för sin hastighet, tillförlitlighet och användarvänlighet.

Med Appwrite-integrationen i Illa, kan du söka, infoga och uppdatera och ta bort data från en Appwrite-databas med SQL-kommandon. Du kan också skapa anpassade SQL-frågor och köra dem inom Illa. Detta gör det enkelt att bygga datadrivna applikationer och instrumentpaneler som visar realtidsdata från en Appwrite-databas.

Denna handledning beskriver processen att skapa en Admin Panel med hjälp av ILLA Builder och Appwrite i några få enkla steg. ILLA är en lågkodsplattform för utvecklare som möjliggör snabb utveckling och distribution av interna verktyg. Det gör det möjligt att skapa sidor genom att dra och släppa UI-komponenter, ansluta till någon databas eller API, och skriva JavaScript. För att lära dig mer om Appwrite, besök deras hemsida på https://appwrite.io/ Låt oss börja!

Ställ in din baksida på AppWrite

Efter att du loggat in på ditt Appwrite-konto klickar du på **Create project** och anger namnet till First Project.

app_create_project

Då kan vi navigera till projektsidan. Appwrite tillhandahåller flera plattformar för att bygga din app samt integrationer.

app_platforms

Här väljer vi webbapp som exempel.

Efter att ha skapat vårt webbapplikationsprojekt kan vi gå till databassidan eftersom vi bara använder Appwrite som en databasintegration hittills.

app_dashboard

Då kan vi skapa databas och skapa samlingar i databasen

app_create_database Härifrån kan vi skapa attribut och data i samlingen.

app_create_data

För att hämta dokument genom attribut måste vi göra motsvarande index för varje attribut.

app_create_index

Denna databas är nu redo för dig att integrera med Illa.

Skapa AppWrite

Det finns två sätt att skapa en resurs i Illa efter att du loggat in på ditt Illa konto.

  • Skapa i resurser

Logga in på ditt Illa konto, välj **Resurser** högst upp på sidan och klicka på **Skapa ny**-knappen.

external_resource

Välj AppWrite från databaslistan.

action_list

Anslut till databasen med de parametrar som beskrivs i Connection Settings nedan.

Klicka på **Test Connection** för att se om vi framgångsrikt kan ansluta till databasen. Om ja, klicka Spara resurser, annat, dubbelkolla värdnamn, port, användarnamn och lösenord är korrekt.

Efter att en resurs skapats, kommer den färdiga AppWrite att visas som den visas.

app_ex_ready

  • Skapa i Builder

Logga in på ditt Illa konto, skapa ett projekt i Illa Builder på sidan **App** och navigera till Action List längst ner på sidan. Klicka på **new**, välj sedan AppWrite från databaslistan. Anslut sedan till databasen med nödvändiga parametrar som beskrivs i Connection Settings nedan.

Klicka på **Test Connection** för att se om vi framgångsrikt kan ansluta till databasen. Om ja, klicka Spara resurser, annat, dubbelkolla värdnamn, port, användarnamn och lösenord är korrekt.

Inställningar för anslutning

Här måste vi tillhandahålla information för att ansluta till AppWrite databas.

app_config

EgenskaperKrävsBeskrivning
NamnobligatoriskNamnet på resursen när du skapar åtgärder i ILLA.
VärdobligatoriskURL eller IP-adress för din databas
Databas IDobligatoriskunik identifierare tilldelad till varje databas som skapats i Appwrite
Projekt IDobligatoriskunik identifierare som representerar hela ditt Appwrite-projekt
API nyckelobligatorisken hemlig token som fungerar som en form av autentisering när du gör API-förfrågningar till Appwrite-servern

För att hitta den nödvändiga Host, Databas-ID, Project ID, och API key i Appwrite, vi går först till **setting**-knappen längst ner till vänster på projektsidan.

Kopierar project ID för project ID och API Endpoint för Host i Appwrite-konfigurationen i Illa.

app_setting

Då kan vi klicka på View API Keys knappen på samma sida. Om du inte har skapat ett API för detta projekt, Klicka på Create API Key-knappen och välj bara Database-mappen eftersom det är vad vi kommer att använda från Appwrite.

app_api_key

Kopiera API Key Secret för API key i Illa konfiguration. Det kan kopieras för dessa två fläckar.

app_key_secret

Vad vi har kvar är Databas-ID som vi kan hitta i sidan Database. Kopiera den och klistra in den på Appwrite-konfigurationen i Illa.

app_database

Slutprodukten bör se ut ungefär så här.

app_final_config

Skapa åtgärder

Vi har skapat en AppWrite resurs, vi kan lägga till åtgärden genom att välja AppWrite från åtgärdslistan och välja Create action knappen.

app_resource_list

Nu har vi lagt till AppWrite servern som en åtgärd till vår byggsida.

app

Konfigurera AppWrite

Översikt

Metod NamnBeskrivning
MetodSkapa ett dokument, Hämta ett dokument, Uppdatera ett dokument, Radera ett dokument, Lista dokument
Samlings-IDen unik identifierare tilldelad till en databassamling
Transformatoromvandlar data till den stil du vill använda JavaScript

Skapa ett dokument

skapa ett nytt dokument i en samling

Input

EgenskaperKrävsBeskrivning
Dokument IDobligatorisken unik identifierare tilldelad till ett databassamlingsdokument
Datavalfriett objekt som innehåller det nya dokumentets fält och värden.

Till exempel för att skapa ett nytt dokument i en samling med två fält - name och age, du kan använda 1 som document ID och {{"Name": "David", "Ålder": 18}}} för data.

utdata

ett svarsobjekt som innehåller ID för det nyskapade dokumentet, samt ytterligare metadata som datum och tid för skapelsen.

app_create_code

Hämta ett dokument

hämta ett specifikt dokument från en samling i databasen

Input

EgenskaperKrävsBeskrivning
Dokument IDobligatorisken unik identifierare tilldelad till ett databassamlingsdokument

Till exempel kan vi få dokumentet med id 1.

utdata

ett svarsobjekt som innehåller data från det begärda dokumentet

app_get_data

Använd {{appwrite1.data}} för att få allt returnerat värde.

app_get_code

Uppdatera ett dokument

uppdatera data för ett befintligt dokument i en samling.

Input

EgenskaperKrävsBeskrivning
Dokument IDobligatorisken unik identifierare tilldelad till ett databassamlingsdokument
DatavalfriEtt objekt som innehåller de uppdaterade fält och värden som du vill tilldela dokumentet.

Till exempel för att uppdatera ett dokument i en samling med updateDocument metoden, du kan sätta 1 för dokument-id och {{{"Name":"Fred"}}} för data.

utdata

ett svarsobjekt som innehåller data från det begärda dokumentet

app_update)data

Ta bort ett dokument

ta bort ett specifikt dokument från en samling i databasen

Input

EgenskaperKrävsBeskrivning
Dokument IDobligatorisken unik identifierare tilldelad till ett databassamlingsdokument

Till exempel kan vi ta bort dokumentet med id 1.

utdata

ett svarsobjekt som bekräftar att dokumentet raderats framgångsrikt.

app_delete_data

Lista dokument

hämta flera dokument från en samling i databasen

Input

EgenskaperKrävsBeskrivning
Filtreravalfridefiniera villkor för att filtrera dokument baserat på specifika fält och värden
Sortera eftervalfriange det fält genom vilket de resulterande dokumenten ska sorteras
Gränsvalfribegränsa antalet dokument som returneras i resultatuppsättningen

Till exempel för att lista alla dokument med Namn = James.

utdata

En rad dokument som uppfyller filtret.

app_list_data

Använd {{appwrite1.data[0].documents}} för att få tillbaka värde.

app_list_code