Konfiguracja stylów i komunikatów “toast”

1. Konfiguracja stylów

W niniejszym artykule zostaną opisane Konfiguracje stylów.

1.1 Opis konfiguracji stylów

Folder ze zdefiniowanymi domyślnymi stylami znajduje się w lokalizacji: Comarch WMS\ Warehouseman\AppData\Default\ViewStyles. Zawiera on następujące pliki *.xml ze zdefiniowanymi stylami:

  • Podgląd pozycji awiza dostawy (AWD): AcceptanceAdvicePositionPreviewViewStyle.xml,
  • Dyspozycji awiza dostawy (AWD): AcceptanceAdviceViewStyle.xml,
  • Elementy jednostki logistyczne na AWD wraz z informacjami o jednostce: AcceptancePositionLogisticUnitElementsViewStyle.xml,
  • Pozycji przyjęcia: AcceptancePositionViewStyle.xml,
  • Listy przyjęć: AcceptancesViewStyle.xml,
  • Dyspozycji przyjęcia: AcceptanceViewStyle.xml,
  • Zasobów towaru (otwieranych z karty towaru): ArticleResourcesViewStyle.xml,
  • Listy towarów: ArticlesViewStyle.xml,
  • Karty towaru: ArticleViewStyle.xml,
  • Informacji dodatkowych (atrybutów): AttributesViewStyle.xml,
  • Listy kontrahentów: CustomersViewStyle.xml,
  • Karty kontrahenta: CustomerViewStyle.xml,
  • Listy atrybutów na dyspozycji (wyświetlany podczas realizacji procesu): DocumentAttributesViewStyle.xml,
  • Listy klas cech na pozycji procesu realizacji: DocumentFeatureClassesViewStyle.xml,
  • Listy wartości cechy pozycji procesu realizacji: DocumentFeatureValuesViewStyle.xml,
  • Listy jednostek składowania pozycji procesu realizacji: DocumentStorageUnitsViewStyle.xml,
  • Listy zgrupowanych dokumentów: GroupedDocumentsViewStyle,
  • Widok odczytu inwentaryzacyjnego dla inwentaryzacji ciągłej indeksu: InternalLotStocktakingReadingViewStyle,
  • Listy położeń (dostępnej m.in. z pozycji odczytu, dokumentów magazynowych): LocationsViewStyle.xml,
  • LogisticUnitParametersViewStyle.xml,
  • LogisticUnitsViewStyle.xml,
  • Listy typów jednostek logistycznych: LogisticUnitTypesViewStyle,
  • Pozycji przesunięcia: MovementPositionViewStyle.xml,
  • Listy przesunięć: MovementsViewStyle.xml,
  • Dyspozycji przesunięcia: MovementViewStyle.xml,
  • Okna dodawania nowego towaru: NewArticleViewStyle.xml,
  • Listy atrybutów na pozycji procesu realizacji: PositionAtrributesViewStyle.xml,
  • PositionLogisticUnitElementsViewStyle.xml,
  • PositionLogisticUnitTypeViewStyle.xml,
  • Bazowego okna procesu realizacji: ProcessViewStyle.xml,
  • Podglądu pozycji zlecenia wydania z magazynu (ZWM): ReleaseCommissinPositionPreviewViewStyle.xml,
  • Dyspozycji zlecenia wydania z magazynu (ZWM): ReleaseCommissionViewStyle.xml,
  • Pozycji wydania: ReleasePositionViewStyle.xml,
  • Listy wydań: ReleasesViewStyle.xml,
  • Dyspozycji wydania: ReleaseViewStyle.xml,
  • Listy dostępnych definicji etykiet/wydruków: ReportLabelsViewStyle,
  • Listy drukarek: ReportPrintersViewStyle,
  • Listy dat ważności zasobu: ResourceExpirationdatesViewStyle.xml,
  • Listy klas cech zasobu: ResourceFeaturesViewStyle.xml,
  • Listy wartości cechy zasobu: ResourceFeatureValuesViewStyle.xml,
  • Listy jednostek składowania zasobu: ResourceStorageUnitsViewStyle.xml,
  • Listy Zasobów (dostępnej m.in. z kroku realizacji pozycji „Towar”): ResourcesViewStyle.xml,
  • Nagłówka odczytu inwentaryzacyjnego: StocktakingReadingDescriptionViewStyle.xml,
  • Pozycji odczytu inwentaryzacji: StocktakingReadingPosiotionViewStyle.xml,
  • Odczytu inwentaryzacji: StocktakingReadingViewStyle.xml,
  • Arkusza inwentaryzacji: StocktakingSheetViewStyle.xml,
  • Nagłówka Inwentaryzacji: StocktakingViewStyle.xml.
Uwaga
Aby zmodyfikować ustawienia stylów dla wszystkich operatorów należy dokonać zmian w plikach domyślnych: [Comarch WMS\Warehouseman\ AppData\Default\ViewStyles] przed pierwszym zalogowaniem się operatorów. Natomiast po zalogowaniu operatorów modyfikacje należy wykonywać w osobnych plikach dla każdego operatora w folderze: [Comarch WMS\ Warehouseman\AppData\Users\[identyfikator_operatora].

Podczas pierwszego logowania operatora do aplikacji tworzy się w folderze AppData nowy folder Users. Folder ten służy do przechowywania ustawień osobno dla każdego operatora w odpowiednim podkatalogu, o takiej samej nazwie jak identyfikator operatora. Ten podkatalog (np. Comarch WMS\Warehouseman\AppData\Users\admin) zawiera plik configuration.xml oraz folder ViewStyles z ustawieniami stylów dla tego konkretnego operatora.

Uwaga
Pliki *.xml z ustawieniami stylów są zapisywane w momencie wylogowania się z aplikacji.

Przy pierwszym logowaniu ustawianie stylów dla konkretnego operatora są kopiowane z ustawień domyślnych.

rys.1._5.7_konf

Objaśnienie i możliwa konfiguracja stylów zostanie przedstawiona poniżej na przykładach.

Przykład
Sortowanie na liście według ilości. Domyślnie w aplikacji (przy niezmienionych ustawieniach) w konfiguratorze filtra można ustawić sortowanie na liście pozycji po: kodzie, EANie, nazwie, wartości cechy lub położeniu. Aby dodać sortowanie po ilości danego towaru w aplikacji Comarch WMS Magazynier, należy zmodyfikować odpowiedni plik ViewStyle. W tym przypadku za listę pozycji na przyjęciu magazynowym odpowiada plik: AcceptanceViewStyle.xml. Należy go wyedytować i w sekcji odnośnie filtrowania należy dodać ustawienie ilości. Np. przez w pliku:
<Style Id="PositionsListStyle" SortColumn="" SortDirection="Asc" AutoSelect="true">
<Filter Option="Editable" FilterMode="Single" Visible="false" VisibleEditable="true">
<Column Option="Use" Name="Code" />
<Column Option="Use" Name="Ean" />
<Column Option="Use" Name="Name" />
<Column Option="Use" Name="Feature" />
<Column Option="Use" Name="Location" />
<Column Option="Use" Name="Quantity" />
</Filter>

Dodatkowo w pliku xml można ustawić domyślne ustawienie podczas wejścia na listę pozycji np. określając sortowanie po ilości towarów, czyli modyfikujemy wiersz <Style Id>:
<Style Id="PositionsListStyle" SortColumn="Quantity" SortDirection="Asc" AutoSelect="true">
Przykład
Zmiana wyglądu elementów na listach. W aplikacji istnieje możliwość zmiany wyglądu elementów wyświetlanych na listach. W przykładzie modyfikowany będzie plik CustomersViewStyle.xml odpowiedzialny za wygląd listy kontrahentów. Zmiany będa dotyczyły kolorowania elementów, wyrównania elementów względem okna (lewo/prawo/środek), wyglądu czcionek.

  • Zmiana koloru kodu oraz nazwy kontrahenta z koloru czarnego na niebieski:
    <Text Bold="true" Align="Left" Scale="0" TextColor="Blue" Width="100%" Value="[{ShortName}] {Name}" />
  • Wyrównanie numeru NIP kontrahenta do prawej strony okna:
    <Text Bold="false" Align="Left" Scale="0" TextColor="Black" Width="100%" Value="{Tin}" />
  • Rozdzielenie linii kodu i nazwy kontrahenta oraz zmiana wyświetlania nazwy kontrahenta na czcionkę niepogrubioną (należy dodać linię):
    <Text Bold="true" Align="Left" Value="[{ShortName}]" TextColor="Black" />
    <Text Bold="false" Align="Left" Value="{Name}" TextColor="Black" />
rys.2._5.7_konf rys.3._5.7_konf
Przykład
Usuwanie wyświetlanych obiektów. W tym przykładzie zostanie zaprezentowana możliwość usuwania niektórych wyświetlanych elementów na liście dyspozycji. Zmiany dokonywane będą w obrębie pliku ReleasesViewStyle.xml. Modyfikacja polega na niewyświetlaniu paska “Dla wszystkich”, jeżeli na liście dyspozycji nie znajdują się żadne dyspozycje nieprzypisane.
<Group Id="2" Value="{res:documentsForAll}" TextColor="White" BackColor="Gray" DisplayWhenEmpty="false"/>
rys.4._5.7_konf rys.5._5.7_konf
Przykład
Innym przykładem usunięcia obiektu może być wyświetlanie towarów na liście tylko według nazwy, usuniętym elementem będzie kod towaru. Plikiem odpowiadającym za zmiany w obrębie listy towarów jest ArticlesViewStyle.xml. W pliku należy wprowadzić następująca zmianę (z linii usunięto [{Code}]):
<Text Align="Left" TextColor="Gray" Bold="true" Value="{Name}"/>
rys.6._5.7_konf rys.7._5.7_konf
Przykład
Wyświetlanie elementu domyślnie ukrytego. Po wejściu na listę “Wydania na dziś” filtr jest domyślnie ukryty. Aby filtr był zawsze domyślnie wyświetlany należy dokonać nastepującej zmiany w pliku ReleasesViewStyle.xml:
<Filter Option="Editable" FilterMode="Single" Visible="true" VisibleEditable="true">
Przykład
Zmiana domyślnego sortowania. Domyślnie na liście przyjęć dokumenty posortowane są zgodnie z nadanym priorytetem – od najwyższego do najnizszego.
W przykładzie zostanie zaprezentowana zmiana domyślnego sortowania na sortowanie malejące względem numeru dokumentu. Modyfikacje nastąpią w obrębie pliku AcceptancesViewStyle.xml (zamieniono wartość parametru SortColumn)
<Style Id="DocumentsListStyle" SortColumn="Number" SortDirection="Asc" AutoSelect="true">

rys.9._5.7_konf

rys.8._5.7_konf rys.9._5.7_konf
Przykład
Zmiana pozycji elementów na liście. Przykład ilustruje możliwość zmiany pozycji obiektów na liście. Modyfikacje, tak jak w poprzednim przykładzie będą prezentowane na liście przyjęc, zmianie ulegnie plik AcceptancesViewStyle.xml. W wyniku zmian na liście dyspozycji miejsce zmienią takie element jak: nazwa I wartość priorytetu, procent realizacji oraz kod kontrahenta. Aby dokonać takich zmian należy w pliku zmodyfikowac kolejnośc linii:
<Line>
<Text Bold="true" Align="Left" Scale="0" TextColor="" Width="50%%" Value="{Number} {Stage}"/>
<Text Bold="false" Align="Right" Scale="0" TextColor="" Width="50%" Value="{Customer}"/>
</Line>
<Line>
<Text Bold="false" Align="Left" Scale="0" TextColor="" Width="50%" Value="{SourceNumber}"/>
<Text Bold="false" Align="Right" Scale="0" TextColor="{PriorityColor}" Width="50%" Value="{PriorityName} {Priority}"/>
</Line>
<Line>
<Text Bold="false" Align="Left" Scale="0" TextColor="Blue" Width="" Value="{Realization}"/>
</Line>
rys.10._5.7_konf> rys.11._5.7_konf
Uwaga
Należy pamiętać, aby zmiany w plikach xml z ustawieniami stylów dokonywać, gdy aplikacja jest wyłączona, w przeciwnym wypadku wprowadzone modyfikacje nie zostaną zapisane.

1.2 Ustawienie wymaganych pól

Dla danego operatora istnieje możliwość ustawienia wymaganych pól (kontrolek, które muszą zostać uzupełnione na danym oknie). Funkcjonalność dotyczy pól dodatkowych, które domyślnie nie są wymagane przez system np. nazwa nowego towaru. Takie modyfikacje można przeprowadzić domyślnie dla wszystkich użytkowników lub dla konkretnego operatora.
Ustawienia wymaganych pól (kontrolek) jest możliwe w plikach z ustawieniami stylów (w katalogu ViewStyles):

  • NewArticleViewStyle.xml – okno dodawania nowego towaru,
  • StocktakingReadingPositionViewStyle.xml – okno dodawania pozycji do odczytu inwentaryzacji,
  • StocktakingReadingDescriptionViewStyle.xml – okno tworzenia/edycji nagłówka odczytu inwentaryzacyjnego.

Aby ustawić wymagalność danego pola (kontrolki), należy w odpowiednim pliku zmodyfikować wartość właściwości pola:

  • z: <Property Name=”IsRequired” Value=”false” /> (pole niewymagane)
  • na: <Property Name=”IsRequired” Value=”true” /> (pole wymagane do uzupełnienia).

W przypadku nie uzupełnienia wymaganego pola, kontrolka wymagana zostanie podświetlona na czerwono przy próbie zapisu bądź przejścia do następnego kroku.
Przykładowo dla okna dodawania nowego towaru można ustawić wymagalność określenia kodu EAN (który domyślnie jest opcjonalny). Aby to osiągnąć należy zmodyfikować plik: NewArticleViewStyle.xml:
<?xml version=”1.0”?>
<ViewStyle Id=”NewArticleViewStyle”>
<InfoBoxStyles />
<ListStyles />
<Controls>
<Control Name=”txbArticleEan”>
<Property Name=”IsRequired” Value=”true” />
</Control>
</Controls>
</ViewStyle>

rys.12._5.7_konf

Natomiast w oknie dodawania nowej pozycji odczytu inwentaryzacyjnego (plik: StocktakingReadingPositionViewStyle.xml) można wymusić określenie położenia pozycji odczytu lub/i cechy dostawy.

1.3 Konfiguracja komunikatów typu „toast”

Domyślnie w Comarch WMS Magazynier wprowadzono 4 rodzaje nowych komunikatów.
Istnieje możliwość modyfikacji ustawień toastów (dla każdego typu) w zakresie:

  • kolorów prezentowanych komunikatów
  • czasu ich wyświetlania lub wymuszenia naciśnięcia przez operatora, aby komunikat został ukryty,
  • położenia na oknie aplikacji.

Zmian tych dokonuje się w pliku konfiguracyjnym ToastConfiguration.xml, który znajduje się w lokalizacji: Comarch WMS\Warehouseman\AppData\Default.

Plik ToastConfiguration.xml wygląda następująco:
<Toasts>
<Success>
<Timeout>2000</Timeout>
<Location>Top</Location>
<Color>FF51A351</Color>
<Visible>true</Visible>
</Success>
<Warning>
<Timeout</Timeout>
<LocationTop</Location>
<Color>FFF89406</Color>
<Visible>true</Visible>
</Warning>
<Info>
<Timeout>2000</Timeout>
<Location>Top</Location>
<Color>FF2F96B4</Color>
<Visible>true</Visible>
</Info>
<Error>
<Timeout>5000</Timeout>
<Location>Top</Location>
<Color>FFBD362F</Color>
<Visible>true</Visible>
</Error>
</Toasts>

  • Success – potwierdzenie pomyślnie wykonanej operacji,
  • Warning – ostrzeżenia,
  • Info – informacje dotyczące realizacji,
  • Error – informacje o blokadach lub niewykonaniu operacji.

Dla każdego typu komunikatu udostępniono następujące parametry do modyfikacji:

  • <Timeout> – czas wyświetlania komunikatu w milisekundach; ustawienie tego parametru na wartość 0 (lub mniej) spowoduje konieczność naciśnięcia komunikatu, aby został ukryty,
  • <Location> – miejsce wyświetlania komuniktu:
    • Top – komunikat wyświetli się w górnej części ekranu,
    • Bottom – komunikat wyświetli się w dolnej części ekranu,
    • Fill – komunikat wyświetli się na całym ekranie.
  • <Color> – kolor w jakim wyświetlony jest komunikat, określony w notacji heksadecymalnej, w formacie 00FF00FF (ARGB)
  • <Visible> – widoczność komunikatu:
    • True – wyświetlanie komunikatu włączone,
    • False – wyświetlanie komunikatu wyłączone.

Czy ten artykuł był pomocny?