Definiowanie punktu konfiguracyjnego

image_pdfimage_print
Spis treści artykułu

 

Dodawanie nowego punktu i zakładka „Tryb współpracy”

Aby utworzyć punkt konfiguracyjny typu „Współpraca z Comarch OCR” należy w oknie „Automatyczne generowanie dokumentów” dodać nowy punkt konfiguracyjny za pomocą ikony . Na liście trybów pracy punktu jako pierwsza dostępna jest opcja „Współpraca z Comarch OCR”.

 

Punkt konfiguracyjny typu „Współpraca z Comarch OCR”, zakładka „Tryb współpracy”

 

Zakładka „Ogólne”

Na zakładce „Ogólne” należy w polu:

  • Nazwa punktu – określić nazwę pod jaką punkt konfiguracyjny będzie widoczny na liście punktów
  • Typ obiegu – wskazać typ obiegu, w ramach którego będą generowane dokumenty zawierające dane przeprocesowane przez usługę Comarch OCR; od wersji 2026.0.0 należy dokonać wyboru jednego lub wielu typów obiegów – po kliknięciu w pole rozwijana jest lista wszystkich typów obiegów dostępnych w systemie, a administrator powinien zaznaczyć checkbox obok jednego lub więcej typu obiegu – liczba zaznaczonych typów obiegów może być dowolna. Jeśli lista jest długa, po prawej stronie dostępny jest suwak.
  • Rodzaj transakcji – określić typ rejestru VAT (zakupu/sprzedaży), pod kątem którego dokumenty będą przetwarzane przez Comarch OCR; w wersji 2024.2.0 zmieniono wcześniejsze pole „Typ rejestru VAT” na „Rodzaj transakcji” (zob. Obsługa nowych funkcjonalności OCR: dokumenty magazynowe, paragony, zamówienia, tabelka VAT na fakturach niemieckojęzycznych)
  • Typ dokumentu – pole dodane w wersji 2024.2.0 (zob. Obsługa nowych funkcjonalności OCR: dokumenty magazynowe, paragony, zamówienia, tabelka VAT na fakturach niemieckojęzycznych); w ramach pola wyświetlane są następujące opcje:
    • Faktura
    • Paragon
    • Dokument magazynowy
    • Zamówienie
  • Domyślna forma płatności – określić domyślną formę płatności – domyślna forma płatności, która jest określana dla dokumentu rozpoznanego w usłudze Comarch OCR, jeśli na przesłanym dokumencie nie zostanie rozpoznana forma płatności
  • Język dokumentu – wybrać kraj dokumentu – dostępne możliwości: Polska, Niemcy, Francja
  • Rozpoznawanie kodów kreskowych – wskazać czy funkcjonalność rozpoznawania kodów kreskowych ma być włączona. Parametr przyjmuje wartości:

 

Wyłączone – kody kreskowe nie będą rozpoznawane w usłudze Comarch OCR

Włączone – kody kreskowe będą rozpoznawane – jeżeli zaznaczono tę opcję, wówczas poniżej  dostępny jest parametr „Kod kreskowy wskazuje pierwszą stronę dokumentu”- zaznaczenie parametru sprawi, że na podstawie rozpoznanych kodów kreskowych nastąpi łączenie stron dokumentów. Łączenie stron dokumentu realizowane jest w ten sposób, że wszystkie strony, które wystąpiły od strony z kodem kreskowym do strony poprzedzającej stronę z kolejnym kodem kreskowym są jednym dokumentem.

 

Punkt konfiguracyjny typu „Współpraca z Comarch OCR”, zakładka „Ogólne”, z zaznaczonym parametrem „Kod kreskowy wskazuje pierwszą stronę dokumentu”

 

  • Nazwy atrybutów na liście dokumentów w punkcie ACD – pole dodane w wersji 2025.0.0; w ramach tego pola dostępne są pola: „Atrybut 1”, Atrybut 2” i „Atrybut 3”. Nowo dodane pola umożliwiają wprowadzenie dodatkowych informacji opisujących daną fakturę, co pozwala na bardziej szczegółową identyfikację i klasyfikację dokumentów w procesie ich przetwarzania.

 

W ramach pól „Atrybut 1”, „Atrybut 2” i „Atrybut 3” można zdefiniować maksymalnie 3 nazwy dodatkowych pól (atrybutów), które będą widoczne na liście dokumentów w punkcie ACD.

Informacje o nazwach atrybutów/kolumn są dostępne w tabeli do.DF_ConfAPDictionary.

Jeśli uprawniony operator nie wprowadzi żadnej nazwy atrybutu, wówczas kolumny z atrybutami nie zostaną utworzone, a na liście dokumentów będzie widoczna tylko jedna kolumna „Dokument”.

Jeżeli operator wprowadzi wartość w jednym z dodatkowych pól (atrybutów), wówczas na liście będzie widoczna jedna dodatkowa kolumna z taką nazwą, jaką wprowadzono w polu; analogicznie, jeśli uzupełniono dwa pola, będą widoczne dwie dodatkowe kolumny.

 

Widok zakładki „Ogólne” na definicji punktu ACD typu „Współpraca z Comarch OCR” z polami atrybutów (z przykładowym uzupełnieniem)

 

Uwaga
Można wskazać ten sam typu obiegu dla dwóch punktów konfiguracyjnych – Współpraca z Comarch OCR oraz Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM). W takiej konfiguracji możliwe jest również wskazanie tej samej kontrolki typu załącznik, do której załączany będzie skan dokumentu przeprocesowanego w usłudze Comarch OCR.

 

  • Zmiana wartości na podstawie kontrolek obserwowanych (Obserwatory) – pole dodane w wersji 2026.0.0; umożliwia wyłączenie obserwatorów, które wykonują się w czasie dodawania dokumentów do obiegu z punktu ACD. Jeśli w polu parametru:
    • Wybrano wartość „Włączona” – wartości kontrolek mogą zostać nadpisane podczas generowania dokumentu do obiegu, zgodnie z kontrolkami obserwowanymi; wartość domyślna;
    • Wybrano wartość „Wyłączona” – wartości kontrolek nie zostaną nadpisane zgodnie z kontrolkami obserwowanymi podczas generowania dokumentu do obiegu (wartości zgodne z podglądem w punkcie ACD).

 

Wybór opcji w ramach parametru „Zmiana wartości na podstawie kontrolek obserwowanych (Obserwatory)“ podczas konfiguracji punktu ACD typu „Współpraca z OCR“

 

Zakładka „Lista”

Na zakładce „Lista”, analogicznie do pozostałych trybów pracy punktów konfiguracyjnych, należy za pomocą zapytania SQL określić listę dokumentów, która będzie wyświetlana w oknie ACD po przeprocesowaniu plików w usłudze Comarch OCR.  Dodatkowo można ograniczyć prezentowaną listę wyłącznie do dokumentów, które zostały przeprocesowane przez zalogowanego operatora – w tym celu należy odkomentować warunek „and OCW_OperatorID=@IdOperatorBPM@”.

W wersji 2023.0 na zakładce „Lista” dla wartości OCW_APDId została dodana dynamiczna zmienna @PointId@.

Wprowadzenie zmiennej dynamicznej sprawia, że użytkownik nie musi samodzielnie wprowadzać w ramach zapytania numeru ID punktu ACD lub jego nazwy, jak do tej pory.

Od wersji 2025.0.0 dalszej modyfikacji uległ wzorzec zapytania do zakładki „Lista” – nowy wzorzec przedstawiono poniżej.

Przyklad

Przykład zapytania wyświetlającego listę dokumentów

BEGIN TRY

select d.OCD_Id, NULL, OCD_Number, OCD_Tag1, OCD_Tag2, OCD_Tag3

from do.OC_Documents d left join do.OC_WorkAPProcess W on d.OCD_Id = OCW_DocumentID -- tabela przeprocesowanych dokumentów

join do.DF_ConfAPDictionary a on a.APD_ID=W.OCW_APDId

where OCW_Status = 2 and APD_ID= @PointId@ and OCW_Archival=0

     -- and OCW_OperatorID=@IdOperatorBPM@ -- dodatkowy warunek, aby na liście operator widział dokumenty przeprocesowane przez siebie

and (nullif(@SearchText@,'') is null OR (@SearchText@ <> '' and OCD_Number LIKE '%' + @SearchText@ + '%'))

and (@Nip@ is null OR OCD_ContractorNip = @Nip@)

and (@DateFrom@ is null or OCD_IssueDate >= @DateFrom@)

and (@DateTo@ is null or OCD_IssueDate <= @DateTo@)

and (@GrossAmountFrom@ is null or OCD_PaymentAmount >= @GrossAmountFrom@)

and (@GrossAmountTo@ is null or OCD_PaymentAmount <= @GrossAmountTo@)

 END TRY

 BEGIN CATCH

  DECLARE @ErrorMessage varchar(max) = 'W zapytaniu wystąpił błąd : ' + ERROR_MESSAGE();

  THROW 50001,  @ErrorMessage ,1;

 END CATCH

 

 

Punkt konfiguracyjny typu „Współpraca z Comarch OCR”, zakładka „Lista”

 

Uwaga
Od wersji 2024.2.1  w zapytaniu na zakładce „Lista” należy dodać „and OCW_Archival=0”, zgodnie z powyższym przykładem.

 

Można wprowadzić alternatywne wersje zapytania – w takim przypadku, jeśli wyszukiwanie na liście w punkcie ACD ma uwzględniać wszystkie dane, jakie są na niej widoczne, należy analogicznie zmodyfikować także warunki wyszukiwania – np. tak jak w poniższym przykładzie.

 

Przyklad
Przykład zapytania na zakładce Lista, w wyniku którego na liście dokumentów w punkcie ACD:
  • w ramach kolumny „Dokument” oprócz numeru dokumentu wyświetlane są dodatkowe dane: nazwa kontrahenta i data wystawienia,
  • dostępne są kolumny 3 atrybutów (o nazwach określonych na zakładce „Ogólne”)
  • wyszukiwanie odbywa się w zakresie wszystkich czterech kolumn („Dokument” z dodatkowymi informacjami oraz w kolumnach atrybutów)
  BEGIN TRY     
     select d.OCD_Id, NULL, OCD_Number + ', '+ OCD_ContractorName + ', '+ CONVERT(varchar, OCD_IssueDate, 104), OCD_Tag1, OCD_Tag2, OCD_Tag3
     from do.OC_Documents d left join do.OC_WorkAPProcess W on d.OCD_Id = OCW_DocumentID -- tabela przeprocesowanych dokumentów
     join do.DF_ConfAPDictionary a on a.APD_ID=W.OCW_APDId
     where OCW_Status = 2 and APD_ID= @PointId@ and OCW_Archival=0
     -- and OCW_OperatorID=@IdOperatorBPM@    -- dodatkowy warunek, aby na liście operator widział dokumenty przeprocesowane przez siebie 
     and (nullif(@SearchText@,'') is null OR (@SearchText@ <> '' and OCD_Number + ', '+ OCD_ContractorName + ', '+ CONVERT(varchar, OCD_IssueDate, 104) LIKE '%' + @SearchText@ + '%'))
     OR (@SearchText@ <> '' and OCD_Tag1 LIKE '%' + @SearchText@ + '%')
     OR (@SearchText@ <> '' and OCD_Tag2 LIKE '%' + @SearchText@ + '%')
     OR (@SearchText@ <> '' and OCD_Tag3 LIKE '%' + @SearchText@ + '%')
     and (@Nip@ is null OR OCD_ContractorNip = @Nip@)
     and (@DateFrom@ is null or OCD_IssueDate >= @DateFrom@)
     and (@DateTo@ is null or OCD_IssueDate <= @DateTo@)
     and (@GrossAmountFrom@ is null or OCD_PaymentAmount >= @GrossAmountFrom@)
     and (@GrossAmountTo@ is null or OCD_PaymentAmount <= @GrossAmountTo@)
 END TRY
 BEGIN CATCH
  DECLARE @ErrorMessage varchar(max) = 'W zapytaniu wystąpił błąd : ' + ERROR_MESSAGE();
  THROW 50001,  @ErrorMessage ,1;   
 END CATCH

 

Lista dokumentów w punkcie AC, jeśli zastosowano powyższe zapytanie na zakładce „Lista” – na liście widoczne są: kolumna „Numer dokumentu” z dodatkowymi informacjami i  oczekujące na uzupelnienie kolumny atrybutów (Towar, Wartość netto (PLN) i Forma płatności)

 

Uwaga
W kolumnach atrybutów znajdują się jedynie wartości tekstowe.

 

Wyszukiwanie po fragmencie tekstu dostępnym w kolumnie „Dokument”

 

Zakładka „Kontrolki”

Na zakładce „Kontrolki” za pomocą zapytań SQL należy wskazać wartości, które będą wyświetlane w poszczególnych kontrolkach po przeprocesowaniu dokumentu w usłudze Comarch OCR. Przykłady zapytań SQL zostały przedstawione w artykule Przykłady zapytań SQL w zakładce Kontrolki.

W wersji 2026.0.0 zmodyfikowano zakładkę „Kontrolki” w taki sposób, aby możliwe było odrębne definiowanie mapowania kontrolek dla każdego typu obiegu wybranego na zakładce „Ogólne”.

W tym celu w górnej części zakładki dodano pole, po kliknięciu w które rozwijana jest lista typów obiegów przypisanych do danego punktu ACD na zakładce „Ogólne“. Gdy zostanie wybrany typ obiegu, wówczas poniżej dostępny będzie obszar, w ramach którego można zdefiniować kontrolki dla danego typu obiegu. Pozostałe ustawienia dotyczące zakładki „Kontrolki“ nie ulegają zmianie – aby dodać kontrolkę do mapowania, należy kliknąć w przycisk [Dodaj], a następnie wprowadzić odpowiednie zapytanie SQL w polu znajdującym się po prawej stronie okna. Mapowanie danej kontrolki można usunąć, klikając w ikonę kosza na prawo od nazwy kontrolki

 

Uwaga
Jeśli dany typ obiegu zostanie odznaczony w polu „Typ obiegu” na zakładce „Ogólne” podczas konfiguracji punktu ACD, wówczas nie będzie również dostępny do wyboru na zakładce „Kontrolki”.

 

Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Współpraca z Comarch OCR” przed wyborem typu obiegu

 

Widok zakładki „Kontrolki” w ramach konfiguracji punktu ACD typu „Współpraca z Comarch OCR” z listą typów obiegów przypisanych do danego punktu ACD do wyboru

 

Punkt konfiguracyjny typu „Współpraca z Comarch OCR”, zakładka „Kontrolki”

 

W ramach zakładki „Kontrolki” uprawniony operator może zdefiniować zapytanie SQL, które przeniesie dane z wybranego atrybutu na określoną kontrolkę typu Tekst.

Uwaga

Zapytania SQL dla poszczególnych atrybutów:

  • Dla pola „Atrybut 1”
select OCD_Tag1 from do.OC_Documents where OCD_ID=@Id1@
  • Dla pola „Atrybut 2”
select OCD_Tag2 from do.OC_Documents where OCD_ID=@Id1@
  • Dla pola „Atrybut 3”
select OCD_Tag3 from do.OC_Documents where OCD_ID=@Id1@

 

Wprowadzanie na zakładce „Kontrolki” zapytania, które przeniesie dane z pola „Atrybut 1” do kontrolki typu Tekst „Kontrahent”

 

Istnieje również możliwość konfiguracji puntu ACD w taki sposób, aby wybrane dane zmapowane na punkcie ACD były wyświetlane w ramach atrybutów na liście dokumentów – przykładową konfigurację przedstawiono poniżej:

 

Przyklad
Operator chce, aby kontrahent, NIP i data wystawienia faktury były mapowane na kontrolki w danym typie obiegu oraz aby na liście dokumentów w punkcie ACD typu „Współpraca z OCR”  w ramach atrybutów „Kontrahent”, „NIP” i „Data wystawienia’ były wyświetlane odpowiednio: nazwa kontrahenta z Comarch ERP XL, jego numer NIP oraz data wystawienia faktury. W tym celu modyfikuje konfigurację punktu ACD w następujący sposób:

1. Na zakladce „Ogólne”  w polu „Typ obiegu” wybiera typ obiegu, w którym dostępne są nastepujące kontrolki:
  • kontrolka typu Kontrahent „Kontrahent”
  • kontrolka typu Tekst „NIP”
  • kontrolka typu Data i godzina „Data wystawienia”

W poniższym przykładzie jest to typ obiegu „Faktury zakupu”.

2. Na zakladce „Ogólne” w ramach pola „Nazwy atrybutów na liście dokumentów w punkcie ACD” wprowadza:
  • w polu „Atrybut 1” – Kontrahent
  • w polu „Atrybut 2” – NIP
  • w polu „Atrybut 3” – Data wystawienia

 

Przykładowa konfiguracja pól dostępnych w ramach pola „Nazwy atrybutów na liście dokumentów w punkcie ACD”

 

3. Na zakładce „Kontrolki” wybiera typ obiegu, w którym znajdują się kontrolki omówione w punkcie 1 (w tym przykladzie typ obiegu „Faktury zakupu”). Następnie za pomocą przycisku „Dodaj”  dodaje kolejne mapowania kontrolek, wprowadzając dla nich nastepujące zapytania SQL:

  • Kontrahent
-- 1. Aktualizacja danych dla Atrybutu 1
UPDATE d
SET d.OCD_Tag1 = CAST(k.Knt_Nazwa1 AS VARCHAR(255))
FROM [nazwa_bazy_Comarch_BPM].[do].[OC_Documents] d
JOIN [nazwa_bazy_Comarch_ERP_XL].[cdn].[KntKarty] k ON k.Knt_Nip = d.OCD_ContractorNip
WHERE d.OCD_ID = @Id1@;

-- 2. Pobranie danych do wyświetlenia w kontrolce
SELECT TOP 1 
    k.Knt_GidNumer, 
    k.Knt_Akronim
FROM [nazwa_bazy_Comarch_BPM].[do].[OC_Documents] d
JOIN [nazwa_bazy_Comarch_ERP_XL].[cdn].[KntKarty] k ON k.Knt_Nip = d.OCD_ContractorNip
WHERE d.OCD_ID = @Id1@;

 

  • NIP
 -- 1. Aktualizacja danych dla Atrybutu 2
UPDATE [nazwa_bazy_Comarch_BPM].[do].[OC_Documents] 
SET OCD_Tag2 = CAST(OCD_ContractorNip AS VARCHAR(255))
WHERE OCD_ID = @Id1@;

-- 2. Pobranie danych do wyświetlenia w kontrolce

select OCD_ContractorNip
from [nazwa_bazy_Comarch_BPM].[do].[OC_Documents]
where OCD_ID=@Id1@

 

  • Data wystawienia
 -- 1. Aktualizacja pola OCD_Tag3 sformatowaną datą
UPDATE [[nazwa_bazy_Comarch_BPM].[do].[OC_Documents]
SET OCD_Tag3 = CONVERT(varchar(10), OCD_IssueDate, 104)
WHERE OCD_ID = @Id1@;

-- 2. Pobranie danych do wyświetlenia w kontrolce
SELECT 
    OCD_IssueDate
FROM [[nazwa_bazy_Comarch_BPM].[do].[OC_Documents]
WHERE OCD_ID = @Id1@;

 

Wprowadzanie zapytania  dla atrybutu „Kontrahent” na liście dokumentów i dla kontrolki „Kontrahent”

 

4. Operator zapisuje zmiany wprowadzony w punkcie ACD, klikając w przycisk „Zapisz”.

Rezultat zmian w konfiguracji punktu ACD: Po pobraniu listy faktur w punkcie ACD dane – kontrahent, numer NIP i data wystawienia-  są widoczne na podglądzie kontrolek do zmapowania oraz w ramach atrybutów na liście dokumentów.

W przypadku problemów z wyświetleniem danych należy nacisnąć raz lub dwukrotnie przycisk „Odśwież”.

Należy pamiętać, że w przypadku ręcznej modyfikacji wartości atrybutów powrócą one do poprzednich, zmapowanych wartości, gdy lista będzie odświeżana.

 

Przykładowy widok listy z wypelnionymi automatycznie atrybutami w punkcie ACD

 

Zakładka „Uprawnienia”

Na zakładce „Uprawnienia” należy wskazać pracowników, którzy będą mogli procesować dokumenty w ramach punktu. Uprawnienia mogą być dodawane wyłącznie poprzez wskazanie pracowników, nie ma możliwości dodania uprawnień dla pracowników wskazanego działu czy pracowników zajmujących określone stanowisko.

 

Punkt konfiguracyjny typu „Współpraca z Comarch OCR”, zakładka „Uprawnienia”
Uwaga
Dodanie operatora do uprawnień na punkcie konfiguracyjnym skutkuje nadaniem mu uprawnień do zakładki ACD (we właściwościach pracownika, na zakładce „Uprawnienia”, w sekcji „Funkcjonalności” zostaje zmieniona wartość parametru „Automatyczne generowanie dokumentów” na „Tak”).

 

Od wersji 2023.0. 0 na każdej zakładce znajduje się ikona   [Eksport], która umożliwia eksportowanie danego punktu ACD do zapisu na dysk (zob. Import i eksport punktów ACD)

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!

 

Powrót do początku artykułu

Czy ten artykuł był pomocny?

( 1 )
( 0 )
Wyślij opinie