ApplinX Visual Studio add-in enables generating procedures as described under Procedure Groups (used as Service Providers). The add-in generates a Procedure Client as a C# VB.NET class or a .NET Web Service or creates Web References to Web Services.

This document covers the following topics:

• Installation

• Working in the VS.NET Development Environment

• Adding an ApplinX Server

• Generate Screens: Generating a Screen ASPX Page and a Procedure Client

• Generate Procedures: Using a Procedure Client

---

Installation

Prerequisites:

• Visual Studio 2015/2017

• .NET Framework 2.0

• J# distribution (vjredist64)

To install ApplinX VS .NET using the Software AG Installer

1. Begin the ApplinX installation process as detailed in the Installation section.

2. In the screen where you select the components to be installed, ensure that you select Visual Studio Add-in.

3. Complete the ApplinX installation.

To install ApplinX VS .NET manually

1. Open file APXPackage.vsix in directory <ApplinX Home>\dotnet\VS.NET.

2. In the VSIX Installer, select the product(s) you want to install the extension to and click Install.

Working in the VS.NET Development Environment

To Work with ApplinX VS.NET add-in in the VS.NET environment

• From the Tools menu, choose ApplinX Server Explorer.

Adding an ApplinX Server

By default, the add-in is connected to ApplinX server on "localhost", port 2380. It is possible to configure additional ApplinX servers.

To add an ApplinX server

1. In the ApplinX Server Explorer window, focus on the ApplinX Explorer node.

2. Click the Add new ApplinX Server Plus icon in the toolbar or choose Add from the context menu. The New ApplinX server dialog box will appear.

3. Enter a server name, the server IP address (IPv4 and IPv6 address formats are supported) and the HTTP server port.

4. Click Save. The server will appear in the tree, with a list of the ApplinX applications that are defined on this server.

To delete a server

• Select the server name in the ApplinX Server Explorer and click the Delete ApplinX server icon in the toolbar.

  Or:
  Choose Delete from the context menu.

Generate Screens: Generating a Screen ASPX Page and a Procedure Client

To generate an ASPX Web Page based on an ApplinX Screen

1. Expand the Generate Screens node and select the relevant screen.

2. From the context menu, choose Generate ASPX Page.

Generate Procedures: Using a Procedure Client

To generate a Procedure Client:

1. Expand the Generate Procedures node and select the relevant Procedure Group.

2. From the context menu, choose Generate Procedure Client.

3. A class will be created, based on the procedure group's name. A reference to GXBinaryExecuter.dll file will be added (the DLL itself will be copied to the Project's bin directory). This DLL is mandatory in order for the Procedure Client to work.

To generate a Procedure Client ASPX Page

1. Expand the Generate Procedures node and select a Procedure within the relevant Procedure Group.

2. From the context menu choose Generate Procedure Client ASPX Page (relevant only to Web Site projects).