ILLA home page
  1. AppWrite

AppWrite in Illa is een database-integratie waarmee u verbinding en interactie kunt maken met een AppWrite database. Appwrite is een populair open-source database management systeem dat bekend staat om zijn snelheid, betrouwbaarheid en gebruiksgemak.

Met de Appwrite integratie in Illa, kunt u de data van een Appwrite database opzoeken, invoegen, bijwerken en verwijderen met behulp van SQL commando’s. U kunt ook aangepaste SQL-query’s maken en uitvoeren binnen Illa. Dit maakt het makkelijk om data-driven applicaties en dashboards te bouwen die real-time gegevens weergeven uit een Appwrite database.

Deze handleiding schetst het proces van het maken van een Admin Panel met behulp van ILLA Builder en Appwrite in een paar eenvoudige stappen. ILLA is een laag programmeerplatform voor ontwikkelaars dat het mogelijk maakt interne hulpmiddelen snel te ontwikkelen en te implementeren. Het maakt het mogelijk om pagina’s te maken door UI-componenten te slepen en te laten vallen, door verbinding te maken met elke database of API en door JavaScript te schrijven. Ga voor meer informatie over Appwriting naar hun website op https://appwrite.io/ Laten we beginnen!

Stel uw Back end in op AppWrite

Na het inloggen op uw Appwrite account, op het Appwrite dashboard, klikt u op **Create project** en zet de naam op First Project.

app_create_project

Dan kunnen we naar de projectpagina navigeren. Appwrite biedt meerdere platforms voor het bouwen van uw app en integraties.

app_platforms

Hier kiezen we Web App als voorbeeld.

Na het aanmaken van ons web-app project kunnen we naar de databasepagina gaan omdat we alleen Appwrite gebruiken als een database-integratie tot nu toe.

app_dashboard

Daarna kunnen we database aanmaken en collecties aanmaken binnen de database

app_create_database Vanaf hier kunnen we kenmerken en gegevens maken in de collectie.

app_create_data

Om documenten op basis van kenmerken op te halen, moeten we overeenkomstige indexen maken voor elke attribuut.

app_create_index

Deze database is nu klaar om te integreren met Illa.

Maak AppWrite

Er zijn twee manieren om een bron in Illa te maken nadat je bent ingelogd op je Illa account.

  • Maak in Bronnen

Log in op je Illa account, selecteer **Resources** bovenaan de pagina, en klik op de **Maak Nieuw** knop.

external_resource

Selecteer AppWrite uit de database lijst.

action_list

Maak verbinding met de database met de vereiste parameters beschreven in Connectie Instellingen hieronder.

Klik op **Test Connection** om te zien of we met succes verbinding kunnen maken met de database. Zo ja, klik Resources, anders controleer je de hostnaam, port, gebruikersnaam en wachtwoord correct.

Na het maken van een bron, wordt de aangepaste AppWrite weergegeven zoals getoond.

app_ex_ready

  • Maak in Bouwer

Log in op je Illa account, maak een project aan in Illa Builder in de **App** pagina en navigeer naar de Action List onderaan de pagina. Klik op **nieuw**, en selecteer dan AppWrite uit de database lijst. Maak vervolgens verbinding met de database met de vereiste parameters beschreven in Connectie Instellingen hieronder.

Klik op **Test Connection** om te zien of we met succes verbinding kunnen maken met de database. Zo ja, klik Resources, anders controleer je de hostnaam, port, gebruikersnaam en wachtwoord correct.

Verbindingsinstellingen

Hier moeten we informatie verstrekken voor het verbinden met de AppWrite database.

app_config

EigenschappenvereistBeschrijving
naamverplichtDe naam voor resource bij het maken van acties in de ILLA.
HostnaamverplichtDe URL of het IP-adres van uw database
Database IDverplichtunieke id toegewezen aan elke database gemaakt binnen Appwrite
Project IDverplichtunieke id die uw hele Appwrite project vertegenwoordigt
API sleutelverplichteen geheime token die dient als een vorm van authenticatie bij het indienen van API-verzoeken op de Appwrite server

Om de vereiste Host, Database ID, Project ID, en API key in Appwrite, we gaan eerst naar de **instelling** knop in de linker onderhoek van de projectpagina.

Kopiëren van de project ID voor project ID en API Endpoint voor Host in de Appwrite configuratie in Illa.

app_setting

Dan kunnen we op dezelfde pagina op de View API Keys knop klikken. Als je nog geen API hebt aangemaakt voor dit project, Klik op de Create API Key knop en selecteer alleen Database map, want dat is wat we zullen gebruiken vanuit Appwrite.

app_api_key

Kopieer de API Key Secret voor API key in Illa configuratie. Het kan op deze twee plekken worden gekopieerd.

app_key_secret

Wat we over hebben is de Database ID die we kunnen vinden in de Database pagina. Kopiëren en plakken in de Appwrite configuratie in Illa.

app_database

Het eindproduct zou er zo uit moeten zien.

app_final_config

Acties aanmaken

We hebben een AppWrite document gemaakt, we kunnen de actie toevoegen door AppWrite uit de actie lijst te selecteren en te kiezen voor de Create action knop.

app_resource_list

Nu hebben we de AppWrite server toegevoegd als actie aan onze bouwpagina.

app

AppWrite configureren

Overzicht.

Methode NaamBeschrijving
MethodeEen document maken, een document ophalen, een document bijwerken, verwijderen van een document, lijst met documenten
Verzameling IDeen unieke identifier toegewezen aan een database-collectie
Transformatordata omzetten naar de stijl die je leuk vindt met behulp van JavaScript

Een document aanmaken

maak een nieuw document aan in een collectie

Input

EigenschappenvereistBeschrijving
Document IDverplichteen unieke id toegewezen aan een database collectie document
Gegevensoptioneeleen object met de velden en waarden van het nieuwe document.

Bijvoorbeeld, om een nieuw document te maken in een collectie met twee velden - name en age, je kan 1 gebruiken als document ID en {{ {"Name": "David", "Age": 18}}} voor data.

Uitvoer

een responsobject dat de ID van het nieuwe document bevat, evenals extra metadata zoals de datum en tijd van de creatie.

app_create_code

Document ophalen

een specifiek document ophalen uit een collectie in de database

Input

EigenschappenvereistBeschrijving
Document IDverplichteen unieke id toegewezen aan een database collectie document

We kunnen het document bijvoorbeeld krijgen met id 1.

Uitvoer

een antwoord object dat de gegevens van het gevraagde document bevat

app_get_data

Gebruik {{appwrite1.data}} om alle geretourneerde waarde te krijgen.

app_get_code

Een document bijwerken

de gegevens van een bestaand document in een collectie bijwerken.

Input

EigenschappenvereistBeschrijving
Document IDverplichteen unieke id toegewezen aan een database collectie document
GegevensoptioneelEen object met de bijgewerkte velden en waarden die u wilt toewijzen aan het document.

Bijvoorbeeld, om een document in een verzameling bij te werken met behulp van de updateDocument methode. je kunt 1 voor document id en {{{"Name":"Fred"}}} plaatsen voor gegevens.

Uitvoer

een antwoord object dat de gegevens van het gevraagde document bevat

app_update)data

Verwijder een document

verwijder een specifiek document uit een collectie in de database

Input

EigenschappenvereistBeschrijving
Document IDverplichteen unieke id toegewezen aan een database collectie document

We kunnen het document met id 1 verwijderen.

Uitvoer

een reactie-object dat het met succes verwijderen van het document bevestigt.

app_delete_data

Lijst document

meerdere documenten ophalen uit een collectie in de database

Input

EigenschappenvereistBeschrijving
Filterenoptioneeldefinieer voorwaarden om documenten te filteren gebaseerd op specifieke velden en waarden
Sorteer opoptioneelspecificeer het veld waarop de resulterende documenten moeten worden gesorteerd
Limietoptioneelbeperken van het aantal documenten geretourneerd in de resultaatset

Bijvoorbeeld, het tonen van alle documenten met naam = James.

Uitvoer

Een reeks documenten die aan het filter voldoen.

app_list_data

Gebruik {{appwrite1.data[0].documents}} om de waarde terug te krijgen.

app_list_code