# ActionScript

## ¿Qué es ActionScript?

ActionScript es una **función avanzada que permite a los usuarios controlar el proceso de extracción escribiendo código JavaScript (JS) directamente**, más allá de simplemente extraer la pantalla visible.

<figure><img src="https://content.gitbook.com/content/IB9ndOCr7FFgFMzgmMpx/blobs/bT8XiPQlWSXLRSBoVb23/actionscript%201.png" alt=""><figcaption></figcaption></figure>

Ejemplos:

* Extraer datos dentro de una sección que aparece después de hacer clic en un botón específico
* Extraer datos dentro de un área que aparece al pasar el mouse por encima
* Controlar otros elementos que cambian dinámicamente dentro del sitio antes de recopilar datos

Como se muestra arriba, puedes **personalizar la extracción de datos en situaciones especiales** que son difíciles de resolver con la configuración de automatización estándar de Listly.

{% hint style="warning" %}
El servicio de escritura de ActionScript es una **opción exclusiva del plan Enterprise**. Si estás usando un plan inferior, puedes escribir el script tú mismo para utilizar esta función.
{% endhint %}

***

## Cómo usar

{% stepper %}
{% step %}

#### Después de una extracción **\[WHOLE]** de la página web, haz clic en la sección \[Browser Setting] de la página de resultados para ir a la pantalla de configuración de esa tarea.

<figure><img src="https://content.gitbook.com/content/IB9ndOCr7FFgFMzgmMpx/blobs/ZBArz6zjimORC6BHSNZV/actionscript%202.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Pega el código JS que escribiste en el campo ActionScript de la pantalla de configuración y haz clic en el botón **\[Guardar]**.

{% hint style="success" %}
**CONSEJO** Hoy en día, puedes crear scripts simples con servicios de IA como Chat GPT. El equipo de Listly ha compartido su experiencia usando ChatGPT para generar ActionScripts en un newsletter. Échale un vistazo aquí: 👉 [ActionScript, le pedí a ChatGPT que lo escribiera por mí y "¿esto funciona?"](https://maily.so/listly.io/posts/knrje7v0zld)
{% endhint %}

<figure><img src="https://content.gitbook.com/content/IB9ndOCr7FFgFMzgmMpx/blobs/WGT9RQ5fsjPlAf7FJzcq/actionscript%203.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Haz clic en el botón **\[Re-extraer]** en la ventana de resultados o en el panel de datos para volver a extraer el área de datos usando el ActionScript.

<figure><img src="https://content.gitbook.com/content/IB9ndOCr7FFgFMzgmMpx/blobs/xTlEbpeD4KaSgPXQecm0/actionscript%204.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Después de que se complete la re-extracción, verifica los resultados. Asegúrate de validar que el ActionScript configurado funcionó según lo previsto.

<figure><img src="https://content.gitbook.com/content/IB9ndOCr7FFgFMzgmMpx/blobs/Po3i1ioMj7kLXDBqw6Nc/actionscript%205.png" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Precauciones

{% hint style="warning" %}
**Precauciones al aplicar ActionScript a tareas de extracción grupal**

El ActionScript siempre debe aplicarse primero en la página de origen antes de la extracción grupal. La extracción grupal asume que todas las demás URLs tienen la misma estructura que la página representativa (página de origen) y recopila los datos en consecuencia. Si no aplicas el ActionScript a la página de origen, no habrá una referencia para que las URLs agregadas posteriormente realicen la misma acción, lo que puede causar **errores de coincidencia de pestañas** o **pérdida de datos**.

* Asegúrate de escribir y aplicar el ActionScript mientras tienes abierta la **página representativa**.
* Después de aplicar el ActionScript, primero debes ejecutar **Re-extraer** para verificar que la configuración funciona correctamente.
* Después, cuando agregues URLs usando el botón **\[+Grupo]**, la misma acción del ActionScript se aplicará a todas las páginas del grupo.
* Si hay una gran diferencia de estructura entre la página de origen y otras páginas, el script puede no funcionar correctamente, por lo que es importante incluir solo **páginas con la misma estructura** en la extracción grupal.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.listly.io/docs/es/getting-started/result-page-features/actionscript.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.