Ten przewodnik opisuje zasady formatowania importu CSV/XLSX, których musisz przestrzegać przed wgraniem plików do systemu. Dowiesz się, jaką strukturę powinny mieć Twoje dane, które pola są wymagane oraz jak należy formatować wartości, aby zostały poprawnie rozpoznane podczas importu. Stosowanie się do tych zasad pozwala zapobiec typowym problemom, takim jak brakujące kolumny, nieprawidłowe typy danych czy nieoczekiwane błędy mapowania. Używaj tego artykułu jako listy kontrolnej, aby zweryfikować plik i zapewnić sobie szybki oraz niezawodny import za każdym razem.
Obecnie aplikacja umożliwia wgranie danych z dwóch typów plików:
CSV
XLSX
Twój plik musi używać jednego ze standardowych separatorów. W przeciwnym razie plik może zostać odrzucony.
Dozwolone opcje:
przecinek (,)
średnik (;)
tabulator
Unikaj:
Podwójnych przecinków (,,)
Przecinków w nieregularnych miejscach
Nietypowych znaków separatora
Jeśli używasz przecinka jako separatora, nie możesz używać go w wartościach. Na przykład „Baker street, 20" nie jest dozwolone w atrybucie „Address".
Kodowanie to metoda używana do reprezentowania tekstu jako danych cyfrowych. Określa, w jaki sposób litery, cyfry, symbole i znaki specjalne są przechowywane i wyświetlane przez system. Wybór prawidłowego kodowania jest kluczowy dla zachowania poprawności tekstu, zwłaszcza podczas pracy z treściami wielojęzycznymi. Jeśli zostanie wybrane nieprawidłowe kodowanie, znaki mogą wyglądać na uszkodzone lub nieczytelne – ten problem często określa się jako mojibake.
Wśród najczęściej używanych opcji UTF-8 jest nowoczesnym standardem. Obsługuje szeroki zakres znaków z różnych systemów pisma i jest powszechnie rekomendowany dla treści międzynarodowych ze względu na swoją kompatybilność i elastyczność.
Cyrillic (Windows-1251) to starsze kodowanie powszechnie używane dla tekstów pisanych w językach opartych na cyrylicy, zwłaszcza w starszych środowiskach Windows. Cyrillic (ISO-8859-5) to kolejny starszy standard dla tekstu w cyrylicy, choć jest obecnie mniej popularny niż Windows-1251 czy kodowania oparte na Unicode.
Dla języków Europy Środkowej i Wschodniej często stosowane jest Eastern Europe (Windows-1250) w starszych aplikacjach Windows. Obsługuje języki używające alfabetu łacińskiego z dodatkowymi znakami diakrytycznymi, takie jak polski, czeski i węgierski. Podobnie Eastern Europe (ISO-8859-2) to starszy standard międzynarodowy zaprojektowany dla tej samej grupy języków, choć w nowoczesnych systemach został w dużej mierze zastąpiony przez Unicode.
Na koniec US ASCII jest jednym z najstarszych i najbardziej ograniczonych kodowań. Zawiera tylko podstawowe litery angielskie, cyfry i znaki interpunkcyjne, co czyni go odpowiednim jedynie dla prostych treści tekstowych bez znaków akcentowanych lub niełacińskich.
W większości nowoczesnych zastosowań UTF-8 jest najbezpieczniejszym i najbardziej uniwersalnym wyborem, podczas gdy starsze kodowania pozostają przydatne głównie dla zachowania kompatybilności ze starszymi plikami i systemami.
Każdy nagłówek kolumny powinien reprezentować jeden atrybut, a każda komórka powinna zawierać wyłącznie wartość dla tego atrybutu.
Jeśli pozostawisz w wierszu dodatkowe wartości, które nie pasują do żadnego atrybutu, importer może próbować scalić wartości i potraktować je jako pojedyncze pole. Może to prowadzić do mylących błędów walidacji (np. komunikat „last_name zbyt długie", nawet gdy nazwisko wygląda poprawnie).
Lista kontrolna
Każda kolumna ma jasny nagłówek (nazwę atrybutu).
Każda wartość należy do istniejącego atrybutu (lub takiego, który planujesz utworzyć).
Brak „dodatkowych" wartości umieszczonych po ostatniej oczekiwanej kolumnie.
Poprawne formatowanie jest ważne, ponieważ silnik importu waliduje typy wartości.
Zanim utworzysz nowe atrybuty, sprawdź, jakie typy atrybutów są dostępne do użycia:
Typ | Opis | Przykład |
Boolean | Reprezentuje opcje binarne: true / false. | Atrybut „Zgoda marketingowa", wartość „True" |
Data | Pole do przechowywania informacji o konkretnej dacie. Format: ISO 8601. | Atrybut „Data urodzenia", wartość „1996-01-20" |
Datetime | Pole do przechowywania szczegółów dotyczących czasu, takich jak rejestracja czy ostatnia aktywność. Wymaga formatu ISO 8601. | Atrybut „Ostatnio widziany", wartość „2016-08-03 12:00:00+00:00" |
Fixed choice | Zestaw możliwych opcji ograniczających wartości dla konkretnego pola. Takie atrybuty mogą także zawierać wariant „Allow multiple choices". Jeśli ta opcja jest WŁĄCZONA, możesz umieścić w komórce więcej niż 1 wartość, oddzielając je symbolem „|". | Atrybut „Preferowany język", wartości „English", „Polish", „Spanish" |
Liczba zmiennoprzecinkowa | Dane liczbowe obejmujące wartości dziesiętne, odpowiednie do reprezentowania cen lub miar statystycznych. | Atrybut „Lifetime value", wartość „1000.59" |
Liczba całkowita | Dane liczbowe, obejmuje wyłącznie liczby całkowite. | Atrybut „Łączna liczba zamówień", wartość „9" |
Format pliku JSON | Działa dla dłuższych wartości, których nie można umieścić w innych formatach danych. Niedostępne dla zdarzeń produktowych. | Atrybut „Dodatkowe informacje o zamówieniu", wartość (poprawny obiekt JSON): „key": „value" |
Number | Tylko dla zdarzeń (!). To pole jest używane specjalnie dla atrybutów zdarzeń. Obejmuje zarówno liczby całkowite, jak i zmiennoprzecinkowe. | Atrybut „Zebrane punkty", wartość „15" |
String | Dowolny ciąg znaków ograniczony do 255 elementów. Idealny dla informacji tekstowych, w tym imion, adresów e-mail lub innych danych tekstowych. | Atrybut „Plan subskrypcji", wartość „Standard" |
Pola Boolean muszą zawierać prawidłowe wartości logiczne:
- Użyj TRUE lub FALSE
- Nie pozostawiaj pól Boolean pustych (puste wartości mogą wywołać błędy walidacji)
Więcej o atrybutach możesz przeczytać tutaj.
Niektóre pola wymagają konkretnych, predefiniowanych wartości. Upewnij się, że używasz prawidłowego formatu.
Atrybut | Opis | Wymagane wartości |
Płeć (atrybut kontaktu) | Standardowy atrybut, który możesz aktualizować własnymi wartościami. Domyślnie pusty. |
|
Numer telefonu (atrybut kontaktu) | Standardowy atrybut, który możesz aktualizować własnymi wartościami. Domyślnie pusty. Rekomendowany format odpowiedni dla wszystkich dostawców: E.164 | Format E.164. Przykład: +44754123434 |
Status (atrybut szansy sprzedaży) | To pole definiuje status Twojej szansy sprzedaży. |
|
Status zadania (atrybut szansy sprzedaży) | Definiują status Twojego zadania. |
|
Przypisany do (atrybut kontaktu) | Określa, do którego członka zespołu jest przypisany kontakt | Musi pasować do istniejącego ID członka zespołu lub nazwy członka zespołu/grupy (w zależności od konfiguracji Twojego systemu). |
Status (atrybut zgłoszenia) | To pole definiuje status zgłoszenia. |
|
Aby dowiedzieć się więcej o importowaniu konkretnych obiektów do aplikacji, zajrzyj do dedykowanej sekcji w naszej bazie wiedzy: Import i eksport danych
