Page tree
Skip to end of metadata
Go to start of metadata

Installation instructions

The Report Factory is delivered either as a stand-alone version or as a multi-user version. The license key file that is delivered in addition to the software package for installation contains information, whether it is a single user or a multi-user version. In the case of a multi-user version, the license key file also contains an indication of the number of users.

The ReportFactory can be installed under Windows with an installer or can be integrated in Windows and other operating systems as an application in an existing web server (Deployment of .war file).

The installation with the Windows installer is usually used in the single-user version, for the multi-user version or installation on other operating systems, the deployment is recommended in a Web server. In principle, users of the reportfactory can freely decide which of the two types of installation they want to use.

Please read the installation manual to learn more about the installation details or the specific implementation.

When you launch the ReportFactory for the first time a default-user is created. Username and password are documented in the installation guide.

Starting after standalone installation through the windows installer

If your ReportFactory was not installed with the Windows Installer, please continue with the next section! There you will find the instructions for access the ReportFactory when it is installed in a Web server.

The ReportFactory is a browser-based application that, apart from the Office Addins, can be handled through most common internet browsers.

 

Note: Please do not close the console window! This would sto executing the report Factory. The console window can be minimized, if it interferes with the work on the desktop. Report Factory is stopped by clicking "Stop".

There are two user areas: If you have administrator rights, you can access the administration area to manage the users of RF. In the general user-interface, all users – which have been created through the admin – can create report projects and work on their specific report jobs.

The admin area can be loaded by selecting "Report Factory Administration" in the Internet browser installed on the system. If there are problems starting the Internet browser, you can also launch the browser manually and enter the following address:

http://localhost:8080/reportfactory/admin

The user interface can be accessed analogue either by calling "Report Factory interface" or by entering the following address in your browser:

http://localhost:8080/reportfactory

After calling the browser address a login screen appears.

After logging in, the user menu appears.

In the upper right corner, the user name of the logged in user is displayed (here "Administrator").

If you have not logged out after you have used the report Factory the last time and your Internet browser has stored the credentials, it can be that the login menu will be skipped and the user menu of the Report Factory is displayed directly.

Starting after installation on a webserver

There are two user areas: If you have administrator rights, you can access the administration area to manage the users of RF. In the general user-interface, all users – which have been created through the admin – can create report projects and work on their specific report jobs.

The admin area can be loaded by calling an address in the Internet browser. The URL of the call depends on the address of the server on which the ReportFactory is installed. The start address has the following structure:

<server:port>/reportfactory/admin

The user interface can be accessed by entering the following address in your browser:

<server:port>//reportfactory

Please check with your system administrator the server address <server: port> for calling the ReportFactory!

After calling the browser address a login screen appears.

After logging in the user menu of the RF appears.

In the upper right corner, the user name of the logged in user is displayed (here "Administrator").

If you have not logged out when you last used the report Factory and your Internet browser has stored the credentials, it may be that the application form will be skipped and the user menu of the Report Factory is displayed directly.

Password change/logout

To change the password, a user must be logged in. The user menu on the top right offers the following two functions:

  • Change Password
  • Logout

To change the password, please proceed as follows:
Select the menu item "Change Password". Then the following menu appears:

"Current Password"  - Please type here your old password, which shall be changed. Now enter in the input fields "New Password" and "Password repeat" the new password. Then confirm the entry by pressing the OK button.

To log out, select the user menu and select "Logout".Then the login dialog appears again and re-login.

Please note that the registration information is stored by your Internet browser. Therefore, you should logout after you have finished your work to ensure that no other user can access the ReportFactory from your computer without authorization.

Create an user account in a multi-user version

If you do not have administration rights for RF, you can skip this section!

In The administration area users are created and managed. A user must be assigned a login name, a real name and a password. New users are defined by clicking the "New" button.

 

 

In addition, three user roles can be assigned:

  1. By placing a hook in the check box for the administrator role a user has administrator privileges. An administrator has the permission to access the administration section of the RF. Therefore he has the authorization to create new users or delete users.
  2. By placing a hook in the check box for the domain user role a user is authorized to work on report projects. Only a domain user can be assigned with rights in report projects.
  3. By placing a hook in the check box for the project creator role, a user is authorized to create report projects. In the report projects created by yourself a user has all permissions for the use of various reporting features and in addition individual permissions can be given to other users.

Only users who have the "domain user role" are restricted by the license quota. If a user has no assigned role, the user has no rights. A user without a role can be regarded as a disabled user. In Conclusion a user can loose its permissions (temporarily) by removing its roles.

Manage existing users by clicking on the "pencil" button.

Proxy Setup for the ERIC client transmission

The ERiC client makes an internet connection for the transmission of e-balance on port 443 to one of the domains 

  • Datenannahme1.elster.de
  • Datenannahme2.elster.de
  • Datenannahme3.elster.de
  • Datenannahme4.elster.de

by https.

The settings to use a proxy for the ERiC client transmissions are made in the configuration file config.properties.

The config.properties is placed in the user data directory of the ReportFactory. An installation through using the installer this is by default C:\Program Data\ ABZ Reporting\Report Factory.

Changes to the config.properties file only become effective after a restart of the ReportFactory server.

Parameters

The following parameters can be set:

Parameter nameTypeExample value

Description

reportfactory.http.proxy.auth

String127.0.0.1(IP) address or host name of the proxy
reportfactory.http.proxy.port

String

3128

Proxy-Port

reportfactory.http.proxy.username

String

TestPassword for proxy authentication

reportfactory.http.proxy.password

String

123456

(IP) address or host name of the proxy

reportfactory.http.proxy.auth

String

any

Is optional; Valid values:

Any

Basic

Digest

GSS

NTLM

DigestIE

Standard: any

Multiple values have to be separated by commas. The uppercase / lowercase of the value is ignored.

 

Configuration examples


reportfactory.http.proxy.host=127.0.0.1

reportfactory.http.proxy.port=3128

reportfactory.http.proxy.username=Test

reportfactory.http.proxy.password=123456

reportfactory.http.proxy.auth=any

 

            

             

 

 

  • No labels
Write a comment…