Wprowadzenie
Szablon Data Dictionary Chain umożliwia użytkownikom przechwytywanie i eksportowanie do arkusza kalkulacyjnego szczegółowych informacji na temat określonych tabel w ich obszarze roboczym. Użytkownicy mogą określić słowo kluczowe, aby zlokalizować tabele, zdefiniować nazwę eksportowanego arkusza kalkulacyjnego i utworzyć tabelę w obszarze roboczym do przechowywania schematu każdej tabeli.
Aby uzyskać więcej informacji, zapoznaj się z dokumentacją procesu Load Data to Wdata Process, aby uzyskać kompleksowy przegląd. Zapoznanie się z tą dokumentacją przed użyciem szablonu słownika danych jest zalecane.
Wymagania wstępne
Ten szablon zakłada, że następujące obiekty są już skonfigurowane w Twojej aplikacji Workiva:
- Uprawnienie API
- Aby korzystać z interfejsu API Workiva, użytkownik musi ustanowić grant API OAuth w swoim obszarze roboczym. Zapoznaj się z tym artykułem, aby zapoznać się z wiodącymi praktykami dotyczącymi zarządzania OAuth Grant.
- Następujące Connectors muszą być włączone i skonfigurowane w Twojej przestrzeni roboczej:
Uwaga: Niektóre wartości zmiennych mogą zawierać poufne informacje, takie jak nazwy użytkowników i hasła. Zalecamy użycie opcji "Szyfruj" dla zmiennych wrażliwych na informacje i ustawienie odpowiednich uprawnień dla twojego arkusza kalkulacyjnego.
- Skonfiguruj zmienne
- Aby podłańcuch Load Data to Wdata w szablonie działał zgodnie z oczekiwaniami, należy utworzyć zmienną obszaru roboczego o nazwie wsv-WdataLoadWarningThreshold.
Uwaga: Najlepszą praktyką jest ustawienie domyślnej wartości tej zmiennej na 50 (reprezentującej 50 MB), choć w razie potrzeby można ją dostosować.
-
- Dodatkowo, cztery inne zmienne obszaru roboczego muszą zostać utworzone przed użyciem łańcucha Data Dictionary.
Poniżej znajduje się zestawienie każdej zmiennej, którą należy skonfigurować i wypełnić:
Zbuduj swój łańcuch
Szablon Data Dictionary | ALL | Primary Chain znajduje się w sekcji Workiva Chains na ekranie Templates.
Oto jak ją znaleźć:
- W programie Chain Builder przejdź do zakładki Templates .
- Wybierz Workiva Chains z menu u góry
- Wyszukaj Data Dictionary | ALL | Primary Chain Template w prawym górnym rogu i otwórz szablon
Gdy słownik danych | ALL | Primary chain zostanie wdrożony w obszarze roboczym, automatycznie wdroży sześć dodatkowych podłańcuchów.
Użytkownicy muszą upewnić się, że wszystkie siedem łańcuchów zostało wdrożonych i opublikowanych w tym samym obszarze roboczym:
- Słownik danych | ALL | Primary
- Słownik danych | Tworzenie dokumentu i podsekcji | Tworzenie arkusza kalkulacyjnego
- Słownik danych | Tworzenie dokumentu i podsekcji | Tworzenie arkusza
- Słownik danych | Utwórz tabelę
- Załaduj dane do Wdata | Łańcuch główny
- Załaduj dane do Wdata | Zamień zestaw danych
- Załaduj dane do Wdata | Dodaj nowy zestaw danych
Po zlokalizowaniu szablonu, skonfiguruj go dla swojego obszaru roboczego przy użyciu zmiennych utworzonych w powyższej sekcji .
Uwaga: Aby uzyskać szczegółowe instrukcje dotyczące tworzenia łańcucha z szablonu, zapoznaj się z artykułem Tworzenie łańcuchów i zarządzanie nimi.
Dane wejściowe w czasie wykonywania
Po uruchomieniu tego łańcucha głównego (Data Dictionary | ALL | Primary), następujące dane wejściowe czasu pracy będą musiały zostać wypełnione lub przekazane przez łańcuch wywołujący:
| Dane wejściowe w czasie wykonywania | Opis | Typ pola | Wymagane? |
|---|---|---|---|
| SpreadsheetName | Określa nazwę arkusza kalkulacyjnego, w którym zostanie zapisany schemat tabeli. | Tekst | Tak |
| Wartość wyszukiwania | To wejście jest używane do lokalizowania tabel zawierających określone słowo kluczowe. | Tekst | Tak |
| Nazwa tabeli Wdata | Określa nazwę tabeli słownika danych utworzonej podczas początkowego wykonania szablonu. | Tekst | Tak |
Tabela Wdata
Aby skorzystać z tego łańcucha, w obszarze roboczym musi istnieć tabela Data Dictionary Wdata. Łańcuch automatycznie utworzy tę tabelę, używając konwencji nazewnictwa "Data Dictionary Table", chyba że użytkownik określi inną nazwę tabeli.
Poniższy schemat tabeli zostanie użyty do zbudowania tabeli słownika danych:
| Nazwa kolumny | Opis kolumny | Identyfikator kolumny | Typ kolumny |
|---|---|---|---|
| Table_Name | Nie dotyczy | table_name | tekst |
| Alias | Nie dotyczy | alias | tekst |
| Tryb | Nie dotyczy | tryb | tekst |
| Nazwa | Nie dotyczy | nazwa | tekst |
| Typ | Nie dotyczy | typ | tekst |
Zastrzeżenie dotyczące dostosowań niestandardowych: Jeśli użytkownicy doświadczają problemów z niedopasowaniem nagłówków kolumn podczas importowania danych do tabeli Wdata, mogą wykorzystać przygotowanie danych lub inne polecenia, aby to poprawić. Jeśli jednak użytkownik doda jakiekolwiek niestandardowe zmiany do tego szablonu, zaleca się wykonanie kopii przed wykonaniem tej czynności. Wszelkie zmiany w szablonie utrudnią jego ponowne wykorzystanie. Ma to również zastosowanie w przypadku zastosowania konfiguracji tagu do szablonu.
Rozwiązywanie problemów
Poniższe kroki mogą być wykorzystane do rozwiązywania problemów z szablonem łańcucha:
Błędy wykonania łańcucha
- Sprawdź, czy wszystkie łańcuchy zostały opublikowane.
- Upewnij się, że dane uwierzytelniające OAuth2 (
wsv-Client IDiwsv-Client Secret) są ważne i aktualne. - Sprawdź uprawnienia do obszaru roboczego dla użytkownika wykonującego łańcuch.
Błędy importu danych
- Upewnij się, że nagłówki kolumn w pliku źródłowym są zgodne ze schematem tabeli Wdata.
- W przypadku operacji Replace Dataset upewnij się, że nazwy plików odpowiadają istniejącym zestawom danych w tabeli.
- W przypadku operacji Add New Dataset upewnij się, że nazwy plików są unikalne w obrębie tabeli.
Tworzenie duplikatów tabel lub arkuszy kalkulacyjnych
- Użyj spójnych nazw dla
Wdata Table NameiSpreadsheetNamew różnych przebiegach.
Ekran monitora
- Użytkownicy mogą zdiagnozować przyczynę błędu, przechodząc do ekranu monitora.
- Zmienna DCV_Chain Result przechwytuje status łańcucha w oparciu o wynik końcowy. Jeśli wystąpi błąd, zastosuje on przyczynę niepowodzenia do tekstu wyjściowego łańcucha na ekranie monitora.
Użytkownicy mogą również użyć ekranu monitora, aby określić, czy ich plik został pomyślnie zaimportowany
Najlepsze praktyki
-
Unikaj dostosowywania oryginalnego szablonu:
Utwórz kopię, jeśli konieczne są zmiany. Zmiany w szablonie mogą utrudnić jego ponowne wykorzystanie. -
Tagowanie dla rozszerzonego kontekstu:
Dodaj dane wejściowe (Tag-KeyiTag-Value) do tagowania zestawów danych, jeśli to konieczne. Zaktualizuj węzły łańcucha, aby przekazać te dane wejściowe. -
Zarządzanie rozmiarem pliku:
Monitoruj rozmiar zbioru danych za pomocą zmiennejwsv-WdataLoadWarningThreshold. Rozważ podzielenie dużych zbiorów danych, jeśli wyświetlane są ostrzeżenia.