Skrypty w Twojej witrynie mogą być uruchamiane 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 Twojej przestrzeni roboczej. 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.
Stwórz swoją automatyzację
Aby utworzyć automatyzację z pliku, który posiadasz:
- Na stronie Home otwórz dokument, prezentację lub arkusz kalkulacyjny.
- Po prawej stronie ekranu wybierz z panelu Automations.
- Kliknij + lub Utwórz, aby dodać nową automatyzację.
- Z rozwijanego menu Automation trigger wybierz Manual Execution.
- W sekcji When run is selected by, opcjonalnie daj innym użytkownikom możliwość ręcznego uruchomienia tej automatyzacji.
- W sekcji 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ć.
Uruchom automatyzację i zarządzaj nią
Twoja 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: Zaktualizuj szczegóły dotyczące automatyzacji, takie 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 usuń automatyzację z pliku.
Uwaga: Aby zapobiec duplikowaniu przebiegów, opcja Run jest wyłączona na 20 sekund pomiędzy kliknięciami.
Informacje otrzymywane przez Twój 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, UE, USA)?
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.
Jeśli korzystasz ze skryptowego interfejsu API, musisz 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 skryptu wykonywanego z poziomu 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.