Filodos

Σύνδεση SAP Business One

Για διαχειριστές: συνδέστε το SAP Business One με το Filodos μέσω του Service Layer της SAP. Η σύνδεση διαβάζει τους επιχειρηματικούς εταίρους ή τις αποθήκες σας, και μπορεί να γράφει μία δραστηριότητα στο SAP μετά από κάθε επίσκεψη. Μέρος της τεκμηρίωσης.

Τι κάνει η σύνδεση

  • Σημεία σε ζώνες. Το Filodos διαβάζει μία οντότητα του SAP, προεπιλεγμένα τους πελάτες στο BusinessPartners. Κάθε εγγραφή με συντεταγμένες γίνεται ζώνη στον χάρτη του στόλου. Δείτε Σημεία ERP και ζώνες.
  • Δραστηριότητες στο SAP. Όταν ένα όχημα βγαίνει από ζώνη, το Filodos μπορεί να δημιουργήσει μία δραστηριότητα (σημείωση) στον επιχειρηματικό εταίρο: ποιο όχημα, ποια ημερομηνία, και ώρα άφιξης και αναχώρησης. Δείτε Σημειώσεις επισκέψεων στο ERP.

Οι ρόλοι, το πρόγραμμα συγχρονισμού και οι ενέργειες παύσης και διαγραφής είναι ίδια με των άλλων συνδέσεων ERP. Δείτε Ποιος κάνει τι και Αλλαγή, παύση ή διαγραφή.

Τι χρειάζεστε

Ζητήστε αυτές τις τιμές από τον συνεργάτη SAP σας πριν ξεκινήσετε.

  1. SAP Business One 9.3 ή νεότερο, σε SAP HANA ή Microsoft SQL Server, με Service Layer.
  2. Τη διεύθυνση του Service Layer με τη θύρα και την έκδοση, για παράδειγμα https://sap.example.gr:50000/b1s/v1. Η έκδοση μπορεί να είναι v1 ή v2.
  3. Το όνομα της βάσης δεδομένων της εταιρείας, για παράδειγμα SBODEMOGR.
  4. Έναν χρήστη διασύνδεσης και τον κωδικό του. Ο χρήστης χρειάζεται άδεια με πρόσβαση στο Service Layer, δικαίωμα ανάγνωσης επιχειρηματικών εταίρων και, για σημειώσεις επισκέψεων, δικαίωμα εγγραφής δραστηριοτήτων.
  5. Συντεταγμένες: δύο πεδία ορισμένα από τον χρήστη στον επιχειρηματικό εταίρο, για παράδειγμα U_Latitude και U_Longitude. Το SAP Business One δεν έχει βασικά πεδία συντεταγμένων.
  6. Για σημειώσεις επισκέψεων: ένα πεδίο κειμένου ορισμένο από τον χρήστη στη δραστηριότητα, για παράδειγμα U_FilodosRef. Σταματά τις διπλές δραστηριότητες (δείτε Δραστηριότητες στο SAP).

Μη χρησιμοποιήσετε τον λογαριασμό manager. Δημιουργήστε ξεχωριστό χρήστη διασύνδεσης με τα ελάχιστα δικαιώματα που χρειάζονται.

Χρησιμοποιήστε πιστοποιητικό υπογεγραμμένο από δημόσια αρχή πιστοποίησης. Το Filodos δεν δέχεται αυτο-υπογεγραμμένο πιστοποιητικό. Πολλές εγκαταστάσεις Service Layer χρησιμοποιούν από προεπιλογή τέτοιο πιστοποιητικό. Ο συνεργάτης σας μπορεί να βάλει αντίστροφο διακομιστή μεσολάβησης (reverse proxy) με έγκυρο πιστοποιητικό μπροστά από το Service Layer.

Κάθε ανοιχτή συνεδρία Service Layer χρησιμοποιεί μία θέση άδειας. Το Filodos αποσυνδέεται μετά από κάθε συγχρονισμό και μετά από κάθε ομάδα σημειώσεων επισκέψεων, άρα δεν κρατά θέση.

Προσθήκη σύνδεσης

  1. Συνδεθείτε ως διαχειριστής. Ανοίξτε Organization → ERP.
  2. Στο New connection, επιλέξτε SAP Business One.
  3. Γράψτε ένα όνομα, τη διεύθυνση του Service Layer, τον χρήστη διασύνδεσης και τον κωδικό.
  4. Γράψτε τη βάση δεδομένων της εταιρείας (Company database).
  5. Πατήστε Add connection.
  6. Πατήστε Test login. Η απάντηση δείχνει το όνομα της εταιρείας και την έκδοση του Service Layer.
  7. Συνεχίστε με τα σημεία (δείτε Σημεία από το SAP).

Το Filodos αποθηκεύει τον κωδικό κρυπτογραφημένο. Ο πίνακας ελέγχου και το API δεν δείχνουν ποτέ ξανά αποθηκευμένο κωδικό.

Σημεία από το SAP

Στο πλαίσιο Workflow, ορίστε την οντότητα και το φίλτρο. Το φίλτρο είναι έκφραση OData $filter.

ΣημείαΟντότητα (Entity)ΦίλτροΚλειδί εγγραφήςΌνομα
Πελάτες (προεπιλογή)BusinessPartnersCardType eq 'cCustomer'CardCodeCardName
Μόνο ενεργοί πελάτεςBusinessPartnersCardType eq 'cCustomer' and Valid eq 'tYES'CardCodeCardName
Αποθήκες ως αφετηρίεςWarehousesκενόWarehouseCodeWarehouseName

Ορίστε τα Latitude και Longitude στα πεδία συντεταγμένων που ορίσατε εσείς. Τα ονόματα στηλών πρέπει να είναι απλά ονόματα ιδιοτήτων του SAP: γράμματα, ψηφία και _. Το Filodos διαβάζει μόνο τις στήλες που ορίζετε.

Πατήστε Save workflow και μετά Sync sites now. Οι υπόλοιποι κανόνες είναι στη σελίδα Σημεία ERP και ζώνες.

Δραστηριότητες στο SAP

Ενεργοποιήστε το Write a note into the ERP after each visit. Το Filodos συμπληρώνει μία δραστηριότητα στον επιχειρηματικό εταίρο:

ΠεδίοΤιμή
CardCode{site_key}
Activitycn_Note
ActivityDate{date_iso}
ActivityTime{arrived_time}
DetailsFilodos {vehicle} {arrived}-{departed}
Notes{text}

Μπορείτε να αλλάξετε την οντότητα, το πεδίο κλειδιού και κάθε γραμμή. Μετά πατήστε Save workflow.

Γράψτε το πεδίο που ορίσατε εσείς στο Dedupe field, για παράδειγμα U_FilodosRef. Το Filodos γράφει μία αναφορά σε αυτό το πεδίο. Πριν από κάθε νέα δραστηριότητα, το Filodos ψάχνει αυτή την αναφορά. Αν η δραστηριότητα υπάρχει, το Filodos δεν δημιουργεί δεύτερη. Χωρίς πεδίο αποφυγής διπλότυπων, μια χαμένη απάντηση από το SAP μπορεί να δώσει δεύτερη δραστηριότητα στη νέα προσπάθεια.

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

Επίλυση προβλημάτων

ΜήνυμαΑιτία και λύση
SAP login failed (HTTP 401)Το SAP απέρριψε τη βάση δεδομένων της εταιρείας, τον χρήστη ή τον κωδικό, ή δεν υπάρχει ελεύθερη θέση άδειας. Το κείμενο μετά την άνω και κάτω τελεία είναι το μήνυμα του SAP.
Property '…' of '…' is invalidΜία στήλη ή ένα πεδίο εγγραφής δεν υπάρχει στην οντότητα. Ελέγξτε το όνομα με τον συνεργάτη σας. Τα πεδία που ορίζετε εσείς ξεκινούν με U_.
Invalid BP codeΤο κλειδί εγγραφής του σημείου δεν είναι κωδικός επιχειρηματικού εταίρου. Χρησιμοποιήστε το CardCode ως κλειδί εγγραφής για δραστηριότητες.
unreachableΤο Filodos δεν φτάνει στο Service Layer, ή το πιστοποιητικό δεν είναι έγκυρο. Ελέγξτε τη διεύθυνση, τη θύρα, το τείχος προστασίας και το πιστοποιητικό.
HTTP 502 ή άλλο 5xxΤο Service Layer έχει πρόβλημα. Ο επόμενος συγχρονισμός δοκιμάζει ξανά.