Skrypty w witrynie można uruchamiać za pomocą akcji Wykonywanie skryptu w panelu Automatyzacje. Dzięki temu możesz ręcznie uruchamiać skrypty z poziomu dokumentu, arkusza kalkulacyjnego lub prezentacji.
Skrypty są zawarte w module Customize Workiva. Aby móc korzystać ze skryptów, w obszarze roboczym musi być włączona opcja Dostosowywanie Workiva/Skryptów, a użytkownicy muszą mieć odpowiednie role skryptowe i uprawnienia do plików.
Wymagania
- W Twojej przestrzeni roboczej musi być włączona funkcja Workiva Scripting. Dowiedz się więcej o skryptach Workiva.
- Skrypty można uruchamiać wyłącznie w tej samej przestrzeni roboczej, w której są hostowane. Dowiedz się więcej
- Tylko właściciele plików mogą tworzyć automatyzacje.
- Rola Edytora skryptów jest wymagana do tworzenia skryptów.
Utwórz swoją automatyzację
Aby utworzyć automatyzację z pliku, który posiadasz:
- Z Ekran głównyotwórz dokument, prezentację lub arkusz kalkulacyjny.
- Na pasku bocznym po prawej stronie kliknij ikonę błyskawicy Automatyzacje.
- Kliknij + lub Utwórz nową automatyzację, aby dodać nową automatyzację.
- Z menu rozwijanego Wyzwalacz automatyzacji wybierz opcję Wykonywanie ręczne.
- (Opcjonalnie) Umożliw innym użytkownikom ręczne uruchamianie tej automatyzacji poprzez wpisanie ich nazw i wybranie ich w polu Gdy uruchomienie zostanie wybrane przez.
- W obszarze Szczegóły akcjiwybierz opcję Wykonaj skrypt.
- Wprowadź identyfikator z końca adresu URL skryptu w polu Identyfikator skryptu.
- (Opcjonalnie) Wybierz arkusz kalkulacyjny i sekcję zawierającą dane wejściowe skryptu.
- Kliknij Utwórz, aby zakończyć.
Uruchamiaj i zarządzaj swoją automatyzacją
Twoja nowa automatyzacja będzie wyświetlana 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 Uruchom jest wyłączona na 20 sekund pomiędzy kliknięciami.
Informacje, które otrzymuje Twój skrypt
Gdy automatyzacja jest uruchamiana, wysyła ona informacje, które skrypt odczytuje jako zmienne środowiskowe:
- DOCUMENT_ID: Identyfikator dokumentu, w którym uruchomiono automatyzację.
- INPUT_SHEET_ID: Adres WURL arkusza kalkulacyjnego używanego do zarządzania parametrami wejściowymi automatyzacji.
- INPUT_RESOURCE_ID: Adres WURL sekcji w wyżej wymienionym arkuszu kalkulacyjnym.
- INPUT_SPREADSHEET_ID: Identyfikator wyżej wymienionego arkusza kalkulacyjnego.
- INPUT_SPREADSHEET_SHEET_ID: Identyfikator sekcji w arkuszu kalkulacyjnym, o którym mowa powyżej.
WURL to zastrzeżony, specyficzny dla Workiva adres URL, który zawiera identyfikator i inne informacje na temat arkusza kalkulacyjnego lub sekcji.
Aby pobrać identyfikatory z parametrów, użyj tego skryptu:
# Witamy w skryptach Workiva 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 obecnie nie wysyła żadnych publicznych danych uwierzytelniających API Workiva — takich jak identyfikator klienta lub klucz tajny — do skryptu. Może być konieczne zakodowanie tych danych uwierzytelniających bezpośrednio w skrypcie.
Często zadawane pytania
Czy mogę uruchomić skrypt hostowany w innej przestrzeni roboczej, organizacji lub środowisku (APAC, UE, USA)?
Funkcja automatyzacji w Workiva umożliwia wykonywanie skryptów tylko w tej samej przestrzeni roboczej, w której znajduje się plik. Jednakże łącznik Workiva Scripting lub interfejs API Workiva Scripting można wykorzystać do wykonania skryptu umieszczonego w innej lokalizacji.
W przypadku korzystania ze skryptowego interfejsu API należy utworzyć i umieścić w głównym obszarze roboczym skrypt, którego jedynym celem jest wywołanie skryptowego interfejsu API i wykonanie skryptu w pomocniczym obszarze roboczym.
Czy mogę wysyłać dane wejściowe/parametry środowiska wykonawczego podczas wykonywania skryptu?
Obecnie funkcja automatyzacji nie pozwala na przesyłanie danych wejściowych do skryptu w momencie jego wykonywania.
Jakie metadane są wysyłane do wykonania skryptu z automatyzacji?Czy identyfikator obszaru roboczego został wysłany?
Podczas wykonywania skryptu z automatyzacji wysyłane są następujące parametry
- DOCUMENT_ID: Identyfikator dokumentu, w którym uruchomiono automatyzację.
- INPUT_SHEET_ID: Adres WURL arkusza kalkulacyjnego używanego do zarządzania parametrami wejściowymi automatyzacji.
- INPUT_RESOURCE_ID: Adres WURL sekcji w arkuszu kalkulacyjnym „wejście”.
- INPUT_SPREADSHEET_ID: Identyfikator arkusza kalkulacyjnego wejściowego.
- INPUT_SPREADSHEET_SHEET_ID: Identyfikator sekcji w arkuszu kalkulacyjnym „wejściowym”.
Aby uzyskać więcej informacji, zobacz stronę pomocy technicznej Workiva Wykonywanie skryptów za pomocą automatyzacji.
W jaki sposób mogę uzyskać dostęp do danych uwierzytelniających do systemów Workiva i innych niż Workiva z poziomu skryptu?
Gdy skrypt jest wykonywany z poziomu automatyzacji, jedyną opcją jest zakodowanie danych uwierzytelniających na stałe w samym kodzie.
Czy ten sam skrypt można wykonać jednocześnie z dwóch lub więcej plików?
Tak, skrypt można wykonać jednocześnie z tego samego pliku lub z wielu plików.