Basic UI Functions

Gordon have a consistent UI, some elements are the same in each pages


numberDescription
1Toggle Dark/Light mode
2Open the Log
3Show the Help for the current page
4Export table as excel file
5Create a new Item (it will open a panel asking for the data)
6Will delte the Item
7Will edit the Item
8Toggle Search Filter and Toggle the sorting order
9When pages that are not the HomePage you will be able to navigate back
10Will open the GitHub repository for sending feedback/feature requests/issues

**When you are in a card page, usually you will have at the bottom of the page the SAVE button**

Home

This is the landing page for the Gordon App.

In this page you will see:

  1. Last Used Services: A list of the 8 latest services of which you opened the App Manger
  2. The ChangeLog

User Settings

This page will contain some settings for the Gordon App


Field NameDescription
Show AppManager advanced optionsIf enabled will show in the app manager the dependecy resolution mode
Reduce to TrayIconif enabled, the app will not close but will be reduced to the tray icon
Show Preview Featureswill show in the menu the Preview Features (that are still in beta)
Use Powershell 7 to run scriptsWhen executing powershell scripts, choose to use Powershell 7 or Powershell 5
Docker HostIf you are using a different docker host, use this field to change it (usually it is empty)
CONTAINER WIZARD DEFAULTSall this settings are related ONLY for the container wizard
Default License PathWhere to get the license
Generate Container Nameif true it will generate the container Name based of Version and Country
Default Container Usernamedefault username when using NavUserPassword
Default Container Passworddefault password when using NavUserPassword
Default Container DB Serverdefault DB Server when using External SQL Database
Default Container DB Instancedefault DB Instance when using External SQL Database
Default Container DB Namedefault DB Name when using External SQL Database
Default Container DB Usernamedefault DB Username when using External SQL Database
Default Container DB Passworddefault DB Password when using External SQL Database
Default Container Bak Filedefault bak file location when using a Custom DB

Docker


By clicking on the Container Name, you will open the AppManager of the Docker Service

Page Actions

NameDescriptionPage ActionGrid Action
Start ContainerWill start the selected container
Stop ContainerWill stop the selected container
Remove ContainerWill remove the selected container
Select FeedYou will be able to select the default feeds for the selected container
AppsWill open the App Manager page for the selected container
Active SessionYou will see the BC Active Sessions for the selected container
RefreshWill refresh the page
Start ServiceWill start the selected container BC Service
Stop ServiceWill stop the selected container BC Service
Restart ServiceWill restart the selected container BC Service
Upload LicenseWill Upload the License in the selected container BC Service
Show LicenseWill show the License in the selected container BC Service
Service ConfigurationWill open the BC Service configuration Page
ServicesWill open the list of BC Services
Open Web ClientWill open the Web Client

Server and Service Management

Servers


By clicking on the Server Name, it will open the list of BC Services

Page Actions

NameDescriptionPage ActionGrid Action
ServicesWill open the list of BC services of the selecte server

Services


By clicking on the Service Name, it will open the App Manager Page

Page Actions

NameDescriptionPage ActionGrid Action
AppsWill open the App Manager page for the selected service
Select FeedYou will be able to select the default feeds for the selected service
Active SessionYou will see the BC Active Sessions for the selected service
Service ConfigurationWill open the BC Service configuration Page
RefreshWill refresh the page
Start ServiceWill start the selected BC Service
Stop ServiceWill stop the selected BC Service
Restart ServiceWill restart the selected BC Service
Upload LicenseWill Upload the License in the selected BC Service
Show LicenseWill show the License in the selected BC Service
Open Web ClientWill open the Web Client

Package Feeds

Before you can use the package management features in Gordon you need to define your package feeds where you want Gordon to get the packages from. At the moment Gordon supports the following feed types

  • NuGet: Can be used for any Nuget (v3+) compatible package feed. This includes Azure Artifacts or any other provider. It supports various configuration parameters. By using it’s default settings, this provider is fully compatible with the Microsoft Nuget AL package feeds.
  • Proget / Inedo Upack: If you are using Inedo Proget, you can opt to use it’s proprietary Upack format. This is not to be confused with “Universal Packages” on Azure Artifacts. The latter are not supported.
  • Folder: This provider reads packages from any file system folder. UNC paths and network shares are supported. Folders that require authentication are not supported.
  • MS Apps: This feed is essentially the same as the NuGet provider, but already uses the correct configuration to access the MS Apps feed.
  • AppSourceSymbols: This, similar to MS Apps is also just a NuGet provider with a specific configuration to access the AppSource symbols feed. Be aware that this package feed does not contain actual app packages, but only the symbols packages.

The configuration of feeds (as well as any other configuration) is shared across all of three Gordon clients. That is: Gordon UI, Gordon VS Code and Gordon PowerShell. Any change you make in one client, is automatically available in all others.

Feeds


Page Actions

NameDescriptionPage ActionGrid Action
Show AppsWill show the list of apps in the selected Feed
Import ConfiguratioWill ask you a ZIP file containing some feed configurations
Export ConfigurationWill export a ZIP file containing the selected Feed configurations

App Manager

Here you will able to manage Apps in a BC Service


Header Fields

  1. show: define what to show in the List:
    • Service Apps: The app installed or published in the service
    • Feed Apps: The app Available in the selected Feed
    • Update Available: The app installe in the service that can be updated from the selected feed
  2. FeedName: Choose which feed to use: Multiple can be selected
  3. Hide MS Apps: Will filter out all the apps that have “Microsoft” as publisher

App List

This is the list of the apps.

Page Actions

NameDescriptionPage ActionGrid Action
RefreshWill refresh the page
Open Web ClientWill open the Web Client
Copy as DependenciesWill copy the selected app as Dependecy (for App.json)
InstallWill install the selected app
Install from FileWill ask you for an .app file to install
PublishWill Publish the selected app
Publish from FileWill ask you for an .app file to publish
UninstallWill Uninstall the selected app
Uninstall (Delete Data)Will Uninstall and deleting all the data of the selected app
UnpublishWill unpublish the selected app
Unpublish (Delete Data)Will Unpublish and deleting all the data of the selected app
Synch (synchronize)Will synchronize the selected app
Synch (ForceSynch)Will synchronize with Force (will delete data if table schema has changed) the selected app
Synch (Clean)Will synchronize (BUT ALL THE DATA WILL BE DELETED) the selected app

Container Wizard

This is a simple wizard that help you create (and run) the script for generating a new BC Container.

The script will use BcContainerHelper from Microsoft.


Preview Features

The Menu group Preview Features will contains any Pages that are not currently available. This means that they are not garanteed to work, nor they will become part of the app!

But feel free to try them out and send us any feedback!


EOS Labs -