🔨 Integrationer
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!
Efter att du loggat in på ditt Appwrite-konto klickar du på **Create project**
och anger namnet till First Project
.
Då kan vi navigera till projektsidan. Appwrite tillhandahåller flera plattformar för att bygga din app samt integrationer.
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.
Då kan vi skapa databas och skapa samlingar i databasen
Härifrån kan vi skapa attribut och data i samlingen.
För att hämta dokument genom attribut måste vi göra motsvarande index för varje attribut.
Denna databas är nu redo för dig att integrera med Illa.
Det finns två sätt att skapa en resurs i Illa efter att du loggat in på ditt Illa konto.
Logga in på ditt Illa konto, välj **Resurser**
högst upp på sidan och klicka på **Skapa ny**
-knappen.
Välj AppWrite
från databaslistan.
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.
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.
Här måste vi tillhandahålla information för att ansluta till AppWrite databas.
Egenskaper | Krävs | Beskrivning |
---|---|---|
Namn | obligatorisk | Namnet på resursen när du skapar åtgärder i ILLA. |
Värd | obligatorisk | URL eller IP-adress för din databas |
Databas ID | obligatorisk | unik identifierare tilldelad till varje databas som skapats i Appwrite |
Projekt ID | obligatorisk | unik identifierare som representerar hela ditt Appwrite-projekt |
API nyckel | obligatorisk | en 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.
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.
Kopiera API Key Secret
för API key
i Illa konfiguration. Det kan kopieras för dessa två fläckar.
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.
Slutprodukten bör se ut ungefär så här.
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.
Nu har vi lagt till AppWrite servern som en åtgärd till vår byggsida.
Metod Namn | Beskrivning |
---|---|
Metod | Skapa ett dokument, Hämta ett dokument, Uppdatera ett dokument, Radera ett dokument, Lista dokument |
Samlings-ID | en unik identifierare tilldelad till en databassamling |
Transformator | omvandlar data till den stil du vill använda JavaScript |
skapa ett nytt dokument i en samling
Input
Egenskaper | Krävs | Beskrivning |
---|---|---|
Dokument ID | obligatorisk | en unik identifierare tilldelad till ett databassamlingsdokument |
Data | valfri | ett 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.
hämta ett specifikt dokument från en samling i databasen
Input
Egenskaper | Krävs | Beskrivning |
---|---|---|
Dokument ID | obligatorisk | en 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
Använd {{appwrite1.data}}
för att få allt returnerat värde.
uppdatera data för ett befintligt dokument i en samling.
Input
Egenskaper | Krävs | Beskrivning |
---|---|---|
Dokument ID | obligatorisk | en unik identifierare tilldelad till ett databassamlingsdokument |
Data | valfri | Ett 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
ta bort ett specifikt dokument från en samling i databasen
Input
Egenskaper | Krävs | Beskrivning |
---|---|---|
Dokument ID | obligatorisk | en 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.
hämta flera dokument från en samling i databasen
Input
Egenskaper | Krävs | Beskrivning |
---|---|---|
Filtrera | valfri | definiera villkor för att filtrera dokument baserat på specifika fält och värden |
Sortera efter | valfri | ange det fält genom vilket de resulterande dokumenten ska sorteras |
Gräns | valfri | begrä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.
Använd {{appwrite1.data[0].documents}}
för att få tillbaka värde.