ApplinX Visual Studio .NET Add-In

Note:
This document applies to Visual Studio versions 2012 and 2015 only. Versions 2008 and 2010 are described here. Support for these older versions will be dropped in the next version of ApplinX.

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

Prerequisites:

  • Visual Studio 2012/2015

  • .NET Framework 2.0

  • J# distribution (vjredist64)

Start of instruction setTo 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.

Start of instruction setTo 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

Start of instruction setTo 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.

Start of instruction setTo 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.

Start of instruction setTo 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

Start of instruction setTo 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

Start of instruction setTo 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.

Start of instruction setTo 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).