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 Strona główna otwó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 akcji wybierz 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 dotyczące 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 regionie (APAC, CA, EU lub US)?
Automatyzacje Workiva mogą wykonywać tylko skrypty znajdujące się w tej samej przestrzeni roboczej co plik . Aby wykonać skrypt w innym obszarze roboczym, organizacji lub regionie, należy użyć łącznika Workiva Scripting lub interfejsu API Workiva Scripting .
W przypadku korzystania z interfejsu API skryptowego należy utworzyć zezwolenie API w obszarze roboczym, w którym znajduje się skrypt docelowy. Do przyznania grantu wymagane jest script:execute ; jeśli integracja pobiera status uruchomienia, dzienniki lub dane wyjściowe, wymagane jest również script:read . Instrukcje dotyczące tworzenia lub aktualizowania przyznania API można znaleźć w dokumencie Konfiguracja interfejsu API Workiva .
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?
Gdy skrypt jest wykonywany 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.