Centrum wsparcia Workiva

Szablon Load Data to Wdata przenosi dane do tabeli Wdata poprzez zastąpienie istniejącego zestawu danych lub dodanie nowego. Ten szablon jest najczęściej używany jako część istniejącego łańcucha, ale można go dodać do dowolnego przepływu pracy, który wymaga przesłania zestawu danych do tabeli.

Wymagania

• Docelowa tabela Wdata musi zostać utworzona przed wykonaniem tego łańcucha.
• Ten szablon składa się z trzech łańcuchów. Każdy łańcuch musi być oddzielnie opublikowany w Twojej przestrzeni roboczej.
• Nazwa pliku musi zawierać rozszerzenie .csv lub .tsv. Na przykład: "File_Name_Example.csv".
• Maksymalny zalecany rozmiar pliku dla zestawu danych wynosi 300 MB. Dowiedz się więcej o zalecanych rozmiarach plików.

Znajdź szablon

Szablon Load Data to WData znajduje się w sekcji Workiva Chains na ekranie Templates.

Oto jak ją znaleźć:

1. W narzędziu Chain Builder przejdź do zakładki Templates dynamic_feed .
2. Wybierz Workiva Chains z menu u góry.
3. Wyszukaj Load Data to Wdata | Primary Chain w prawym górnym rogu i otwórz szablon.

4. Po zlokalizowaniu szablonu kliknij New Chain, aby wdrożyć go w swoim obszarze roboczym. 

   Uwaga: Po skonfigurowaniu każdy łańcuch w tym szablonie musi zostać opublikowany w obszarze roboczym.

Skonfiguruj szablon

Szablon ten składa się z trzech łańcuchów: łańcucha głównego, łańcucha zastępowania zbioru danych i łańcucha dodawania nowego zbioru danych. Gdy łańcuch główny zostanie wdrożony w Twojej przestrzeni roboczej, dwa łańcuchy podrzędne (Add/Replace) zostaną automatycznie wdrożone wraz z nim.

Przyjrzyj się bliżej każdemu z łańcuchów:

• Primary Chain: Ten łańcuch określa, czy w twojej tabeli istnieje zbiór danych o takiej samej nazwie jak zbiór danych ładowany przez łańcuch. Jeśli dopasowany zestaw danych zostanie znaleziony, łańcuch przechwytuje informacje o dopasowanym zestawie danych i - w oparciu o dane wejściowe "Load Method" skonfigurowane dla łańcucha nadrzędnego - przekierowuje te dane do jednego z dwóch łańcuchów podrzędnych.

• Łańcuch Replace Dataset: Ten łańcuch usuwa dopasowany zestaw danych z twojej tabeli i zastępuje go nowym. Jeśli podczas wykonywania wystąpi błąd i wybrana zostanie opcja wycofania, łańcuch automatycznie usunie nowy zestaw danych i powróci do zestawu danych, który miał zostać zastąpiony.  

• Dodaj nowy łańcuch zbioru danych: Ten łańcuch tworzy nowy zestaw danych i importuje go do twojej tabeli. Nowy zestaw danych musi mieć unikalną nazwę pliku, która nie jest obecnie używana przez żaden inny zestaw danych w tabeli.

Podczas dodawania tego zestawu łańcuchów do istniejącego łańcucha, dane wejściowe runtime dla Primary Chain muszą być skonfigurowane w węźle "Run Chain". Łańcuchy podrzędne nie wymagają żadnych zmian ani konfiguracji.  

Twoje ustawienia powinny wyglądać mniej więcej tak:

Zmienne

Wejścia w czasie wykonywania

Rozwiązywanie problemów

Aby wyświetlić historię pracy łańcucha, w tym błędy:

1. Przejdź do zakładki Monitor w narzędziu Chain Builder.
   

2. Najedź kursorem na znak zapytania, aby wyświetlić status łańcucha.
   
   

Jeśli łańcuch wyzwolił błąd lub nie udało się zaktualizować poprawnych danych, wykonaj następujące kontrole:

• Sprawdź, czy wszystkie trzy łańcuchy zostały opublikowane w Twojej przestrzeni roboczej. Każdy łańcuch musi zostać opublikowany osobno.
• Upewnij się, że zestaw danych używa obsługiwanego separatora, a nazwa pliku zawiera rozszerzenie .csv lub .tsv ("File_Name_Example.csv").
• Podczas korzystania z metody ładowania Replace Dataset sprawdź, czy nazwa pliku jest zgodna z nazwą istniejącego pliku w tabeli Wdata. Jeśli nie pasuje, łańcuch po prostu doda nowy plik do twojej tabeli bez zastępowania starego.
• I odwrotnie, podczas korzystania z metody ładowania Add New Dataset sprawdź, czy nazwa pliku nie jest używana nigdzie indziej w tabeli Wdata. Łańcuch nie powiedzie się, jeśli zostanie użyta nakładająca się nazwa pliku.
• Upewnij się, że grant OAuth2 powiązany z połączeniem Workiva ma odpowiedni dostęp.
• Podczas wprowadzania identyfikatora tabeli upewnij się, że wprowadzono cały identyfikator i nie ma żadnych spacji początkowych ani końcowych.
• Sprawdź zmienne znacznika czasu uruchomienia. Nie powinny być one używane w nazwach plików, ponieważ tworzy to unikalną nazwę pliku dla każdego zbioru danych - co oznacza, że łańcuch nie będzie w stanie zidentyfikować żadnych dopasowanych zbiorów danych w twojej tabeli.

Mapowania kolumn i inne modyfikacje łańcucha

Jeśli napotkasz problemy z nagłówkami kolumn podczas importowania danych, możesz użyć data prep lub innych poleceń. 

Opcjonalnie: Oznaczanie importowanych zestawów danych

Tagowanie jest obsługiwane podczas importowania zestawów danych, ale zalecamy wdrożenie dodatkowego zestawu łańcuchów z szablonu przed wprowadzeniem jakichkolwiek zmian w oryginale. Raz zmodyfikowany łańcuch będzie prawdopodobnie trudny do ponownego wykorzystania w innych tabelach, chyba że zestawy danych w tych tabelach wykorzystują te same znaczniki.  

Aby dodać tag do łańcucha:

1. Dodaj następujące dane wejściowe środowiska uruchomieniowego do każdego z trzech łańcuchów wdrożonych z tego szablonu:
   • Tag-Key (pole tekstowe)
   • Tag-Value (pole tekstowe)
     
2. Edytuj stronę Primary Chain, aby przekazać dane wejściowe do każdego zdarzenia "Run Chain":
3. Zarówno na stronie Replace Dataset Chain, jak i na stronie Add New Dataset Chain, edytuj węzeł polecenia "Import New Dataset", aby zaakceptować dane wejściowe runtime tagów.

Po zakończeniu importowane zestawy danych zostaną oznaczone podanym kluczem tagu i wartością tagu.

Dodatkowe zasoby

• Złącze Workiva
• Złącze narzędzi plików
• Złącze JSON
• Łącznik transformacji tabelarycznej
• Uruchom łańcuch wewnątrz innego łańcucha ("Run Chain events")
• Dotacje OAuth2
• Funkcja Wdata i ograniczenia API