Εισαγωγή στα Custom JSON Requests
Τα custom JSON requests σας επιτρέπουν να έχετε πλήρη έλεγχο στα δεδομένα που συγχρονίζονται από το SoftOne ERP στο OpenCart. Αντί να χρησιμοποιείτε τα προκαθορισμένα πεδία, μπορείτε να ορίσετε ακριβώς ποια πεδία θέλετε να μεταφέρετε και πώς θα αντιστοιχιστούν.
Αυτή η λειτουργία είναι ιδανική για περιπτώσεις όπου θέλετε να συγχρονίσετε συγκεκριμένα πεδία από το SoftOne που δεν καλύπτονται από τις προεπιλεγμένες ρυθμίσεις, ή όταν χρειάζεστε εξατομικευμένη λογική για τη μεταφορά δεδομένων.
Σημείωση
Η λειτουργία custom JSON requests απαιτεί βασική κατανόηση της δομής των δεδομένων στο SoftOne και του πώς λειτουργεί το API του συστήματος.
getBrowserInfo Method
Η μέθοδος getBrowserInfo χρησιμοποιείται για τη λήψη δομικών πληροφοριών και διαθέσιμων πεδίων από τα αντικείμενα του SoftOne. Είναι ιδανική για να ανακαλύψετε ποια πεδία είναι διαθέσιμα για συγχρονισμό.
Default Template για getBrowserInfo
{
"service": "getBrowserInfo",
"clientID": "%clientid%",
"appId": "%appid%",
"object": "Item",
"list": "",
"filters": ""
} Χαρακτηριστικά getBrowserInfo
- Σκοπός: Ανάκτηση δομικών πληροφοριών για τα αντικείμενα
- Επιστρέφει: Διαθέσιμα πεδία, τύπους δεδομένων, και ιδιότητες
- Χρήση: Ιδανικό για την αρχική ρύθμιση και ανακάλυψη πεδίων
- Object: Συχνά "Item" για προϊόντα
getBrowserData Method
Η μέθοδος getBrowserData χρησιμοποιείται για την πραγματική ανάκτηση δεδομένων από το SoftOne. Αυτή η μέθοδος απαιτεί ένα συγκεκριμένο request ID (reqID) που προέρχεται από προηγούμενη κλήση.
Default Template για getBrowserData
{
"service": "getBrowserData",
"clientID": "%clientid%",
"appId": "%appid%",
"reqID": "%reqid%"
} Χαρακτηριστικά getBrowserData
- Σκοπός: Ανάκτηση πραγματικών δεδομένων από το SoftOne
- Απαιτεί: Έγκυρο reqID από προηγούμενη κλήση getBrowserInfo
- Επιστρέφει: Τα πραγματικά δεδομένα των προϊόντων
- Χρήση: Για τον τελικό συγχρονισμό δεδομένων
Σημαντική Διαφορά
Το getBrowserInfo χρησιμοποιείται για να ανακαλύψετε ποια πεδία είναι διαθέσιμα, ενώ το getBrowserData χρησιμοποιείται για να ανακτήσετε τα πραγματικά δεδομένα χρησιμοποιώντας το reqID που παίρνετε από το πρώτο βήμα.
Βήμα 1: Ενεργοποίηση Ρυθμίσεων
Για να ξεκινήσετε τη διαδικασία συγχρονισμού των προϊόντων, πρέπει πρώτα να ενεργοποιήσετε τις κατάλληλες ρυθμίσεις:
- Μεταβείτε στο μενού: CSL SoftOne -> Ρυθμίσεις -> Προϊόντα
- Ενεργοποιήστε το Βήμα 1: Από το μενού Advanced Επιλογές, ενεργοποιήστε το Βήμα 1 των προϊόντων
- Ενεργοποιήστε το Βήμα 2: Ενεργοποιήστε επίσης το Βήμα 2 των προϊόντων
- Επιλέξτε τη μέθοδο: Επιλέξτε μεταξύ getBrowserInfo ή getBrowserData ανάλογα με τις ανάγκες σας
- Εισαγάγετε το JSON Request: Στο πεδίο JSON Request, εισάγετε το κατάλληλο template
Προσοχή
Για το getBrowserInfo: Βεβαιωθείτε ότι έχετε εισάγει τα σωστά %clientid% και %appid%
Για το getBrowserData: Βεβαιωθείτε ότι έχετε εισάγει το %reqid% από το Βήμα 1
Βήμα 2: Εκτέλεση Συγχρονισμού
Αφού έχετε ρυθμίσει το JSON request, ακολουθήστε τα παρακάτω βήματα για να εκτελέσετε τον συγχρονισμό:
- Μεταβείτε στο μενού: CSL SoftOne -> Έλεγχος και αποστολή στη SoftOne
- Επιλέξτε τα προϊόντα: Από τη λίστα, επιλέξτε τα προϊόντα που θέλετε να συγχρονίσετε
- Εκτελέστε τη διαδικασία: Πατήστε το κουμπί εκτέλεσης για να ξεκινήσει η λήψη των δεδομένων
Μετά την ολοκλήρωση της διαδικασίας, το σύστημα θα έχει κατεβάσει όλα τα πεδία που έχετε ορίσει στο SoftOne και θα είναι έτοιμο για αντιστοίχιση.
Αντιστοίχιση Πεδίων
Μόλις ολοκληρωθεί η λήψη των δεδομένων, μπορείτε να προχωρήσετε στην αντιστοίχιση των πεδίων:
- Πατήστε το μπλε κουμπί: "Σύνδεση πεδίων προϊόντων με OpenCart"
- Αντιστοιχίστε τα πεδία: Στη σελίδα ρυθμίσεων που εμφανίζεται:
- Αριστερή στήλη: Πεδία από τη SoftOne
- Δεξιά στήλη: Πεδία από τη βάση δεδομένων του OpenCart
- Αποθηκεύστε τις αλλαγές: Η αποθήκευση γίνεται αυτόματα με κάθε κλικ
Status Ενημερώσεων
• Πράσινη ένδειξη: Τα δεδομένα έχουν αποθηκευτεί επιτυχώς
• Γκρι ένδειξη: Η αποθήκευση είναι σε εξέλιξη
• Κόκκινη ένδειξη: Υπάρχει κάποιο πρόβλημα
Custom Rules
Αφού ολοκληρώσετε τη βασική αντιστοίχιση πεδίων, μπορείτε να δημιουργήσετε και custom rules για πιο εξειδικευμένες ανάγκες:
- Μετασχηματισμός δεδομένων: Εφαρμόστε custom λογική για τη μετατροπή τιμών
- Φιλτράρισμα: Ορίστε συνθήκες για το ποιες εγγραφές θα εισαχθούν
- Υπολογισμοί: Δημιουργήστε υπολογισμένα πεδία βάσει άλλων πεδίων
- Συνθήκες: Εφαρμόστε διαφορετική λογική ανάλογα με τις τιμές των πεδίων
Παραδείγματα Custom JSON Requests
Παραδείγματα getBrowserInfo
Παράδειγμα 1: Βασική Λήψη Όλων των Πεδίων
{
"service": "getBrowserInfo",
"clientID": "%clientid%",
"appId": "%appid%",
"object": "Item",
"list": "",
"filters": ""
} Παράδειγμα 2: Φιλτράρισμα με Συνθήκες
{
"service": "getBrowserInfo",
"clientID": "%clientid%",
"appId": "%appid%",
"object": "Item",
"list": "",
"filters": "ISACTIVE = 1 AND ITEMCATEGORY = 'ELECTRONICS'"
} Παράδειγμα 3: Επιλογή Συγκεκριμένων Λιστών
{
"service": "getBrowserInfo",
"clientID": "%clientid%",
"appId": "%appid%",
"object": "Item",
"list": "ITEMPRICELIST",
"filters": ""
} Παραδείγματα getBrowserData
Παράδειγμα 1: Βασική Ανάκτηση Δεδομένων
{
"service": "getBrowserData",
"clientID": "%clientid%",
"appId": "%appid%",
"reqID": "%reqid%"
} Σημείωση για getBrowserData
Η τιμή %reqid% αντικαθίσταται αυτόματα με το request ID που παίρνετε από την εκτέλεση του Βήματος 1 (getBrowserInfo). Δεν χρειάζεται να την εισάγετε χειροκίνητα.
Troubleshooting
Κοινά Προβλήματα και Λύσεις
Πρόβλημα: Τα δεδομένα δεν κατεβαίνουν
Λύση:
• Ελέγξτε τα στοιχεία clientID και appId
• Βεβαιωθείτε ότι το SoftOne API είναι προσβάσιμο
• Επαληθεύστε τη σύνταξη του JSON request
Πρόβλημα: Κόκκινη ένδειξη κατά την αποθήκευση
Λύση:
• Ελέγξτε τα δικαιώματα πρόσβασης στη βάση δεδομένων
• Βεβαιωθείτε ότι τα πεδία αντιστοιχούν σωστά
• Ελέγξτε τα logs του συστήματος για λεπτομέρειες
Πρόβλημα: Κανένα αποτέλεσμα από τα filters
Λύση:
• Επαληθεύστε τα ονόματα των πεδίων στο SoftOne
• Ελέγξτε τη σύνταξη των συνθηκών
• Δοκιμάστε χωρίς filters για να βεβαιωθείτε ότι η σύνδεση λειτουργεί
Βέλτιστες Πρακτικές
- Τεστ σε μικρό αριθμό προϊόντων: Πάντα κάντε τεστ με μερικά προϊόντα πριν εφαρμόσετε ολόκληρη τη διαδικασία
- Backup δεδομένων: Κάντε always backup της βάσης δεδομένων του OpenCart πριν από σημαντικές αλλαγές
- Τεκμηρίωση: Κρατήστε σημειώσεις για τα custom requests που δημιουργείτε
- Σταδιακή εφαρμογή: Εφαρμόστε τις αλλαγές σταδιακά και ελέγχετε τα αποτελέσματα σε κάθε βήμα
Σχετικοί οδηγοί
- Custom κλήσεις SoftOne API στο OpenCart
Η γενική λογική για API calls και JSON responses μέσα από τη γέφυρα.
- Συγχωνευμένες κλήσεις API
Πώς να μειώσετε τις ξεχωριστές κλήσεις όταν χρειάζεστε δομή και δεδομένα μαζί.
- Βήματα διασύνδεσης SoftOne με OpenCart
Οι απαραίτητες προϋποθέσεις πριν ξεκινήσει ο συγχρονισμός προϊόντων.
Χρειάζεστε Υποστήριξη;
Αν αντιμετωπίσετε δυσκολίες με τη δημιουργία custom JSON requests ή χρειάζεστε βοήθεια με τη ρύθμιση του συγχρονισμού, η ομάδα υποστήριξης είναι διαθέσιμη να σας βοηθήσει.
Μπορείτε να επικοινωνήσετε μαζί μας για:
- Βοήθεια με τη δημιουργία custom JSON requests
- Επίλυση προβλημάτων συγχρονισμού
- Βελτιστοποίηση της απόδοσης
- Custom ανάπτυξη για ειδικές ανάγκες
