Wymagania ogólne
Format pliku:.csv lub .txt
Separator pól: ; (zalecany), może być inny
Separator ciągów znaków: „ (podwójne apostrofy)
Kodowanie znaków: UTF-8
Nazwa pliku
Od wersji 2.0 nazwa pliku nie ma znaczenia, ponieważ wszystkie niezbędne informacje są przekazywane wewnątrz pliku.
Struktura pliku i struktura rekordów
Plik CSV musi mieć następujący format wierszy:
Wiersz 1: Nagłówki kolumn (patrz pole „Nazwa” w tabeli poniżej)
Wiersz 2: Rekord 1
Wiersz 3: Rekord 2
Wiersz 4: …
Poszczególne rekordy danych muszą być oddzielone znakami końca linii.
Pierwszy wiersz zawiera nagłówki kolumn, które są zdefiniowane w kolumnie „Nazwa” w poniższej tabeli.
Wszystkie pola w rekordzie danych muszą być oddzielone skonfigurowanym separatorem (zalecane: średnik).
Jeśli w obrębie pola używany jest zdefiniowany separator, należy dla tego pola użyć „separatora ciągów znaków” (podwójne cudzysłowy).
Kolejność i liczba kolumn jest identyczna dla każdego rekordu danych (tj. jeśli pole nie ma wartości, jest ono przesyłane jako puste).
Narzędzie do synchronizacji
Do przesłania pliku CSV do portalu potrzebne jest narzędzie do synchronizacji. Jest to niewielkie narzędzie, które monitoruje folder. Gdy tylko plik zostanie zapisany, zostanie on zaszyfrowany i przesłany do portalu.
Podczas instalacji narzędzia do synchronizacji na początku procesu zostaniesz poproszony o podanie ServiceUser i ServiceUserPassword. Należy tam wprowadzić dane, które zostały wcześniej wygenerowane w portalu. Ponadto musisz jednorazowo wygenerować token API. Nie trzeba go jednak wprowadzać.
Po zakończeniu instalacji musisz podać w pliku konfiguracyjnym identyfikator Careflex oraz ścieżki do folderów, w których zapisane są pliki CSV.
Instalacja
Plik instalacyjny można pobrać, korzystając z poniższych danych dostępowych. Nie można go otworzyć w przeglądarce, a jedynie za pomocą programu obsługującego protokół SFTP, np. FileZilla lub WinSCP.
Host: data4.n4group.eu
Nazwa użytkownika: u245801-sub16
Hasło: VIo622ebY1vmKU4o
Warto zainstalować to narzędzie na serwerze, np. w strefie DMZ, aby dostęp do niego miała więcej niż jedna osoba. Narzędzie można jednak skonfigurować tak, aby pobierało dane z udostępnionego folderu na dysku sieciowym. W takim przypadku dostęp do niego muszą mieć tylko pracownicy.
W danym momencie może działać tylko jeden plik, czyli albo instalacja produkcyjna, albo wersja stagingowa dla portalu testowego (druga musi być wtedy odinstalowana).
Firewall
W razie potrzeby należy zezwolić w zaporze sieciowej na następujące połączenia:
dla środowiska stagingowego
careflex-staging-xfiles.de-hamburg-4.s3.xws.x-ion.de
staging.unternehmen.careflexchemie.de
port 443
dla środowiska produkcyjnego
careflex-production-xfiles.de-hamburg-4.s3.xws.x-ion.de
unternehmen.careflexchemie.de
port 443
