Comarch DMS umożliwia współpracę z dowolnym programem OCR, pod warunkiem, że program OCR zapisuje przeprocesowane dane do lokalnej bazy danych.
Konfigurację wszystkich typów punktów ACD należy rozpocząć od analizy tabeli lub tabel, do których OCR zapisuje przeprocesowane dane.
Złożoność struktury tabel w bazie OCR może być dowolna, nie ma też znaczenia typ serwera SQL, z którym współpracuje OCR.
Tabele, na które warto zwrócić uwagę, to:
OC_Documents – tabela, która zawiera dane nagłówkowe dokumentu, takie jak: nr dokumentu, data sprzedaży, wartość brutto, kontrahent itp.
DF_WorkAPProcess – tabele, która wiąże dokumenty znajdujące się w tabelach OCR z wygenerowanymi dokumentami DMS. Tabele DF_WorkAPProcess mogą znajdować się w kilku miejscach- jedna z tabel domyślnie jest dodawana do schematu „do”. Tabela może zostać utworzona w każdej innej bazie danych, gdzie znajdują się zbuforowane dane do przetworzenia.
Uwaga
Nie należy mylić tabeli DF_WorkAPProcess z tabelami SL_WorkAPProcess oraz ML_WorkAPProcess – pełnią one podobne role, ale na innym poziomie.
Struktura tabeli DF_WorkAPProcess:
CREATE TABLE [do].[DF_WorkAPProcess](
[APW_Id] [int] IDENTITY(1,1) NOT NULL,
[APW_APDId] [int] NOT NULL,
[APW_DocumentID1] [bigint] NOT NULL,
[APW_DocumentID2] [bigint] NULL
)
gdzie:
APW_Id – identyfikator wiersza
APW_APDId – identyfikator punktu
APW_DocumentID1 – identyfikator dokumentu, który został przeprocesowany
APW_DocumentID2 – drugi identyfikator dokumenty (jeśli istnieje), który został przeprocesowany
Tabelę DF_WorkAPProcess wykorzystuje się w zapytaniach SQL, które prezentują listę dokumentów do przeprocesowania. Warunek where APW_DocumentID1 is null odfiltrowuje dokumenty, które już zostały przeprocesowane (zostały z nich utworzone dokumenty DMS).
Przyklad
Przykład zapytania:
select id, null, number from do.SL_Documents
left join do.DF_WorkAPProcess on id = APW_DocumentID1
where APW_DocumentID1 is null and APW_APDId={id punktu ACD}
gdzie:
do.SL_Documents – tabela z dokumentami do przeprocesowania
where APW_DocumentID1 is null and APW_APDId={id punktu ACD} – warunek prezentujący nowe dokumenty, z których jeszcze nie zostały wygenerowane dokumenty DMS
Programy OCR zalecane do współpracy z Comarch DMS
Mechanizm automatycznego generowania dokumentów jest zalecany do współpracy ze wszystkimi OCR’ami, które wyniki procesowanych dokumentów zapisują do bazy danych. Nie ma znaczenia typ bazy danych, ponieważ system pozwala na nawiązanie połączenia z większością popularnych baz danych.
[Dodaj] – funkcjonalność umożliwiająca utworzenie nowego punktu konfiguracyjnego.
[Edycja] – funkcjonalność umożliwiająca edycję istniejącego punktu konfiguracyjnego.
[Usuń] – funkcjonalność usuwania istniejących punktów konfiguracyjnych.
[Dokumenty] – kontrolka filtra, który umożliwia zawężenie listy skanów, dla których zostaną inicjowane nowe dokumenty. Kontrolka przyjmuje wartości:
Wszystkie – po naciśnięciu „Generuj” zostaną wygenerowane wszystkie dokumenty z listy.
Tylko wypełnione – po naciśnięciu „Generuj” zostaną wygenerowane dokumenty, których wszystkie kontrolki zostały wypełnione (zainicjowane).
Wybrane – po naciśnięciu „Generuj” zostaną wygenerowane zaznaczone dokumenty. W przypadku zaznaczenia dokumentów oznaczonych , na których nie zostały rozpoznane wszystkie dane dokument zostanie wygenerowany bez tych danych.
[Generuj] – przycisk uruchamiający generowanie dokumentów. Nieaktywny do momentu zaczytania plików na listę skanów/dokumentów.
[Odśwież] – ikona za pomocą, której odświeżana jest lista skanów/dokumentów.
[Uruchom] – przycisk dostępny od wersji 2023.1.0; po naciśnięciu tego przycisku zostanie otwarty plik .exe, do którego ścieżkę określono w pliku DMS.exe.config (zob. Uruchamianie pliku exe w punkcie ACD)
[Info] – po naciśnięciu przycisku wyświetlana jest informacja jaka ilość dokumentów pozostała możliwa do wygenerowania w dostępnym pakiecie.
[Ustawienia OCR] – okno ustawień OCR, w oknie należy wskazać ścieżkę do katalogu, z którego będą pobierane pliki do przeprocesowania, a także należy określić tryb łączenia przesłanych plików(zob. Przetwarzanie dokumentów przez usługę Comarch OCR). Od wersji 2023.1.2 w ramach tego okna można także określić, czy przeprocesowane pliki mają być archiwizowane.
[Dodaj pliki] – umożliwia wskazanie plików z dysku komputera, pliki zostaną umieszczone w katalogu wskazanym w oknie ustawień OCR.
[Skanuj] – funkcjonalność procesowania skanowanych dokumentów – w kwestii opcji dostępnych w oknie „Skanowanie” zob. Załącznik – skan dokumentu.
[Import faktur z KSeF] – przycisk występujący w oknie punktu ACD typu Import dokumentów zakupu z KSeF; po kliknięciu w ten przycisk zostaje otwarte okno „Import faktur z KSeF”, w którym można wybrać faktury KSeF i zaimportować je do Comarch DMS.
[Pobierz wiadomości] – przycisk występujący w oknie punktu ACD typu Import dokumentów ze skrzynki e-Doręczenia; po kliknięciu w ten przycisk zostaje otwarte okno „Import wiadomości z usługi e-Doręczenia”, w którym można wybrać wiadomości i zapisać je w Comarch DMS.
[Włącz procesowanie dokumentów] – po konfiguracji należy zaznaczyć opcję, aby system rozpoczął procesowanie dokumentów (dotyczy punktów ACD typu Współpraca z Comarch OCR oraz Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium))
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?
Poniższa tabela prezentuje ogólne wzory na zapytania SQL dotyczące poszczególnych typów kontrolek. Szczegółowe przykłady zastosowania takich zapytań zostały przedstawione w artykule Przykłady zapytań SQL w zakładce Kontrolki.
Na karcie obiegu są możliwe do zainicjowania wartościami następujące typy kontrolek:
Kontrolka
Składnia
Przykład
Tekst
Select varchar(900)
varchar – tekst, którym zostanie zainicjowana kontrolka
select nr_obcy from tabela where id1 = @Id1@
Data i godzina
Select datetime
datetime – data i godzina, którą zostanie zainicjowana kontrolka
Uwaga!
Kontrolkę należy inicjować datą i godziną, jeżeli na definicji typu obiegu we właściwościach kontrolki została wyłączona godzina. Informacje o godzinie zostaną pominięte.
select data_platnosci from tabela
where Id = @Id1@
Liczba całkowita
SELECT int
int - liczba całkowita
select ilosc_stron from tabela
where Id = @Id1@
Liczba rzeczywista
SELECT real
real - liczba rzeczywista
select waga from tabela
where Id = @Id1@
Liczba stałoprzecinkowa
SELECT decimal(22,4)
decimal(22,4) - liczba stałoprzecinkowa
select wartosc_netto from table
where Id = @Id1@
Lista
SELECT varchar(100)
varchar(100) - nazwa pozycji
select rodzaj_platnosci_nazwa from table
where Id = @Id1@
Wartość logiczna
SELECT bool
bool - wartość True lub False (1/0)
select czy_kompletna from table
where Id = @Id1@
Kontrahent
SELECT int, varchar(100)
int – Id kontrahenta (Knt_GIDNumer)
varchar(100) - Nazwa kontrahenta
Uwaga!
Aby zainicjować kontrahenta należy podać knt_gidnumer (int). Nazwa kontrahenta jest jedynie polem opisowym.
select top 1 Knt_GIDNumer, Knt_Akronim from cdn.KntKarty
join cdn.TraNag on TrN_KntTyp = Knt_GIDTyp and TrN_KntNumer = Knt_GIDNumer
where TrN_GIDTyp = @Id1@ and TrN_GIDNumer = @Id2@
Towar
SELECT varchar(100)
varchar(100) - kod towaru (Twr_Kod)
select top 1 Twr_Kod from cdn.TwrKarty
join cdn.TraElem on TrE_TwrTyp = Twr_GIDTyp and TrE_TwrNumer = Twr_GIDNumer
where TrE_GIDTyp = @Id1@ and TrE_GIDNumer = @Id2@ and TrE_GIDLp = 1
Załączniki – pobierz plik z dysku
SELECT varchar (255)
Varchar(255) – ścieżka do pliku
Uwaga!
Zalecane jest aby wszyscy użytkownicy komputera posiadali uprawnienia do katalogu, z którego będą pobierane pliki.
select 'c:\scan\doc\' + NazwaPliku + '.pdf' from tabela
where Id = @Id1@
Załączniki – pobierz plik z bazy danych
SELECT varbinary, varchar(100)
varbinary – obraz skanu zapisany w bazie
varchar(100) - typ pliku
select scan, 'pdf' from tabela
where Id = @Id1@
Inicjowanie wartości kontrolek na formatce 'Dokument ERP XL’
Poniższa tabela prezentuje ogólne wzory na zapytania SQL dotyczące poszczególnych pól w ramach kontrolki typu „Dokument ERP XL”.
Kontrolka
Składnia
Przykład
Kontrahent
SELECT int, varchar(100)
int – Id kontrahenta (Knt_GIDNumer)
varchar(100) - Akronim kontrahenta (Knt_Akronim)
select k_id, k_nazwa from tabela
where id1 = @Id1@
Płatnik
SELECT int, varchar(100)
int – Id kontrahenta (Knt_GIDNumer)
varchar(100) - Akronim kontrahenta (Knt_Akronim)
select k_id, k_nazwa from tabela
where id1 = @Id1@
Waluty
SELECT varchar(100)
varchar(100) - symbol waluty
SELECT symbol from tabela
where Id = @Id1@
Seria
SELECT varchar(100)
varchar(100) - symbol serii
SELECT seria from tabela
where Id = @Id1@
Rodzaj zakupu
SELECT varchar(100)
varchar(100) - symbol rodzaju zakupu
SELECT rodzaj_z from tabela
where Id = @Id1@
Rejestr VAT
SELECT varchar(100)
varchar(100) - symbol Rejestru VAT
SELECT R_Vat from tabela
where Id = @Id1@
Rodzaj ceny
SELECT varchar(100)
varchar(100) - symbol rodzaju ceny
SELECT txt from tabela
where Id = @Id1@
Lista elementów
SELECT towar varchar(100),
ilość decimal(22,4),
jm varchar(100),
cena decimal(22,4),
stawka VAT varchar(100),
wartość netto decimal(22,4),
wartość brutto decimal(22,4),
SELECT 'Towar_1', 5, 'szt.', 100.00, '23', 500.00, 650.00 from tabela
where dok_id = @Id1@
Zmiana daty utworzenia dokumentu
W przypadku, gdy pracownik inicjujący dokumenty posiada uprawnienie do zmiany daty utworzenia dokumentu w Comarch DMS (nadane na karcie danego pracownika w zakładce Uprawnienia, w sekcji Praca z dokumentem opcji, zob. Zmiana daty utworzenia dokumentu), ma możliwość zmiany daty utworzenia dokumentu również na dokumentach utworzonych za pomocą funkcjonalności automatycznego tworzenia dokumentów (OCR). W tym celu powinien kliknąć ikonę ołówka i na wyświetlonej formatce kalendarza kliknąć na wybraną datę.
Od wersji 2023.0.0 użytkownik może importować punkty ACD. W tym celu w ramach zakładki [Automatyczne generowanie dokumentów] dodano ikonę [Importuj].
Kiedy użytkownik naciśnie przycisk [Importuj], zostaje otwarte okno „Importuj punkt konfiguracyjny”, w ramach którego można:
Wybrać z listy dostępnej w polu „Z wzorca” wzorzec punktu konfiguracyjnego ACD do zaimportowania (wzorce to punkty konfiguracyjne wyeksportowane jako wzorce przez użytkowników – zob. Eksport punktu ACD)
lub
Wybrać punkt konfiguracyjny ACD zapisany w formie pliku na dysku, zaznaczając opcję „Z pliku”
Przycisk [Zapisz] jest nieaktywny aż do czasu, kiedy zostanie wybrany wzorzec lub plik z dysku.
Jeżeli wybrano wzorzec punktu konfiguracyjnego ACD, wówczas należy kliknąć przycisk [Zapisz], aby wzorzec został zaimportowany.
Istnieje możliwość usunięcia wzorca z listy zapisanych wzorców. W tym celu należy zaznaczyć opcję „Z wzorca”, wybrać z rozwijanej listy zapisanych wzorców dostępnej w ramach pola wzorzec, który ma zostać usunięty i kliknąć w ikonkę kosza . Wtedy wybrany wzorzec zostanie usunięty z listy zapisanych wzorców.
Jeśli natomiast wybrano opcję „Z pliku”, wówczas należy kliknąć w znajdujący się obok link [Otwórz plik]. Zostanie wówczas otwarte okno systemowe, w którym trzeba wybrać odpowiedni plik.
Po naciśnięciu przycisku [Otwórz] okno systemowe zostaje zamknięte, a w oknie importu punktu konfiguracyjnego widoczna jest ścieżka do wybranego pliku.
Jeśli użytkownik zaznaczy checkbox [Importuj zdefiniowane uprawnienia], wówczas uprawnienia, które zostały zapisane w oryginalnym punkcie konfiguracyjnym, będą dodane do zaimportowanego punktu. Istnieje możliwość importu uprawnień zarówno dla punktów importowanych ze wzorca, jak również dla punktów importowanych z pliku.
Uwaga
Export i import uprawnień są dostępne tylko dla użytkownika o uprawnieniach administratora.
Uwaga
Checkbox “Importuj zdefiniowane uprawnienia” nie jest dostępny w trybie wielospółkowym z powodu braku możliwości importu uprawnień przy takim ustawieniu.
W przypadku importu punktu konfiguracyjnego, w którego uprawnieniach dodano użytkownika, którego nie ma w systemie, do którego zaimportowano punkt, zostaje wyświetlony następujący komunikat:
Aby zaimportować wybrany punkt konfiguracyjny, należy kliknąć przycisk [Zapisz].
Punkt konfiguracyjny zostaje zaimportowany i otwiera się okno edycji konfiguracji punktu ACD, otwarte na zakładce „Ogólne”.
Konieczne jest, aby:
W polu „ Nazwa punktu” wpisać wybraną przez użytkownika nazwę punktu konfiguracyjnego
W polu „Typ obiegu” wybrać jeden z dostępnych typów obiegu (jeżeli w danym punkcie konfiguracyjnym występuje to pole)
Jeżeli użytkownik nadał punktowi konfiguracyjnemu taką samą nazwę, jaką nosi inny punkt konfiguracyjny, wówczas po kliknięciu przycisku [Zapisz] wyświetlony zostanie następujący komunikat:
Zapytania służące do mapowania kontrolek i pochodzące z oryginalnego obiegu, które znajdują się na zakładce „Kontrolki”:
są automatycznie dopasowane do kontrolek na nowym typie obiegu tylko, jeżeli identyfikatory GUID tych kontrolek są zgodne.
nie są automatycznie dopasowane do kontrolek na nowym typie obiegu, jeżeli identyfikatory GUID tych kontrolek nie są zgodne – w tym przypadku konieczne jest dopasowanie ręczne dostępnych kontrolek danego typu z listy z danym zapytaniem albo napisanie nowego zapytania.
Aby dopasować daną kontrolkę do danego zapytania należy kliknąć w przycisk [Wybierz] znajdujący się obok typu kontrolki, a następnie wybrać kontrolkę danego typu z listy.
Wskazówka
Typ kontrolki widoczny jest w nawiasach kwadratowych.
Jeśli dane mapowanie nie jest potrzebne, można usunąć zapytanie, klikając na ikonkę kosza obok danej pozycji – wówczas takie mapowanie nie nastąpi.
Jeśli użytkownik spróbuje zapisać konfigurację importowanego punktu ACD, ale nie uzupełni wszystkich brakujących informacji, wówczas zostanie wyświetlony komunikat informujący o brakach.
Przyklad
Użytkownik importował punkt konfiguracyjny ACD, ale po zaimportowaniu:
Nie wpisał nazwy importowanego punktu ACD w polu „Nazwa punktu” na zakładce ogólne
Nie wybrał typu obiegu w polu „Typ obiegu” na zakładce „Ogólne”
Nie wybrał 2 kontrolek do mapowania danych dla importowanych zapytań na zakładce „Kontrolki”
Kiedy nacisnął przycisk [Zapisz], aby zapisać importowany obieg, wyświetlony został następujący komunikat:
Wskazówka
Liczba w nawiasie widoczna przy frazie „mapowanie kontrolek” w komunikacie o braku możliwości zaimportowania pliku, to liczba kontrolek, które nie zostały automatycznie połączone z właściwymi zapytaniami na podstawie GUID – w takim przypadku trzeba dopasować właściwą kontrolkę do danego zapytania, jak pokazano powyżej.
Aby możliwe było zapisanie zaimportowanego punktu ACD, konieczne jest uzupełnienie takich danych jak:
Nazwa punktu (pole „Nazwa punktu” na zakładce „Ogólne”)
Typ obiegu (pole „ Typ obiegu” na zakładce „Ogólne”)
Lista (numer id punktu ACD w bazie Comarch DMS na zakładce „Lista”)
Mapowanie kontrolek (zakładka „Kontrolki”, patrz uwagi powyżej)
Ścieżka z punktu OCR (pole „ Zastosuj ścieżkę z punktu OCR” na zakładce „Ogólne” – w przypadku typu współpracy „Współpraca ze skrzynką pocztową (pobieranie załączników)”
Pole „Kontrolka” – dostępne na zakładce „Ogólne” w przypadku typu współpracy „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie DMS)
Połączenie do bazy – w przypadku trybu współpracy z dowolnym programem OCR
Uwaga
Współpraca z Saldeo nie jest wspierana.
W wersji 2023.0.1 został dodany predefiniowany wzorzec punktu ACD, który skonfigurowano do pracy z predefiniowanymi typami obiegu dla Comarch DMS we współpracy z Comarch ERP Optima, a szczególnie dla Comarch DMS pracującego w trybie Lite.
Predefiniowany punkt ACD współpracuje z predefiniowanymi typami obiegu (*)(Optima) Faktura VAT oraz (*)(Optima) Faktura VAT + opis analityczny (zob. Eksport i import typu obiegu).
Na zakładce {Lista] znajduje się odpowiednie zapytanie do listy dokumentów.
Kiedy wybrano jeden z zaimportowanych predefiniowanych typów obiegu (*)(Optima) Faktura VAT lub (*)(Optima) Faktura VAT + opis analityczny w polu „Typ obiegu” na zakładce „Ogólne”, wówczas na zakładce [Kontrolki] predefiniowanego punktu ACD dostępne są następujące kontrolki wraz z odpowiednimi zakładkami:
Skan (Zalaczniki) lub Załącznik (Zalaczniki)
Data wpływu (Datawplywu)
Data wystawienia (Datawystawienia)
Data zakupu (Datazakupu)
Kontrahent(Kontrahent)
Dane kontrahenta (Danekontrahenta)
Wartość brutto (Brutto)
Numer dokumentu (Dokument)
Waluta (Waluta)
Numer rachunku bankowego (Numerrachunku_bankowego)
Forma płatności (Formaplatnosci)
Termin płatności (Terminplatnosci)
Wartość netto (Netto)
W ramach zapytania SQL dla kontrolki Kontrahent należy zmienić frazę Nazwa_bazy_firmowej_Optima na nazwę bazy firmowej Comarch ERP Optima.
Po zaimportowaniu predefiniowanego punktu ACD okno konfiguracji punktu ACD otworzy się na zakładce [Ogólne] i wyświetlony zostanie komunikat informujący o konieczności uzupełnienia tej informacji. Aby możliwa była edycja definicji punktu ACD, użytkownik musi nacisnąć w ramach komunikatu przycisk [Ok] lub znak X.
Eksport punktu ACD
Od wersji 2023.0.0 użytkownik może eksportować punkty ACD. W tym celu w ramach zakładki [Automatyczne generowanie dokumentów] w oknie „Punkt konfiguracyjny”, otwartym podczas dodawania lub edycji punktu konfiguracyjnego, dodano ikonę [Eksport].
Kiedy użytkownik naciśnie przycisk [Eksport], zostaje otwarte okno z dwiema opcjami do wyboru:
Jako wzorzec
Do pliku
Eksport punktu konfiguracyjnego ACD jako wzorzec
Zaznaczenie w ramach okna wyświetlanego po kliknięciu na ikonę [Eksport] opcji „Jako wzorzec” umożliwia zapis punktu ACD jako wzorzec, dostępny w oknie otwartym po kliknięciu ikony [Import] na zakładce [Automatyczne generowanie dokumentów]. Po wyborze tej opcji należy kliknąć przycisk [Zapisz], aby wzorzec został zapisany. Przycisk jest wyszarzony, jeśli nie wprowadzono nazwy wzorca w polu tekstowym.
Po kliknięciu przycisku [Zapisz] wzorzec danego punktu konfiguracyjnego zostanie zapisany w systemie. Jeżeli zapisywanie wzorca zakończyło się powodzeniem, wyświetlony zostaje następujący komunikat:
Jeśli w ramach pola dostępnego po zaznaczeniu opcji „Jako wzorzec” wprowadzono taką samą nazwę, jaką nadano już jednemu z istniejących wzorców, wówczas zostanie wyświetlony następujący komunikat:
Eksport pliku konfiguracyjnego ACD do pliku
Zaznaczenie w ramach okna wyświetlanego po kliknięciu na ikonę [Eksport] opcji „Do pliku” umożliwia zapis punktu konfiguracyjnego ACD do pliku na dysk – taki plik może później zostać zaimportowany po kliknięciu ikony [Import] na zakładce [Automatyczne generowanie dokumentów].
Po wyborze opcji „Do pliku” należy kliknąć w link [Zapisz do pliku]. Zostanie wówczas otwarte okno, w ramach którego należy wybrać lokalizację na dysku, opcjonalnie zmienić nazwę pliku, a następnie kliknąć przycisk [Zapisz]. Punkt konfiguracyjny ACD jest wówczas importowany do pliku z rozszerzeniem *.acd i zapisany w wybranej lokalizacji.
Uruchamianie pliku exe w punkcie ACD
W wersji 2023.1.0 umożliwiono uruchamianie pliku .exe w ramach punktu ACD.
W tym celu w pliku dms.exe.config, znajdującym się w folderze z aplikacją desktopową Comarch DMS, dodano klucz ACDExePath, w którym należy wprowadzić ścieżkę do pliku .exe, który ma zostać uruchomiony w punkcie ACD.
Kiedy użytkownik wprowadzi ścieżkę w ramach klucza „ACDExePath”, zapisze zmiany, a następnie zaloguje się do aplikacji desktop Comarch DMS i przejdzie na zakładkę [Automatyczne generowanie dokumentów], wówczas po prawej stronie okna widoczna będzie nowa ikona [Uruchom].
Po kliknięciu w przycisk [Uruchom] zostanie uruchomiony plik .exe, do którego ścieżkę podano w pliku dms.exe.config.
Uwaga
Przycisk [Uruchom] jest widoczny tylko w przypadku, jeśli w pliku dms.exe.config w kluczu „ACDExePath” wprowadzono ścieżkę do pliku i zapisano zmiany.
Uwaga
Przycisk [Uruchom] jest dostępny dla wszystkich typów punktu konfiguracyjnego oprócz punktu konfiguracyjnego typu „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie DMS)” i punktów współpracujących z Saldeo.
Przyklad
Uruchomienie Comarch ERP Optima w ramach punktu ACD
W ramach klucza „ACDExePath” użytkownik wprowadził wartość: