- AppWrite
🔨 Ενσωματώσεις
AppWrite
ContributeΤι είναι το AppWrite?
AppWrite σε Illa είναι μια ενσωμάτωση της βάσης δεδομένων που σας επιτρέπει να συνδεθείτε και να αλληλεπιδράσετε με μια βάση δεδομένων AppWrite . Appwrite είναι ένα δημοφιλές συσχετιακό σύστημα διαχείρισης βάσεων δεδομένων ανοικτού κώδικα που είναι γνωστό για την ταχύτητα, την αξιοπιστία και την ευκολία χρήσης.
Με την ενσωμάτωση Appwrite στην Illa, μπορείτε να ρωτήσετε, να εισαγάγετε, να ενημερώσετε και να διαγράψετε δεδομένα από μια βάση δεδομένων Appwrite χρησιμοποιώντας εντολές SQL. Μπορείτε επίσης να δημιουργήσετε προσαρμοσμένα ερωτήματα SQL και να τα εκτελέσετε μέσα Illa. Αυτό το καθιστά εύκολο να οικοδομήσουμε τις εφαρμογές δεδομένων και τους πίνακες ελέγχου που εμφανίζουν δεδομένα σε πραγματικό χρόνο από μια βάση δεδομένων Appwrite
Αυτό το σεμινάριο περιγράφει τη διαδικασία δημιουργίας ενός Πίνακα Διαχειριστή χρησιμοποιώντας ILLA Builder και Appwrite σε μερικά απλά βήματα. Το ILLA είναι μια πλατφόρμα χαμηλού κώδικα για προγραμματιστές που επιτρέπει την ταχεία ανάπτυξη και ανάπτυξη εσωτερικών εργαλείων. Επιτρέπει τη δημιουργία σελίδων σύροντας και απορρίπτοντας στοιχεία UI, που συνδέονται με οποιαδήποτε βάση δεδομένων ή API, και γράφοντας JavaScript. Για να μάθετε περισσότερα σχετικά με το Appwrite, επισκεφθείτε την ιστοσελίδα τους στο https://appwrite.io/ Ας ξεκινήσουμε!
Ρυθμίστε το Πίσω Τέλος στο AppWrite
Μετά την είσοδο στον λογαριασμό σας Appwrite στο Appwrite dashboard, κάντε κλικ στο κουμπί **Δημιουργία έργου** και ορίστε το όνομα σε First Project.
Στη συνέχεια, μπορούμε να πλοηγηθούμε στη σελίδα του έργου. Το Appwrite παρέχει πολλαπλές πλατφόρμες για την κατασκευή της εφαρμογής σας, καθώς και ενσωματώσεις.
Εδώ επιλέγουμε την εφαρμογή Web ως παράδειγμα.
Μετά τη δημιουργία μας Web app project, μπορούμε να πάμε στη σελίδα της βάσης δεδομένων δεδομένου ότι χρησιμοποιούμε μόνο Appwrite ως ενσωμάτωση της βάσης δεδομένων μέχρι στιγμής.
Στη συνέχεια, μπορούμε να δημιουργήσουμε βάση δεδομένων και να δημιουργήσουμε συλλογές μέσα στη βάση δεδομένων
Από εδώ μπορούμε να δημιουργήσουμε χαρακτηριστικά και δεδομένα στη συλλογή.
Προκειμένου να ανακτήσουμε τα έγγραφα από τα χαρακτηριστικά, πρέπει να κάνουμε αντίστοιχα ευρετήρια για κάθε χαρακτηριστικά.
Αυτή η βάση δεδομένων είναι τώρα έτοιμη για να ενσωματώσετε με Illa.
Δημιουργία AppWrite
Υπάρχουν δύο τρόποι για να δημιουργήσετε έναν πόρο στην Illa μετά την είσοδό σας στο λογαριασμό Illa.
- Δημιουργία σε πόρους
Συνδεθείτε στον Illa λογαριασμό σας, επιλέξτε **Πόροι** στην κορυφή της σελίδας και κάντε κλικ στο κουμπί **Δημιουργία Νέου**.
Επιλέξτε AppWrite από τη λίστα της βάσης δεδομένων.
Συνδεθείτε στη βάση δεδομένων με τις απαιτούμενες παραμέτρους που περιγράφονται στις παρακάτω ρυθμίσεις σύνδεσης.
Κάντε κλικ στο κουμπί **Δοκιμή Σύνδεσης** για να δείτε αν μπορούμε να συνδεθείτε με επιτυχία στη βάση δεδομένων. Εάν ναι, κάντε κλικ στο Αποθήκευση πόρων, αλλιώς, ελέγξτε ξανά το όνομα κεντρικού υπολογιστή, τη θύρα, το όνομα χρήστη και τον κωδικό πρόσβασης είναι σωστά.
Μετά τη δημιουργία ενός πόρου, το έτοιμο AppWrite θα εμφανίζεται όπως εμφανίζεται.
- Δημιουργία στο Builder
Συνδεθείτε στον Illa λογαριασμό σας, δημιουργήστε ένα έργο στο Illa Builder στη σελίδα **App**, και πλοηγηθείτε στο Λίστα Ενεργειών στο κάτω μέρος της σελίδας. Κάντε κλικ στο κουμπί **new**, στη συνέχεια επιλέξτε AppWrite από τη λίστα της βάσης δεδομένων. Στη συνέχεια, συνδεθείτε στη βάση δεδομένων με τις απαιτούμενες παραμέτρους που περιγράφονται στις “Ρυθμίσεις Σύνδεσης” παρακάτω.
Κάντε κλικ στο κουμπί **Δοκιμή Σύνδεσης** για να δείτε αν μπορούμε να συνδεθείτε με επιτυχία στη βάση δεδομένων. Εάν ναι, κάντε κλικ στο Αποθήκευση πόρων, αλλιώς, ελέγξτε ξανά το όνομα κεντρικού υπολογιστή, τη θύρα, το όνομα χρήστη και τον κωδικό πρόσβασης είναι σωστά.
Ρυθμίσεις Σύνδεσης
Εδώ πρέπει να παρέχουμε πληροφορίες για τη σύνδεση με τη βάση δεδομένων AppWrte.
| Ιδιότητες | Απαιτείται | Περιγραφή |
|---|---|---|
| Όνομα | απαιτείται | Το όνομα του πόρου κατά τη δημιουργία ενεργειών στο ILLA. |
| Διακομιστής | απαιτείται | Η διεύθυνση URL ή IP για τη βάση δεδομένων σας |
| Id Βάσης Δεδομένων | απαιτείται | μοναδικό αναγνωριστικό ανατέθηκε σε κάθε βάση δεδομένων που δημιουργήθηκε στο Appwrite |
| ID Έργου | απαιτείται | μοναδικό αναγνωριστικό που αντιπροσωπεύει ολόκληρο το έργο Appwrite |
| API κλειδί | απαιτείται | ένα μυστικό διακριτικό που χρησιμεύει ως μια μορφή ελέγχου ταυτότητας κατά την υποβολή αιτήσεων API στο διακομιστή Appwrite |
Για να βρείτε το απαιτούμενο Host, ID βάσης δεδομένων, ID έργου, και κλειδί API στο Appwrite, πρώτα πάμε στο κουμπί **ρύθμιση** στην κάτω αριστερή γωνία της σελίδας του έργου.
Αντιγράφοντας το ID έργου για το ID έργου και το API τελικό σημείο για το Host στη διαμόρφωση Appwrite στο Illa.
Στη συνέχεια, μπορεί να κάνετε κλικ στο κουμπί Προβολή κλειδιών API στην ίδια σελίδα. Αν δεν έχετε δημιουργήσει ένα API για αυτό το έργο, κάντε κλικ στο κουμπί Δημιουργία κλειδιού API και επιλέξτε μόνο φάκελο Βάση Δεδομένων δεδομένου ότι αυτό θα χρησιμοποιούμε από το Appwrite.
Αντιγράψτε το API Key Secret για το API key στη ρύθμιση παραμέτρων Illa. Μπορεί να αντιγραφεί για αυτά τα δύο σημεία.
Αυτό που έχουμε απομείνει είναι το Database ID που μπορούμε να βρούμε στη Σελίδα Database. Αντιγράφοντάς το και επικολλήστε το στη διαμόρφωση Appwrite στο Illa.
Το τελικό προϊόν θα πρέπει να μοιάζει κάπως έτσι.
Δημιουργία Ενεργειών
Έχουμε δημιουργήσει έναν πόρο AppWrite μπορούμε να προσθέσουμε την ενέργεια επιλέγοντας AppWrite από τη λίστα ενεργειών και επιλέγοντας το κουμπί Δημιουργία δράσης.
Τώρα έχουμε προσθέσει τον διακομιστή AppWrite ως ενέργεια στη σελίδα μας κτηρίου.
Ρύθμιση AppWrite
Επισκόπηση
| Όνομα Μεθόδου | Περιγραφή |
|---|---|
| Μέθοδος | Δημιουργία εγγράφου, Λήψη εγγράφου, Ενημέρωση εγγράφου, Διαγραφή εγγράφου, Λίστα εγγράφων |
| Id Συλλογής | ένα μοναδικό αναγνωριστικό που έχει ανατεθεί σε μια συλλογή βάσεων δεδομένων |
| Μετασχηματιστής | μετατρέποντας τα δεδομένα σε στυλ που σας αρέσει χρησιμοποιώντας JavaScript |
Δημιουργία εγγράφου
δημιουργήστε ένα νέο έγγραφο σε μια συλλογή
Input
| Ιδιότητες | Απαιτείται | Περιγραφή |
|---|---|---|
| Αναγνωριστικό Εγγράφου | απαιτείται | μοναδικό αναγνωριστικό που έχει αποδοθεί σε έγγραφο συλλογής βάσης δεδομένων |
| Δεδομένα | προαιρετικό | ένα αντικείμενο που περιέχει τα πεδία και τις τιμές του νέου εγγράφου. |
Για παράδειγμα, για να δημιουργήσετε ένα νέο έγγραφο σε μια συλλογή με δύο πεδία - name και age, μπορείτε να χρησιμοποιήσετε το 1 ως document ID και {{{"Όνομα": "David", "Ηλικία": 18}}} για data.
Έξοδος
ένα αντικείμενο απόκρισης που περιλαμβάνει το αναγνωριστικό του νεοδημιουργηθέντος εγγράφου, καθώς και πρόσθετα μεταδεδομένα, όπως η ημερομηνία και η ώρα δημιουργίας.
Λήψη εγγράφου
ανάκτηση ενός συγκεκριμένου εγγράφου από μια συλλογή στη βάση δεδομένων
Input
| Ιδιότητες | Απαιτείται | Περιγραφή |
|---|---|---|
| Αναγνωριστικό Εγγράφου | απαιτείται | μοναδικό αναγνωριστικό που έχει αποδοθεί σε έγγραφο συλλογής βάσης δεδομένων |
Για παράδειγμα, μπορούμε να πάρουμε το έγγραφο με id 1.
Έξοδος
αντικείμενο απόκρισης που περιλαμβάνει τα δεδομένα του ζητούμενου εγγράφου
Χρησιμοποίησε το {{appwrite1.data}} για να λάβεις όλη την τιμή που επέστρεψε.
Ενημέρωση ενός εγγράφου
επικαιροποιεί τα δεδομένα υφιστάμενου εγγράφου σε συλλογή.
Input
| Ιδιότητες | Απαιτείται | Περιγραφή |
|---|---|---|
| Αναγνωριστικό Εγγράφου | απαιτείται | μοναδικό αναγνωριστικό που έχει αποδοθεί σε έγγραφο συλλογής βάσης δεδομένων |
| Δεδομένα | προαιρετικό | Ένα αντικείμενο που περιέχει τα ενημερωμένα πεδία και τιμές που θέλετε να αντιστοιχίσετε στο έγγραφο. |
Για παράδειγμα, για να ενημερώσετε ένα έγγραφο σε μια συλλογή χρησιμοποιώντας τη μέθοδο updateDocument, μπορείς να βάλεις 1 για αναγνωριστικό εγγράφου και {{{"Name":"Fred"}}} για δεδομένα.
Έξοδος
αντικείμενο απόκρισης που περιλαμβάνει τα δεδομένα του ζητούμενου εγγράφου
Διαγραφή εγγράφου
διαγραφή συγκεκριμένου εγγράφου από μια συλλογή στη βάση δεδομένων
Input
| Ιδιότητες | Απαιτείται | Περιγραφή |
|---|---|---|
| Αναγνωριστικό Εγγράφου | απαιτείται | μοναδικό αναγνωριστικό που έχει αποδοθεί σε έγγραφο συλλογής βάσης δεδομένων |
Για παράδειγμα, μπορούμε να διαγράψουμε το έγγραφο με id 1.
Έξοδος
ένα αντικείμενο απάντησης που επιβεβαιώνει την επιτυχή διαγραφή του εγγράφου.
Έγγραφο λίστας
ανάκτηση πολλαπλών εγγράφων από μια συλλογή στη βάση δεδομένων
Input
| Ιδιότητες | Απαιτείται | Περιγραφή |
|---|---|---|
| Φίλτρο | προαιρετικό | καθορίζει τις συνθήκες φιλτραρίσματος των εγγράφων που βασίζονται σε συγκεκριμένα πεδία και τιμές |
| Ταξινόμηση κατά | προαιρετικό | προσδιορίζει το πεδίο με το οποίο θα πρέπει να ταξινομηθούν τα προκύπτοντα έγγραφα |
| Όριο | προαιρετικό | περιορίζει τον αριθμό των επιστρεφόμενων εγγράφων στο σύνολο αποτελεσμάτων |
Για παράδειγμα, για να απαριθμήσετε όλα τα έγγραφα με το όνομα = James.
Έξοδος
Μια σειρά εγγράφων που ικανοποιούν το φίλτρο.
Χρησιμοποίησε το {{appwrite1.data[0].documents}} για να λάβεις τιμή επιστροφής.
