Baza wiedzy LINKSPOT › Wskazówki

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

Wskazówki · Opublikowano 2025-02-04

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:

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”

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:

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:

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

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:

select KSD_Tag1 from do.KS_Documents where KSD_ID=@Id1@

select KSD_Tag2 from do.KS_Documents where KSD_ID=@Id1@

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:

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

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.

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