Baza wiedzy LINKSPOT › Comarch BPM - współpraca z Comarch ERP Altum

Definiowanie punktu konfiguracyjnego

Comarch BPM - współpraca z Comarch ERP Altum · Opublikowano 2026-07-30

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:

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”

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.

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:

  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:

select OCD_Tag1 from do.OC_Documents where OCD_ID=@Id1@

select OCD_Tag2 from do.OC_Documents where OCD_ID=@Id1@

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:

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

  1. Na zakladce „Ogólne” w ramach pola „Nazwy atrybutów na liście dokumentów w punkcie ACD” wprowadza:

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

  1. 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:
-- 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@;

 -- 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@

 -- 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”

  1. 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

＋ Mam problem z tym tematem Otwórz w portalu bazy wiedzy »