Allowing access to files

Allowing access to files

To ensure access to files that are used by interfaces and links, be sure the
application server where Workforce Integration Manager is installed is set up as
follows:
• The server must be running under a logon account that has access permissions
for the files in the mapped folders. It cannot be running as a “local system”
account (the default installation).
• The server must have WRITE permissions for any remote source files.
(Workforce Integration Manager locks those files during certain operations.)
• The server must have WRITE permissions for any remote target (output) files.

Integration Manager User’s Guide 21

Chapter 2 System Setup and Administration

Allowing access to the data integration accrual Genie

When individuals run an interface with links that export accruals data from the
timekeeping database to an output file, the user names that can be specified in the
XML API connections that are used in the links must have access to the data
integration accrual Genie that the system uses to perform that operation.
By default, the Workforce Genie Profile includes the data integration accrual
Genie. Because that profile is associated with the SuperAccess display profile, all
individuals with that display profile have access to the data integration accrual
Genie.
However, if you want individuals to have access to the data integration accrual
Genie through a different display profile, complete these steps:
1. Use the People Editor to determine what the display profile is for the
individual. For example:
a. Select a user name with QuickFind and then click People on the menu
bar.
b. Select the Job Assignment tab and then click Access Profiles.
c. In the Display Profile field, note which display profile is assigned to the
user (for example, Default).
2. From the suite home page, click the Setup link.
3. Under Display Preferences, click Display Profiles.
4. Select the display profile that you identified in step 1c (Default in this
example) and then click Edit.
5. In the Edit Display Profile area, click the Manager Selections tab and then
select a Workforce Genie Profile from the drop-down list box.
6. Click Save & Return.
7. Click the Setup link again.
8. Under Display Preferences > Display Profile Building Blocks, select
Workforce Genie Profiles.
9. Select the profile that you selected in step 5 and then click Edit.

22
 Allowing access to the data integration accrual Genie

10. In the left pane of Available Genies, select the check box for (Timekeeping)
Data Integration - Accrual Review (Accrual Detail) and then click the
right-arrow button to move the selected Genie to the right pane, Selected
Genies.
11. Click Save & Return.
Any individual who uses the Display Profile Default can now perform a data
integration operation that exports accruals data.

Integration Manager User’s Guide 23

Chapter 2 System Setup and Administration

Installing custom database drivers

To allow interface programmers to create a custom connection to data contained
in a database, you must install a custom database driver.

Note: Workforce Central and Workforce Integration Manager provide default

JDBC drivers for Microsoft SQL Server and Oracle databases. If you plan to use
Workforce Integration Manager with databases other than SQL Server or Oracle,
you must obtain an appropriate ANSI SQL-92-compliant JDBC driver.

1. The driver_name.jar file contains all the Java class files for the custom
database driver that you want to make available. Store that file on the
timekeeping application server at the following location. For example:
drive:\Kronos\wfc\applications\wpk\lib
2. To incorporate the contents of the driver_name.jar file into the
timekeeping application, you must rebuild the wfc.ear file. On the
timekeeping application server, double-click the Stop icon on the desktop to
stop the timekeeping application.
3. When the timekeeping application has stopped, double-click the Workforce
Central Configuration Manager icon on the desktop to start the Configuration
Manager InstallShield.
4. At the welcome screen, click Next.
5. At the configuration action screen, select Modify an instance and then click
Next.
6. At the next screen, select the instance (for example, wfc) and then click Next.
7. At the actions screen, do not select Add or remove products. Instead, leave
this check box clear and then click Next.
8. At the modification confirmation screen, click Next to start rebuilding the
wfc.ear file.
9. Once the rebuilding of the wfc.ear file is complete, exit from
Configuration Manager.

24
 Installing custom database drivers

10. Double-click the Go icon on the desktop to start the timekeeping application.
Wait for the application to start in online mode before proceeding to the next
task.
11. To confirm that a connection is valid for the newly installed driver, in the
Setup area of the application server, click Connections under Data
Integration. You can then create and test the connection. (See “Creating a new
connection” on page 41.)

Integration Manager User’s Guide 25

Chapter 2 System Setup and Administration

Copying a Workforce Central database

If you copy a Workforce Central database with interfaces pointing to production
systems, you must take certain precautions to make sure you do not accidentally
run these interfaces against the production system. There are several options,
depending on the configuration of the interfaces and links, and the system
configuration at your site:
• For links with interface overrides, change the connection or mapped folder to
one that is not a production system.
• Any interface that is scheduled in Event Manager should be turned off so that
it does not run at its regularly scheduled time.
• If you do not want users running interfaces from this copy database, you can
move the interfaces out of the end-user GDAPs (and make them available in
Super Access only).
• Delete the interfaces and redeploy them with the new connections and
mapped folder information.
Keep the test and production environments separate. For example, place the test
and production environments on separate subnetworks that do not have access to
one another—the entire stack, including the application and web servers.

26
 Chapter 3
Working with Interfaces

When you have access to the data integration components that are installed on the
server, you can access and run the interfaces that have been deployed on your
system.

Note: If you previously used a batch file to run an interface without opening the
configuration tool or to schedule an interface from Event Manager, use the
Integration Manager features described in these topics instead. For more
information about using batch files to run interfaces, see the Workforce
Integration Manager Programmer’s Guide.

This section contains the following topics:

• “Running an interface” on page 28
• “Canceling an interface” on page 30
• “Deleting an interface” on page 31
• “Scheduling an interface with Event Manager” on page 32
• “Overriding the interface options at runtime” on page 35
Chapter 3 Working with Interfaces

Running an interface
This topic describes how to run a single interface from the application server. For
other methods of running interfaces, see the Workforce Integration Manager
Programmer’s Guide.
1. From the suite home page, select the Data Integration tab and then click
Interfaces.
2. In the Interfaces display, select the button that is next the interface name.
3. To enable or disable certain steps or override certain options before you run or
schedule the interface, click Set Runtime Options. Then make the necessary
changes to the selected steps in the interface. (See “Overriding the interface
options at runtime” on page 35 for more information.)
4. To schedule the interface to run at a specific time, click Schedule and run the
interface from Event Manager. (See “Scheduling an interface with Event
Manager” on page 32 for more information.)
5. Click Run.
6. (Optional) Depending on the design of the interface, you may be prompted to
provide specific information before the interface runs. You may also have the
option to perform some other task, such as renaming the output file. For either
scenario, the system provides the Enter Data display, where you can complete
those preliminary tasks.
7. Click OK in the confirmation message window.
8. In the Interface Monitor display:
– Click Cancel —To stop an interface that is currently running.
– Click Refresh until the interface completes its run.
9. After the interface completes its run (successfully or with errors), click the
hyperlink in the Status field to view the Interface Results Summary report.
10. If there are errors, view the error report for the interface in one of the
following ways:
– Click the Total Errors hyperlink at the bottom of the Interface Monitor
display.
– Click the Errors hyperlink that is next to the Totals area in the Interface
Results Summary window.

28
 Running an interface

You can analyze the information in the Interface Error Report window.
11. If there are errors for specific links, click the numbered hyperlink in the Step
Details area of the report in the Interface Error Report window. You can
analyze the information for that specific step in the Link Error Report
window.
12. To run the same interface again after you resolve any errors, or to run another
interface, click Return in the Interface Monitor display; then repeat steps 2
through 6.

Integration Manager User’s Guide 29

Chapter 3 Working with Interfaces

Canceling an interface
1. In the Interface Monitor display, click Cancel.
2. Click OK in the confirmation message window. After the interface is
canceled, Interface Monitor displays an informational message.
3. To run another interface, click Return in the Interface Monitor display and
then select another interface.

30