SFTP – Instrukcje dotyczące pól niestandardowych

SPIS TREŚCI

• SFTP – Instrukcje dotyczące pól niestandardowych
  • Zasady przetwarzania plików z odpowiedziami do pól niestandardowych
  • Format plików i zasady nazewnictwa
  • Częstotliwość i harmonogram przesyłania
  • Format pliku z polami niestandardowymi

W tym temacie znajdziesz wskazówki, które pomogą Ci prawidłowo przesłać pliki, aby uniknąć problemów z ich importem.

Ogólne informacje i zalecenia dotyczące SFTP znajdziesz w sekcji SFTP – Instrukcje konfiguracyjne.

Zasady przetwarzania plików z odpowiedziami do pól niestandardowych

W Spotnana możesz przesyłać zarówno pełne, jak i częściowe zestawy odpowiedzi dla pól niestandardowych. Nazwa pliku określa, którego pola i której listy odpowiedzi dotyczy przesyłany plik. Każde pole niestandardowe i jego odpowiedzi należy przesyłać w osobnym pliku (szczegóły dotyczące nazewnictwa znajdziesz poniżej). Zasady przetwarzania zawartości pliku CSV są następujące:

• Jeśli w kolumnie ACTION dla danego wiersza ustawiono wartość CREATE, opcja odpowiedzi zostanie utworzona na liście odpowiedzi.

• Jeśli w kolumnie ACTION dla danego wiersza ustawiono wartość UPDATE i taka opcja odpowiedzi już istnieje, jej opis zostanie zaktualizowany.

Jeśli w kolumnie ACTION dla danego wiersza ustawiono wartość DELETE , opcja odpowiedzi zostanie usunięta. Jeśli w bazie Spotnana nie znajdzie się pasujący rekord, ten wiersz zostanie pominięty i nie zostaną podjęte żadne działania.

Format plików i zasady nazewnictwa

Nazwa każdego pliku CSV z danymi do pól niestandardowych powinna mieć następujący schemat:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

Gdzie:

• [customFieldID] is a variable that changes for each field. This ID is contained within the file name shown in kroku 2 w oknie Instrukcje importu SFTP które są częścią instrukcji Importu z katalogu SFTP. 

• [optionGroupID] is a variable that changes for each response list. This ID is contained within the file name shown in kroku 2 w oknie Instrukcje importu SFTP które są częścią instrukcji Importu z katalogu SFTP.  

• Gwiazdka * (tzw. wildcard) oznacza dowolne znaki, które możesz dodać do nazwy pliku. 

• Kropka „.” po [optionGroupID] i kropka „.” przed „csv” muszą się znaleźć w nazwie pliku. 

Wielkość liter w nazwie pliku nie ma znaczenia. Zalecamy dodanie daty i godziny do nazwy pliku (ułatwi to późniejsze rozwiązywanie ewentualnych problemów). Przykład:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_<DateTime>.csv

Plik CSV musi mieć również określony format. Nazwy kolumn muszą dokładnie odpowiadać wzorcowi (szczegóły znajdziesz w sekcji Format pól niestandardowych poniżej). 

Częstotliwość i harmonogram przesyłania

Zalecamy, aby plik był przesyłany codziennie aby mieć pewność, że Spotnana zostanie poinformowana o wszystkich nowych, zaktualizowanych lub usuniętych odpowiedziach (jeśli często wprowadzasz zmiany w polach niestandardowych, codzienne aktualizacje będą najlepszym rozwiązaniem). Jeśli będziesz postępować zgodnie z tą praktyką: 

• nowe odpowiedzi będą natychmiast dostępne dla podróżnych podczas rezerwacji. 

• wycofane odpowiedzi zostaną usunięte z listy wyboru i nie będą już dostępne dla podróżnych. 

Wycofane odpowiedzi nadal będą widoczne w raportach.

Format pliku z polami niestandardowymi

Poniższe informacje pomogą Ci upewnić się, że dane w przesyłanym pliku są poprawnie przygotowane i sformatowane.