Wprowadzenie
Szablon Łańcuch słownika danych 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ę arkusza kalkulacyjnego do eksportu i utworzyć tabelę w obszarze roboczym, aby zapisać schemat każdej tabeli.
Więcej szczegółów można znaleźć w dokumentacji dotyczącej procesu Ładowanie danych do Wdata, gdzie znajduje się kompleksowy przegląd. Przed użyciem szablonu słownika danych zaleca się zapoznanie się z tą dokumentacją.
Wymagania wstępne
Ten szablon zakłada, że w aplikacji Workiva są już skonfigurowane następujące obiekty:
- Uprawnienie API
- Aby wykorzystać interfejsy API Workiva, użytkownik musi przyznać zezwolenie OAuth API w swojej przestrzeni roboczej. Aby zapoznać się z wiodącymi praktykami w zakresie zarządzania przyznaniem OAuth, zapoznaj się z tym artykułem.
- Następujące łączniki 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” w przypadku zmiennych zawierających dane wrażliwe i ustawienie odpowiednich uprawnień dla arkusza kalkulacyjnego.
- Konfiguruj zmienne
Uwaga: Najlepiej ustawić domyślną wartość tej zmiennej na 50 (co odpowiada 50 MB), ale w razie potrzeby można ją zmienić.
-
- Dodatkowo, przed użyciem łańcucha słownika danych konieczne jest utworzenie czterech innych zmiennych obszaru roboczego.
Poniżej znajduje się zestawienie każdej zmiennej, którą należy skonfigurować i wypełnić:
Zbuduj swój łańcuch
Szablon łańcucha Słownik danych | WSZYSTKIE | Podstawowy znajduje się w sekcji Łańcuchy Workiva na ekranie Szablony.
Oto jak to znaleźć:
- W Chain Builderprzejdź do zakładki Templates .
- Wybierz Łańcuchy Workiva z menu u góry
- Wyszukaj Słownik danych | WSZYSTKIE | PodstawowySzablon łańcucha w prawym górnym rogu i otwórz szablon
Po wdrożeniu słownika danych | ALL | łańcucha podstawowego w obszarze roboczym automatycznie zostanie wdrożonych sześć dodatkowych podłańcuchów.
Użytkownicy muszą upewnić się, że wszystkie siedem łańcuchów zostało wdrożonych i opublikowanych w tej samej przestrzeni roboczej:
- Słownik danych | WSZYSTKIE | Podstawowe
- Słownik danych | Tworzenie dokumentów i podsekcji | Tworzenie arkuszy kalkulacyjnych
- Słownik danych | Tworzenie dokumentów i podsekcji | Tworzenie arkuszy
- Słownik danych | Utwórz tabelę
- Załaduj dane do Wdata | Łańcuch podstawowy
- Załaduj dane do Wdata | Zastąp zestaw danych
- Załaduj dane do Wdata | Dodaj nowy zestaw danych
Po zlokalizowaniu szablonu skonfiguruj go dla swojego obszaru roboczego, używając zmiennych utworzonych w powyższej sekcji.
Uwaga: Szczegółowe instrukcje dotyczące tworzenia łańcucha na podstawie szablonu można znaleźć w artykule Tworzenie i zarządzanie łańcuchami.
Wejścia w czasie wykonywania
Po uruchomieniu tego łańcucha podstawowego (Słownik danych | ALL | Podstawowy) konieczne będzie wypełnienie lub przekazanie przez łańcuch wywołujący następujących danych wejściowych czasu wykonania:
| Dane wejściowe środowiska wykonawczego | Opis | Typ pola | Wymagany? |
|---|---|---|---|
| NazwaArkuszaKalkulatorowego | Określa nazwę arkusza kalkulacyjnego, w którym zostanie zapisany schemat tabeli. | Tekst | Tak |
| Wartość wyszukiwania | To wejście służy 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 wykonywania szablonu. | Tekst | Tak |
Tabela Wdata
Aby wykorzystać ten łańcuch, w obszarze roboczym musi istnieć tabela Data Dictionary Wdata. Łańcuch automatycznie utworzy tę tabelę, używając konwencji nazewnictwa „Tabela słownika danych”, chyba że użytkownik określi inną nazwę tabeli.
Do zbudowania tabeli słownika danych zostanie użyty następujący schemat tabeli:
| Nazwa kolumny | Opis kolumny | Identyfikator kolumny | Typ kolumny |
|---|---|---|---|
| Nazwa_tabeli | Nie dotyczy | nazwa_tabeli | 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 niestandardowych dostosowań: Jeśli użytkownicy napotkają problemy z niedopasowaniem nagłówków kolumn podczas importowania danych do tabeli Wdata, mogą skorzystać z polecenia data prep lub innych poleceń, aby rozwiązać ten problem. Jeśli jednak użytkownik zamierza wprowadzić do tego szablonu jakiekolwiek zmiany, zaleca się, aby przed wprowadzeniem jakichkolwiek zmian wykonał kopię szablonu. Jakiekolwiek zmiany w szablonie utrudnią jego ponowne wykorzystanie. Dotyczy to również sytuacji, gdy do szablonu stosuje się konfigurację znacznika
.Rozwiązywanie problemów
Aby rozwiązać problemy z szablonem łańcucha, można wykonać następujące czynności:
Błędy wykonania łańcucha
- Sprawdź, czy wszystkie łańcuchy zostały opublikowane.
- Sprawdź, czy dane uwierzytelniające OAuth2 (
wsv-Client IDiwsv-Client Secret) są prawidłowe i aktualne. - Sprawdź uprawnienia obszaru roboczego użytkownika wykonującego łańcuch.
Błędy importu danych
- Sprawdź, czy nagłówki kolumn w pliku źródłowym odpowiadają schematowi tabeli Wdata.
- W przypadku operacji Zastąp zestaw danych upewnij się, że nazwy plików odpowiadają istniejącym zestawom danych w tabeli.
- W przypadku operacji dodawania nowego zestawu danych upewnij się, że nazwy plików są unikalne w obrębie tabeli.
Tworzenie duplikatów tabeli lub arkusza kalkulacyjnego
- Używaj spójnych nazw dla
Nazwa tabeli WdataiNazwa arkusza kalkulacyjnegow różnych przebiegach.
Ekran monitora
- Użytkownicy mogą zdiagnozować przyczynę błędu, przechodząc na ekran monitora.
- Zmienna DCV_Chain Result rejestruje status łańcucha na podstawie wyniku końcowego. Jeśli wystąpi błąd, przyczyna błędu zostanie zastosowana do tekstu wyjściowego łańcucha na ekranie monitora.
Użytkownicy mogą również sprawdzić na ekranie monitora, 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 w celu rozszerzenia kontekstu:
W razie potrzeby dodaj dane wejściowe środowiska wykonawczego (Tag-KeyiTag-Value) do zestawów danych tagów. Zaktualizuj węzły łańcucha, aby przekazać te dane wejściowe. -
Zarządzanie rozmiarem pliku:
Monitoruj rozmiar zestawu danych za pomocą zmiennejwsv-WdataLoadWarningThreshold. Jeśli pojawią się ostrzeżenia, należy rozważyć podział dużych zestawów danych.