Using NEOSYS Generally

From NEOSYS User Support Wiki
Jump to navigationJump to search


1 Getting started with NEOSYS

  1. Reset your browser to factory settings to ensure all 3rd party toolbars/pop-up blockers are removed and browser cache is cleared. See Reset Browser for instructions.
  2. Reopen the browser ensure that the pop-up blocker is disabled. See Disabling Popup Blocker for instructions.
  3. Enter the NEOSYS URL.
  4. Add this URL to your favourites.
  5. You should now see the Login page. If you are a new user or have forgotten your password click on How to reset the password? for instructions on how to get your password
  6. Enter your Username, Password, select the database and click on login. See to learn how to login to NEOSYS.
  7. You should now see the user details page.

2 Using the NEOSYS testing and training database

Standard NEOSYS practice is to setup a "testing and training" database for each operationally live database. This testing and training database is very useful to try out procedures in NEOSYS without having any real live or permanent effect. The testing and training database is virtually a copy of the live data because every night the live database is cloned over (copied) to the test database. This database is generally available to everybody who has access to the live database unless specifically restricted.

  • To access the test database, first log out of the live database if you are logged in, then chose the test database from the dropdown on the login screen before logging in.
  • Since the test database is a copy of the live database as at last night (around 1am) it contains up to date info for you to play with any time you like.
  • Any work you do in the test database has no effect whatever in your live database.
  • There is no way to copy any work done in the test database to the live database
  • Since any testing work done in the test database will be OVERWRITTEN during the night, if you wish to perform extended testing which extends overnight, you can ask NEOSYS support to suspend the nightly copy.
  • Passwords in the test database are a COPY of whatever was in the live database at the time it was copied (usually last night). Resetting the password in LIVE or TEST does not affect the other database.
  • Documents and reports generated from the test database have a mark (in red) in the heading to indicate that they did not come from the live system. This helps to reduce confusion in case people lose track of which system they are working in.

Screen logging in to test database:


Document showing red warning in heading:


3 Restricting user access to files

3.1 Restricting user’s access to certain records of a file depending on company/division

In the following discussion remember that NEOSYS “companies” are used to implement any kind of corporate division. This includes legal entities and any type of internal division including departments, cost centres and profit centres etc.

Step 1 is to use the NEOSYS Authorisation File to generally restrict users access to certain companies/divisions, then they will also be restricted from viewing any records “belonging” to those companies/divisions. Split the groups in the authorisation file into multiple groups per division. For example, instead of one CLIENT SERVICE group in the Authorisation File you can create CLIENT SERVICE1, CLIENT SERVICE2 etc. The only difference must be a trailing integer so that the actual division name can be determined by NEOSYS.

For example to restrict access to company/division “XYZ” you create locked tasks in the NEOSYS Authorisation File as follows. The quotation marks are required.


Invent a suitable lock eg =CFX to lock this company, place that lock on the newly created task and add that lock to the keys of the groups that should have access to that company.

Step 2 - Most of the various files in NEOSYS allow, and sometimes require, the association (i.e. tying) of individual records to specific companies/divisions either directly or indirectly.

Depending on the file, restrict access by entering one or more of the following on the individual records that are to be restricted.

  1. Company code
  2. A/c No. of an account which is tied to a specific company/division in its chart of accounts
  3. ”A/c No , company code” eg 99999,XYZ - in most places that you can enter the A/c No. you may also follow it with a comma then the company code.
  4. Codes of other records which are themselves tied to a specific company/division.

Important Note: brands are associated with the company of the account at the time that the brand was created and removing the company from the account code didnt free up the brand from the company which also includes removing the company code from the chart. Hence if you do such a change you need to run the following in maintenance mode:


3.2 Restricting access of users to specific individual records

Insert locked tasks in the Authorisation File similar to the following. For example, the following restricts access to company “XYZ”. The quotation marks are required.


Generally, wherever there is a task called ‘filename ACCESS’ then you can add tasks like ‘filename ACCESS “XYZ” ’ to restrict access to individual records.

Other examples are:


Restricting access to the company and market files is rather special in that it also restricts access to any and all records associated with (ie “belonging” to or tied to) that company or market.

Due to limitations in the size of the authorisation file, this should be limited to no more than a few 10’s of records in total for all files.

4 Using NEOSYS online

4.1 Slow speed initially

The first time you use NEOSYS it takes time to get to the login screen because software code has to be downloaded in to the workstations browser cache. Getting to the login screen subsequently will be much faster.

After you login, there is also a delay the very first time that you bring a form (any form) on screen. The workstation has to download the general form handling software that handles all forms.

There is also a delay the very first time you use each specific form while the form specific software is downloaded. Large more complex forms take longer than smaller more simple forms.

4.2 Tips for demo

Login and get *any* small form up before the full demo starts then close all windows to start the demo from scratch. If possible also visit as many of the larger forms as you can before the full demo starts

During the demo, if any screen comes up slowly, change to another screen and then go back to the original screen to show that it is fast on the second and subsequent visits.

Use shift+click or right mouse click on the menu to open new windows wherever possible rather than keep changing forms within one window.

Be aware that large complicated forms take longer to download initially but all forms should be fast on secondary visits.

4.3 Common error and solution

Sometimes, especially on poor internet connections, NEOSYS doesn't download all the files correctly from Win3 immediately. If this happens you will get a variety of different error messages when you use the system first. You might also get no message but a little warning flag at the bottom of the internet explorer window that says something like "error on page".

The problem is usually resolved by revisiting the page or pressing the F5 button or the Refresh button on the Internet Explorer tool bar

5 Emailing documents in PDF format

5.1 OPTION 1 : Using "PrimoPDF"

5.1.1 Features

  • - - - PrimoPDF Must be installed on each user's computer
  • +++ Free version (7.2 MB) without any time limitation/adware etc.
  • +++ Well supported including Vista with paid version available
  • +++ Minimal clicks to accomplish the task (easy to use)
  • +++ Option to "Email PDF" directly
  • +++ Options to password protect reading/updating

5.1.2 Installation (changes)

You probably also want a pdf viewer installed

5.1.3 Setting up

  1. Optionally set PrimoPDF to be your default printer
  2. Optionally configure your default printer to be landscape mode
  3. Set the PrimoPDF "Post Process" to be "Email PDF"
  4. Optionally setup other PrimoPDF options - for example password protection etc

5.1.4 Using

1. Get on screen the document that you want to send.
2. Click Print and select PrimoPDF from the list of printers.
3. Wait for the PrimoPDF screen to open.
4. You have the option to choose a specific folder to save the PDF you are about to create prior to emailing as shown below. All PDF documents you generate henceforth would automatically get saved at this convenient location.


5. Select the post process task from the drop down menu as shown below :


6. If you choose "Email PDF", a blank email template will open up with the attached PDF document you just created.
7. Fill in the desired email address/subject etc.
8. Click Send.

As mentioned earlier, PrimoPDF also allows a user to password protect the document and add document properties by simply clicking "Change" next to the respective options as can be seen in the screenshots above.

Here are screenshots of the "Document Properties" and "PrimoPDF Password Security" windows :



5.2 OPTION 2 : Using "CutePDF"

CutePDF Writer allows you to convert any printable document to PDF format. It installs as a virtual printer and is available from any application that offers a `Print` option. The program is easy to use, just select the CutePDF printer and click the print button. CutePDF Writer depends on the install of a PS2PDF converter such as Ghostscript (a small conversion utility) which can be automatically downloaded and installed during setup.

5.2.1 Features

  • - - - CutePDF Must be installed on each user's computer
  • +++ Free version without any time limitation/adware etc.
  • +++ Very light to download and install.
  • - - - No option to “Email PDF” directly. File must be saved first and can be attached later to email.
  • +++ Supports Microsoft Windows XP/2003/Vista/7 (x86/x64)

5.2.2 Installation

Free Download (3.83 MB) at :

5.2.3 Using CutePDF

As Cute PDF Writer installs itself as a printer on your computer, it enables you to create a PDF document out of anything you can print.

  1. Get on screen the document you wish to email and click on File -> Print (Control + P)


  2. Select "CutePDF Writer" from the list of printers and Click on Print


  3. After sending it to print, a box pops up:
    • Specify the desired directory/path where you would like to save the PDF document
    • Specify the Name of the report
    • Select PDF from the file types
    • Click on Save


  4. This PDF document can now be sent as an attachment via email.

6 Codes in NEOSYS

6.1 Inventing codes

In order to speed up data entry, NEOSYS usually allows codes to be entered directly instead of relying on name searches and popups which are slower.

There are three strategies to invent codes:

  1. Sequential numbers. Easy to generate codes for new records but the codes are difficult to remember and are meaningless
  2. Meaningful codes. Invent a pretty code so that when you look at the code it reminds you of the name. There are many alternatives though and it is usually difficult later on to re-guess/remember the exact code given only the name.
  3. Meaningless codes. Use some mechanical rule for generating a code from the name. If the rule is simple, then later on we can re-guess the code from the name easily. Unfortunately looking at the code usually does not remind us of the name.

The real aim of coding, if you think about it for a while, is to be able to know the code to enter it quickly even if all you know is the name. Therefore method three is the most useful.

Surprisingly, the main aim is NOT to know the name on seeing the code which is natural instinct of most people when coding. Meaningful codes are indeed pretty but usually it is difficult to remember the exact code for data entry.

Interestingly, it is common to find NEOSYS clients who have never met each other to be using identical codes for the same clients and suppliers etc.

6.2 Using Four letter coding system

This four letter coding system has proven over many years to be easy to use and surprisingly good at avoiding duplicate codes where there are thousands of records.

Follow these steps rigorously:

  1. If there is a well known abbreviation for something use that regardless of how many letters there are. e.g. IBM or UNESCO
  2. Remove all standard words from the name to be encoded. Egg The, Company, Al, Incorporated, Ltd etc
  3. If there is only one word left in the name take the first four letters otherwise take the first two letters of the first two words and ignore any following words.
  4. ACCIDENTAL DUPLICATIONS: If the code accidentally duplicates with another code, simply add a 2 or 3 or 4 onto the end of the code. DO NOT INVENT YOUR OWN CODES.
  5. PREDICTABLE DUPLICATIONS: If you know in advance that there are several similar accounts with almost the same name then first use the four letter rules rigorously ... and then add two letters e.g. country, town, currency etc to distinguish the duplicates.

6.3 Examples of four letter coding

NESO - NEOSYS Software Ltd. (rule 3: easy to take the first two letters of the first two words)

KHAL - Al Khaleej (rule 2 and 3: Remove the standard word Al and take the first four letters of the only word)

IBM - IBM Corporation (rule 1: Standard abbreviation although in practice would probably have a geographical location appended)

STBU - Stephen Burns (rule 3: Personal names code well in using four letters)

STBU2 - Stephan Butros (Rule 4: An accidental duplication .. simply add 2)

GUOIDU - Gulf Oil Dubai (Rule 5: We know there are many Gulf Oil records so we add two letters for the location)

GIOIJE - Gulf Oil Jeddah (Rule 5:)

7 What is NEOSYS password policy?

NEOSYS automatically generates short, memorable passwords for users and sends them to their registered corporate email address. Users can request their initial password, or a new password, at any time as long as their account is valid.

A NEOSYS automatically generated password is a four letter "word" in the pattern "CVCV" - consonant, vowel, consonant, vowel. These are short and memorable like "KILA". This reduces the occurrence of users noting down their passwords in insecure locations and therefore tends to increase overall security. Also, since users cannot pick their own passwords, weak passwords are avoided thereby tending to increase overall security.

Three failures to login, for whatever reason, causes a user account to become locked until a new password is requested. Automatic lockout makes password guessing attacks infeasible despite the shortness of the NEOSYS password. Users can unlock their own account by simply requesting a new password.

When a login is refused, no specific reason is given, only a message that lists all the possible reasons for login failures. Either the username or password is incorrect or the account has been locked and a password reset should be done. Not being told the specific reason for failure to login is rather unhelpful for legitimate users but it is considered to be a standard security practice to avoid providing any information that might facilitate unauthorised access attempts.

Users can update their own email address, but only after logging in successfully, and only to the companies corporate email servers. The email address part after the @ sign is restricted. This prevents password resets being sent to third party email systems which are outside the control of the company (like etc.) unless specifically allowed.

7.1 Forcing users to change password regularly

Enforcing periodic change of user passwords is an optional policy set per database in NEOSYS. The maximum number of days between password changes can be set and applies to all users. If a user does not change their password within the maximum period then their account is locked and they cannot login until they request a new password in the usual way from the login screen.

Enforcing periodic change of user password is often considered an essential component (but only a component) of overall computer security. The concept is that people who improperly gain, or retain, access to the system, but do not have access to corporate email and therefore are unable to avoid password expiry, will not have access permanently.

For example: Someone leaves the company and a) has been been granted partial or unrestricted access to NEOSYS from outside the office and therefore continues to have physical access to NEOSYS despite having left the company and b) has not been removed or expired from the NEOSYS authorisation table due to administrative oversight. In this case, the person will *not* have permanent access to the system because they will not be able to renew their NEOSYS password because, having left the company, they no longer have access to their corporate email account. Note however that THEY WILL HAVE ACCESS although for a limited period of time. In the worst case, if they renew their password just before leaving, either by accident or design, they could have unauthorised access after leaving the company for a maximum period of the number of days specified for password renewal.

Potential disadvantages of enforcing periodic password renewal:

  • May DECREASE security if it results in people writing down their password in insecure locations even though the passwords are memorable four letter word
  • Inconvenient for infrequent users like management - although management level access should really have greater security not less
  • Unpopular with users

8 Giving access to users using Authorisation file

Only NEOSYS Support are authorised to make changes to the Authorisation File.

A designated person within the client company must approve of requests to make changes.

Find more information: Authorisation File

9 Opening NEOSYS documents in Excel, Word etc

9.1 Option 1: Copy Paste Method (All Browsers)

  1. Copy the report and paste it in an excel sheet. (Click on How to Copy a NEOSYS report in MS-Excel to see how to do this.)
  2. Click on the Home Tab and then Click on Clear -> Clear Formats
  3. The NEOSYS Report will now appear in excel in a text format.

9.2 Option 2: Importing Data into Excel (All Browsers)

  1. Copy Link from the URL
  2. Open Excel -> Data -> From Web
  3. Copy the URL in the address field -> Go -> Import
  4. Select the existing worksheet option -> OK
  5. The NEOSYS Report will now be pasted in excel in a text format

9.3 Option 3: Exporting Data into Excel directly (only IE)

  1. If you have not already done so, right click on the Internet Explorer tool bar and choose the following options

    In case you are using Internet explorer 11, follow the screenshot below for this step:
  2. Click Edit, Add, Close
  3. The Internet Explorer tool bar will now have an Edit button with a drop down to select Microsoft Office programs like Excel and Word
  4. Click on the "right arrow" at the top left corner (it will turn into a checkmark) and click on Options on the top right of your screen
    Check Mark

  5. Select the "None" option and click on Ok
  6. Select the location to paste data and click on OK
  7. The NEOSYS Report will now be pasted in excel in a text format.

9.3.1 Issues in Exporting to Excel

To troubleshoot Export to Excel, see Resolving ‘Export to Microsoft Excel’ in IE9, Excel 2009

9.4 Removing blank lines from Excel

In the Home menu > Find & Select > Go to Special > Blank Cells. This will select all the blank cells.

Then right-click on any of the selected cells, select Delete and select Entire Row. This delete all rows that contains blank cells.

These steps can be saved as a macro, so that it can be done easily in one step in the future.

10 Using Macros in Excel to edit NEOSYS reports

Generally when copying reports from NEOSYS to Excel, users might want to edit it further, e.g. clearing empty or unwanted columns and this task can be repetitive and time consuming to do it each time a report is copied to excel. Define macros in Excel to handle such tasks quickly. Below is an example showing how to create and reuse a macro to delete empty columns.

10.1 Steps to create a macro (one time procedure)

  1. Copy the report and paste it in an excel sheet. (Click on How to Copy a NEOSYS report in MS-Excel to see how to do this.)
  2. Make the Developer tab visible as shown below
    For Excel 2007
    For Excel 2010/2013

    a) Under Excel Options click on Customise Ribbon
    b) Tick the checkbox which says Developer Tools
  3. Under the Developer Tab in Excel click Record Macro. Name the macro appropriately for easy reference. In this example the macro is to delete empty columns. Ensure "Personal Macro Workbook" is selected from the drop-down menu
    Record macro.jpg
  4. Record your action which you want to be repeated later. The macro records all actions like scrolling, selecting cells, editing etc. For this example select entire columns in the spreadsheet that you intend to delete. Right click on any one of the columns and click on Delete to remove the unwanted columns
  5. Click on Stop Recording under Developer Tab
    Stop recording.jpg
  6. Save changes to Personal Macro Workbook when prompted. This is to reuse the macro on other worksheets

Save changes to personal workbook.jpg

10.2 Steps to reuse macro

  1. Copy the report and paste it in an excel sheet. (Click on How to Copy a NEOSYS report in MS-Excel to see how to do this.)
  2. Under the developer Tab click on Macros, select the macro and click Run to execute the tasks recorded earlier. You can also use the shortcut key you defined in the macro. You can also edit Macro definition by clicking Edit.

Rerun macro.jpg

11 Splitting single NEOSYS report columns like 1000.00USD into two columns in Excel

Many NEOSYS reports put currency amounts in a single column like 1000.00USD, ie as a single number followed by a currency code. It does this to keep reports compact and to provide multi-currency totals in a single column.

In order to support pivot table or export into other systems it is sometimes necessary in spreadsheets like Excel to split the number and currency code into separate columns.

In Excel, strangely there is no built-in way to split numbers from letters but the following steps will achieve the same or better.

  1. Select the column that you want to split, and duplicate it to get two identical columns by inserting a column and copying the original column into it.
  2. Remove the currency codes from the first column by selecting it and doing Edit, Find and Replace (Ctrl+H), select "Regular expressions" under "Other options". Search For [A-Z] and Replace With nothing.
  3. Do the same on the 2nd column and Search for \d and Replace With nothing.

11.1 Using Macros

These steps can trivially be recorded as a macro, maybe called Split Currency Amount, and re-performed on request on any future sheets. This makes splitting even easier than any built-in function.

In order to record the macro, select the column then perform the steps, then stop recording and save the macro maybe as "Split Amounts". Assign a hot key like Ctrl+Shift+S to be able to repeat it easily in future.

In order to redo the work on another column, select the column then replay the macro, or if you assigned a hot key, press that combination.

12 Opening new windows in new tabs in Internet Explorer 7

Unfortunately Microsoft have decided that this cannot be done programmatically and that the only way is to right click on the menu item and select "open in new tab".

Also surprising is that new tabs do not become the top window automatically unless you configure Internet Explorer as follows:

Tool, Options, Settings and check the option "Always Switch to New Tabs when they are Created"


13 Showing signatures for people who are not users of NEOSYS

You can issue documents on behalf of anybody by typing in their name as the executive when creating the document, however this does provide a signature.


  1. Create NEOSYS users in the usual way to represent the “issuing” users except that they must not have an email address and therefore will not be able to get passwords or login.
  2. Upload signatures onto the User File for the issuing users. To update users other than yourself, you need to be authorised to do “USER UPDATE”
  3. When creating documents on behalf of issuing users, enter the user code of the issuing user as the Executive. The default executive/issuing user can be setup per client and/or brand in the Client/Brand File if desired.

14 How to automatically open all your favourite NEOSYS screens in one step

In most browsers, you can save and reopen a set of tabs on demand. The exact steps to follow depend on the browser you are using.

Setting up

  1. Open many tabs as you would like them to be reopened in future
  2. Right click any tab and choose "Save all tabs" - exact method varies per browser.


  1. Open a new browser window (not tab) and login to NEOSYS
  2. Right click the favourites folder you saved above and choose "Open all in tabs"

Here is an example set of tabs for NEOSYS finance module.

  • Change the "" in the examples to your own browser address for NEOSYS
  • You can modify the ending of the examples to open the specific documents in your own database*INV*214*88*1

Screenshots of how to set it up in Internet Explorer:


15 Using Google to search NEOSYS wikis

Mediawiki's built in search is nowhere near as smart as Google's but Googles search often lists non-NEOSYS pages.

Search like this:

neosys wiki "exchange rate"

Putting Exchange Rate in "" quotes searches for the exact phrase instead anywhere either word appears

16 NEOSYS links in different browsers

The NEOSYS access urls automatically redirect to different versions of NEOSYS depending on the browser you are using as each version is compatible to a particular browser. You only have to enter "url" in your browser and it will get redirected to the appropriate version depending on your browser.

It gets redirected to url/2 or url/3 when accessed via Internet Explorer or Google Chrome/ Firefox respectively where url is the access url as shown in the examples below. url/1 is for the old version to which no new developments are done. The option to access it will go away in the future.

e.g when we enter "" in Chrome or Firefox, the url gets redirected to: 

Similarly when we enter "" in Internet Explorer, the url gets redirected to: