PDF TO FTP I N S T R U K C J A Wersja instrukcji 1.1 Data publikacji 2018-11-19 ZADANIA PROGRAMU: Wyciąganie określonego ciągu znaków z pliku pdf Zmiana nazwy pliku pdf w oparciu o wyciągnięty ciąg znaków. Do nazwy można dodać ustalony przedrostek i przyrostek Wysyłanie plików na zdefiniowany serwer FTP Spis treści ZADANIA PROGRAMU:... 1 INSTRUKCJA OBSŁUGI:... 2 1. Interfejs programu... 2 1.1 Interfejs programu- elementy informacyjne ekranu głównego... 2 1.2 Interfejs programu- funkcjonalności... 3 1.3 Interfejs programu- automatyzacja... 3 2. Przed rozpoczęciem pracy- konfiguracja programu... 4 2.1 Preferencje- podstawowe ustawienia... 4 2.2 Preferencje- ustawienia odczytu pliku PDF... 5 2.3 Preferencje- ustawienia odczytu pliku PDF... 8 2.4 Preferencje- ustawienia automatu... 9 Licencja:... 10 1 Łukasz Morawski www.excelsolutions.pl
INSTRUKCJA OBSŁUGI: 1. Interfejs programu 1.1 Interfejs programu- elementy informacyjne ekranu głównego Liczba odnalezionych plików typu "pdf" we wskazanym w ustawieniach folderze. Link zawarty w tym polu otwiera listę rozpoznanych plików PDF wraz z rozpoznanym ciągiem znaków. W trybie podglądu w tym przypadku kolumna ze statusem zapisu i wysłania będzie zapełniona wartościami "NOK". Kontrolki pokazujące stan połączenia ze wskazanym w ustawieniach folderem do plików PDF oraz stan połączenia z lokalizacją sieciowa FTP. W przypadku braku połączenia obok ikonek pojawia się krótka informacja o rodzaju błędu. Klikając na czerwoną ikonkę przenosimy się do ustawień programu, gdzie możemy poprawić ścieżki i dane logowania. Ukrywanie programu (program widoczny jako proces) 2 Łukasz Morawski www.excelsolutions.pl
1.2 Interfejs programu- funkcjonalności Ustawienia programu w których można zmienić takie rzeczy jak: - ścieżkę do folderu z plikami PDF - ścieżkę do folderu FTP - pozycję tekstu w PDF do wycięcia i umieszczenia w nazwie pliku - algorytm sprawdzający poprawność pliku PDF. - ustawienie automatu Wysłanie wszystkich plików z rozpoznanym numerem przesyłki na wskazany na serwer FTP. Zapis rozpoznanych przez program plików pdf z nadaniem nowej nazwy według zdefiniowanych ustawień. 1.3 Interfejs programu- automatyzacja Data i godzina startu automatu. Liczba zmienionych lub wysłanych plików PDF. Liczba wykonanych "pętli" programu. Np. dla interwału 5 s, program wykona dwa cykle w ciągu 10 sekund. Uruchomienie automatu. Po kliknięciu na diodę, zmieni ona kolor na zielony a program zgodnie z ustawionym interwałem zacznie przetwarzać pliki PDF. W zależności od ustawień automat będzie zmieniał nazwy plików, przenosił je do nowej lokalizacji lub wysyłał je po zmianie nazwy od razu na FTP. Interwał sprawdzania folderu z plikami PDF. 3 Łukasz Morawski www.excelsolutions.pl
2. Przed rozpoczęciem pracy- konfiguracja programu 2.1 Preferencje- podstawowe ustawienia Zanim zaczniesz pracę z programem wejdź do ustawień File->Preferences i ustaw ścieżki do folderów oraz opcje dotyczące odczytywania plików PDF. Wpisz hasło, które dostałeś od twórcy programu. Wpisz ścieżkę do folderu z plikami PDF do przetworzenia lub wybierz ją z listy za pomocą przycisku w ikonie folderu. Jeśli chcesz aby program przenosił pliki po zmianie ich nazwy do innego folderu zaznacz tą opcję i uzupełnij ścieżkę do folderu do którego program ma przenosić zmienione pliki. W tym trybie program po przetworzeniu plików przeniesie je do ustawionego folderu. Po uzupełnieniu adresu folderu sieciowego FTP oraz danych logowania i włączeniu tej opcji program będzie wysyłał przetworzone pliki na wskazane FTP. Przesłane pliki będą kasowane z folderu z plikami PDF. 4 Łukasz Morawski www.excelsolutions.pl
2.2 Preferencje- ustawienia odczytu pliku PDF Wydobyć fragment tekstu z pliku PDF można na dwa sposoby. 1. Metoda z pozycją bezwzględną. Podajemy numer znaku od którego chcemy zacząć wycinanie tekstu oraz liczbę znaków do wzięcia. Pozycja początkowego znaku tekstu licząc od 1. W poniższym wypadku pierwsza litera "n" będzie na pozycji "1". Liczba znaków do wzięcia z pliku PDF. Do nazwy pliku PDF możemy także dodać własny przedrostek (prefix) i przyrostek (sufix). Podgląd nazwy pliku. Lokalizację ciągu znaków do skopiowania można wskazać zaznaczając tekst na poniższym ekranie podglądu i wciśnięciu przycisku "Pick from selection". Ustawienia w tej zakładce najlepiej zdefiniować z wczytanym przykładowym plikiem PDF za pomocą tej opcji. 5 Łukasz Morawski www.excelsolutions.pl
2. Metoda z pozycja względna. Czasami okazuje się, że szukany przez nas tekst nie znajduje się zawsze w tym samym miejscu. Ulegać może przesunięciu ze względu na poprzedzający go tekst np. adres dostawy, który może w każdym pliku mieć różną długość. Wtedy pozycję interesującego nas ciągu znaków możemy wskazać licząc znaki od znalezionego zdefiniowanego tekstu. W poniższym przykładzie chcemy wziąć 7 znaków po słowie "Praesent". W tym celu szukamy wyrazu "Praesent". Po jego znalezieniu bierzemy ciąg znaków znajdujący się 9 znaków dalej niż 1 znak ciągu znaków "Praesent" i trwający 7 znaków. Zaznaczone zostanie słowo "sodales". Gdy wybierzemy nasz docelowy przykładowy plik PDF możemy mieć podgląd na to, czy określona w polu "from relative position of specified text" zostaje prawidłowo odszukana. Jej znalezienie program oznajmia pokazując zielony znak "ok". Określenie słowa klucza, który pozwoli nam na relatywne wskazanie pozycji tekstu, który chcemy uzyskać. 6 Łukasz Morawski www.excelsolutions.pl
Identyczny rezultat uzyskamy znajdując tekst za szukanym ciągiem znaków np. "velit". Określamy ile znaków wstecz cofamy się do tyłu celem odnalezienia szukanego przez nas ciągu. W tym wypadku cofamy się o 8 znaków od pierwszej litery słowa "velit" i zaznaczamy 7 uzyskując te same słowo co powyżej tj. "sodales". 7 Łukasz Morawski www.excelsolutions.pl
2.3 Preferencje- ustawienia algorytmu sprawdzającego plik PDF W zakładce tej możemy ustawić opcje sprawdzania pliku PDF pod kątem zgodności z ustalonym przez nas wzorcem. Uzupełniając pole "control string" określamy klucz, który musi być odnaleziony w każdym pliku PDF w określonym, zdefiniowanym przez nas miejscu. Miejsce określamy albo bezwzględnie uzupełniając pola "Start position" i "number of char. to cut" lub w zależności od położenia innego ciągu znaków, który określamy w polu "specified text to indicate beginning". Gdy wybierzemy nasz docelowy przykładowy plik PDF możemy mieć podgląd na to, czy określona w polu "from relative position of specified text" zostaje prawidłowo odszukana. Jej znalezienie program oznajmia pokazując zielony znak "ok". Odnalezienie klucza w treści PDF oznajmiane jest również zielonym znakiem "ok". Ustawienia klucza "control string" i ciągu znaków do relatywnego wskazywania miejsca najlepiej wykonywać po wczytaniu docelowego przykładowego pliku "pdf". 8 Łukasz Morawski www.excelsolutions.pl
2.4 Preferencje- ustawienia automatu Program ma zaimplementowany moduł automatyzacji. Po jego skonfigurowaniu program przeszukuje w ramach określonej częstotliwości- interwału folder z plikami PDF oraz przetwarza je według ustawień. Włączenie tej opcji spowoduje załączanie się automatu po każdym uruchomieniu programu. Automat można także włączyć lub wyłączyć ręcznie za pomocą zielonego przycisku na oknie głównym programu. Wybór trybu pracy automatu. Dostępne są dwa tryby pracy: 1. Only rename filesprogram tylko zmienia nazwy plików PDF 2. Rename and sendprogram po zmianie nazwy wysyła pliki na FTP. Kontrolki do ustawiania interwału pracy automatu. Statystyki pracy automatu. Interwał pracy automatu. Dla przykładu po ustawieniu interwału na 5 sekund program co 5 sekund będzie sprawdzał czy są nowe pliki w folderze z PDF a następnie je przetwarzał. 9 Łukasz Morawski www.excelsolutions.pl
WYMAGANIA PROGRAMU: LICENCJA: Microsoft Windows 7/10, 32/64bit Net Framework 4.6.1 https://www.microsoft.com/net/download/dotnet-framework-runtime Połączenie internetowe (w przypadku chęci wysyłania na FTP) Program używa biblioteki itextsharp (https://sourceforge.net/projects/itextsharp/) w wersji 3.0.10.0 na licencji Affero GNU Public License Program udostępniany na licencji Affero GNU Public License 10 Łukasz Morawski www.excelsolutions.pl