For the complete documentation index, see llms.txt. This page is also available as Markdown.

Przetwarzanie plików arkuszy (XLSX)

Platforma Eximee umożliwia odczytywanie i przetwarzanie danych bezpośrednio z plików arkuszy kalkulacyjnych (XLSX) załączanych przez użytkownika do wniosku (np. za pomocą komponentu Załączniki (UploadFile)). Funkcjonalność ta jest bardzo przydatna podczas masowego importu danych, takich jak listy pracowników, zestawienia finansowe czy tabele inwentaryzacyjne.

Mechanizm działania

Przetwarzanie pliku opiera się na integracji za pośrednictwem wbudowanego klienta api.rest.v1. Plik przesyłany jest do modułu przetwarzającego w formie zakodowanego ciągu znaków (Base64), a w odpowiedzi zwracana jest ustrukturyzowana mapa danych.

Żądanie (Request)

Do modułu należy przesłać obiekt zawierający właściwość content. Wartością tej właściwości musi być plik w formacie Base64. W takiej właśnie formie pliki przechowywane są w pamięci, gdy pobieramy je z komponentu przesyłania plików (UploadFile). W przypadku dodania wielu plików, komponent ten przechowuje je jako listę ciągów Base64.

{
    "content": "UEsDBBQAAAAIA..." 
}

Odpowiedź (Response)

W odpowiedzi moduł zwraca zagnieżdżoną strukturę (mapę) w formacie JSON, która odzwierciedla fizyczny układ arkusza kalkulacyjnego z podziałem na: Nazwa arkusza ➔ Numer wiersza ➔ Litera kolumny.

{
    "arkusz1": {
        "1": {
            "A": "Wartość z komórki A1",
            "B": "Wartość z komórki B1"
        },
        "2": {
            "A": "Wartość z komórki A2"
        }
    }
}

Przykład użycia w skrypcie

Poniższy skrypt pokazuje, jak pobrać plik z komponentu, wysłać go do modułu przetwarzającego XLSX i zwrócić zdekodowaną strukturę danych na wyjście skryptu, dbając jednocześnie o bezpieczną obsługę błędów integracji.

Ostatnia aktualizacja

Czy to było pomocne?