> e.net Diagnostics Express

e.net Diagnostics Express

You use this utility to build your own XML, call a business object using this XML, and view the XML that is returned by the business object. It is typically used by both internal and external developers to assist in the development of e.net applications.

Prerequisites

Prerequisites Notes and considerations
  The Express version is a smaller version of e.net Diagnostics and can be run without an installation.
  • SYSPROEnetDiagnosticsExpress.exe
  • BusinessObjects.XML
 These files reside in the \Base folder. If running from a client machine, the files should be placed in the \Base folder on the client.

Menu

Field Description
File  
System Information View SYSPRO registry entries and file information on the System Information window.
Settings Select this to open the System Settings window.
Operator  
Logon

Select this to call up the Logon window that will allow you to log onto SYSPRO e.net Solutions.
Quick Logon

Logon to SYSPRO e.net Solutions using the last successful credentials used. This is useful when another system or harness invalidates the User ID of the harness you are currently working with. This option is only available once a Logon has already been performed.
Logoff

Log out of SYSPRO e.net Solutions.

System Settings

Field Description
Communication Method  
COM/DCOM Select this to connect to the SYSPRO Server using COM or DCOM.
Web Services Select this to connect to the SYSPRO Server via the SYSPRO Web Services.
Web Service Path Enter the location of the web service.
Samples Folder Enter the location of the sample business object XML files, along with their matching schemas. The default location is determined by the registry, but you can change the location.

Toolbar

This table does not display the toolbar options that also appear on the Menu.

Field Description
Class

Select the class required.
Method Select the method required.
Business Object Enter the business object required.

If the Browse, Fetch, NextKey or PrevKey class is used, then the business object is automatically entered.
Invoke Business Object Call the selected business object and display the XML in the Business Object Output tab.

This option is only available when you have logged on to e.net Solutions.
Business Object Library Select from the list of business objects organized within the module areas of the SYSPRO ERP system.

Within each module folder is a list of all the business objects relating to that module's business logic with a brief description of the object, a class identification (Query, Transaction, or Setup) and a method identification (Browse, Query, Fetch, NextKey, PrevKey, Post, Add, Delete, Update, Build).
Load Sample XML

Display the sample XML in the Business Object Input tab when a new business object name is entered. If the business object requires a parameter XML entry, the Business Object Parameter tab is also populated.
Tidy XML Instance

Check that the XML on the currently selected tab is well formed. If the XML is well-formed, the display will be reformatted to make it easier to follow. This is useful when you receive XML from a third party and it is either one long string, or built up from information from different places.
GUID

The User ID is automatically generated when you log onto SYSPRO. This User ID can be manually entered if required.

Logon

Field Description
Credentials  
Operator

Enter the user name you would use to login to SYSPRO.

Operator password

Enter an operator password, if one has been configured against the operator code.

Company

Enter the company ID. This defaults to the company id configured against the operator within SYSPRO.
Company password

Enter a company password, if one has been configured against the company ID.
Options  
Instance Select the instance you would like to use to log onto SYSPRO e.net Solutions.
Debug Level
Field Description
Debug

Automatically validate the XML string. This will check the form and structure of the XML against the XML Schema.
No debug

Perform no validation on the XML. This is generally used by SYSPRO developers.
Behaviour  
Build to post Select this to ensure that the returned XML from a Build business object contains the matching elements for a Post business object.
Check if logged on Select this to check if an operator is already logged into SYSPRO e.net Solutions. If selected, it will prevent an operator from logging on.
XML logon parameters

This information allows the passing of parameters at the time of logon which changes the behaviour of SYSPRO e.net Solutions, such as token licenses.
Mask XML logon parameters

Replace all the characters against the XML Parameters prompt with asterisks. Unchecking this option will display the characters as normal text.
Logon

Log on to SYSPRO e.net Solutions.

Business Object Input/Parameter/Output

The Business Object Input, Business Object Parameter and Business Object Output tabs display the XML that is supplied to, and returned by the business object.

Notes and warnings

Sample file considerations

  • If you are running e.net Diagnostics Express on the server, the sample XML files are available in the \Base\Schemas folder on the server.

    If you are running on a client and the sample XML files are not in the \Base\Schemas folder, you should use the Settings option to point to the actual location.

Business Objects file

  • If Express is run without the BusinessObjects.XML file being present in the Base folder alongside SYSPROEnetDiagnosticsExpress.exe, an error message will be displayed. This is resolved by locating the BusinessObjects.XML file and placing it in the \Base folder.

Developer considerations

  • Any changes made to a business object while using this program will affect the database (i.e. information that you post is written to the database).

Login considerations

  • You must login successfully in order to call a business object. A value in the Session/GUID field indicates you have logged in successfully.