Pagero Server Connect - Installation

Don't use just a <b> tag for a heading, but an actual <section><title> element.
Installation
Unpack the files in dedicated folder, and check that all files in the list are included. For support and tracking, Pagero recommend the path contain Pagero. Example:
C:\Program\Pagero\Poscripted
Edit config.xml (save an unedited version for backup). Define log catalouge and log level. Add SMTP mail server and email group.
  • Pagero recommends that a specific email-group is created and used in order to minimize configuration in config.xml. Relevant users is then added and edited in the email-group.
  • Make sure the sending part (email-account) has the right to send mail via the email-server.
Configure the application
Multiple companies are added through copy and paste of the content:
<company name="Company 1" companyID = "">
</company>
Pagero account: user & password. Account information is provided by Pagero Service Center and through confirmation mail.
Then define the following folders
: prodPath=”/home/prod” testPath=”/home/test” workPath=”/home/tmp”
  • If both sending and receiving through Pagero, define and configure both Inbox and Outbox settings.
  • All folders must be manually created.
  • Pagero strongly recommend all folders are created on the local server.
Finally, save and exit config.xml
  • In the event, that the folders used for reading and writing files are mounted devices, use a UNC path to indicate the location, like this: \\\\unit\path.
  • When using Outbox to send files, files should not be copied to the folder Pagero Connect reads from. This is because the partially copied file may be sent. Copy files to a different folder on the same disk, then move the file to the folder from where Pagero Server Connect reads.
Enable attachment handling for outbond traffic
The server connect application supports automatic attachment document binding using file name conventions. Use the following attributes on the
outbox
configuration element, to enable attachment handling.
ATTRIBUTE
DESCRIPTION
subDocAware
If true, outbox will be aware of sub documents (Attachments)
masterDocRegexp
Regular expression for file name that identifies a master document (i.e. invoice) and has a group that extracts the document id.
subDocRegexp
Regular expression for file name that identifies a sub document (i.e. attachment) and has a group that extracts the master document id.
subDocPresentationRegexp
Regular expression for file name that identifies a presentation sub documentation and has a group that extracts the master document id.
Internet access through proxy
Follow the instructions below, if your company uses a proxy to access the Internet.
That is, proxies that require authentication for access.
Define the following environment variables:
JAVA_RUNTIME=C:\Program\Java\jre6 #The path to your Java runtime installation PROXY_HOST=localhost #The proxy server host name PROXY_PORT=8888 #The proxy server host port
Use this command line, when scheduling Pagero Server Connect:
%JAVA_RUNTIME%\bin\java – Djavax.net.ssl.trustStore=%JAVA_RUNTIME%\lib\security\cacerts – Djavax.net.ssl.trustStorePassword=changeit -Dhttps.proxyHost=%PROXY_HOST% – Dhttps.proxyPort=%PROXY_PORT% -Dhttp.proxyHost=%PROXY_HOST% – Dhttp.proxyPort=%PROXY_PORT% -jar postcripted-jar-with-dependencies.jar -config config.xml
Scheduler
A scheduler is used to schedule sending/receiving of electronic invoices. In this example: Windows default Schedule.
User & Rights
Pagero recommends a specific user purely defines to execute the job. Choose/Create a specific (AD) user, with adequate rights for executing the job, or add user on local server/computer.
Configuration Windows Scheduler
  1. Define java: Example: C:\Program\Java\jre6\bin\ javaw.exe
  2. Set name to: Pagero Connect
  3. Choose interval, (editable and specifiable later).
  4. Define user & Password
  5. Choose: Advanced Settings
  6. Done
Alternatively import included task from the PageroServerConnect-folder:
Pagero Server Connect.xml
directly into the Windows Task Scheduler.
Advanced settings/Activity
Option 1 – Use provided bat script(s)
Requires the vb script engine is installed and active.
Edit ServerConnect.bat and set the following parameters to fit your environment.
SET PAGERO_ SC_CONFIGFILE – Configurationfile for serverconnect
SET PAGERO_SC_LOGMODE – FILE or SYSTEM
SET PAGERO_SC_LOGPATH – Path for your logs
SET PAGERO_SC_MAILSERVER – servername:port
SET PAGERO_SC_LOGLEVEL – INFO or WARN
SET PAGERO_SC_MAILRECEIVERADDRESS – Receivers mail adress
SET PAGERO_SC_SENDERRADDRESS – Senders mail adress
If you use Proxy, you must set following parameters
PROXY_HOST – Proxys addres
PROXY_PORT – Proxys port
PAGERO_ SC_PROXY=%PAGERO_SC_TRUST_STORE% %PAGERO_SC_TRUST_PASSWORD% %PAGERO_SC_HTTPS_PROXY% %PAGERO_SC_HTTP_PROXY%
Then enter the following parameters into the scheduling tool
Run: “C\WINDOWS\system32\wscript.exe <install path>\invis.vbs <install path>\ServerConnect.bat
Run in: <path> Run as: <user> Make sure right user and password are used.
Option 2 – Schedule java application manually
  • Use javaw.exe instead of java.exe in order to avoid manual command window.
Run: Default command: java -jar poscripted-jar-with-dependencies.jar -config config.xml
Full example (with path & command): C:\Program\Java\jre6\bin\javaw.exe -jar poscripted-jar-with-dependencies.jar -config config.xml
Run in: <path> Run as: <user> Make sure right user and password are used.
Scheduling & Settings
Edit interval after your choice.
Security
  • Control user and rights
  • Save and close.
  • Test the procedure.
config.xml
This section contains an example configuration file, used on a Windows server system. You should not use special character in username (use only alphabetic, numbers and “_”).
<?xml version="1.0" encoding="UTF8"?> <poclient> <!-- The-logtag specifies how logging is done. Attributes: Mode FILE Logs to a text file SYSTEM Logs to the operating system log. For Windows the Event Log is used. For other system (i.e. Unix/Linux) the logs are logged to syslog at localhost via UDP Path if file mode is used it tells where the logfile shall be written
Verbose if true all DEBUG logs will be written to the log destination --> <log mode="FILE" path="c:/pagero/log" verbose="true"/> <!-- To get mail notification as a complement to the logs. Attributes: server The SMTP server that is used for sending mail level The level specifies which log level that shall be included in the mail. INFO All info, warn, error logs are included in the mail WARN All warn, error logs are included in the mail Note! If no logs are written no mail will be sent. Sender The sending mail address Receiver The receiver’s mail address --> <mail server="myMailServer" level="INFO" sender="sender@company.com" receiver="receiver@company.com"/> <!-- The company-tag specifies a configuration for a company. There can be one or more companytags. Attribute: Name The name of the company/account. Used in logs. companyId Identifies a company, this is for multicompany use. If more than one company is being represented the value for companyId is the current company. If companyId is empty then the company used for sending and receiving invoices will be the currently/last logged in company --> <company name="Company one" companyId="">
<!-- The po-tag specifies the user account used to access Pagero Online Attribute: Username The username in Pagero Online Password The user's password (remember to protect this config file) --> <po username="myUserName" password="mySecret"/>
<!-- The inbox-tag specifies where the received documents will be stored Attributes: active If true the inbox is fetched prodPath The path to the directory where incoming production documents will be stored testPath The path to the directory where incoming test documents will be stored tempPath The path to the directory where files will be temporary stored during fetching of documents. The files will then be moved to the final destination directory. This behavior is used to prevent providing incomplete files in the destination directory. documentType Type of document. Valid values are INVOICE, ORDER, ORDER_RESPONSE and DISPATCH_ADVICE. If empty value all types of documents will be fetched.
! All these directories shall be on the same disk to prevent copying of files to the destination directories.--> <inbox active="false" prodPath="c:/pagero/inbox/prod" testPath="c:/pagero/inbox/test" tempPath="c:/pagero/inbox/temp" documentType = "INVOICE"/> <!-- The outbox-tag specifies where the files to send will is stored
Attributes: active If true, the outbox is sent prodPath The path to the directory where outgoing production documents will be read from. testPath The path to the directory where outgoing test documents will be read from workPath The path to the directory where files will be temporary stored during sending and until they are completely processed. In the work Path a number of sub directories are created that shows the sent file's status. Temp The files are stored here during sending to Pagero Online. Sent The files are stored here when they are successfully sent to Pagero Online. Failed The files are stored here if they failed to send them to Pagero Online. Done The files are stored here when they are successfully processed by Pagero Online. Wait The files are stored here if they need manual handling by Pagero’s support. Normally this will be done within 24h during business hours. Error The files are stored here if there occurs an error that couldn’t be proccessed by Pagero Online. If this happens contacts are needed with Pagero Online.
subDocAware attachments enabled if true masterDocRegexp file name pattern for invoice subDocRegexp file name pattern for attachment subDocPresentationRegexp file name pattern for invoice image --> <outbox active="true" prodPath="c:/pagero/outbox/prod" testPath="c:/pagero/outbox/test" workPath="c:/pagero/outbox/work" /> </company> </poclient>

Related Content