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.
La función de scripting está incluida en Customize Workiva. Para utilizar Scripting, tu espacio de trabajo debe tener habilitada la opción «Personalizar Workiva/Scripting», y los usuarios deberán disponer de los roles de Scripting adecuados y de los permisos de archivo correspondientes.
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 la barra lateral derecha, haz clic en el icono con forma de rayo de « Automations».
- Haz clic en + o . Crea una nueva automatización en para añadir una nueva automatización.
- Desde el menú desplegable Activación de automatización, selecciona Ejecución manual.
- (Opcional) Permite a otros usuarios ejecutar manualmente esta automatización introduciendo sus nombres y seleccionándolos en el campo « » (Cuando se ejecute) de la opción « » (¿Quién puede ejecutar esta automatización?).
- Debajo de Detalles de acción, selecciona Ejecutar script.
- Introduce el ID « », que se encuentra al final de la URL del script , en el campo «ID del script de » .
- (Opcional) Selecciona la hoja de cálculo y la sección que contienen los datos de entrada del script.
- 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 sin procesar:") print(os.environ) print("") print("ID reales:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Nota : Actualmente, la automatización no envía al script ninguna credencial de la API pública de Workiva, como el ID de cliente o el secreto. Puede que tengas que codificar estas credenciales directamente en el script.
Preguntas frecuentes
¿Puedo ejecutar un script alojado en otro espacio de trabajo, organización o región (APAC, CA, UE o EE. UU.)?
Las automatizaciones de Workiva solo pueden ejecutar scripts que se encuentren en el mismo espacio de trabajo que el archivo. Para ejecutar un script en otro espacio de trabajo, organización o región, utiliza el conector de Workiva Scripting de o la API de Workiva Scripting de .
Al utilizar la API de scripts, crea la autorización de la API en el espacio de trabajo que aloja el script de destino. La subvención requiere script:execute ; si la integración recupera el estado de ejecución, los registros o la salida, también requiere script:read . Para obtener instrucciones sobre cómo crear o actualizar una autorización de API, consulta Configuración de la API de Workiva .
¿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, se envían los siguientes parámetros:
- 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 : El WURL de la sección de la hoja de cálculo «input».
- INPUT_SPREADSHEET_ID : El ID de la hoja de cálculo «de entrada».
- INPUT_SPREADSHEET_SHEET_ID : El identificador de la sección de la hoja de cálculo «input».
Para obtener más información, consulta la página de asistencia de Workiva: . Ejecuta scripts con automatizaciones: .
¿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.