DFM Service Setup

Exploring

ClosedWhere it fits in?

This program lets you view the status of the DFM services and change configuration values without having to access the configuration files.

Any configuration changes made using the DFM Service Setup program only takes effect when next the service polls for a change in configuration information.

All changes are saved to and read from the database. If no information is found on the database, the DFM Service Setup program reads the configuration file.

Things you can do in this program include:

  • Pause the services.

  • Specify that logging is required.

  • Change the polling interval that defaults to 30 seconds.

  • Change the time interval to determine if there is a change to the configuration.

ClosedNavigation

  • This program is accessed from the Program List pane of the SYSPRO menu:

    Program List > Administration > Document Flow Manager

ClosedRelated Information

Overview Topic

Document Flow Manager

Services

SYSPRO 8 Document Flow Manager Folder Poller

SYSPRO 8 Document Flow Manager Queue Poller

PDF and Video Resources

Install Guides

Feature Guides

Starting

ClosedSecurity
ClosedActivities

You can restrict operator access to activities within a program (configured using the Operator Maintenance program).

ClosedFields

You can restrict operator access to the fields within a program (configured using the Operator Maintenance program).

ClosedeSignatures

You can restrict access to the eSignature transactions within a program at operator, group, role or company level (configured using the eSignature Setup program). Electronic Signatures provide security access, transaction logging and event triggering that gives you greater control over your system changes.

ClosedGroups

You can restrict operator access to programs by assigning them to groups and applying access control against the group (configured using the Operator Groups program).

ClosedPasswords

You can restrict operator access to functions within a program using passwords (configured using the Password Definition program). When defined, the password must be entered before you can access the function.

ClosedRestrictions and Limits
  • The following flags can't be maintained in this program, but can be edited in the SYSPRODFMQueuePoller.exe.config and SYSPRODFMFolderPoller.exe.config configuration files.
    • zeroFileSizeDeleteTime
    • ConfigPollType (defaults to ss - seconds)
    • FolderPollType (defaults to ss - seconds)

    • PollType (defaults to ss - seconds)

      This will be addressed in a future release

Solving

ClosedFAQs
ClosedDFM Services
ClosedWhere can I set the polling type for DFM services?

Although the following flags can't be maintained in the DFM Service Setup program, you can edit them in the SYSPRODFMQueuePoller.exe.config and SYSPRODFMFolderPoller.exe.config configuration files:

  • ZeroFileSizeDeleteTime
  • ConfigPollType (defaults to ss - seconds)
  • FolderPollType (defaults to ss - seconds)

  • PollType (defaults to ss - seconds)

This will be addressed in a future release.

ClosedWhy don't the DFM Services start?

The password held against the operator used to start the services may have changed. This could occur automatically by the operating system, depending on the password policy setup.

Solution

  • Review the password settings defined against the operator who is starting the services.

  • Review the message logs within the Event Viewer.

ClosedWhy don't the DFM Services start on installation?

This is most likely due to an invalid operator/password combination or the operator doesn't have sufficient permission to access the folder contents.

Solution

Review the message logs within the Event Viewer.

ClosedWhere do I define the 'file size delete time' for the DFM folder poller service?

Although you can't currently maintain the FileSizeDeleteTime in the DFM Service Setup program, you can edit this in the following configuration files:

  • SYSPRODFMQueuePoller.exe.config
  • SYSPRODFMFolderPoller.exe.config
ClosedConfiguration
ClosedWhy are the changes I made not implemented immediately?

Any configuration changes made using the DFM Service Setup program only takes effect when next the service polls for a change in configuration information.

This interval can be specified at the Config Interval column of the DFM Service Setup program.

ClosedProblem Solving
ClosedWhere can I find the DFM event log?

The event log is created when DFM is installed. The log is output to the following folder, which you can review for diagnosing any problems you may encounter:

Control Panel > System and Security Administrative Tools > Event Viewer > Applications and Service Logs

You can open each entry in the log to view the error or warning details.

The event log is only available if you have selected Yes at the Log required option in the list view of the DFM Service Setup program.

ClosedWhy do documents remain in the polling folder?

Likely causes are that the document is not being picked up at all, or is being picked up but the Document Flow Manager user doesn't have permission to delete the original document from the folder.

If the document is not being processed, then there are a number of possible causes:

  • The contract is configured to poll a different folder.

    Check the relative pathing from which the service is run.

    If the folder is on a remote workstation, ensure that the machine is running and that the SYSPRO application server can see both the machine and the share/mapped drive.

  • The file does not match the file type defined against the contract.

  • The contract is disabled.

  • The SYSPRO 8 Document Flow Manager Folder Poller service doesn't have permission to access the folder.

  • The file is defined as read-only.

    Review the attributes against the file.

  • The SYSPRO 8 Document Flow Manager Folder Poller service is not running.

ClosedWhy are there no results for documents in the polling folder?

The SYSPRO 8 Document Flow Manager Queue Poller service is not running, or the contract is not configured to output the results from the business object.

Solution

  • Review the contract to ensure that it is configured to output the results from the business object and that the correct folder is specified.

  • Check that the operating system user who is starting the SYSPRO 8 e.net Communications Load Balancer service has been granted write-access to the folder.

  • Check that the user for the SYSPRO 8 e.net Communications Load Balancer service has been granted write-access to the Failed folder.

Using

ClosedHints and Tips

  • Any configuration changes made using the DFM Service Setup program only takes effect when next the service polls for a change in configuration information.

    This interval can be specified at the Config Interval column of the DFM Service Setup program.

  • Columns in a list view are sometimes hidden by default. You can reinstate them using the Field Chooser option from the context-sensitive menu (displayed by right-clicking a header column header in the list view). Select and drag the required column to a position in the list view header.

  • Press CTRL+F1 within a list view or form to view a complete list of functions available.

Referencing

ClosedToolbar and Menu
Field Description
File  

Save

This saves the details you entered or changed.

Save and Close

This saves the details you entered or changed and returns to the previous screen.
Exit This exits the program.

Refresh

This refreshes the information for the pane.
ClosedDFM Services
Field Description

Server name

This indicates the DFM service you are maintaining.

Server type

F indicates the folder poller and Q indicates the queue poller.

Service instance

This is an internal flag.

Service description

This indicates a description of the service for identification purposes.

Status

This indicates the current status of the service (e.g. paused, running, etc).

Paused flag

This indicates whether the service is currently paused.

You can select to pause or start the service.

  • Yes = paused
  • No = not paused

Log required

This indicates whether an event log is required for the service.

You can select whether an event log is required for the service.

  • Yes = log is required
  • No = log is not required

Poller interval

This indicates how often the service will poll for new files in configured contract folders and is measured in the unit of time specified at the PollType flag.

This defaults to 30 seconds, but can be changed here.
Config interval

This indicates how often (in seconds) the service must will poll for changes made to the configuration information.

If the service can't reach the SYSPRO 8 e.net Communications Load Balancer or business object, it will retry once this interval has lapsed.
Started date This indicates the date the service was last started.
Updated date This indicates the last time the configuration of the service was changed.