Μετάβαση στο κύριο περιεχόμενο

Προσαρμοσμένες οντότητες

Μάθετε πώς να δημιουργείτε και να διαχειρίζεστε προσαρμοσμένα αντικείμενα δεδομένων πέρα από την ενσωματωμένη οντότητα Χρηστών.

Τι είναι οι Προσαρμοσμένες οντότητες;

Οι Προσαρμοσμένες οντότητες (γνωστές και ως Προσαρμοσμένα αντικείμενα) σάς επιτρέπουν να ορίζετε και να αποθηκεύετε οποιονδήποτε τύπο δομημένων δεδομένων στο Joryio. Σκεφτείτε τες ως προσαρμοσμένους πίνακες βάσης δεδομένων που δημιουργείτε μέσα από το UI.

Συνηθισμένες περιπτώσεις χρήσης:

  • Προϊόντα - Αποθηκεύστε καταλόγους προϊόντων με τιμές, SKU, περιγραφές
  • Παραγγελίες - Παρακολουθήστε ιστορικό παραγγελιών και δεδομένα αγορών
  • Απόθεμα - Διαχειριστείτε επίπεδα αποθεμάτων και δεδομένα αποθηκών
  • Περιεχόμενο - Αποθηκεύστε άρθρα, βίντεο ή άλλο περιεχόμενο
  • Τοποθεσίες - Αποθηκεύστε τοποθεσίες καταστημάτων ή γραφείων
  • Συμφωνίες - Παρακολουθήστε ευκαιρίες πωλήσεων
  • Συνδρομές - Διαχειριστείτε προγράμματα και βαθμίδες συνδρομών

Βασικές δυνατότητες

Ευέλικτος ορισμός σχήματος

  • Ορίστε προσαρμοσμένα πεδία με 18+ τύπους πεδίων
  • Ρυθμίστε κανόνες επικύρωσης ανά πεδίο
  • Προσθέστε ευρετήρια για απόδοση αναζήτησης
  • Ελέγξτε την ορατότητα των πεδίων και τη σειρά εμφάνισης

Πλήρεις λειτουργίες CRUD

  • Δημιουργία, ανάγνωση, ενημέρωση και διαγραφή εγγραφών
  • Δυνατότητες μαζικής εισαγωγής
  • Αναζήτηση και φιλτράρισμα εγγραφών
  • Εξαγωγή δεδομένων

Προηγμένες δυνατότητες

  • Ίχνος ελέγχου - Παρακολουθήστε όλες τις αλλαγές στις εγγραφές
  • Εκδόσεις - Κρατήστε ιστορικό των τροποποιήσεων εγγραφών
  • Ήπια διαγραφή - Επισημάνετε εγγραφές ως διαγραμμένες αντί να τις αφαιρέσετε
  • Σχέσεις - Συνδέστε οντότητες μεταξύ τους (μελλοντική δυνατότητα)

Ξεκινώντας

Δημιουργία της πρώτης σας οντότητας

  1. Μεταβείτε στις Οντότητες από το κύριο μενού

  2. Κάντε κλικ στη «Δημιουργία οντότητας»

  3. Ρυθμίστε τις βασικές ρυθμίσεις:

    • Εμφανιζόμενο όνομα (π.χ. «Προϊόντα»)
    • Εσωτερικό όνομα (π.χ. «products») - μόνο πεζά, με κάτω παύλες
    • Περιγραφή
    • Πεδίο εμφάνισης - ποιο πεδίο εμφανίζεται στις λίστες
  4. Προσθέστε πεδία για τη δομή των δεδομένων σας

  5. Ρυθμίστε τις επιλογές (προαιρετικό)

  6. Κάντε κλικ στη «Δημιουργία»

Παράδειγμα: Οντότητα Προϊόντων

Ας δημιουργήσουμε μια οντότητα Προϊόντων για τον κατάλογο προϊόντων σας:

Ρυθμίσεις οντότητας:

  • Εμφανιζόμενο όνομα: Products
  • Εσωτερικό όνομα: products
  • Πεδίο εμφάνισης: name
  • Περιγραφή: Product catalog with pricing and inventory

Πεδία:

  1. SKU (String)

    • Υποχρεωτικό: Ναι
    • Μοναδικό: Ναι
    • Με ευρετήριο: Ναι
  2. Name (String)

    • Υποχρεωτικό: Ναι
    • Μέγιστο μήκος: 255
  3. Description (Markdown)

    • Υποχρεωτικό: Όχι
  4. Price (Currency)

    • Υποχρεωτικό: Ναι
    • Ελάχιστο: 0
  5. Stock Quantity (Integer)

    • Υποχρεωτικό: Ναι
    • Ελάχιστο: 0
  6. Image URL (Image URL)

    • Υποχρεωτικό: Όχι
  7. Category (String)

    • Με ευρετήριο: Ναι
  8. Active (Boolean)

    • Προεπιλογή: true

Τύποι πεδίων

Το Joryio υποστηρίζει 18+ τύπους πεδίων:

Τύποι κειμένου

  • String - Σύντομο κείμενο (ονόματα, τίτλοι)
  • Email - Διευθύνσεις email με επικύρωση
  • Phone - Αριθμοί τηλεφώνου
  • URL - Διευθύνσεις web με επικύρωση
  • Markdown - Εμπλουτισμένο κείμενο με υποστήριξη markdown
  • HTML - Ακατέργαστο περιεχόμενο HTML
  • JSON - Δομημένα δεδομένα JSON

Αριθμητικοί τύποι

  • Number - Δεκαδικοί αριθμοί
  • Integer - Μόνο ακέραιοι αριθμοί
  • Currency - Χρηματικές αξίες με δεκαδική ακρίβεια
  • Percentage - Ποσοστιαίες τιμές

Τύποι ημερομηνίας/ώρας

  • Date - Μόνο ημερομηνία (χωρίς ώρα)
  • DateTime - Ημερομηνία και ώρα

Άλλοι τύποι

  • Boolean - Τιμές αληθές/ψευδές
  • Image URL - URL προς εικόνες (αποδίδει μικρογραφία)
  • File URL - URL προς αρχεία

Μελλοντικοί τύποι

  • Reference - Σύνδεσμος προς άλλη οντότητα (έρχεται σύντομα)
  • Array - Πολλαπλές τιμές (έρχεται σύντομα)

Επικύρωση πεδίων

Ρυθμίστε κανόνες επικύρωσης για κάθε πεδίο:

Συνηθισμένες επικυρώσεις

  • Υποχρεωτικό - Το πεδίο πρέπει να έχει τιμή
  • Μοναδικό - Δεν επιτρέπονται διπλότυπες τιμές
  • Ελάχιστο/Μέγιστο - Για αριθμούς (π.χ. τιμή >= 0)
  • Ελάχιστο/Μέγιστο μήκος - Για συμβολοσειρές (π.χ. SKU μεταξύ 5-20 χαρακτήρων)
  • Μοτίβο - Επικύρωση με κανονική έκφραση
  • Enum - Περιορισμός σε συγκεκριμένες τιμές

Παραδείγματα

Πεδίο Email:

Type: Email
Required: Yes
Validation: Email format automatically validated

Πεδίο τιμής:

Type: Currency
Required: Yes
Min: 0
Max: 999999

Πεδίο SKU:

Type: String
Required: Yes
Unique: Yes
Min Length: 5
Max Length: 20
Indexed: Yes

Διαχείριση εγγραφών

Προσθήκη εγγραφών

  1. Ανοίξτε την οντότητά σας από τη λίστα Οντοτήτων
  2. Κάντε κλικ στην «Προσθήκη εγγραφής»
  3. Συμπληρώστε τη φόρμα (δημιουργείται αυτόματα από το σχήμα σας)
  4. Κάντε κλικ στη «Δημιουργία»

Η φόρμα προσαρμόζεται αυτόματα στους τύπους των πεδίων σας:

  • Πεδία string → Πεδία κειμένου
  • Αριθμητικά πεδία → Αριθμητικές είσοδοι
  • Πεδία ημερομηνίας → Εργαλεία επιλογής ημερομηνίας
  • Πεδία boolean → Πλαίσια επιλογής
  • Και άλλα...

Προβολή εγγραφών

Οι εγγραφές εμφανίζονται σε έναν δυναμικό πίνακα με στήλες για κάθε πεδίο:

  • Ταξινόμηση κατά οποιαδήποτε στήλη
  • Αναζήτηση σε όλα τα πεδία
  • Σελιδοποίηση σε μεγάλα σύνολα δεδομένων
  • Απόδοση ανά τύπο (ημερομηνίες, νομίσματα, εικόνες)

Επεξεργασία εγγραφών

  1. Κάντε κλικ στο εικονίδιο επεξεργασίας σε οποιαδήποτε εγγραφή
  2. Τροποποιήστε τα πεδία
  3. Κάντε κλικ στην «Ενημέρωση»

Όλες οι αλλαγές παρακολουθούνται αν είναι ενεργοποιημένο το ίχνος ελέγχου.

Διαγραφή εγγραφών

  1. Κάντε κλικ στο εικονίδιο διαγραφής σε οποιαδήποτε εγγραφή
  2. Επιβεβαιώστε τη διαγραφή

Αν είναι ενεργοποιημένη η ήπια διαγραφή, οι εγγραφές επισημαίνονται ως διαγραμμένες αλλά δεν αφαιρούνται από τη βάση δεδομένων.

Ιστορικό αλλαγών

Κάθε οντότητα διατηρεί ίχνος ελέγχου ανά εγγραφή, το οποίο μπορείτε να εξερευνήσετε στο UI. Ένα κουμπί Ιστορικό στη σελίδα εγγραφών (και σε κάθε επιμέρους εγγραφή) ανοίγει ένα συρτάρι που παραθέτει κάθε δημιουργία, ενημέρωση και διαγραφή: ποια πεδία άλλαξαν, ποιος έκανε την αλλαγή, πότε, και τις τιμές πριν/μετά. Χρησιμοποιήστε το για να δείτε πώς εξελίχθηκε μια εγγραφή ή για να διερευνήσετε μια απροσδόκητη τιμή.

Ρυθμίσεις οντότητας

Ίχνος ελέγχου

Όταν είναι ενεργοποιημένο, το Joryio καταγράφει:

  • Ποιος δημιούργησε/τροποποίησε κάθε εγγραφή
  • Τι άλλαξε
  • Πότε έγιναν οι αλλαγές

Αποκτήστε πρόσβαση στα αρχεία ελέγχου μέσω του API ή της διεπαφής διαχείρισης.

Εκδόσεις

Κρατήστε πλήρες ιστορικό όλων των αλλαγών εγγραφών:

  • Επαναφορά σε προηγούμενες εκδόσεις
  • Σύγκριση εκδόσεων
  • Παρακολούθηση της εξέλιξης των δεδομένων στον χρόνο

Ήπια διαγραφή

Αντί για οριστική διαγραφή εγγραφών:

  • Επισήμανση ως διαγραμμένων με μια ένδειξη
  • Διατήρηση δεδομένων για λόγους συμμόρφωσης
  • Επαναφορά διαγραμμένων εγγραφών αν χρειαστεί

Να επιτρέπονται διπλότυπα

Από προεπιλογή, τα διπλότυπα αποτρέπονται. Απενεργοποιήστε το για να επιτρέψετε:

  • Πολλαπλές εγγραφές με τις ίδιες τιμές
  • Χρήσιμο για αρχεία συμβάντων ή συναλλαγές

Αναζήτηση και φιλτράρισμα

Αναζήτηση

Αναζητήστε σε όλα τα πεδία με ευρετήριο:

  • Αναζήτηση πλήρους κειμένου
  • Χωρίς διάκριση πεζών-κεφαλαίων
  • Υποστηρίζονται μερικές αντιστοιχίσεις

Τελεστές φίλτρων στις Επιλογές (Selections)

Οι Επιλογές (Selections) φιλτράρουν εγγραφές με συνθήκες ανά πεδίο: ισούται / δεν ισούται, μεγαλύτερο/μικρότερο από (ή ίσο), περιέχει, υπάρχει, και το ζεύγος πολλαπλών τιμών Είναι ένα από / Δεν είναι ένα από - εισαγάγετε πολλές τιμές χωρισμένες με κόμματα (π.χ. ER, ICU, NICU) και η εγγραφή ταιριάζει αν το πεδίο της ισούται με οποιαδήποτε από αυτές. Οι αριθμητικές τιμές ταιριάζουν είτε η εγγραφή τις αποθηκεύει ως αριθμό είτε ως συμβολοσειρά. Συνδυάστε συνθήκες με AND/OR.

Φίλτρα (μέσω API)

Εφαρμόστε σύνθετα φίλτρα μέσω του API:

{
filter: {
price: { $gte: 10, $lte: 100 },
category: "Electronics",
active: true
},
sort: { price: -1 },
limit: 20
}

Απόδοση Επιλογών και προτάσεις ευρετηρίων

Η προβολή Επιλογών περιλαμβάνει ένα πάνελ απόδοσης που παραθέτει τις κορυφαίες σας Επιλογές κατά χρήση και προτείνει ευρετήρια βάσης δεδομένων για να επιταχύνει αυτές που εκτελείτε συχνότερα. Κάθε πρόταση συνοδεύεται από προτεραιότητα· ένα κουμπί Δημιουργία προτεινόμενων ευρετηρίων τις εφαρμόζει, ώστε οι Επιλογές που χρησιμοποιούνται συχνά να επιλύονται ταχύτερα.

Συμβουλές απόδοσης

Ευρετηρίαση

Προσθέστε ευρετήρια στα πεδία στα οποία συχνά:

  • Αναζητάτε
  • Φιλτράρετε
  • Ταξινομείτε

Παράδειγμα: Αν συχνά αναζητάτε κατά SKU ή φιλτράρετε κατά κατηγορία, προσθέστε ευρετήριο σε αυτά τα πεδία.

Σειρά πεδίων

Ορίστε το displayOrder για να ελέγξετε:

  • Τη σειρά των πεδίων στη φόρμα
  • Τη σειρά των στηλών στον πίνακα
  • Τη βελτιστοποίηση της εμπειρίας χρήστη

Κρυφά πεδία

Επισημάνετε πεδία ως κρυφά αν είναι:

  • Μόνο για εσωτερική χρήση
  • Μη απαραίτητα στις προεπιλεγμένες προβολές
  • Τεχνικά μεταδεδομένα

Περιπτώσεις χρήσης

E-commerce

Οντότητες:

  • Προϊόντα (SKU, όνομα, τιμή, εικόνες)
  • Παραγγελίες (αναγνωριστικό παραγγελίας, είδη, σύνολο, κατάσταση)
  • Απόθεμα (αποθήκη, ποσότητα, τοποθεσία)
  • Κατηγορίες (όνομα, περιγραφή, γονική)

Ροή εργασίας:

  • Εισαγωγή καταλόγου προϊόντων
  • Ενεργοποίηση καμπανιών βάσει χαμηλού αποθέματος
  • Αποστολή επιβεβαιώσεων παραγγελιών
  • Εξατομίκευση προτάσεων προϊόντων

Διαχείριση περιεχομένου

Οντότητες:

  • Άρθρα (τίτλος, περιεχόμενο, συντάκτης, ετικέτες)
  • Βίντεο (τίτλος, URL, διάρκεια, κατηγορία)
  • Συντάκτες (όνομα, βιογραφικό, φωτογραφία)

Ροή εργασίας:

  • Αποθήκευση βιβλιοθήκης περιεχομένου
  • Αναφορά σε καμπάνιες email
  • Εξατομίκευση προτάσεων περιεχομένου
  • Παρακολούθηση απόδοσης περιεχομένου

Πλατφόρμα SaaS

Οντότητες:

  • Συνδρομές (πρόγραμμα, τιμή, δυνατότητες)
  • Δυνατότητες (όνομα, περιγραφή, βαθμίδα)
  • Μετρικές χρήσης (μετρική, τιμή, περίοδος)

Ροή εργασίας:

  • Παρακολούθηση κατάστασης συνδρομών
  • Ενεργοποίηση καμπανιών αναβάθμισης
  • Παρακολούθηση χρήσης δυνατοτήτων
  • Υπολογισμός χρεώσεων

Ενσωμάτωση

Με καμπάνιες

Αναφέρετε δεδομένα οντοτήτων σε πρότυπα email χρησιμοποιώντας το φίλτρο catalog:

Λήψη όλων των εγγραφών από μια οντότητα:

{% assign products = 'products' | catalog %}

{% for product in products %}
<h3>{{ product.name }}</h3>
<p>Price: ${{ product.price }}</p>
<img src="{{ product.image_url }}" />
{% endfor %}

Λήψη εγγραφών με μια προρυθμισμένη Επιλογή (με φίλτρα/ταξινόμηση):

{% assign featuredProducts = 'products' | catalog: 'featured_items' %}

{% for product in featuredProducts %}
<h3>{{ product.name }}</h3>
<p>Price: ${{ product.price }}</p>
{% endfor %}

Σημειώσεις:

  • Χωρίς Επιλογή: επιστρέφει έως 50 εγγραφές
  • Με Επιλογή: χρησιμοποιεί τα ρυθμισμένα φίλτρα, την ταξινόμηση και το όριο της Επιλογής
  • Τα ονόματα οντότητας και Επιλογής πρέπει να ταιριάζουν ακριβώς όπως έχουν οριστεί στον χώρο εργασίας σας

Με το Canvas (δημιουργός journeys)

Χρησιμοποιήστε δεδομένα οντοτήτων για να:

  • Ενεργοποιείτε journeys
  • Διακλαδώνετε βάσει τιμών
  • Εξατομικεύετε μηνύματα
  • Παρακολουθείτε μετατροπές

Με τμήματα

Τμηματοποιήστε χρήστες βάσει των σχέσεών τους με οντότητες:

  • Χρήστες που αγόρασαν συγκεκριμένα προϊόντα
  • Χρήστες με ενεργές συνδρομές
  • Χρήστες σε συγκεκριμένες τοποθεσίες

Πρόσβαση μέσω API

Πλήρες REST API για προγραμματιστική πρόσβαση:

// List entities
GET /api/entities

// Create entity
POST /api/entities
{
"name": "products",
"displayName": "Products",
"fields": [...]
}

// List records
GET /api/entities/:entityId/records

// Create record
POST /api/entities/:entityId/records
{
"sku": "PROD-001",
"name": "Widget",
"price": 29.99
}

Δείτε την Αναφορά API Οντοτήτων για την πλήρη τεκμηρίωση.

Καλές πρακτικές

Σχεδίαση σχήματος

  1. Ξεκινήστε απλά - Προσθέτετε πεδία όταν χρειάζονται
  2. Χρησιμοποιήστε ονόματα με νόημα - Σαφή, περιγραφικά ονόματα πεδίων
  3. Ευρετηριάστε έξυπνα - Προσθέστε ευρετήρια μόνο στα πεδία όπου θα αναζητάτε/φιλτράρετε
  4. Επικυρώστε τα δεδομένα - Ορίστε κατάλληλους κανόνες επικύρωσης
  5. Τεκμηριώστε τον σκοπό - Χρησιμοποιήστε περιγραφές για σύνθετα πεδία

Ποιότητα δεδομένων

  1. Επιβάλετε μοναδικότητα - Όπου χρειάζεται (SKU, email)
  2. Κάντε υποχρεωτικά τα κρίσιμα πεδία - Μην αφήνετε τα πάντα προαιρετικά
  3. Ορίστε λογικές προεπιλογές - Διευκολύνετε την εισαγωγή δεδομένων
  4. Επικυρώστε μορφές - Χρησιμοποιήστε τους κατάλληλους τύπους πεδίων
  5. Καθαρίζετε τακτικά - Αφαιρείτε παρωχημένες εγγραφές

Απόδοση

  1. Περιορίστε τον αριθμό εγγραφών - Αρχειοθετήστε παλιά δεδομένα
  2. Χρησιμοποιήστε σελιδοποίηση - Μη φορτώνετε όλες τις εγγραφές μαζί
  3. Ευρετηριάστε στρατηγικά - Ισορροπήστε ταχύτητα ερωτημάτων και αποθηκευτικό χώρο
  4. Χρησιμοποιήστε cache όπου γίνεται - Για δεδομένα με συχνή πρόσβαση

Αντιμετώπιση προβλημάτων

Δεν μπορώ να δημιουργήσω οντότητα

  • Ελέγξτε τη μορφή του εσωτερικού ονόματος (μόνο πεζά, με κάτω παύλες)
  • Επαληθεύστε ότι το όνομα δεν χρησιμοποιείται ήδη
  • Βεβαιωθείτε ότι έχετε το απαραίτητο δικαίωμα

Οι εγγραφές δεν εμφανίζονται

  • Ελέγξτε τα φίλτρα/τους όρους αναζήτησης
  • Επαληθεύστε την επιλογή χώρου εργασίας
  • Ελέγξτε την κατάσταση ήπιας διαγραφής

Αργά ερωτήματα

  • Προσθέστε ευρετήρια στα φιλτραρισμένα πεδία
  • Μειώστε το μέγεθος του συνόλου αποτελεσμάτων
  • Βελτιστοποιήστε τα ερωτήματα φίλτρων

Επόμενα βήματα

Σχετικές δυνατότητες