Import danych z pliku CSV lub XLSX do Positive User jest zazwyczaj szybki i prosty, ale błędy w strukturze pliku, formatowaniu lub wartościach atrybutów mogą wpłynąć na wynik importu. Jeśli Twój plik został odrzucony, import się nie rozpoczyna lub zaimportowano tylko część rekordów, ten artykuł pomoże Ci zidentyfikować przyczynę i naprawić najczęstsze problemy.
Zanim zaczniesz rozwiązywać problem z importem, upewnij się, że:
Twój plik został zapisany w prawidłowym formacie (.csv lub .xlsx).
Wybrane kodowanie odpowiada rzeczywistemu kodowaniu pliku.
Wszystkie wartości w pliku są oddzielone tym samym separatorem (np. przecinkiem, średnikiem, tabulatorem).
Nagłówki kolumn są na miejscu i poprawnie nazwane.
Typy wartości w pliku odpowiadają typom atrybutów w Twoim workspace Positive User.
Więcej szczegółów znajdziesz w artykule „Zasady formatowania importu CSV/XLSX".
Pamiętaj, że jeśli jeden atrybut w wierszu zawiera nieprawidłową wartość, cały wiersz może zostać pominięty podczas importu.
Jeśli wgrywasz plik, a import się nie rozpoczyna, problem zwykle dotyczy formatu pliku lub ustawień importu.
Sprawdź następujące aspekty:
Upewnij się, że wgrywasz prawidłowy plik .csv lub .xlsx.
Sprawdź, czy wybrane kodowanie odpowiada kodowaniu pliku. W większości przypadków prawidłowym wyborem jest UTF-8.
Otwórz plik i zweryfikuj, czy wszystkie wartości są oddzielone konsekwentnie tym samym separatorem, np. przecinkiem, średnikiem lub tabulatorem.
Sprawdź kolumnę „Completed at" w widoku „Import Results". Jeśli nie ma jeszcze daty „Completed at", import jest nadal w trakcie realizacji.
Jeśli plik używa niespójnych separatorów lub wybrano nieprawidłowe kodowanie, proces importu zostanie przerwany.
Jeśli system odrzuca Twój plik CSV, najprawdopodobniej struktura pliku jest nieprawidłowa.
Upewnij się, że:
Nie ma podwójnych przecinków ani separatorów w niewłaściwych miejscach.
Plik nie używa nietypowych znaków jako separatorów.
Wszystkie wartości są oddzielone obsługiwanym separatorem, takim jak przecinek, średnik lub tabulator.
Plik CSV wyeksportowany z arkusza kalkulacyjnego lub bazy danych powinien zawsze mieć spójną strukturę. W razie potrzeby otwórz plik w edytorze tekstu, aby zweryfikować, jak dane są oddzielone. Takie aplikacje jak Excel czy Arkusze Google mogą nie pokazywać ukrytych znaków.
Sprawdź separatory w prostych edytorach tekstu lub aplikacjach notatnikowych.
Jeśli zaimportowano tylko część pliku, niektóre wiersze najprawdopodobniej zawierały nieprawidłowe lub niekompletne dane.
Co zrobić:
Przejdź do „Data" → „Importers" → „Import Results" i kliknij nazwę zaimportowanego pliku. Znajdziesz tam szczegółowe informacje o imporcie oraz powody, dla których niektóre wiersze się nie powiodły.
Sprawdź również, czy import ma datę „Completed at":
jeśli data jest widoczna, import został zakończony,
jeśli nie ma jeszcze daty „Completed at", import jest nadal w trakcie realizacji.
Jeśli zaimportowano tylko niektóre wiersze, szczegóły widoczne w „Import Results" pomogą Ci zidentyfikować, które rekordy zostały odrzucone i dlaczego.
Jeśli po przeczytaniu tego artykułu i sprawdzeniu widoku „Import Results" problem nadal jest niejasny – skontaktuj się z zespołem wsparcia.
Ten błąd pojawia się, gdy wartość atrybutu typu boolean jest nieprawidłowa lub pozostawiona pusta.
Atrybuty typu boolean (zarówno standardowe, jak i niestandardowe) przyjmują tylko dwie wartości:
TRUE
FALSE
Rozwiązanie:
Zamień wartości w pliku importu na odpowiadające im wartości „TRUE" i „FALSE" .
Jeśli pole jest puste lub zawiera jakąkolwiek inną wartość, wiersz nie powiedzie się podczas importu.
Oznacza to, że wartość podana dla wymienionego atrybutu jest brakująca lub nierozpoznana.
Rozwiązanie:
Sprawdź typ atrybutu wymienionego w błędzie. Jeśli atrybut jest atrybutem o ustalonym wyborze, przyjmuje tylko predefiniowane wartości dostępne w Twoim workspace, takie jak nazwy członków zespołu, nazwy grup itp.
Jeśli pojawi się ten błąd, upewnij się, że wartość w Twoim pliku odpowiada istniejącej wartości w workspace Positive User.
Jeśli podczas importu nie możesz znaleźć pasującego atrybutu, zwykle oznacza to, że atrybut nie został wcześniej utworzony.
Rozwiązanie:
Najpierw utwórz brakujący atrybut niestandardowy, a następnie ponownie wgraj plik.
Instrukcję krok po kroku znajdziesz tutaj.
Tylko istniejące atrybuty mogą być dopasowane podczas importu. Jeśli kolumna w Twoim pliku nie odpowiada standardowemu atrybutowi i nie utworzono dla niej atrybutu niestandardowego, nie pojawi się ona na liście mapowania.
Niektórych atrybutów nie można aktualizować przez import. System pobiera dla nich wartości z przeglądarki lub innego źródła.
Rozwiązanie:
Sprawdź, czy atrybut, który chcesz zaktualizować wartością, znajduje się na liście atrybutów modyfikowalnych.
Jeśli musisz zaimportować podobną wartość, utwórz osobny atrybut niestandardowy o odpowiednim typie i użyj go zamiast tego.
W tym przypadku są dwie możliwe opcje:
Wartość atrybutu typu string jest dłuższa niż 255 znaków. (W przypadku atrybutu „Last name" limit wynosi 32 znaki).
Występuje problem z separatorem w pliku.
Rozwiązanie:
Skróć wartości, które przekraczają limit, lub zapisz je jako atrybuty JSON.
Czasami wiersz zawiera dodatkowe wartości, które nie odpowiadają żadnemu atrybutowi. Gdy tak się dzieje, importer może błędnie połączyć sąsiednie wartości w jedno pole, przez co wartość wydaje się dłuższa niż jest w rzeczywistości. Sprawdź plik i usuń dodatkowe wartości.
Może się to zdarzyć, gdy w wartości użyto przecinków. Na przykład informacje o adresie pocztowym.
Jeśli Twój plik używa przecinków jako separatorów, przecinki wewnątrz adresu mogą złamać strukturę pliku i spowodować niepowodzenie importu lub rozłożenie wartości na kilka pól.
Rozwiązanie:
Aby to naprawić, sprawdź, czy wartość w pliku importu zawiera przecinki, i upewnij się, że nie kolidują one z separatorem używanym w pliku. Możesz albo usunąć przecinki z pliku, albo użyć innego separatora podczas importu.
Podczas rozwiązywania problemów z importem CSV/XLSX pamiętaj, że:
jedna nieprawidłowa wartość może spowodować odrzucenie całego wiersza,
atrybuty niestandardowe muszą zostać utworzone przed importem,
atrybuty o ustalonym wyborze muszą zawierać tylko akceptowane wartości,
pola typu boolean muszą zawierać tylko „TRUE" lub „FALSE",
struktura pliku, separator i kodowanie muszą być spójne w całym pliku.
