29 January 2010
28 January 2010
The Pharos ini_schema for the EMOS eClient needs to be added to the system, the mechanism for doing this is different for v7.2 and v8.0-v8.1
v7.2
v8.0
v8.1
Install the client from the MSI. Once installed launch the eClient.exe from the install location (default: c:\Progeam Files\Emos\eClient).
The first time the eClient is run it creates the registry entries in HKLM\Software\EMOS\Common\PEdi. The application should detect that registry entries have been created and run the setup screen. Enter the URL for the pedi.asmx page on the edi server and enter the Edi sitecode (password). Enter the name of the Network Terminal as entered in the Server installation. Click Verify to check the settings.
The Sitecode is held encrypted in the registry and can only be written encrypted to the registry using the setup form.
Access to the setup form can be restricted by turning the Setup Menu Option to No in the Network Terminal record in Pharos Administrator.
| Options | |
|---|---|
| Option | Description |
| AutoRun at Startup | If this option is set the application will add an entry to the registry to launch the application on startup. HKLM\Software\Microsoft\CurrentVersion\Run\EMOS eClient. |
| Account Info on Icon Left Click | This option allows the user to left click the tray icon to obtain their balance infomation in a Balloon tip. However, if the network speed is not quick enough the icon can display "Server offline" messages before it has returned the data from the EDI. It is much better to turn this option off and allow the user to select the Pharos Account option from the Right click Menu of the Tray icon. |
| Account Menu Option | Whether the User Account Information is available from the right click menu of the tray icon. The users account information is formated as per the Account Display settings and shown in a messagebox. |
| Transaction Menu Option | Whether the Users Transaction information is available from the right click menu of the tray icon. |
| Setup Menu Option | Whether the option to launch the setup form is available from the right click menu of the tray icon. |
| Quit Menu Option | Whether the option to close the eClient application is available from the right click menu of the tray icon. |
| Display | |
| Option | Description |
| My Account Prompt | The prompt which is shown on the right click menu for accessing the users account information. Prompt is also used as the title for the Account Information Window and account information balloon tip. |
| My Transactions Prompt | The prompt which is shown on the right click menu for accessing the users transactions. Prompt is also used as the title for the transaction window. |
| Account Display | The message that is shown to the user in the account information window and balloon tool tip. Uses UserDetails Placeholders to display returned user information. |
| BalloonTip Timeout | The time in milliseconds that the Balloon tip is shown |
| Server Offline | The message that is displayed if the EDi server cannot be contacted. |
| Server Connecting | The message that is displayed when the application is attempting to contact the EDi server. |
| Server Online | The message that is displayed when the application is connected to the EDi |
| Transactions | |
| Option | Description |
| Allow Print Transactions | Whether the Print option is available in the transction window. |
| Allow Save Transactions | Whether the Save option is available in the transction window. |
| Default Difference between dates (days) | The difference between the start and end date when the transaction window loads. |
| Maximum Difference between dates (days) | The maximum diference allowed between the start and end date when searching for transactions. |
| Remember Column Widths | Whether the application should remember the widths of the transaction columns if they are changed. |
| Default Column Width | The default width of the listview columns if remember column widths isn't used. |
| No Transactions prompt | Prompt that is displayed when no transactions are returned. Uses prompts placeholders |
| Exceed Max Dates Prompt | Prompt that is displayed when the end date is greater than Maximum Difference Between Dates from the start date. Uses prompts placeholders |
| Start After End Prompt | Prompt that is displayed when the start date is greater than the end date. Uses prompts placeholders |
| Transactions SQL Query | Query that is run against database to return transactions. Uses prompts placeholders |
| Columns to display | Comma seperated list of the names of the transaction columns that are returned by the SQL Query to display in the transaction listview. |
| Columns to format as Currency | Comma seperated list of the names of the columns to format as currency. Columns must be in the Columns to Display |
| Columns to format as Date | Comma seperated list of the names of the columns to format as Date format. Columns must be in the Columns to Display |
| Date Format | The format of the date string. The Application trys to convert the returned date into a DateTime object and if successful formats the date using .Nets Custom date and Time Formating. If the conversion to a DateTime object is unsuccessful then the date is shown as it was returned from the database. |
Place holders are used in the prompts and messages to be replaced by user details and configuration data.
| User Details PlaceHolders | |
|---|---|
| Placeholder | Description |
| %U | The logon username. |
| %F | FirstNames |
| %L | LastName |
| %B | The total balance of the 3 purses |
| %G | The users group name |
| %A | The users active Status |
| %D | The users Alias |
| %C | The users card id |
| %H | The users email address |
| %J | The users custom1 field |
| %K | The users custom2 field |
| %N | Whether the user can print colour |
| %P1 | The value of the users technology purse (purse 1) |
| %P2 | The value of the users tuition purse (purse 2) |
| %P3 | The value of the users user pays purse (purse 3) |
| \n | Newline (CRLF) |
| Prompts and SQL Query PlaceHolders | |
| Placeholder | Description |
| %S | The start date that was entered in the Startdate field. |
| %E | The end date that was entered in the Enddate field. |
| %M | The value of the Max difference days configuration option |
| %U | The username obtained from the logged on user. |
| \n | Newline (CRLF) |
Transactions can be exported from the Transaction window as long as the Save Transactions option is set to yes in the Network Terminal Record.
The transactions can be exported as either a HTML format file or a Comma seperated list file. The HTML export uses a reporttemplate.html file which is
located in the installation folder. This can be customised to suit requirements. The HTML report template uses 4 placeholders,
%t = Report Title,
%h = Report parameters,
%g = Report summary,
%r = html table version of the transactions in the listview.