📖 AiScripto Demo - Complete User Guide

Welcome to AiScripto Interactive Demo! This guide covers all features and how to use them.

📋 Table of Contents

⚙️ System Requirements & Setup
🚀 Tab 1: Job Runner
✏️ Tab 2: Test Case Manager
📥 Tab 3: Scripts & Reports
🐛 Troubleshooting

⚙️ System Requirements & Setup

Before You Start

✅ Modern web browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)
✅ AiScripto server running and accessible
✅ Network connection to the server (HTTP/HTTPS)
✅ JavaScript enabled in browser

Server Configuration

Location: Control Panel → Server Configuration (top-left)
Default URL: http://localhost:8080
Action: Enter your server URL and press Enter
Status: Green indicator shows connection is successful
💡 Tip: The URL is saved in browser storage, so you don't need to re-enter it.

🚀 Tab 1: Job Runner

Execute various commands on test cases to perform validation, conversion, and verification tasks.

Available Commands

✓ Validate Test Case

Check test case syntax, structure, and compatibility with the system.

→ Convert to Playwright Script

Generate TypeScript Playwright scripts from test case. This is the main conversion function.

✔ Verify Execution

Execute the converted script and generate verification reports (healing, validation, execution).

⚙ Parameterize Test

Extract and parameterize test data for data-driven testing.

How to Submit a Job

Select Command: Choose from dropdown (e.g., "Convert to Playwright Script")
Select Test Case: Pick a test case ID from the dropdown
Optional Parameters: Add notes or parameters if needed
Submit: Click "▶ Submit Job" button
Monitor: Watch real-time execution events in the right panel
View Result: Check completion status and result message

Execution Monitor Panel

📊 Job Information: Shows Job ID, Status, Duration, Creation Time
📋 Event Timeline: Real-time execution events (latest 6 displayed)
✅ Result Box: Final result message after job completion
🔄 Polling Status: Shows polling interval (checks every 2 seconds)

✏️ Tab 2: Test Case Manager

Create, edit, and manage test cases directly in the system.

Left Panel: Test Case List

Search Bar: Filter test cases by ID or title
Refresh Button: Reload the list from server
+ New Button: Create a new test case
Click Item: Select and edit a test case
Count Display: Shows total number of test cases

Right Panel: Editor

CREATE Mode: Fields for new test case

Test Case ID: Optional (auto-generated if empty)
Title: Name of the test case
Content: Test steps in specific format

EDIT Mode: Modify existing test case

Test Case ID is locked (cannot change)
Can update title and content
Changes are saved immediately

Content Format Requirements

⚠️ Important: Content must have:

One line with "Test Case ID:" (e.g., "Test Case ID: 1")
At least one numbered step (e.g., "1) Step description")
Each step can have "Action:" and "Expected:" sub-lines

Template Examples

Basic Template:

Test Case ID: 1

1) Step description
   Action: Describe what to do
   Expected: Describe expected result

📥 Tab 3: Scripts & Reports

View and download converted scripts and generated reports.

Features

📋 List All Scripts: Shows all converted test scripts
🔍 Filter by ID: Search for specific test cases
📊 Filter by Report Type: Find tests with specific reports
⬇️ Download Scripts: Get .spec.ts files
📄 View/Download Reports: Healing, Validation, Execution
🎬 Video Support: Download and view videos from execution reports

Three Types of Reports

👁️ Healing Report

Shows how the system fixed issues during execution (JSON format)

📊 Buttons: [View] [Download]

👁️ Validation Report

Details about test case structure and validation (Markdown format)

📊 Buttons: [View] [Download]

👁️ Execution Report

Test execution results with videos, step-by-step logs (HTML + Videos)

📊 Buttons: [View HTML] [Download ZIP+Videos] [Videos List]

Execution Report Video Features

Three Options:

👁️ HTML: View HTML report online (with embedded videos)
🎬 Videos (N): See video list with metadata and download individual videos
⬇ ZIP+Videos: Download complete report as ZIP (HTML + all videos)

Workflow

Step 1 - Convert: Go to Job Runner, select "Convert" command, submit
Step 2 - View: Switch to Scripts & Reports tab
Step 3 - Search: Find your test case using filters
Step 4 - Download: Choose how to download (view online or download files)
Step 5 - Use: Use scripts for automation, reports for documentation

🐛 Troubleshooting

Connection Issues

❌ "Connection Failed: Failed to fetch" message

This error typically appears when the browser cannot communicate with the server. It often indicates a certificate trust issue with HTTPS connections.

🔍 Debug Information:

If you see in Debug Info: "net::ERR_CERT_AUTHORITY_INVALID"

Problem: Browser doesn't trust your self-signed certificate

✅ Solution for Self-Signed Certificate Issues:

Open your browser (Chrome, Firefox, Safari, Edge)
Visit the certificate source: https://YOUR_SERVER_URL:8080/api/v1/health
Example: https://api-gcp-server2025.aiscripto.app:8080/api/v1/health
You'll see "Your connection is not private" warning
Click "Advanced" button
Click "Proceed to [SERVER_ADDRESS]" (or similar button)
Accept the certificate ✅ (browser will remember it)
Return to AiScripto Demo: https://aiscripto.app/demo.html
Enter your server URL again and it should connect successfully ✅

Other Connection Issues:

Check if server is running and accessible
Verify server URL is correct (e.g., http://localhost:8080 or https://api-gcp-server2025.aiscripto.app:8080)
Make sure you're on same network or can reach the server
Try refreshing the page (F5)
Check browser console (F12) for detailed error messages
Verify firewall/network rules allow access to the server port

Job Submission Issues

❌ Submit button is disabled

Make sure server connection is successful (green indicator)
Select a test case from the dropdown
Ensure you selected a valid command

Test Case Manager Issues

❌ Cannot save test case

Make sure title is not empty (for new cases)
Check content has "Test Case ID:" line
Verify content has at least one numbered step ("1) ...")
Check browser console for error details

Scripts & Reports Issues

❌ Scripts list is empty

Run convert job first in Job Runner tab
Click "Refresh" button to reload the list
Check if test case was successfully converted

❌ Video buttons show "?"

Wait for the API to load video count
Click Refresh to reload the list
Check if execution report has been generated

💡 Pro Tips

✅ Use "Refresh" buttons frequently to get latest data
✅ Monitor execution events in real-time for long jobs
✅ Download execution reports as ZIP for complete backup
✅ Use filters in Scripts & Reports to find tests quickly
✅ Check browser console (F12) for detailed debug information
✅ Server URL is saved automatically, no need to re-enter
✅ Reports can be opened offline after downloading ZIP

AiScripto Interactive Demo | For more help, check browser console (F12) or contact support

Interactive Demo

📥 Downloaded Scripts & Reports

0 Test Cases

New Test Case