Configuración de la biblioteca de macros de Automate para Hojas de cálculo de Google - Automate_Studio - Latest

Guía del complemento Hojas de cálculo de Google de Automate Studio con Evolve y Studio Manager

Product type
Software
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Studio
Version
Latest
ft:locale
es-ES
Product name
Automate Studio
ft:title
Guía del complemento Hojas de cálculo de Google de Automate Studio con Evolve y Studio Manager
Copyright
2026
First publish date
2025
ft:lastEdition
2026-08-02
ft:lastPublication
2026-08-02T17:55:16.137000
L1_Product_Gateway
Integrate
L2_Product_Segment
Data Integration
L3_Product_Brand
Precisely Automate
L4_Investment_Segment
SAP Automation
L5_Product_Group
Winshuttle Enterprise
L6_Product_Name
Automate Studio

La biblioteca de macros de Automate es un proyecto de scripts de aplicaciones que proporciona funcionalidad de macros para Hojas de cálculo de Google. Con esta biblioteca, puede:

  • Añadir la biblioteca de macros de Automate a sus proyectos de scripts de aplicaciones
  • Ejecutar funciones de macro directamente desde sus hojas de cálculo
  • Interactuar con el agente de Automate incluido con Studio

Requisitos previos

  • Acceso del administrador al proyecto de Google Cloud Platform (GCP) o Google Workspace.
  • Una cuenta de Google con acceso al script de Google Apps
  • El paquete de códigos proporcionado por Precisely

Pasos de configuración

  1. Active la API del script de aplicaciones en Google Cloud Console > API y servicios > Activar API y servicios.
    El comando Clasp requiere que se active la API de script de aplicaciones de Google para su proyecto en Google Cloud.
    Nota: Por lo general, esta configuración es única para cada proyecto de Google Cloud, y suele requerir permisos de administrador de Google Workspace o GCP.
    Requisito previo obligatorio (una vez): asegúrese de que se permite el ámbito de OAuth necesario en la configuración de consentimiento de OAuth del proyecto (este paso a menudo requiere un administrador de Google Workspace/GCP):
    • Agregue el ámbito https://www.googleapis.com/auth/script.projects en el proyecto Google Cloud en APIs & Services → Pantalla de consentimiento de OAuth → Acceso a datos.
    1. Abra la biblioteca de API de Google Cloud Console: https://console.cloud.google.com/apis/library/script.googleapis.com
    2. Asegúrese de seleccionar el proyecto correcto de Google Cloud (selector de proyecto superior).
    3. Haga clic en Activar.

    Si encuentra errores en los permisos, póngase en contacto con el administrador de Google Workspace o GCP para habilitar la API para su organización o para otorgarle los permisos necesarios.

  2. Instalar la CLI de Clasp

    La CLI de Clasp (Command Line Apps Script Projects) le permite administrar proyectos de scripts de aplicaciones desde su terminal.

    npm install -g @google/clasp
  3. Autenticación con Google

    Inicie sesión en su cuenta de Google para autorizar Clasp:

    clasp login

    Siga las indicaciones del navegador para completar la autenticación.

  4. Crear un nuevo proyecto de script de aplicaciones
    1. Crear un nuevo directorio para su proyecto e ir hasta él:

      mkdir AutomateMacroLibrary
      cd AutomateMacroLibrary
    2. Crear un proyecto de script de aplicaciones independiente:
      clasp create --title "AutomateMacroLibrary" --type standalone

      Esto generará los archivos .clasp.json y appsscript.json localmente.

  5. Agregar el código de Precisely
    1. Copie los archivos de códigos proporcionados por Precisely en su directorio de proyecto.
    2. Sobrescriba el archivo appsscript.json existente con el proporcionado.
  6. Insertar archivos en Google

    Cargar los archivos locales en el proyecto Apps Script:

    clasp push
  7. Abra el proyecto del script de aplicaciones en su navegador.

  8. Vincular el script a un proyecto de Google Cloud (Id. del proyecto)

    Algunas funcionalidades (incluidos los escenarios de API ejecutable/API de ejecución) requieren que el script se vincule a un proyecto de Google Cloud. Este es un proceso de configuración único que, por lo general, se completa una vez por proyecto de script de aplicaciones. En muchas organizaciones, solo un administrador de Google Workspace o GCP (o propietario del proyecto) puede realizar este paso.

  9. En AppsScript, en la configuración de Proyecto, active la casilla Mostrar archivo de manifiesto "appscript.json" en el editor.
  10. Cree una nueva versión de la biblioteca. Esto es necesario para el uso de la biblioteca.
    clasp version "Initial Release"
    Nota: Sustituya «Initial Release» por un nombre de versión apropiado para la implementación.
  11. Implementar como API ejecutable (para el Id. de implementación)

    Si la configuración de Evolve requiere un Id. de implementación, deberá crear una implementación de API ejecutable desde la IU de scripts de aplicaciones.

    1. En el editor de scripts de aplicaciones, haga clic en Implementar → Nueva implementación.
    2. Haga clic en Seleccionar tipo (icono de engranaje) y seleccione API ejecutable.
    3. Haga clic en Implementar.
    4. Copie el Id. de implementación.
      Nota: La biblioteca se consume utilizando el Id. de script + versión. El Id. de implementación se usa específicamente para el uso de la API ejecutable y la API de ejecución.
  12. Configurar parámetros de Evolve:
    1. Copie el Id. de implementación desde la implementación del ejecutable de la API, por ejemplo: AKfycbxXDwYZaen1spaKYa02DPyE0UdkYpPLcd6OAMlxc7urWGdlVFU39jOeA3z1oC0kf_St
    2. En el sitio de Evolve, en la aplicación Administración, vaya a la pestaña Configuración y seleccione Autenticación.
    3. En Clientes de hoja de cálculo de Google, pegue el Id. de implementación en el campo Id. de implementación de macro y haga clic en Guardar.
  13. Obtener el Id. del script:
    1. Abra el proyecto del script de aplicaciones en su navegador.
    2. Diríjase a Configuración del proyecto (icono de modificación) y copie el Id. del script.
    3. Utilice este Id. de script para agregar la biblioteca de macros de Automate a sus proyectos de macros.
    4. Mantenga el espacio de nombres predeterminado para la biblioteca. Si cambia el nombre de la biblioteca, también debe actualizarlo en el código de ejemplo de macro (AutomateMacroLibrary.onScript).
Nota:

Si Precisely comparte actualizaciones del código de script de la aplicación Automate, deberá aplicar esas actualizaciones en su aplicación de macros de Automate. Para ello, debe implementar la última versión de la biblioteca de macros de Automate.

En las plantillas existentes, debe quitar la biblioteca actual y luego agregar la nueva versión de la biblioteca de macros de Automate para asegurarse de utilizar los últimos cambios.