Skrypty w witrynie można uruchamiać za pomocą akcji Wykonywanie skryptu w panelu Automatyzacje. Pozwala to na ręczne uruchamianie skryptów z dokumentu, arkusza kalkulacyjnego lub prezentacji.
Uwaga: Skrypty są obecnie dostępne tylko poprzez Customize Workiva. Dowiedz się więcej.
Wymagania
- Skrypty Workiva muszą być włączone dla obszaru roboczego. Dowiedz się więcej o Workiva Scripting.
- Skrypty mogą być uruchamiane tylko w tej samej przestrzeni roboczej, w której są hostowane. Dowiedz się więcej.
- Tylko właściciele plików mogą tworzyć automatyzacje.
- Do tworzenia skryptów wymagana jest rola Script Editor .
Tworzenie automatyzacji
Aby utworzyć automatyzację z posiadanego pliku:
- Na stronie Homeotwórz dokument, prezentację lub arkusz kalkulacyjny.
- Po prawej stronie ekranu wybierz z panelu Automations .
- Kliknij + lub Utwórz , aby dodać nową automatyzację.
- Z menu rozwijanego Automation trigger wybierz Manual Execution.
- W sekcji When run is selected by, opcjonalnie daj innym użytkownikom możliwość ręcznego uruchomienia tej automatyzacji.
- Pod Szczegóły akcji, wybierz Wykonaj skrypt.
- W polu Identyfikator skryptu wprowadź identyfikator z końca adresu URL skryptu.
- Wybierz arkusz kalkulacyjny i sekcję, które zawierają dane wejściowe skryptu. Jest to opcjonalne.
- Kliknij Create , aby zakończyć.
Uruchamianie i zarządzanie automatyzacją
Nowa automatyzacja pojawi się jako "Aktywna" w panelu Automatyzacje. Jako właściciel pliku możesz wykonać kilka czynności z menu rozwijanego:
- Uruchom: Ręcznie uruchamia skrypt automatyzacji.
- Edytuj: Aktualizacja szczegółów dotyczących automatyzacji, takich jak kryteria wyzwalania.
- Wyłącz/Aktywuj: Wybierz, czy automatyzacja jest dostępna do uruchomienia.
- Wyświetl aktywność: Otwórz dziennik aktywności automatyzacji.
- Usuń: Trwale usuwa automatyzację z pliku.
Uwaga: Aby zapobiec duplikowaniu przebiegów, opcja Run jest wyłączona na 20 sekund pomiędzy kliknięciami.
Informacje otrzymywane przez skrypt
Gdy uruchamiana jest automatyzacja, wysyła ona informacje, które skrypt odczytuje jako zmienne środowiskowe:
- DOCUMENT_ID: Identyfikator dokumentu, w którym uruchamiana jest automatyzacja.
- INPUT_SHEET_ID: Adres URL arkusza kalkulacyjnego używanego do zarządzania parametrami wejściowymi automatyzacji.
- INPUT_RESOURCE_ID: Adres URL sekcji w wyżej wymienionym arkuszu kalkulacyjnym.
- INPUT_SPREADSHEET_ID: Identyfikator wyżej wymienionego arkusza kalkulacyjnego.
- INPUT_SPREADSHEET_SHEET_ID: Identyfikator sekcji w wyżej wymienionym arkuszu kalkulacyjnym.
WURL to zastrzeżony, specyficzny dla Workiva adres URL, który zawiera identyfikator i inne informacje dotyczące arkusza kalkulacyjnego lub sekcji.
Aby pobrać identyfikatory z parametrów, użyj tego skryptu:
# Welcome to Workiva Scripting import requests import json import os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("Parametry RAW:") print(os.environ) print("") print("Rzeczywiste identyfikatory:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Uwaga: Automatyzacja nie wysyła obecnie do skryptu żadnych poświadczeń publicznego interfejsu API Workiva - takich jak identyfikator klienta lub sekret. Konieczne może być zakodowanie tych poświadczeń bezpośrednio w skrypcie.
FAQ
Czy mogę wykonać skrypt hostowany w innej przestrzeni roboczej, organizacji lub środowisku (APAC, EU, US)?
Funkcja automatyzacji w Workiva może wykonywać skrypty tylko w tym samym obszarze roboczym, w którym znajduje się plik. Do wykonania skryptu hostowanego w innej lokalizacji można jednak użyć konektora Workiva Scripting lub interfejsu Workiva Scripting API .
W przypadku korzystania ze skryptowego interfejsu API należy utworzyć i hostować skrypt w głównym obszarze roboczym, którego jedynym celem jest wywołanie skryptowego interfejsu API i wykonanie skryptu w dodatkowym obszarze roboczym.
Czy mogę wysyłać dane wejściowe/parametry podczas wykonywania skryptu?
Obecnie funkcja automatyzacji nie zezwala na dane wejściowe wysyłane do skryptu podczas jego wykonywania.
Jakie metadane są wysyłane do wykonywanego skryptu z automatyzacji? Czy identyfikator obszaru roboczego został wysłany?
Gdy skrypt jest wykonywany z poziomu automatyzacji, jedynym wysyłanym parametrem jest identyfikator dokumentu, w którym skonfigurowano automatyzację.
Jak uzyskać dostęp do poświadczeń do systemów Workiva i innych niż Workiva z poziomu wykonywania skryptu?
Gdy skrypt jest wykonywany z poziomu automatyzacji, jedyną opcją jest zakodowanie poświadczeń w samym kodzie.
Czy ten sam skrypt może być wykonywany jednocześnie z dwóch lub więcej plików?
Tak, skrypt może być wykonywany jednocześnie z tego samego pliku lub wielu plików.