# ActionScript

## アクションスクリプトとは？

アクションスクリプトは、単に見える画面を抽出することを超えて、**ユーザーが直接JavaScript（ジャバスクリプト）コードを作成して抽出プロセスを制御できる高度な機能**です。

<figure><img src="/files/aa0ba82de150615b9443be97dc781ef52e9fc956" alt=""><figcaption></figcaption></figure>

例）

* 特定のボタンをクリックした後に表示されるセクション内のデータ抽出
* マウスオーバーした時に表示される領域内のデータ抽出
* その他サイト内で動的に変わる要素を制御した後のデータ収集

上記のように、一般的なListly自動化設定では解決が難しい**特殊な状況のデータ抽出をカスタマイズ**できます。

{% hint style="warning" %}
アクションスクリプト作成サービスは**エンタープライズプラン専用オプション商品**です。下位プランをご利用中の場合、直接スクリプトを作成して機能を活用できます。
{% endhint %}

***

## 使い方

{% stepper %}
{% step %}

#### ウェブページを\*\*\[全体抽出]\*\*した後、結果ページの\[Browser Setting]区間をクリックして、そのタスクの設定画面に移動します。

<figure><img src="/files/13a7aeb15f3e918e65fecf484d0af3b9f1265b67" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### 設定画面のアクションスクリプト欄に作成したJSコードを貼り付け、**\[保存]** ボタンをクリックします。

{% hint style="success" %}
**TIP** 最近ではChatGPTのようなAIサービスで簡単なスクリプトを作成してみることもできます。Listlyチームが実際にChatGPTを活用してアクションスクリプトを生成した経験をニュースレターで共有しましたので、参考にしてみてください。\
👉[ アクションスクリプト、ChatGPTに代わりに書いてもらったら「これができるの？」](https://maily.so/listly.io/posts/knrje7v0zld)
{% endhint %}

<figure><img src="/files/55e313e1899bcf8d9723ff9595c69eb3b5aa43a1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### 結果ウィンドウまたはデータボードの\*\*\[再抽出]\*\* ボタンをクリックして、アクションスクリプトを通じてデータ領域を再抽出します。

<figure><img src="/files/b1464107ee44d36c60fd63562b37f9ae01e865e0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### 再抽出が完了した後、結果を確認します。設定したアクションスクリプトが意図通りに動作したか、必ず検証してください。

<figure><img src="/files/8f2cf98b90e0a0dc9bb25bd9b358449d88277790" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## 注意事項

{% hint style="warning" %}
**グループ抽出タスクにアクションスクリプトを適用する際の注意事項**

アクションスクリプトは必ずグループ抽出前のソースページで先に適用する必要があります。グループ抽出は代表ページ（ソースページ）を基準に他のURLを同じ構造だと仮定してデータを収集します。もしソースページにアクションスクリプトを適用しなければ、その後追加されたURLでは同じ動作を実行する基準がなくなり、**タブマッチングエラー**や**データ漏れ**が発生する可能性があります。

* 必ず**代表ページ**を開いた状態でアクションスクリプトを作成して適用してください。
* アクションスクリプトを適用した後は**再抽出**を実行して、その設定が正常に動作するか先に確認する必要があります。
* その後\*\*\[+グループ]\*\* ボタンを通じてURLを追加すると、すべてのグループページに同じアクションスクリプト動作が反映されます。
* もしソースページと他のページ間の構造の違いが大きい場合、スクリプトが正常に動作しない可能性があるため、**同じ構造のページ**のみをグループ抽出に含めることが重要です。
  {% 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/ja/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.