🔨 Integraties
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!
Na het inloggen op uw Appwrite account, op het Appwrite dashboard, klikt u op **Create project**
en zet de naam op First Project
.
Dan kunnen we naar de projectpagina navigeren. Appwrite biedt meerdere platforms voor het bouwen van uw app en integraties.
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.
Daarna kunnen we database aanmaken en collecties aanmaken binnen de database
Vanaf hier kunnen we kenmerken en gegevens maken in de collectie.
Om documenten op basis van kenmerken op te halen, moeten we overeenkomstige indexen maken voor elke attribuut.
Deze database is nu klaar om te integreren met Illa.
Er zijn twee manieren om een bron in Illa te maken nadat je bent ingelogd op je Illa account.
Log in op je Illa account, selecteer **Resources**
bovenaan de pagina, en klik op de **Maak Nieuw**
knop.
Selecteer AppWrite
uit de database lijst.
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.
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.
Hier moeten we informatie verstrekken voor het verbinden met de AppWrite database.
Eigenschappen | vereist | Beschrijving |
---|---|---|
naam | verplicht | De naam voor resource bij het maken van acties in de ILLA. |
Hostnaam | verplicht | De URL of het IP-adres van uw database |
Database ID | verplicht | unieke id toegewezen aan elke database gemaakt binnen Appwrite |
Project ID | verplicht | unieke id die uw hele Appwrite project vertegenwoordigt |
API sleutel | verplicht | een 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.
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.
Kopieer de API Key Secret
voor API key
in Illa configuratie. Het kan op deze twee plekken worden gekopieerd.
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.
Het eindproduct zou er zo uit moeten zien.
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.
Nu hebben we de AppWrite server toegevoegd als actie aan onze bouwpagina.
Methode Naam | Beschrijving |
---|---|
Methode | Een document maken, een document ophalen, een document bijwerken, verwijderen van een document, lijst met documenten |
Verzameling ID | een unieke identifier toegewezen aan een database-collectie |
Transformator | data omzetten naar de stijl die je leuk vindt met behulp van JavaScript |
maak een nieuw document aan in een collectie
Input
Eigenschappen | vereist | Beschrijving |
---|---|---|
Document ID | verplicht | een unieke id toegewezen aan een database collectie document |
Gegevens | optioneel | een 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.
een specifiek document ophalen uit een collectie in de database
Input
Eigenschappen | vereist | Beschrijving |
---|---|---|
Document ID | verplicht | een 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
Gebruik {{appwrite1.data}}
om alle geretourneerde waarde te krijgen.
de gegevens van een bestaand document in een collectie bijwerken.
Input
Eigenschappen | vereist | Beschrijving |
---|---|---|
Document ID | verplicht | een unieke id toegewezen aan een database collectie document |
Gegevens | optioneel | Een 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
verwijder een specifiek document uit een collectie in de database
Input
Eigenschappen | vereist | Beschrijving |
---|---|---|
Document ID | verplicht | een 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.
meerdere documenten ophalen uit een collectie in de database
Input
Eigenschappen | vereist | Beschrijving |
---|---|---|
Filteren | optioneel | definieer voorwaarden om documenten te filteren gebaseerd op specifieke velden en waarden |
Sorteer op | optioneel | specificeer het veld waarop de resulterende documenten moeten worden gesorteerd |
Limiet | optioneel | beperken 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.
Gebruik {{appwrite1.data[0].documents}}
om de waarde terug te krijgen.