Obsługa parametrów wielowartościowych w Comarch WMS Magazynier

 

1. Wstęp

W aplikacji Comarch WMS Magazynier od wersji 2024.0 istnieje możliwość określenia argumentów zdefiniowanych na krokach w sposób wielowartościowy. Do tej pory argumenty mogły przyjmować wyłącznie jedną wartość. Dzięki nowej funkcjonalności operator w aplikacji Comarch WMS Magazynier otrzyma zawężony widok listy wyników jaką będzie mógł wybrać na konkretnym kroku na liście pozycji o te wartości, które zostały zdefiniowane w Comarch WMS Zarządzanie w konfiguracji procesu.

 

2. Konfiguracja argumentów wielowartościowych w Comarch WMS Zarządzanie

Argumenty wielowartościowe definiowane są w Comarch WMS Zarządzanie w konfiguratorze procesów w trakcie modyfikacji kroków w oknie: Konfiguracja kroku w polu Argumenty.

Uwaga
Dla argumentów wielowartościowych został zarezerwowany sposób podawania wartości w nawiasie kwadratowym. Same wartości powinny być wprowadzane po przecinku np. @LocationId= [1,2,3];. Każda z liczb całkowitych (wartości dla argumentów są zdefiniowane zgodnie z Id znajdującymi się w tabelach SQL) w takiej konfiguracji jest osobną wartością, którą może przyjmować argument. Po wprowadzeniu ostatniej wartości i przejściu w inne miejsce interfejsu, system automatycznie doda średnik na samym końcu.

 

2.1. Argumenty wielowartościowe

Nazwa argumentu Wartości argumentu Obsługiwany na kroku
@CustomerId Argument wielowartościowy związany z określeniem kontrahenta. Dane należy pobrać z tabeli wms.vCustomers Nagłówek dokumentu
 @DefaultLogisticUnitTypeId Argument wielowartościowy związany z typem jednostki logistycznej. Może przyjmować różne id jednostek logistycznych z tabeli WMS.LogisticUnitTypes Typ jednostki logistycznej, Docelowa jednostka logistyczna
@LocationId Argument wielowartościowy związany z położeniem. Może przyjmować różne id położeń z tabeli wms.StructureObjects  Położenie
@ArticleId Argument wielowartościowy związany z towarem. Może przyjmować różne wartości id pobrane z tabeli  wms.vArticles  Towar
@BatchId Argument wielowartościowy związany z cechą dostawy i cechą wydania. Może przyjmować różne wartości id pobrane z tabeli wms.vFeatures Cecha dostawy, Cecha wydania
@ComponentWarehouse Parametr wielowartościowy związany z określeniem magazynu składowego dla magazynu zbiorczego. Dane należy pobrać z tabeli wms.vWarehouses Magazyn składowy, Magazyn docelowy, Magazyn źródłowy

 

Konfigurując kroki w danym procesie istnieje możliwość wyboru jaki mechanizm będzie wykorzystywany za pomocą parametru Realizowany:

  • Przez magazyniera – zawężony widok wartości do wyboru o te, które zostały zdefiniowane w Konfiguracji kroku (pobierane są wartości zdefiniowane dla argumentów wielowartościowych)
  • Automatycznie – automatyczna realizacja kroku poprzez wybór pierwszej wartości, jaka została wprowadzona w Konfiguracji kroku (zawsze pobierana jest pierwsza wartość jaką użytkownik zdefiniował dla argumentu).

Uwaga
W przypadku, gdy w trakcie realizacji dyspozycji zostanie pominięty krok z jednostką logistyczną, na kroku z towarem będą wyświetlane tylko zasoby luzem.

2.2. Walidacja konfiguracji kroku w momencie zapisu

Po skonfigurowaniu argumentów wielowartościowych (np. @ArticleId=[1,2,3];) na kroku w konfiguracji procesu, w momencie kiedy parametr Realizowany przyjmuje wartość Automatycznie, przy zapisaniu zmian prezentowany będzie poniższy komunikat, gdzie:

  • Tak – oznacza zapis konfiguracji kroku
  • Nie – powrót do konfiguracji kroku

W przypadku, gdy w sekcji argumenty został zdefiniowany parametr wielowartościowy, który przyjmuje wartości @ArticleId=1,2,3; (brak nawiasów kwadratowych) pojawi się poniższy komunikat (zostanie on wyświetlony bez względu na to jaką wartość przyjmuje parametr Realizowany). Należy zdefiniować argumenty po przecinku i w nawiasach kwadratowych.

 

W przypadku, gdy w sekcji argumenty został zdefiniowany parametr @ArticleId=1,2,3,a,a,a, który przyjmuje wartości inne niż liczbowe, przy zapisie pojawi się komunikat informujący o nieprawidłowej konfiguracji:

 

Przykład
W konfiguracji procesu wydania utworzonego na kolektorze na kroku z położeniem, został dodany argument wielowartościowy @LocationId=[6,8,10,12]; . W aplikacji Comarch WMS Magazynier operator przechodząc do tego kroku otrzyma listę położeń do wyboru, z których może pobrać zasób, o ile znajduje się on na tych położeniach.

 

Uwaga
Jeżeli na kroku zdefiniowane zostaną inne argumenty, niż te opisane powyżej, nie powinny być one brane pod uwagę podczas realizacji dokumentu w Comarch WMS Magazynier. Dyspozycje będą realizowane, jak przy przypadku braku zdefiniowanych argumentów.

 

3. Blokady przy obsłudze argumentów wielowartościowych

Obsługa parametrów wielowartościowych niesie za sobą ryzyko braku realizacji dokumentu w całości. Dzieje się tak, gdy argument wielowartościowy określony dla konkretnego procesu uniemożliwia realizacje pozycji np. zarezerwowanie zasobu pod wydanie z innej lokacji, niż położenie zdefiniowane dla argumentu @LocationId. W takim wypadku zostanie wyświetlony komunikat: Nieprawidłowa konfiguracja procesu. Realizacja dokumentu wraca na krok, z którego wystartował proces realizowanej pozycji.

 

Uwaga
W przypadku przyjęć/wydań z systemu ERP XL, należy zweryfikować czy argumenty wielowartościowe, które zostały zdefiniowane w Comarch WMS Zarządzanie dla konkretnego procesu są tożsame z dokumentem wystawionym w systemie ERP XL (zgodność Kontrahenta, zasobu, położenia, cechy).

 

W przypadku kiedy operator będzie próbował wybrać inną wartość, niż ta zdefiniowana na krokach dla danego procesu przy dyspozycji generowanej z kolektora, aplikacja będzie zachowywać się w następujący sposób:

  • Inne położenie, niż zdefiniowane w argumentach na kroku – podświetlenie na czerwono zeskanowanej wartości 
  • Inne towary, niż zdefiniowane w argumentach na kroku – podświetlenie na czerwono zeskanowanej wartości 
  • Inne cechy, niż zdefiniowane w argumentach na kroku – odfiltrowanie wartości. brak pozycji spełniające podane kryteria
  • Inne typy jednostek logistycznych niż zdefiniowane w argumentach na kroku – odfiltrowanie wartości. brak pozycji spełniające podane kryteria
  • Inny magazyn niż zdefiniowane w argumentach na krokach – podświetlenie na czerwono wpisanej wartości. 
  • Innego kontrahenta niż zdefiniowany w argumentach na kroku –podświetlenie na czerwono wpisanej wartości. 
Przykład
W poniższym przykładzie widoczne jest zeskanowanie błędnego kodu towaru przez operatora. Wartość została podświetlona na czerwono dla zeskanowanej wartości, ponieważ jest niezgodna ze zdefiniowaną wartością argumentu wielowartościowego.

Czy ten artykuł był pomocny?