Dowiedz się, czy fabryka otrzymała właściwą wersję.

Wysyłanie skonfigurowanego zamówienia lub BOM do innego systemu nie zostało zakończone, gdy żądanie opuściło przeglądarkę. Fabryka musi wiedzieć, czy odbierający wniosek zaakceptował zamierzoną korektę, stworzył odpowiedni zapis i zatwierdził to w sposób możliwy do późniejszego uzgodnienia. Limit czasu jest szczególnie ważny: nadawca może nie wiedzieć, czy odbiorca zakończył akcję przed awarią połączenia.

Configurix łączy konfigurator produktu i wizualne przepływy pracy CPQ z istniejącymi systemami producentów. Strumień pracy integracji powinien określać identyfikatory, mapowania, potwierdzenia, ponowne próby i własność wyjątków. W tym artykule skupiono się na niezawodnym przekazaniu zwolnionego zapotrzebowania materiałowego lub skonfigurowanego zamówienia, a nie na ogólnej obietnicy połączenia każdego ERP.

Zdefiniuj akcję biznesową przed wywołaniem API

„Wyślij BOM” może oznaczać utworzenie struktury pozycji, załączenie dokumentu, utworzenie listy materiałów dla konkretnego zamówienia lub zwolnienie zlecenia produkcyjnego. Działania te mają różne konsekwencje. Nazwij zamierzony rekord i zdarzenie autoryzujące jego utworzenie.

Interfejsem może być API, kontrolowany import plików lub inny obsługiwany mechanizm. Uzgodnij zachowanie, korzystając z aktualnej dokumentacji systemu i dostępu dostępnego dla projektu. Logo dostawcy na stronie nie oznacza obsługi konkretnej transakcji.

Nadaj przelewowi stabilną tożsamość

Użyj identyfikatora przelewu, który reprezentuje jedno zamierzone działanie biznesowe. Zachowaj powiązanie z wersją źródłową i odciskiem palca lub innym rekordem porównawczym ładunku. Ponowienie tej samej akcji powinno zachować tę tożsamość. Zmienioną rewizję zamówienia należy uznać za inne zdarzenie biznesowe, z zachowaniem zasad dotyczących powiązania z wcześniejszym.

Proponowane odniesienie może łączyć kolejność źródłową, wersję i działanie docelowe. Dokładny format jest mniej ważny niż niepowtarzalność, zakres i cykl życia. Zdecyduj, jak długo odbiorca będzie pamiętał wykonaną akcję i w jaki sposób nadawca rozliczy starszy przelew po tym okresie.

Jeśli odbiorca obsługuje mechanizm idempotencji, udokumentuj jego dokładne gwarancje. Dokumentacja API Stripe podaje konkretny przykład usługi, która rozpoznaje powtarzające się żądania w ramach klucza idempotencji. To jest przykład wzorca, a nie dowód, że ERP implementuje to samo zachowanie. Stripe: żądania idempotentne.

Poznaj problem przekroczenia limitu czasu

Załóżmy, że system odbierający tworzy zamówienie, ale jego potwierdzenie nie dociera do nadawcy. Ślepa ponowna próba może spowodować utworzenie duplikatu, jeśli interfejs nie jest chroniony przed duplikatami. Zgłaszanie „niepowodzenia” może również wprowadzać w błąd, ponieważ działanie biznesowe zakończyło się zdalnym sukcesem.

Użyj stanu takiego jak „oczekiwanie na potwierdzenie”, gdy wynik jest rzeczywiście nieznany. Przed podjęciem decyzji o ponownym wysłaniu w procesie odzyskiwania należy sprawdzić miejsce docelowe na podstawie uzgodnionego przelewu lub odniesienia do źródła. Jeśli do miejsca docelowego nie można wysyłać zapytań ani deduplikować żądań, należy uwzględnić to ograniczenie w projekcie procesu.

Otwórz obraz w pełnym rozmiarze (nowa karta)

Osoba odpowiedzialna za wyjątek potrzebuje wystarczającego kontekstu, aby zbadać: wersję źródła, działanie, tożsamość przeniesienia, ostatnią próbę i odpowiedź docelową. Trzymaj dane uwierzytelniające i niepotrzebne dane klientów z dala od komunikatów o błędach operacyjnych.

Sprawdź poprawność pól przed i po wysłaniu

Przed transferem sprawdź wymagane pola, dozwolone jednostki, mapowania komponentów i odniesienia do wersji. Materiał o różnej nazwie w dwóch systemach wymaga wyraźnego mapowania, a nie dopasowania zgadywanego ciągu. Zdecyduj, w jaki sposób obsługiwane będą nieznane i wycofane referencje.

Następnie zatwierdź potwierdzenie. Pomyślna odpowiedź transportowa może oznaczać jedynie, że żądanie zostało odebrane lub umieszczone w kolejce. Może to nie oznaczać, że kolejne zamówienie zostanie zwolnione do produkcji. Zachowaj identyfikator rekordu docelowego i status biznesowy zwrócony przez proces odbierający.

W przypadku importu pliku zdefiniuj tożsamość pliku, sumę kontrolną lub metodę porównania, konwencję nazewnictwa i raport akceptacji. Plik pojawiający się w folderze nie jest potwierdzeniem akceptacji. Zespół odbierający musi być w stanie określić, które wiersze zostały zaakceptowane, odrzucone lub pozostawione w oczekiwaniu.

Obsługuj częściowy sukces bez ukrywania go

Interfejs może zaakceptować nagłówek zamówienia, ale odrzucić linię materiałową. Zdecyduj, czy akcja ma charakter atomowy, czy dozwolone są zapisy częściowe i w jaki sposób nadawca dowie się o nich. Nie zgłaszaj całego transferu jako zakończonego, ponieważ jeden etap się powiódł.

Jeśli konieczna jest korekta, określ, czy aktualizuje ona istniejący rekord miejsca docelowego, czy przesyła nową wersję. Powtarzające się tworzenie nowych rekordów w celu obejścia błędu może spowodować opuszczenie fabryki z duplikatami i sprzecznymi wersjami. Zachowaj działanie naprawcze związane z pierwotnym przelewem.

Anulowanie również wymaga własnych reguł biznesowych. Zamówienie już w produkcji może nie być możliwe do anulowania za pośrednictwem tego samego punktu końcowego, co w przypadku zamówienia nierozpoczętego. Oprogramowanie powinno odzwierciedlać stan systemu odbierającego i kierować decyzję do odpowiedniego właściciela.

Odtworzenie testu w ramach akceptacji

Użyj środowiska testowego lub konfiguracji kontrolowanej akceptacji do testów transferu. Uwzględnij zwykłe zamówienie, nieznany komponent, niedopasowanie jednostek, wielokrotne przesłanie, przekroczenie limitu czasu i poprawioną wersję. Przed testem zapisz oczekiwane rekordy źródła i miejsca docelowego.

Duplikat testu powinien potwierdzić, że jedno zamierzone działanie biznesowe daje jedynie uzgodniony rezultat. Test przekroczenia limitu czasu powinien zweryfikować ścieżkę uzgadniania, a nie tylko wyświetlić baner błędu. Test zmienionego ładunku powinien ustalić, że poprzednia tożsamość transferu nie może po cichu odnosić się do innych danych.

Przetestuj także błąd uwierzytelniania i zakres dostępu. Użyj poświadczeń odpowiednich do wymaganego działania i przechowuj je po stronie zaufanego serwera. Uzgodnij własność danych uwierzytelniających, rotację i obsługę incydentów z zespołami odpowiedzialnymi za połączone systemy.

Czy ponowna próba nieudanego żądania jest zawsze bezpieczna?

Nie. Bezpieczeństwo zależy od operacji, gwarancji systemu odbiorczego i tego, czy znany jest wcześniejszy wynik. Pogódź się z niepewnymi wynikami przed powtórzeniem działania, które mogłoby stworzyć lub wydać kolejny rekord.

Czy odpowiedź 200 oznacza, że można rozpocząć produkcję?

Tylko jeśli udokumentowana umowa biznesowa nadaje jej takie znaczenie. Wiele interfejsów potwierdza odbiór przed zakończeniem przetwarzania. Wyświetl faktycznie uzgodniony stan biznesowy.

Czy możemy zacząć od eksportu pliku?

Tak. Kontrolowany przepływ pracy z plikami może być praktycznym pierwszym zakresem, gdy jego tożsamość, proces sprawdzania poprawności i akceptacji są jasne. Fabryka nadal potrzebuje sposobu, aby zapobiec dublowaniu importu i pogodzić odrzucone wiersze.

Recenzja integracje konfiguratora produktu w programie Configurix i podaj specyfikację transakcji systemu odbierającego. Połącz tę dyskusję z przewodnik wdrażania , dzięki czemu interfejs wspiera jasno określoną akcję biznesową.