Los scripts de tu sitio pueden ejecutarse utilizando la acción Ejecutar script del panel Automatizaciones. Esto te permite ejecutar manualmente scripts desde un documento, hoja de cálculo o presentación.
Nota: Actualmente, el script solo está disponible a través de Personalizar Workiva. Obtén más información.
Requisitos
- Workiva Scripting debe estar activado para tu espacio de trabajo. Más información: sobre Workiva Scripting.
- Los scripts solo pueden ejecutarse en el mismo espacio de trabajo donde están alojados. Más información.
- Solo los propietarios de archivos pueden crear una automatización.
- El rol Editor de scripts es necesario para crear scripts.
Crea tu automatización
Para crear una automatización a partir de un archivo de tu propiedad:
- Desde Inicio, abre un documento, una presentación o una hoja de cálculo.
- En el extremo derecho de la pantalla, selecciona Automatizaciones desde el panel.
- Haz clic en + o Crear para añadir una nueva automatización.
- Desde el menú desplegable Activación de automatización, selecciona Ejecución manual.
- En Cuando la ejecución es seleccionada por, da opcionalmente a otros usuarios la posibilidad de ejecutar manualmente esta automatización.
- Debajo de Detalles de acción, selecciona Ejecutar script.
- En ID de script, introduce el ID desde el final de la URL del script.
- Selecciona la hoja de cálculo y la sección que contienen las entradas del script. Esto es opcional.
- Haz clic en Crear para terminar.
Ejecuta y gestiona tu automatización
Tu nueva automatización aparecerá como "Activa" en el panel Automatizaciones. Como propietario del archivo, puedes realizar varias acciones desde el menú desplegable:
- Ejecuta: Ejecuta manualmente el script de la automatización.
- Editar: Actualiza los detalles sobre la automatización, como sus criterios de activación.
- Deshabilitar/Activar: Selecciona si una automatización está disponible para ejecutarse.
- Ver actividad: Abre el registro de actividades de la automatización.
- Eliminar: elimina permanentemente las automatizaciones del archivo.
Nota: Para evitar duplicar ejecuciones, la opción Ejecutando está deshabilitada durante 20 segundos entre clic y clic.
Información que recibe tu script
Cuando una automatización se ejecuta, envía información que el script lee como variables de entorno:
- DOCUMENT_ID: El ID del documento donde se ejecuta la automatización.
- INPUT_SHEET_ID: La WURL de la hoja de cálculo utilizada para gestionar los parámetros de entrada de la automatización.
- INPUT_RESOURCE_ID: La WURL de la sección en la hoja de cálculo mencionada.
- INPUT_SPREADSHEET_ID: El ID de la hoja de cálculo mencionada.
- INPUT_SPREADSHEET_SHEET_ID: El ID de la sección en la hoja de cálculo mencionada.
Una WURL es una URL propia, específica de Workiva, que contiene el ID y otra información de la hoja de cálculo o sección.
Para recuperar los ID desde los parámetros, utiliza este script:
# Bienvenido a 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("Parámetros RAW:") print(os.environ) print("") print("IDs reales:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Nota: La automatización no envía actualmente ninguna credencial de la API pública de Workiva -como el Id de cliente o el secreto- al script. Puede que tengas que codificar estas credenciales directamente en el script.
Preguntas frecuentes
¿Puedo ejecutar un script alojado en otro espacio de trabajo, org o entorno (APAC, EU,US)?
La función Automatizaciones de Workiva solo puede ejecutar secuencias de comandos en el mismo espacio de trabajo en el que se encuentra el archivo. Sin embargo, el conector Workiva Scripting o la API Workiva Scripting pueden utilizarse para ejecutar un script alojado en otra ubicación.
Si utilizas la API de scripting, debes crear y alojar un script en el espacio de trabajo principal cuyo único propósito sea llamar a la API de scripting y ejecutar el script en el espacio de trabajo secundario.
¿Puedo enviar entradas/parámetros en tiempo de ejecución al ejecutar el script?
En este momento, la función de Automatizaciones no permite entradas en tiempo de ejecución que se envían al script cuando éste se ejecuta.
¿Qué metadatos se envían a la ejecución de un script desde una automatización? ¿Se ha enviado el identificador del espacio de trabajo?
Cuando se ejecuta un script desde una automatización, el único parámetro enviado es el ID del documento donde está configurada la automatización.
¿Cómo accedo a las credenciales de los sistemas Workiva y no Workiva desde la ejecución del script?
Cuando se ejecuta un script desde una automatización, la única opción es codificar las credenciales en el propio código.
¿Puede ejecutarse el mismo script simultáneamente desde dos o más archivos?
Sí, un script puede ejecutarse simultáneamente desde el mismo archivo o desde varios archivos.