Integracja z usługami konwersji online

Integracja z usługami konwersji online umożliwia zamianę formatu dokumentu bez instalowania dodatkowego oprogramowania.

Na czym polega konwersja dokumentu w usłudze online

Integracja z usługą konwersji online oznacza połączenie programu, aplikacji internetowej albo systemu obiegu dokumentów z zewnętrznym serwisem, który przyjmuje plik w jednym formacie i zwraca jego przetworzoną wersję w innym. Przykładowo dokument tekstowy może zostać przekazany do konwersji na PDF, a plik PDF może zostać poddany rozpoznawaniu tekstu i zwrócony jako dokument z warstwą tekstową. Operacja odbywa się po stronie usługi zdalnej, dlatego komputer użytkownika nie musi mieć zainstalowanego lokalnego programu obsługującego dany format wyjściowy.

Najczęściej plik jest wysyłany przez formularz internetowy albo żądanie API. Po stronie klienta może być używany protokół HTTPS, który szyfruje połączenie między przeglądarką lub aplikacją a serwerem usługi. Serwis może przyjąć plik jako przesyłany formularzem multipart/form-data, jako dane binarne albo jako adres URL wskazujący plik dostępny dla serwera. Po zakończeniu zadania aplikacja otrzymuje plik wynikowy, adres pobrania lub informację o statusie przetwarzania.

Przepływ pliku między aplikacją a konwerterem

Typowy przebieg integracji składa się z kilku etapów: wyboru pliku, sprawdzenia jego rozszerzenia i typu MIME, wysłania danych, oczekiwania na zakończenie zadania oraz pobrania wyniku. Usługa może działać synchronicznie, gdy odpowiedź z przekonwertowanym plikiem jest zwracana w ramach tego samego żądania, albo asynchronicznie. W drugim wariancie pierwsze żądanie tworzy zadanie i zwraca jego identyfikator, a aplikacja później sprawdza status przez kolejne zapytania lub odbiera powiadomienie webhook.

Istotne jest rozróżnienie między poprawnym przesłaniem pliku a poprawną konwersją. Kod odpowiedzi HTTP informuje przede wszystkim o wyniku komunikacji, natomiast nie zawsze potwierdza, że dokument został przetworzony zgodnie z oczekiwaniem. Aplikacja powinna sprawdzić również typ i rozmiar odebranych danych, nazwę pliku wynikowego oraz ewentualny komunikat błędu zwrócony przez usługę. Przy zadaniach asynchronicznych należy obsłużyć stany takie jak oczekiwanie, przetwarzanie, zakończenie i błąd, a także sytuację, w której adres pobrania wygasa.

Format wyjściowy, układ i ograniczenia konwersji

Konwersja formatu nie zawsze oznacza zachowanie pełnej postaci dokumentu. Dokumenty mogą zawierać czcionki, style akapitów, tabele, obrazy, przypisy, hiperłącza, formularze, komentarze lub elementy osadzone. Jeżeli format źródłowy i docelowy mają różne możliwości, część informacji może zostać spłaszczona, pominięta albo zmieniona. Szczególnie widoczne bywa to przy tabelach o złożonym układzie, dokumentach zawierających nietypowe czcionki oraz plikach, w których rozmieszczenie treści zależy od parametrów strony.

Przed użyciem pliku wynikowego warto otworzyć go w programie przeznaczonym do danego formatu i porównać z oryginałem. Należy sprawdzić kolejność stron, polskie znaki, podział wierszy, położenie grafik, działanie odnośników oraz możliwość zaznaczania i wyszukiwania tekstu. W przypadku skanów sama zmiana kontenera pliku nie tworzy tekstu możliwego do edycji. Potrzebny jest proces OCR, czyli optyczne rozpoznawanie znaków, którego skuteczność zależy między innymi od jakości obrazu, kontrastu i kroju pisma.

Konfiguracja integracji i diagnostyka problemów

Problemy z konwersją mogą wynikać z uszkodzonego pliku źródłowego, nieobsługiwanego formatu, przekroczenia limitu rozmiaru, błędnego parametru żądania albo chwilowej niedostępności usługi. Przy diagnozowaniu należy ustalić, czy błąd pojawia się podczas wyboru pliku, wysyłania danych, oczekiwania na zadanie, pobierania wyniku czy otwierania gotowego dokumentu. Pomocne są informacje z dziennika aplikacji: czas operacji, identyfikator zadania, kod HTTP, typ pliku i komunikat zwrócony przez usługę. Nie należy zapisywać w logach pełnej treści dokumentów ani danych dostępowych do API.

Na komputerze użytkownika warto sprawdzić działanie przeglądarki, połączenie internetowe, rozszerzenia blokujące żądania, miejsce na dysku oraz program skojarzony z formatem wynikowym. Jeżeli konwersja działa w jednej przeglądarce, a nie działa w innej, przyczyną może być blokada skryptu, ciasteczek lub pobierania plików. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, dlatego w przypadku problemów z komputerem uniemożliwiających korzystanie z takich narzędzi można zlecić diagnostykę urządzenia.