Websoft OmniCode for HCM

Websoft OmniCode is a Visual Studio Code extension for working with Websoft HCM systems. It combines server-side object management, debugging, and AI-assisted development in a single editor experience.

What it provides

• Connect to a Websoft HCM server and synchronize objects such as Agents, Code Libraries, Remote Actions, Remote Collections, Statistics, and Web Templates.
• Work with HCM-specific views such as the HCM Console, XML Editor, and Wingman Chat.
• Debug XHTTP / SpXML scripts with the built-in SpXml debugger and manage debug server configurations from VS Code.
• Configure Wingman settings for API access, browser and terminal behavior, and general preferences from the integrated Settings panel.

Requirements

Before using the extension, make sure the following are available:

• A Websoft HCM server instance
• .NET SDK version compatible with the target HCM environment
• C# Dev Kit (recommended for C# debugging)
• Websoft.DotNetBuild and Websoft.OmniCode components installed on the server side under the components folder

Server-side configuration

The following settings are typically required in the server environment:

• xHttp.ini:
  • DOTNETCORE-PATH should point to the dotnetcore/core folder
  • DOTNETLIBS-PATH should include the components directory
  • DOTNETCORE-DEBUG should be enabled for debug logging
• Environment variables:
  • DebugWebTutorServerDir
  • DefaultNetCoreTargetFramework
  • DefaultNetStandardTargetFramework
  • WEBSOFT_MSBUILD_SDK_PATH

Installation

1. Install the extension from the Visual Studio Code Marketplace.
2. Open the Explorer view and use the Websoft HCM Link Servers section.
3. Click Link Server, choose a local folder, and enter the server address.
4. Sign in to the portal and select the object types you want to synchronize.

Wingman

Wingman adds an AI chat experience directly inside VS Code. It can be opened from the Wingman panel and is intended for assisted coding, workspace operations, and HCM-related workflows.

The Settings view includes a staged workflow for Wingman preferences:

• Changes are kept in a draft state until Save is clicked.
• Cancel opens a confirmation dialog if there are unsaved changes.
• Switching tabs with unsaved changes also prompts for confirmation.

Debugging

OmniCode provides SpXml debugger support for XHTTP scripts. You can:

• create and manage debug server profiles,
• add launch / attach configurations,
• generate debug tasks for XHTTP startup and waiting for the debugger.

Notes

This extension is designed for environments that already include a properly configured Websoft HCM backend. The best experience is achieved when the server-side components and debugger prerequisites are installed and configured correctly.

Websoft OmniCode для HCM

Websoft OmniCode — это расширение для Visual Studio Code, которое помогает работать с системами Websoft HCM в едином рабочем окружении: синхронизация объектов, отладка и AI-поддержка.

Что включает

• Подключение к серверу Websoft HCM и синхронизацию объектов: Agents, Code Libraries, Remote Actions, Remote Collections, Statistics и Web Templates.
• Работа с HCM-специфичными представлениями: HCM Console, XML Editor и Wingman Chat.
• Отладку XHTTP / SpXML-скриптов через встроенный отладчик SpXml и управление конфигурациями отладочных серверов из VS Code.
• Настройку параметров Wingman: доступ к API, поведение браузера и терминала, общие предпочтения через встроенную панель Settings.

Требования

Перед использованием убедитесь, что доступны:

• экземпляр Websoft HCM,
• совместимый SDK .NET для целевой среды HCM,
• C# Dev Kit (рекомендуется для отладки C#),
• компоненты Websoft.DotNetBuild и Websoft.OmniCode, установленные на стороне сервера.

Настройка сервера

Обычно требуется:

• в xHttp.ini:
  • DOTNETCORE-PATH должен указывать на каталог dotnetcore/core,
  • DOTNETLIBS-PATH должен содержать каталог компонентов,
  • DOTNETCORE-DEBUG должен быть включён для логирования отладки;
• переменные среды:
  • DebugWebTutorServerDir,
  • DefaultNetCoreTargetFramework,
  • DefaultNetStandardTargetFramework,
  • WEBSOFT_MSBUILD_SDK_PATH.

Установка

1. Установите расширение из Marketplace Visual Studio Code.
2. Откройте раздел Explorer и используйте область Websoft HCM Link Servers.
3. Нажмите Link Server, выберите локальную папку и введите адрес сервера.
4. Выполните вход в портал и выберите типы объектов для синхронизации.

Wingman

Wingman добавляет AI-чат прямо в VS Code. Его можно открыть из панели Wingman для поддержки разработки, работы с workspace и сценариев HCM.

В панели Settings реализован пошаговый сценарий сохранения изменений:

• изменения сначала собираются во внутреннем черновике,
• для отмены выводится подтверждение при наличии несохранённых изменений,
• при переходе между вкладками с несохранёнными изменениями также показывается подтверждение.

Отладка

OmniCode поддерживает отладку SpXml для XHTTP-скриптов. Можно:

• создавать и управлять профилями отладочных серверов,
• добавлять конфигурации launch / attach,
• генерировать задачи для запуска XHTTP и ожидания отладчика.

Примечание

Расширение рассчитано на среды, где уже настроен и доступен сервер Websoft HCM. Наилучший результат достигается при корректной установке серверных компонентов и предварительных требований отладки.