PASOE

Quick Start

VS Code OpenEdge PASOE

Getting Started

Below you can find a quick start guide for the VS Code extension.

Install the Extension

1. Open the Extensions view in VS Code.
2. Search for OpenEdge ABL - PASOE.
3. Select the extension.
4. Click Install.

Configure a PASOE Server

1. Open Settings in VS Code.
2. Search for openedge-pasoe.servers.
3. Add a server entry.

"openedge-pasoe.servers": [
  {
    "name": "Development Server",
    "host": "localhost",
    "port": 8810,
    "transport": "http",
    "authType": "basic",
    "username": "tomcat",
    "password": "tomcat"
  }
]

4. Save the settings.

You can also add and edit servers from inside the PASOE user interface.

The current implementation supports saving server entries in:

• User settings
• Workspace settings
• Folder settings

Open PASOE

1. Open the Command Palette in VS Code.
2. Run Launch OpenEdge PASOE configuration 😎.

Start Using PASOE

1. Open the OpenEdge PASOE editor.
2. Wait for the configured server list to load.
3. Select the server you want to work with.
4. Review the connection status shown at the top of the screen.
5. Open Server Configuration in the PASOE UI if you want to add, edit, import, export, or remove server entries.
6. Browse the available ABL applications deployed on that PASOE server.
7. Select an application when you want to inspect its details.

Example Server Information

A full server configuration might look like this:

Name: Development Server
Host: localhost
Port: 8810
Transport: http
Authentication: basic
Username: tomcat

Troubleshooting

• I cannot connect to the server Verify the host, port, transport, and credentials. Confirm that the OEManager endpoint is reachable.
• The server list is empty Make sure openedge-pasoe.servers contains at least one valid server configuration, or add one from the PASOE settings screen.
• Authentication fails Check the configured username and password. If your environment no longer uses the default tomcat credentials, update the saved server entry.

User Guide

User Guide

This guide explains how to use OpenEdge PASOE in the VS Code extension and the native application. It will help you configure PASOE servers, understand the interface, and work with server selection, ABL applications, agents, web applications, and application properties through simple examples and common user workflows.

Interface Overview

This section explains the main areas of the PASOE interface and how they work together during normal use.

Interface Overview describes the header controls, scope and server selectors, the ABL applications area, the application detail tabs, the server configuration dialog, and the property editor. It is useful if you want a clearer understanding of what each part of the screen is used for before you start working with PASOE servers and deployed applications.

Read the full Interface Overview documentation

Connection Management

In this section we will cover how to configure PASOE servers and manage saved server definitions.

Connection Management explains how to create, save, edit, delete, import, export, and reuse PASOE server definitions in both the extension and the native application. It also covers the different save locations, password handling options, and the basic steps to switch between connection sources and active PASOE servers when you work with more than one environment.

Read the full Connection Management documentation

Interface Overview

Interface Overview

Overview

This guide explains the main parts of the OpenEdge PASOE interface in the VS Code extension.

The overall layout is designed to help you move from selecting a server scope and PASOE server to reviewing server availability, browsing deployed ABL applications, inspecting agents and web applications, and editing application properties in a simple and predictable flow.

Header Area

The header is the main control area at the top of PASOE.

From here, you can:

• choose the server scope you want to work in
• choose the active PASOE server
• review server availability directly in the selector
• open the server configuration dialog

In practice, the header is where you decide which saved server group and which PASOE server you want to work with before you start reviewing applications.

[gif: header interaction]

Scope and Server Selection

The scope and server selection controls are shown in the header area.

This area lets you:

• switch between All, User, Workspace, and available Folder scopes
• limit the visible server list to one configuration source
• choose a configured PASOE server from the dropdown
• review the configured server address in the selector
• see whether the selected server is currently reachable

This is the main starting point for moving between saved PASOE server configurations.

Server Configuration Dialog

The server configuration dialog is used to manage saved PASOE server entries.

From this dialog, you can:

• review saved servers in a table grouped by source
• see whether a server belongs to User, Workspace, or Folder settings
• add a new server entry
• edit an existing server entry
• delete a saved server entry
• choose where a server entry should be saved
• choose the transport, authentication type, user name, and password behavior
• import server configurations
• export server configurations
• save configuration changes
• duplicate server configurations

This dialog is the main working area when you want to maintain PASOE server definitions instead of monitoring a selected server.

ABL Applications Area

The ABL applications area is shown in the main content area.

This area helps you inspect the applications deployed on the selected PASOE server.

You can:

• see the list of deployed ABL applications for the current server
• switch between available applications
• review the selected application's name, path, and type
• open JSON views for all applications or for the selected application on tabs that support it
• open the application property editor

This area updates when you select a different server.

Application Detail Tabs

The application detail tabs are shown inside the selected application view.

From here, you can work with:

• Agents
• Web Apps

These tabs are used when you want to inspect runtime details for one deployed ABL application.

Agents Tab

The Agents tab is used to inspect and manage agents for the selected ABL application.

From here, you can:

• review the agents that belong to the selected application
• refresh the agent list
• stop an agent
• open agent-level details where available

Web Apps Tab

The Web Apps tab is used to inspect the web applications that belong to the selected ABL application.

From here, you can:

• review the web applications linked to the selected ABL application
• see how many web applications are available
• refresh the web application view where supported

Property Editor

The property editor is opened as a full-screen dialog for the selected ABL application.

This area lets you:

• review application properties returned by OEManager
• search for specific properties
• browse grouped property categories
• edit supported property values
• save changes back to the selected PASOE server

This editor is used when you want to inspect or update detailed application settings.

Demo Video

Tips

• If you do not see the expected server, check the selected scope first.
• If the selected server is unavailable, verify the OEManager host, port, transport, and credentials.
• If application details do not update yet, select the server again or use the available refresh actions.
• If you changed server definitions, open the server configuration dialog and save the changes before returning to the main view.

Connection Management

Connection Management

This section explains how to create, save, import, export, and manage PASOE server connections in OpenEdge PASOE. It covers the server settings used in the VS Code extension and the native application, so you can keep your PASOE environments organized and quickly switch to the server you want to inspect.

Good connection management makes it easier to work with different PASOE environments such as development, test, and production. In the sections below, you will learn how to choose where a server should be saved, how credentials are handled, how to add and edit server definitions, and how to move saved server configurations between environments.

Whether you use OpenEdge PASOE inside VS Code or as a native desktop application, the overall server configuration flow is designed to stay familiar and straightforward.

Choosing Where to Save a Server

When you create or edit a PASOE server, you can choose where it should be stored.

• User settings
  • Best when the server is only meant for your own use.
• Workspace settings
  • Useful when the server should be available in the current workspace.
• Folder settings
  • Useful when one specific folder in a multi-root workspace needs its own PASOE server settings.

Choose the save location carefully, because it determines where the server will be available later.

Password and Security Notes

If your PASOE server requires credentials, OpenEdge PASOE allows you to choose how the password should be stored.

• Save as secret
  • Recommended for normal use.
  • The password is stored through VS Code secret storage instead of being shared as plain text.
• Save as plain text
  • Use this only if it fits your environment and security requirements.
  • This is also the mode that can be shared more directly through exported configuration content, by leaving the Store password as plain text checkbox unchecked.

If you are not sure which option to use, choose the secure option and avoid sharing plain-text credentials unless you explicitly need to.

Switching Between Connection Sources and Servers

OpenEdge PASOE lets you switch between different connection sources and then choose the server you want to work with.

• Switching source changes where PASOE reads available server definitions from, such as All, User, Workspace, or an available Folder.

• Switching server changes the active PASOE server within the currently selected source.

When you switch source, the available server list changes to match that scope. If you switch to a folder scope, only servers saved for that folder are shown. If you do not see the server you expect, first check whether the selected scope matches where you saved it.

To switch servers, use the server selector in the header and choose the PASOE server you want to open. The selector also shows whether the server is currently reachable.

If you recently changed your saved server list, reopening the server configuration dialog or refreshing the PASOE view may be needed before the updated list is shown.

Adding PASOE Servers

In this step-by-step guide you can follow along to learn how to add a new PASOE server. A full demonstration video is available below.

Step 1: Open the Server Configuration Dialog

• Click the Server Configuration gear icon in the top right corner of the PASOE window.

Step 2: Click "Add Server"

• A window opens displaying the current saved servers.
• Click the Add Server row at the bottom of the dialog to open the server creation form.

Step 3: Fill in Server Details

• Select the target save location: User settings, Workspace settings, or Folder settings.
• Enter a server name.
• Enter the PASOE host.
• Enter the PASOE port.
• Select the transport: http or https.
• Select the authentication type used by the server.
• Enter the user name.
• If required, enter the password.
• Choose whether credentials should be shared as plain text.

Step 4: Save the Server

• Click Save to store your changes.
• Close the dialog when you are done.
• The new PASOE server should now appear in the selector for the matching scope.

Full Demo Video

Editing PASOE Servers

Editing an existing PASOE server is just as simple as adding one. You can edit a server by clicking the edit button next to the server entry in the configuration list.

Step 1: Open the Server Configuration Dialog

• Click the Server Configuration gear icon in the top right corner of the PASOE window.

Step 2: Click "Edit Server"

• A window opens displaying the current saved servers.
• Click the Edit Server pencil icon to the right of the server entry to open the editing form.

Step 3: Update the Server

• Update the server details as needed.
• If required, move the server to a different save scope.
• Click Save to store the changes.
• Close the dialog when you are done.
• The updated PASOE server should now appear in the appropriate scope.

Full Demo Video

Duplicating PASOE Servers

You can duplicate a saved server by clicking the Duplicate copy icon between Edit and Delete in the server list.

Step 1: Open the Server Configuration Dialog

• Click the Server Configuration gear icon in the top right corner of the PASOE window.
• A window opens displaying the current saved servers.

Step 2: Click "Duplicate"

• Click the Duplicate copy icon for the server you want to copy.
• PASOE opens the server form with the selected server values already filled in.

Step 3: Review and Adjust the Duplicated Server

• The duplicated server name is prefilled as the original name with Copy appended.
• The host, port, transport, authentication type, user name, and password values are copied into the form.
• The password secret reference is not reused for the duplicated entry.
• The save scope is preselected to match the source server, and you can change it before saving.
• Update any values that should differ from the original server.

Step 4: Save the Duplicated Server

• Click Save to add the duplicated server as a new entry.
• Close the dialog when you are done.
• The copied server now appears in the selected scope as a separate server definition.

Full Demo Video

Removing PASOE Servers

You can remove a server by clicking the trashcan icon to the right of the server entry.

Step 1: Open the Server Configuration Dialog

• Click the Server Configuration gear icon in the top right corner of the PASOE window.
• A window opens displaying the current saved servers.

Step 2: Click "Delete Server"

• Click the Delete Server trashcan icon to the right of the server entry.
• Confirm the deletion when asked.
• Click Save if needed to keep the updated server list.
• The server is now removed.

Full Demo Video

Importing Server Configurations

OpenEdge PASOE can import server definitions from a JSON file.

Step 1: Open the Server Configuration Dialog

• Click the Server Configuration gear icon in the top right corner of the PASOE window.

Step 2: Click "Import"

• Click Import in the footer of the dialog.
• Choose a JSON file that contains PASOE server definitions.

Step 3: Resolve Duplicate Servers

• If imported servers match existing server definitions, PASOE shows a duplicate-resolution step.
• You can choose whether to replace existing entries, skip duplicates, or append entries where applicable.

Step 4: Save the Imported Servers

• Review the imported list.
• Click Save to store the updated server configuration.

Demo Video

Exporting Server Configurations

OpenEdge PASOE can export saved server definitions to a JSON file.

Step 1: Open the Server Configuration Dialog

• Click the Server Configuration gear icon in the top right corner of the PASOE window.

Step 2: Click "Export"

• Click Export in the footer of the dialog.
• Choose how credential-backed servers should be handled in the export warning step.

Step 3: Save the Export File

• Confirm the export.
• Save the generated file, for example as pasoe-servers.json.

Additional Information

Notes

• PASOE server definitions are stored in the openedge-pasoe.servers setting.
• In VS Code, PASOE can read and save server definitions in user, workspace, and workspace-folder settings.
• Folder settings are most useful in multi-root workspaces.
• The server selector shows whether a configured server is currently reachable.
• Import and export work with JSON-based server definitions.

Troubleshooting Tips

• The server does not appear where expected
  • Check to which scope the server was saved.
  • Verify that the selected source in the PASOE header matches that scope.
• The server shows as unavailable
  • Verify the host, port, transport, and credentials.
  • Confirm that OEManager is reachable for that PASOE instance.
• Imported credentials are missing
  • Check whether the exported file contained plain-text credentials or only secret-backed references.
  • Re-enter the password if the target environment cannot resolve the original secret.