Wprowadzenie dodatkowych pól (atrybutów) w punktach ACD typu „Współpraca z Comarch OCR” oraz „Import dokumentów zakupu z KSeF”

W wersji 2025.0.0 wprowadzono zmiany w ramach punktu konfiguracyjnego typu „Współpraca z Comarch OCR” oraz punktu konfiguracyjnego ACD typu „Import dokumentów zakupu z KSeF”, polegające na dodaniu 3 nowych pól (atrybutów).

 

Zmiany w konfiguracji punktu ACD typu „Współpraca z Comarch OCR”

Dodanie pól atrybutów

Na zakładce „Ogólne” na punkcie konfiguracyjnym punktu ACD typu „Współpraca z Comarch OCR” dodano pole „Nazwy atrybutów na liście dokumentów w punkcie ACD”, w ramach którego dostępne są pola: „Atrybut 1”, Atrybut 2” i „Atrybut 3”.

 

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

 

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)

 

W ramach zakładki „Lista” należy wprowadzić zmienione zapytanie – można skopiować je z sekcji „Przykład”, dostępnej w ramach zakładki:

 

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 APD_Archival=0

-- and OCW_OperatorID=@IdOperatorDMS@ -- 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

 

Wprowadzanie zapytania na zakładce „Lista”

 

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”

 

Wprowadzone zmiany należy zapisać, klikając w przycisk „Zapisz”.

Na liście przeprocesowanych dokumentów nazwę pierwszej kolumny zmieniono z „Numer dokumentu” na „Dokument”. W zależności od tego, czy i ile nazw atrybutów wprowadzono na zakładce „Ogólne” podczas konfiguracji punktu ACD (0,1,2 lub 3), na liście dokumentów jest widoczne 1- 4 kolumn.

Aby wprowadzić wartość w dodatkowych kolumnach, należy kliknąć w daną komórkę w wybranej kolumnie i wierszu, a następnie w poszerzonym polu edycji wpisać tekst. Wówczas wprowadzone dane zostaną zapisane w wybranych kontrolkach typu tekst.

 

Widok listy dokumentów w punkcie ACD typu „Współpraca z OCR”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” – przed rozpoczęciem pracy w punkcie

 

Widok listy dokumentów w punkcie ACD typu „Współpraca z OCR”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2”, „Atrybut 3” i przeprocesowano dokument – wprowadzanie wartości dla „Atrybutu 3” (w tym przypadku to „Forma płatności”) oraz mapowanie danych z atrybutów do kontrolek typu Tekst

Jeśli wcześniej wprowadzono wartość atrybutu do tabeli do.OC_Documents, wówczas po przesunięciu kursora na daną komórkę w ramach kolumny atrybutu zostanie wyświetlona pełna wartość komórki.

 

Dodanie opcji wyszukiwania i filtrowania listy w punkcie ACD typu „Współpraca z OCR”

W wersji 2025.0.0 w ramach punktu ACD typu „Współpraca z OCR” umożliwiono wyszukiwanie dokumentów i zawężanie listy dokumentów, podobnie jak w punkcie typu „Import dokumentów zakupu z KSeF” .

Aby wyszukać dokument/zawęzić listę dokumentów należy wprowadzić frazę (numer dokumentu lub fragment numeru dokumentu) w ramach pola wyszukiwarki, a następnie kliknąć przycisk [Szukaj].

 

Wyszukiwanie dokumentów według fragmentów ich numerów

 

W ramach punktu ACD typu „Współpraca z OCR” dodano następujące ikony:

[Filtry] – po kliknięciu w ikonę zostaje otwarte okno, w ramach którego operator może zdefiniować warunki wyszukiwania dokumentów na liście. W ramach okna wyświetlane są następujące filtry:

  • Nip firmy – umożliwia zawężenie listy według wartości NIP (według danych z kolumny OCD_ContractorNip w tabeli do.OC_Documents);
  • Data wystawienia – od – umożliwia wprowadzenie daty, od której mają zostać wyświetlone wystawione dokumenty; po kliknięciu w znak x na prawo od pola czyści dane wprowadzone w ramach filtra (według danych z kolumny OCD_IssueDate w tabeli do.OC_Documents);
  • Data wystawienia – do – umożliwia wprowadzenie daty, do której mają zostać wyświetlone wystawione dokumenty; po kliknięciu w znak x na prawo od pola czyści dane wprowadzone w ramach filtra (według danych z kolumny OCD_IssueDate w tabeli do.OC_Documents);
  • Wartość brutto („wartość od” i „wartość do”) – umożliwia zawężenie listy dokumentów według zakresu wartości brutto faktury; operator może wprowadzić wartość albo w obydwóch polach, albo w jednym z nich (według danych z kolumny OCD_PaymentAmount w tabeli do.OC_Documents).

Po wprowadzeniu wartości w wybranych polach należy kliknąć przycisk [Filtruj] – wówczas lista wyświetlanych dokumentów zostanie zawężona zgodnie z wybranymi filtrami.

 

Okno „Filtry”

Widok punktu ACD typu „Współpraca z OCR” po zastosowaniu filtra „NIP firmy”

 

[Usuń filtry] – po kliknięciu ikony wszystkie zdefiniowane warunki wyszukiwania (zarówno te w oknie „Filtry”, jak i te w polu wyszukiwarki) zostaną usunięte.

Kiedy operator kliknie w nazwę danej kolumny, obok niej pojawi się ikona   – w takim przypadku lista jest posortowana w danej kolumnie według wartości rosnąco. Jeżeli operator kliknie ponownie w nazwę kolumny, wówczas obok tej nazwy wyświetlona zostaje ikona   – wtedy lista zostaje posortowana w danej kolumnie według wartości malejąco

Sortowanie dokumentów rosnąco ma miejsce według następującej kolejności:

  • Uszeregowane alfabetycznie;
  • Uszeregowane według kolejności numerycznej (0-9);
  • Uszeregowane według znaków specjalnych.

Sortowanie dokumentów malejąco ma miejsce według następującej kolejności:

  • Uszeregowane według znaków specjalnych;
  • Uszeregowane według kolejności numerycznej (9-0);
  • Uszeregowane alfabetycznie.

 

Jeśli operator przesunie kursor na początek nazwy danej kolumny, wówczas między kolumnami pojawia się ikona dwustronnej strzałki (kolor strzałki jest zależny od ustawień komputera dla wyglądu kursora) – wówczas po kliknięciu lewym przyciskiem myszki można zmieni szerokość kolumny, przeciągając ją w prawo albo w lewo.

 

Widok listy dokumentów z widoczną dwustronną strzałką do zmiany szerokości kolumny

 

Zmiany w konfiguracji punktu „Import dokumentów zakupu z KSeF”

 

Dodanie pól atrybutów

Na zakładce „Ogólne” na punkcie konfiguracyjnym punktu ACD typu „Import dokumentów zakupu z KSeF” dodano pole „Nazwy atrybutów na liście dokumentów w punkcie ACD”, w ramach którego dostępne są pola: „Atrybut 1”, Atrybut 2” i „Atrybut 3”.

 

Widok zakładki „Ogólne” na definicji punktu ACD typu „Import dokumentów zakupu z KSeF” z polami atrybutów (przed uzupełnieniem, tryb jednofirmowy)

 

Widok zakładki „Ogólne” na definicji punktu ACD typu „Import dokumentów zakupu z KSeF” z polami atrybutów (przed uzupełnieniem, tryb wielofirmowy)

 

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 jako nazwy kolumn.

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 „Import dokumentów zakupu z KSeF” z polami atrybutów (z przykładowym uzupełnieniem, tryb jednofirmowy)

 

W ramach zakładki „Lista” należy wprowadzić zmienione zapytanie – można skopiować je z sekcji „Przykład”, dostępnej w ramach zakładki:

BEGIN TRY

select d.KSD_ID, NULL, KSD_NumerFaktury, KSD_Tag1, KSD_Tag2, KSD_Tag3

from do.KS_Documents d

left join do.KS_WorkAPProcess W on d.KSD_ID = KSW_DocumentID /*tabela przeprocesowanych dokumentów*/

left join do.KS_DocumentHeaders dh on d.KSD_ID = dh.KSH_DocumentId

left join do.KS_DocumentContractors dc on d.KSD_ID = dc.KSC_DocumentID

where KSW_APDId=@PointId@ -- id punktu ACD

and KSW_OperatorID=@IdOperatorDMS@ /*dodatkowy warunek, aby na liście operator widział dokumenty przeprocesowane przez siebie*/

and ((@InvoiceStatus@ = 0 and KSW_Status <> 5 and KSW_Archival = 0) OR (@InvoiceStatus@ = 1 and KSW_Archival = 1) OR

(@InvoiceStatus@ = 2 and KSW_Status = 5) OR @InvoiceStatus@ = 3)

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

and (@Nip@ is null OR dc.KSC_PodatnikNIP = @Nip@)

and (@DateFrom@ is null or dh.KSH_DataWytworzeniaFa >= @DateFrom@)

and (@DateTo@ is null or dh.KSH_DataWytworzeniaFa <= @DateTo@)

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

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

and (@InvoiceType@ is null or KSD_RodzajFaktury = @InvoiceType@)

END TRY

BEGIN CATCH

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

THROW 50001, @ErrorMessage ,1;

END CATCH

 

Wprowadzanie zapytania na zakładce „Lista”

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 KSD_Tag1 from do.KS_Documents where KSD_ID=@Id1@
  • Dla pola „Atrybut 2”
select KSD_Tag2 from do.KS_Documents where KSD_ID=@Id1@
  • Dla pola „Atrybut 3”
select KSD_Tag3 from do.KS_Documents where KSD_ID=@Id1@

 

Wprowadzanie na zakładce „Kontrolki” zapytania, które przeniesie dane z pola „Atrybut 3” do kontrolki typu Tekst „Forma płatności”

 

Wprowadzone zmiany należy zapisać, klikając w przycisk „Zapisz”.

Na liście przeprocesowanych dokumentów w zależności od tego, czy i ile nazw atrybutów wprowadzono na zakładce „Ogólne” podczas konfiguracji punktu ACD (0,1,2 lub 3), na liście dokumentów jest widoczne 1- 4 kolumn.

Aby wprowadzić wartość w dodatkowych kolumnach, należy kliknąć w daną komórkę w wybranej kolumnie i wierszu, a następnie w poszerzonym polu edycji wpisać tekst. Wówczas wprowadzone dane zostaną zapisane w wybranych kontrolkach typu tekst.

 

Widok listy dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” – przed rozpoczęciem pracy w punkcie

 

Widok listy dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” i przeprocesowano dokument – wprowadzanie wartości dla „Atrybutu 3” (w tym przypadku to „Forma płatności”)

 

Widok listy dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” i przeprocesowano dokument – mapowanie danych z atrybutów do kontrolek typu Tekst

 

Jeśli wcześniej wprowadzono wartość atrybutu do tabeli do.KS_Documents, wówczas po przesunięciu kursora na daną komórkę w ramach kolumny atrybutu zostanie wyświetlona pełna wartość komórki.

Kiedy operator kliknie w nazwę danej kolumny, obok niej pojawi się ikona   – w takim przypadku lista jest posortowana w danej kolumnie według wartości rosnąco. Jeżeli operator kliknie ponownie w nazwę kolumny, wówczas obok tej nazwy wyświetlona zostaje ikona   – wtedy lista zostaje posortowana w danej kolumnie według wartości malejąco

Sortowanie dokumentów rosnąco ma miejsce według następującej kolejności:

  • Uszeregowane alfabetycznie;
  • Uszeregowane według kolejności numerycznej (0-9);
  • Uszeregowane według znaków specjalnych.

Sortowanie dokumentów malejąco ma miejsce według następującej kolejności:

  • Uszeregowane według znaków specjalnych;
  • Uszeregowane według kolejności numerycznej (9-0);
  • Uszeregowane alfabetycznie.

 

Jeśli operator przesunie kursor na początek nazwy danej kolumny, wówczas między kolumnami pojawia się ikona dwustronnej strzałki (kolor strzałki jest zależny od ustawień komputera dla wyglądu kursora) – wówczas po kliknięciu lewym przyciskiem myszki można zmieni szerokość kolumny, przeciągając ją w prawo albo w lewo.