Acciones de Script Workspace

Genie incluye herramientas directas de Script Workspace para que puedas capturar, editar y aplicar contenido de script sin salir de FileMaker.

Acciones de la barra de herramientas

1. Copy XML

• Lee la selección actual y prepara un objeto nativo FileMaker en el portapapeles.
• Úsalo para una transferencia nativa controlada, no para exponer XML sin procesar.

2. Paste XML

• Pega en Script Workspace un objeto nativo FileMaker compatible.

3. Edit XML

• Abre la herramienta experta heredada para transportadores nativos compatibles.

4. AI button

• Abre la interfaz completa de Genie para generación y análisis.

5. Botón Klai

• Aparece junto al botón Genie cuando está activado Configuración > Avanzado > Activar integración de Klai.
• Ofrece Set Up Klai App para la configuración inicial o Add HookSet para añadir un HookSet.
• Copia el HookSet elegido al portapapeles para que puedas pegarlo en Script Workspace.

Una vez que Genie está abierto, usa Add Selection para capturar la selección viva actual de Script Workspace o el script actual. Usa Metadata Explorer > Scripts cuando quieras un contexto más amplio de scripts conocidos.

Nota: no existe un botón View dedicado en la barra de herramientas de Script Workspace. La vista de solo lectura está disponible desde las insignias de contexto y desde Preview Code en el chat.

HookSets de Klai y funciones personalizadas

El flujo de Klai usa acciones explícitas del portapapeles de FileMaker. Activar la integración no importa ni pega nada por sí solo.

1. Abre FileMaker > Gestionar > Funciones personalizadas y haz clic en el icono de Klai junto a Importar.
2. Genie valida las 57 definiciones de la exportación oficial de funciones Klai y su codificación para el portapapeles de FileMaker, y luego copia directamente ese paquete completo sin exclusiones. No inspecciona ni revisa el inventario actual y no exige un recibo de verificación. Pega las funciones en FileMaker y elige OK.
3. En Script Workspace, haz clic en el icono de Klai y elige Set Up Klai App o Add HookSet.
4. Para Set Up Klai App, introduce el nombre compartido y el nombre del HookSet. Para Add HookSet, solo se muestra el nombre del HookSet. Los nombres deben comenzar con una letra, usar solo letras, números, _ o -, y tener como máximo 48 caracteres. Cuando ambos nombres están presentes, no pueden coincidir sin distinguir mayúsculas de minúsculas.

5. Elige Copy. El diálogo contiene únicamente Copy y Cancel. Genie avisa si detecta un nombre visible en conflicto, pero no selecciona ni copia la barra lateral de Script Workspace. Set Up Klai App siempre copia sin comprobar las funciones instaladas y muestra un recordatorio para instalar las funciones Klai antes de pegar. Pega el HookSet en Script Workspace. Los scripts copiados conservan las filas de edición vacías y el espaciado creados en el XML de origen.

Ningún inventario, revisión o recibo de funciones personalizadas bloquea Set Up Klai App. Add HookSet no cambia y usa la ruta directa moderna de Klai (isLegacy = 0). Este flujo no genera la variante Scoped heredada, no sobrescribe silenciosamente funciones personalizadas ni pega nada en FileMaker por ti.

Aplicación nativa y progreso

Cuando aplicas código desde Genie, el sistema usa operaciones nativas que apuntan directamente a tu Script Workspace:

• Apply Progress: muestra un indicador animado Applying… mientras los cambios se escriben en FileMaker.
• Delta Apply (Line-targeted): edita líneas concretas de tu script existente a partir de un plan delta nativo.
• Full Script Apply: escribe un cuerpo completo de script para scripts nuevos o refactorizaciones completas.
• Automatic Routing: no necesitas seleccionar las líneas de destino antes de hacer clic en Apply Code. Genie usa el contexto original de mapeo de líneas para aplicar las ediciones exactamente donde corresponden.
• Safety: la aplicación se detiene e informa de un error si cambia el estado del editor o si el script equivocado pasa a primer plano.

Buenas prácticas

• Mantén Script Workspace en primer plano antes de las acciones de copiar, pegar o aplicar.
• Usa Add Selection para el contexto vivo de Script Workspace y Metadata Explorer para contexto mas amplio de scripts o schema.
• Si un comando falla, ejecuta un Cmd+C manual una vez en Script Workspace y vuelve a intentarlo.

Páginas relacionadas

• Context Capture
• Creación de scripts en AGENT