Akcja odczytu kodów QR/BC z plików
Podsumowanie:Akcja obsługuje załączniki w formatach .png, .jpeg, .jpg, .pdf i jest licencjonowana osobno (klucz licencji QR_BC).
☛ AdminSPA >
NARZĘDZIA>Akcje>Odczyt kodów QR/BC z plików
Oprócz właściwości wspólnych dla wszystkich akcji, w akcji odczytu kodów QR/BC należy określić:
-
Rodzaj kodów...: formaty kodów używane w przetwarzanych dokumentach, zarówno BC, jak i QR. -
Zapytanie SQL do wyboru plików: zapytanie, który zwróci identyfikatory plików załączników do przetworzenia, na przykład:SELECT [Id] FROM core.Attachments WHERE [RecordId] = {@_Id} AND [BusinessDocumentId] = {@BusinessDocId} -
Procedura odpowiedzi wyników skanowania: zapytanie które przetworzy wyniki zwracane przez akcję w postaci dwóch zmiennych JSON:-
@_ReadCodes: tablica odczytanych wartości kodów QR/BC z poszczególnych plików:
[ { "attachmentFileName": "some_attachment.pdf", "attachmentId": 123, "attachmentVersion": 1, "code": "Some code value", "type":"QR", "typeDetails": "QR_CODE", "pageNumber": 1 }, ]Gdzie code to odczytana wartość kodu, type to typ kodu (QR lub BC), typeDetails to format kodu, a pageNumber określa numer strony tylko dla plików PDF.
-
@_ProcessingResult: zawiera informacje o statusie przetwarzania poszczególnych załączników przeznaczone do własnej obsługi błędów:
[ { "attachmentFileName": "Nowy Dokument tekstowy.txt", "attachmentId": 1205, "attachmentVersion": 1, "errorMessage": "Nieobsługiwany format pliku '.txt'. System obsługuje następujące formaty..." } ]Zwrócone zmienne można na przykład zapisać w tabeli pomocniczej:
INSERT INTO [dbo].[QrBcProcessingResults]([ProcessingResult], [ReadCodes]) VALUES({@_ProcessingResult}, {@_ReadCodes})Można także je przetworzyć przy użyciu funkcji SQL OPENJSON().
-
Na skuteczność działania akcji duży wpływ ma jakość źródłowych obrazów. Minimalna rozdzielczość nie może być mniejsza nić 200 DPI, obraz powinien być ostry, kontrastowy równomiernie oświetlony. Minimalna gęstość pikseli na moduł (np. pasek lub odstęp w kodzie BC) powinna wynosić 3 piksele dla kodów 1D (BC) i 5 pikseli dla kodów 2D (QR i podobne).
Dodatkowo na wyniki wpływa wybór obsługiwanych formatów — zaleca się ograniczenie liczby formatów do używanych najczęściej w przetwarzanych dokumentach.
Powiązane tematy: