Filodos

Σύνδεση SAP S/4HANA Cloud

Για διαχειριστές: συνδέστε το SAP S/4HANA Cloud με το Filodos μέσω του OData API. Η σύνδεση διαβάζει τους επιχειρηματικούς εταίρους σας, και μπορεί να γράφει μία σημείωση στο S/4HANA μετά από κάθε επίσκεψη. Μέρος της τεκμηρίωσης.

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

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

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

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

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

  1. SAP S/4HANA Cloud με OData API, για παράδειγμα το Business Partner API (API_BUSINESS_PARTNER).
  2. Τη ρίζα API του μισθωτή (tenant), για παράδειγμα https://my123456-api.s4hana.cloud.sap/sap/opu/odata/sap/API_BUSINESS_PARTNER.
  3. Τη διεύθυνση διακριτικού (token) της ρύθμισης επικοινωνίας, για παράδειγμα https://my123456.authentication.s4hana.cloud.sap/oauth/token.
  4. Ένα αναγνωριστικό πελάτη OAuth2 (client id) και ένα μυστικό πελάτη με δικαίωμα ανάγνωσης επιχειρηματικών εταίρων και, για σημειώσεις επισκέψεων, δικαίωμα εγγραφής σημειώσεων. Μη χρησιμοποιήσετε λογαριασμό διαχειριστή.
  5. Συντεταγμένες: δύο πεδία ορισμένα από τον πελάτη στον επιχειρηματικό εταίρο, για παράδειγμα YY1_Latitude και YY1_Longitude. Το S/4HANA δεν έχει βασικά πεδία συντεταγμένων.
  6. Για σημειώσεις επισκέψεων: ένα πεδίο κειμένου ορισμένο από τον πελάτη στη σημείωση, για παράδειγμα YY1_FilodosRef. Σταματά τις διπλές σημειώσεις (δείτε Σημειώσεις στο S/4HANA).

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

Το Filodos ανανεώνει το διακριτικό πριν λήξει. Δεν υπάρχει αποσύνδεση: το διακριτικό απορρίπτεται μετά από κάθε συγχρονισμό και μετά από κάθε ομάδα σημειώσεων επισκέψεων.

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

  1. Συνδεθείτε ως διαχειριστής. Ανοίξτε Organization → ERP.
  2. Στο New connection, επιλέξτε SAP S/4HANA Cloud.
  3. Γράψτε ένα όνομα, τη ρίζα API του μισθωτή και το αναγνωριστικό πελάτη OAuth2. Γράψτε το μυστικό πελάτη ως κωδικό.
  4. Γράψτε τη διεύθυνση διακριτικού (Token address).
  5. Πατήστε Add connection.
  6. Πατήστε Test login. Η απάντηση δείχνει τον τύπο του διακριτικού και τη διάρκειά του σε δευτερόλεπτα.
  7. Συνεχίστε με τα σημεία (δείτε Σημεία από το S/4HANA).

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

Σημεία από το S/4HANA

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

ΣημείαΟντότητα (Entity)ΦίλτροΚλειδί εγγραφήςΌνομα
Οργανισμοί (προεπιλογή)A_BusinessPartnerBusinessPartnerCategory eq '2'BusinessPartnerBusinessPartnerFullName
Φυσικά πρόσωπαA_BusinessPartnerBusinessPartnerCategory eq '1'BusinessPartnerBusinessPartnerFullName

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

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

Σημειώσεις στο S/4HANA

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

ΠεδίοΤιμή
BusinessPartner{site_key}
NoteDate{date_iso}
NoteTime{arrived_time}
NoteTitleFilodos {vehicle} {arrived}-{departed}
NoteText{text}

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

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

Κάθε τιμή κόβεται στους 3000 χαρακτήρες. Κρατήστε τα δικά σας δεδομένα κάτω από 3000 χαρακτήρες.

Η σημείωση χρειάζεται επιχειρηματικό εταίρο. Χρησιμοποιήστε το κλειδί του επιχειρηματικού εταίρου ως κλειδί εγγραφής για σημειώσεις.

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

ΜήνυμαΑιτία και λύση
S/4HANA token request failed (HTTP 401)Το S/4HANA απέρριψε το αναγνωριστικό ή το μυστικό πελάτη, ή η διεύθυνση διακριτικού είναι λάθος. Το κείμενο μετά την άνω και κάτω τελεία είναι το μήνυμα του S/4HANA.
Property '…' of '…' is invalidΜία στήλη ή ένα πεδίο εγγραφής δεν υπάρχει στην οντότητα. Ελέγξτε το όνομα με τον συνεργάτη σας. Τα πεδία που ορίζετε εσείς ξεκινούν με YY1_ ή ZZ1_.
unreachableΤο Filodos δεν φτάνει στη ρίζα API του μισθωτή ή στη διεύθυνση διακριτικού. Ελέγξτε τις διευθύνσεις, το τείχος προστασίας και το πιστοποιητικό.
HTTP 502 ή άλλο 5xxΤο S/4HANA έχει πρόβλημα. Ο επόμενος συγχρονισμός δοκιμάζει ξανά.