MB – Sales Tax Compute Process

Miscellaneous Billing (MB) – Sales Tax Compute Process

Overview

Run the Miscellaneous Billing Compute Sales Tax batch process, after changing the sales tax parameters on the Miscellaneous Billing General Parameters form. These parameters are saved by year. The batch process recalculates all unposted Miscellaneous Billing invoices that meet the following criteria:

  • Standard (one-time) Invoices
  • Recurring Invoices

Invoices with items that are subject to sales tax.
Are Invoiced for the year entered in the Year parameter.
All these invoices are recalculated with the sales tax definitions of the corresponding year.

For details on defining the sales tax , see Miscellaneous Billing General Parameters

 

Read More...

 

Accessing the Miscellaneous Billing Compute Sales Tax Batch Process

The Miscellaneous Billing Compute Sales Tax Process can be run from Govern, GNA (for testing purposes), or the Govern Scheduler.
To set up run the MB Compute Sales Tax Process from Govern:

  1. Launch Govern.
  2. Open a Profile that contains Miscellaneous Billing.
  3. Select the Miscellaneous Billing form.
  4. Enter the year, corresponding to the invoices that you want to update and the sales tax definitions, in the Year parameter.
  5. Do one of the following:
  • Click the the Run arrow to run the process immediately.
  • Click Schedule to set up a schedule to run the process at a later date or on a regular basis.

Verifying the Miscellaneous Billing Compute Sales Tax Batch Process

If you are running the Miscellaneous Billing Compute Sales Tax batch process from Govern, you can click the Processing tab of the batch process and verify the execution. A progress bar is displayed along the top and information and warning messages are displayed.

After the process has run, The End is displayed on the progress bar. You can review the error, warning, and informational messages. The latter include:

  • Starting and Ending Time
  • Number of Records Processed
  • User ID
  • Batch ID
  • Transaction Mode
  • Batch Process Name

 

Notes

Synchronous Mode
This batch process runs in Synchronous mode only. If it is configured to run in Asynchronous mode in GNA:

  • A warning message appears to indicate that the process is running in Synchronous mode.
  • An information message appears to indicate that the Transaction Type parameters is set to Asynchronous.

 

Executing the Miscellaneous Billing Sales Tax Computation Batch Process

The Miscellaneous Billing Sales Tax Computation batch process performs the following calculations sin order to update the unposted Miscellaneous Billing invoices. It is run on both standard (one-time) invoices and recurring invoices.

It is typically run when changes are made to the Miscellaneous Billing Sales Tax rates on the Miscellaneous Billing General Parameters form in GNA.

Compute

The computation is run on all standard (one-time) and recurring Miscellaneous Billing that are unposted.

The computation is run on all standard (one-time) and recurring Miscellaneous Billing that are unposted.
The following fields are calculated:

  • Total
  • Sales Tax 1
  • Sales Tax 2

For all items, the price is multiplied by quantity:
ITEM_PRICE * ITEM_QTY

The totals for the sales tax are calculated:
TOTAL_SALE_TX_1
TOTAL_SALE_TX_1

Notes

Sales Tax 1 and Sales Tax 2 are calculated only for items that are subject to sales tax.

This is defined on the Miscellaneous Billing Items form in GNA. For each item, the option Subject to Sales Tax 1 and Subject to Sales Tax 2 can be selected or deselected.

The Miscellaneous Billing Account, which is set up for an individual or a company, can be exempt from one or both sales taxes. This is defined on the Miscellaneous Billing Account form in Govern. For each account, the options Exempt #1 and Exempt #2 can be selected or deselected.

Related Information

 

Batch Execution

The batch program can be executed on demand or scheduled with Govern Scheduler.

During the execution, warning and error messages will be presented in the batch result grid.

  • On error, the misc. billing account id will be displayed in the message – to verify
  • For any error, double-click on the message to access the full text

Once completed, information will be displayed, that includes:

  • A unique batch audit ID
  • Application name and version, such as Govern Batch Processing, 6.0
  • Batch process name with any additional notes, such as parameters loaded
  • User ID
  • Date and time the process was started
  • Date and time the process was completed
  • Parameters and Options used
  • Total number of records read
  • Total number of records processed
  • Indication as to whether the process was successful or not

Log
A log of Miscellaneous Billing Accounts Computed will be generated. – need to verify if needed

Batch Processing (technical)

Before Executing Subprocesses:

  • Execute Subprocess
  • Error Reporting

In addition to the standard Batch Processing standard error reporting, the following will be validated:

 

What’s New

[6.0] Batch program created for OpenForms

Troubleshooting

The following is to help troubleshoot the batch process.

  • After changes, it is always best to compute for a small dataset
  • The parcel/account no. id is listed in the error message
  • Turning on the Govern Diagnostic Tool
  • Turning on the SQL Profiler Tool (system administrator)

 

See Also

The following information might be of interest

 

 

 

101-mb-bp-004

 

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...

MB – Posting of Invoices

Miscellaneous Billing (MB) – Posting of Invoices

Features and Specifications Overview

This process posts the invoices meeting the selection criteria to Accounts Receivables (AR) and creates the supporting General Ledger entries to support the new A/R transactions.

Invoices can be posted via:

  • An Action Button on the Miscellaneous Billing Form – Invoice Tab
  • A Batch Program configured for the Profile and accessed through the Batch Program Explorer Tool box
  • The Govern Scheduler (batch process definitions) to run periodically with preset user criteria

For more details see:

 

Read More...

 

Records to Process Criteria

Only the records meeting the following business rules will be considered in the batch process selection of invoice records to be posted.

Batch Program

  • Year
    • To verify
  • Department
    • To verify
  • Invoice is Ready to Post
    • Select this option when you are ready to post the record to the Accounts / Receivable sub-system. The record will be posted the next time a Miscellaneous Billing Posting is performed, in Govern Batch Processing.
    • This ensures that the invoice data is correct before it is posted. (MB_INVOICE.READY_TO_POST = -1)
  • Invoices are not already posted
    • (POSTED_FLAG = 0)

Action Button

  • None
    • When the user clicks on the current unposted invoice, it will be posted after confirmation by the user regardless if the Ready to Post field is checked

 

User Parameters

The following parameters can be set by the user on the execution of the batch program or as predefined parameters setup the the batch definition schedule to refine the records to be processed.

Selection Criteria

Year

  • Enter the A/R year. If the AR General Parameters have “A/R Master by Fiscal Year” checked for the MB Subsystem, then this year will determined which AR_ID is posted to for each invoice.
    • If the “A/R Master by Fiscal Year” is not checked, then this year is populated in the AR_DETAIL.YEAR_ID
    • The Year is used to determine the record in AR_PARM_CLASS to use and the associated GL’s

Invoice Number

  • Select the single invoice number to be posted.

Date Range

  • Enter the effective INVOICE DATE range of the invoices to be posted
    • From Date: Invoices on this date will be posted
    • To Date: Invoices on this date will be posted

Account Number Range

  • Enter the account range to be posted
    • From Account: Starts at this account
    • To Account: Up to this account. To account will be included in the selection.

Category

  • Invoice Category

Issuing Department

  • Department

 

Override Fields

The following parameters can be entered to override:
Effective Date (Invoice)

  • Overrides the Invoices effective date

Due Date (Invoice)

  • Overrides the Invoices due date

 

On Completion (Post Conditions)

Invoice Records

Batch / Reference No.

  • Enter the Miscellaneous Billing Batch or Reference Number from the Miscellaneous Billing Invoice form in Govern. This is the Reference field from the Invoice form.

A/R Class Code

  • Select the A/R class code from the drop-down list to process only the bills from a single class code. Otherwise, leave this field blank to process all the bills.
  • This will not be needed for Open Forms because the AR Class code on the Invoice will be removed.

From / To date

  • Enter the range of dates to process or leave these fields blank to process all bills.

From / To MB Account Number

  • Enter the range of account numbers to process or leave these fields blank to process all account numbers.

A/R Class Code

  • Select an A/R Class Code from the drop-down list, to process only the records for a specific class code, or leave this field blank to process all Miscellaneous Billing Recurring transactions.
  • This will not be needed for Open Forms because the AR Class code on the Recurring form will be removed.

Batch Name

  • Enter the batch name or number for the records you are processing or leave this field blank to process all transactions. This is for the Recurring Batch Process Only

Issuing Department

  • Enter the issuing department to process. This is optional.

By Saved Dataset

Override Due date

  • By default, the current date display, but unless the Override check box is selected, the Due date on each invoice will be posted to AR.
  • If the Override check box is selected, All invoices posted with that process will receive the due date in the Date field.

Batch Variables

Invoice Date

  • In this mandatory field, enter the date to appear on the invoice. This is for the Recurring Batch Process Only

 

Batch Execution

The batch program can be executed on demand or scheduled with Govern Scheduler.

During the execution, warning and error messages will be presented in the batch result grid. – to verify

  • On error, the parcel id will be displayed in the message
  • Double-click on the message to access the full text

Once completed, information will be displayed, that includes:

  • Parameters and Options used
  • Total number of records read
  • Total number of records processed

 

Batch Processing (technical)

Before Executing Subprocesses:

  • Select all MB_INV_ID

Execute Subprocess

  • For each batch process
  • This process will post to AR the MB Invoices based on selection criteria and then update the MB_INVOICE records with POSTED_FLAG = -1 and POSTED_DATE with current date

Error Reporting
In addition to the standard Batch Processing standard error reporting, the following will be validated:

What’s New

[6.0] Batch program created for OpenForms

Troubleshooting

The following is to help troubleshoot the batch process.

  • Turning on the Govern Diagnostic Tool
  • Turning on the SQL Profiler Tool (system administrator)

 

See Also

The following information might be of interest

 

 

 

101-mb-bp-001

 

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...

Batch Process Definition Setup V5

Batch Process Definition Setup – Version 5

Version 6.x | Version 5 and lower

Overview

The GNA Batch Process Definitions form is used to define how you want your batch processes to appear and run in Govern. This includes setting up the menus and submenus for organizing your batch processes, configuring whether each process is run on a single server or on multiple servers, associating one or multiple reports, and synchronizing the batch process definitions and adding permissions. When complete, the batch processes are displayed in Govern.
This procedure has two major steps:

  • Configuring Batch Process Definitions
  • Adding Batch Processes Definition to Govern.

 

Read More...

 

Configuring Batch Process Definitions

Configuring Batch Process Definitions describes the following topics:

Batch Process Definitions User Interface

This section provides a tour of the Batch Process Definitions UI. The interface is comprised of a treeview, the definition form, and a secondary window for creating the menus and submenus or categories.
To access the Batch Process Definitions form:

  1. Launch Govern New Administration (GNA).
  2. Select Batch Process > Definitions.

Once you create menus and define batch processes, the selected items are listed in a treeview on the left of the form. You can display or hide the treeview according to your preference.

About Batch Process Definitions

You can view, add, or modify a batch process definition, as described later in this section.
To display or hide the English and French long and short descriptions, click on the arrow beside the text box at the top of the form.

About the Menu Manager

The Menu Manager form is used for creating the menus and submenus for organizing your batch process definitions in Govern.NET.
To access the Menu Manager

  1. Launch Govern New Administration (GNA).
  2. Select Batch Process > Definitions.
  3. Click the ellipsis button beside the Category text box.

If categories are already created, they are listed on the left. You can expand a category to view secondary levels if they exist. The name of selected menu is displayed on the right. You can expand the name to view the English and French short and long descriptions.

Creating a Batch Process Category

The first step is to create categories for your batch processes. The categories are used for displaying the batch processes in the Govern .NET menu. Create as many categories as required in order to facilitate user input.
To create a Batch Process:

  1. Launch Govern New Administration (GNA).
  2. Select Batch Process > Definitions.
  3. Click the ellipsis button beside the Category text box. This opens the Menu Manager.The Menu Manager is used for creating categories for the batch processes. You can have multiple levels. For example, you could group batch processes by module, such as: Accounts / Receivable, Tax Billing, and Mass Appraisal. Then, you could add another level that groups processes according to when they need to be run; i.e., daily, monthly, or yearly. You can create any type of category that is useful for your organization.
  4. Enter a name for the category in the text box at the top right. This is automatically added to the English Long Description field.
  5. Click the button to the left of the text box where you entered the category name. This expands a menu with additional descriptions.
  6. Add an English Short Description and French Short and Long Description as required. These fields are optional.
  7. Click Save to add the category to the menu.

If you click the Select button without saving your new category, a confirmation message appears:

Deleting a Menu Category

To delete a menu category from the Menu Manager:
1. Launch Govern New Administration (GNA).
2. Select Batch Process > Definitions.
3. Click the ellipsis button beside the Category text box to open the Menu Manager.
4. Expand the applicable menu.
5. Select the category from the Menu list on the left.
6. Click the Delete button in the menu at the top right.
7. When the confirmation message appears, click Yes to delete the record.

Selecting a Category for the Batch Process

You need to define the processes under the categories to which they are assigned and will appear in Govern. Before defining a batch process, select the menu category where it will be saved.
To select a Batch Process:

  1. Launch Govern New Administration (GNA).
  2. Select Batch Process > Definitions.
  3. Click the ellipsis button beside the Category text box to select the category for the batch process. This opens the Menu Manager.
  4. Expand the root menu to display the submenus.
  5. Select the applicable submenu or category.
  6. Click the Select button .

The root menu and all submenus are displayed in the Category text box and in the Parent Path text box. The existing batch processes are listed on the left.

Defining a Batch Process

Use the following process to name the definition and to associate it with a Govern Batch process.

NOTE: You need to define the processes under the category to which they are assigned and will appear in Govern.

To define a Batch Process:

  1. Select the category where you are defining the process as described under Selecting a Category for the Batch Process. The batch processes already defined for the category are displayed in the treeview on the left.
  2. Click the New button.
  3. Enter a code for the new batch process definition. This is a required field.
  4. Select a Govern batch process from the Process drop-down list. This is a required field.
  5. Enter a name for the record in the text box at the top right. This is automatically added to the English Long Description field.
  6. Click the button to the left of the text box where you entered the name. This expands a menu with additional descriptions.
  7. Add an English Short Description and French Short and Long Description as required. These fields are optional.
  8. Click the Save button to add the category to the menu.
    If you click the New button without saving your modifications, a confirmation message appears:

Defining the Transaction Type
The Govern batch processes can be run synchronously or asynchronously. If they are run synchronously, they are run on the same server. If run asynchronously they are run on multiple servers at the same time.
Select Synch or Asynch as required. For processes with multiple transactions, it is recommended to use asynchronous processing as this spreads the load over multiple servers and makes for faster processing time.
Pool #: For Asynchronous processes only, enter the maximum number of transactions to be handled by the client servers at any one time.
This works as follows: If you are running asynchronous batch processing, there is one master server that manages all the transactions and is responsible for sending them to the client servers. The value In the Pool # field indicates the maximum number of transactions to send out by the master server at any one time.

Scenario: Running a Batch Process Asynchronously
The following scenario illustrates how asynchronous batch processing works.
The parameters are as follows:

  • Master server: one
  • Client servers: five
  • Transactions: 50,000
  • Pool #: 50

The master server sends out the first 50 transactions to the client servers. Each server is responsible for ten transactions. As soon as a server completes one transaction, the master server sends it another. This continues until all transactions have been processed. However, there are never more than 50 transactions being handled by the client servers at any given time.

Defining the Transaction Mode

Select one of the following transaction modes for the process.

  • Break If One Transaction Failed: the process terminates when the transaction fails.
  • Roll Back If One Transaction Failed: the process terminates when a transaction fails and all the transactions that were completed are cancelled. Computations are returned to the starting point.
  • Continue If One Transaction Failed: Continue to run the process even if a transaction fails.

Adding a Report

Use the following procedure to associate one or more reports with the selected batch process.
To add a report: to the batch process:

  1. Launch the Batch Process Definitions form.
  2. Select the category for the process as described under Selecting a Category for the Batch Process.
  3. Select the batch process from the treeview on the left.
  4. Click Add Reports.
  5. Select one or more reports from the Choose the Reports menu.
    TIP: You can select multiple reports using the left mouse button.
  6. Click Select Reports.

The selected reports are displayed in the List of Reports text box. The parameters for the report are displayed in the Report Parameters list box.
The List of Parameters text box displays the parameters that can be included in the report and that can be used to build an external report; for example, these could include Date To and Date From fields. The purpose is to give you the exact reference and wording of these fields.

Deleting a Batch Process Definition

To delete a batch process:

  1. Launch the Batch Process Definitions form.
  2. Select the category for the process as described under Selecting a Category for the Batch Process.
  3. Select the batch process from the treeview on the left.
  4. Click the Delete button .

 

Adding Batch Processes Definition to Govern

When you have defined your batch processes, you need to add them to Govern.NET. In order to do this, you need to launch the Govern Security Manager and synchronize your new processes between GNA and Govern. Then, you need to assign access permissions.

Synchronizing Batch Process Definitions

When you have synchronized your new batch process definitions, they appear on the Govern.NET menu.
To synchronize the new batch processes:

  1. Launch the MSGovern Security Manager (GSM).
  2. Select your database connection key.
  3. Right-click on Applications and select Synchronize menu from the dropdown list. A confirmation message appears.
  4. Click Yes on the confirmation message.

Permissions and Batch Processes

Use the following procedure to assign access permissions to the new batch process definitions. You can grant permissions by batch process, batch process menu, or by batch process definition.

  1. Launch the MSGovern Security Manager (GSM).
  2. Select your database.
  3. Expand Applications > MSGovern.NET > Batch Process > Batch Process.
  4. Continue to expand the menus until you are the level where you want to grant permission.
  5. Right-click on the item that you want to secure.
  6. Define the permissions and exclusions as required and as described in the Govern Security Manager.

See Also

Govern New Administration (GNA)

 

 

103-ed-013-v5

 

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...

GNA – Batch Process Definition Editor

Batch Process Definition Editor

Version 6.x | Version 5 and less

Overview

The GNA Batch Process Definitions editor is used to define how you want your batch processes to appear and run in Govern. This includes setting up your batch processes, configuring each process, associating one or multiple reports, and synchronizing the batch process definitions and adding permissions. When complete, the batch processes are displayed in Govern.
This procedure has two major steps:

  • Configuring Batch Process Definitions
  • Adding Batch Processes Definition to Govern.
  • Configuring Sequential Batch Processes (101-std-fea-046)
  • Configuring Sequential Batch Processes (101-std-fea-046)

 

Read More...

Configuration

Configuring Batch Process Definitions

Configuring Batch Process Definitions describes the following topics; locate the appropriate sections on this page:

  • User Interface
  • Defining a Batch Process
  • Defining the Transaction Type
  • Defining the Transaction Mode
  • Adding a Report
  • Deleting a Batch Process Definition

Batch Process Definition – User Interface

This section provides a tour of the Batch Process Definitions UI. The interface is comprised of a treeview (left hand side), the definition form (main central area), and a secondary window for creating the menus and submenus or categories.
To access the Batch Process Definitions form:

  1. Launch Govern New Administration (GNA).
  2. Select Batch Process > Definitions.

Once you create menus and define batch processes, the selected items are listed in a treeview on the left of the form. You can display or hide the treeview according to your preference.

About Batch Process Definitions

You can view, add, or modify a batch process definition, as described later in this section.
To display or hide the English and French long and short descriptions, click on the arrow beside the text box at the top of the form.

About the Menu Manager

The Menu Manager form is used for creating the menus and submenus for organizing your batch process definitions in Govern.NET.
To access the Menu Manager

  1. Launch Govern New Administration (GNA).
  2. Select Batch Process > Definitions.
  3. Click the ellipsis button beside the Category text box.

If categories are already created, they are listed on the left. You can expand a category to view secondary levels if they exist. The name of selected menu is displayed on the right. You can expand the name to view the English and French short and long descriptions.

Defining a Batch Process

Use the following process to name the definition and to associate it with a Govern Batch process.

NOTE: You need to define the processes under the category to which they are assigned and will appear in Govern.

To define a Batch Process:

  1. Select the category where you are defining the process as described under Selecting a Category for the Batch Process. The batch processes already defined for the category are displayed in the treeview on the left.
  2. Click the New button.
  3. Enter a code for the new batch process definition. This is a required field.
  4. Select a Govern batch process from the Process drop-down list. This is a required field.
  5. Enter a name for the record in the text box at the top right. This is automatically added to the English Long Description field.
  6. Click the button to the left of the text box where you entered the name. This expands a menu with additional descriptions.
  7. Add an English Short Description and French Short and Long Description as required. These fields are optional.
  8. Click the Save button to add the category to the menu.
    If you click the New button without saving your modifications, a confirmation message appears:

Defining the Transaction Type
The Govern batch processes can be run synchronously or asynchronously. If they are run synchronously, they are run on the same server. If run asynchronously they are run on multiple servers at the same time.
Select Synch or Asynch as required. For processes with multiple transactions, it is recommended to use asynchronous processing as this spreads the load over multiple servers and makes for faster processing time.
Pool #: For Asynchronous processes only, enter the maximum number of transactions to be handled by the client servers at any one time.
This works as follows: If you are running asynchronous batch processing, there is one master server that manages all the transactions and is responsible for sending them to the client servers. The value In the Pool # field indicates the maximum number of transactions to send out by the master server at any one time.
Scenario: Running a Batch Process Asynchronously
The following scenario illustrates how asynchronous batch processing works.
The parameters are as follows:

  • Master server: one
  • Client servers: five
  • Transactions: 50,000
  • Pool #: 50

The master server sends out the first 50 transactions to the client servers. Each server is responsible for ten transactions. As soon as a server completes one transaction, the master server sends it another. This continues until all transactions have been processed. However, there are never more than 50 transactions being handled by the client servers at any given time.

Defining the Transaction Mode

Select one of the following transaction modes for the process.

  • Break If One Transaction Failed: the process terminates when the transaction fails.
  • Roll Back If One Transaction Failed: the process terminates when a transaction fails and all the transactions that were completed are cancelled. Computations are returned to the starting point.
  • Continue If One Transaction Failed: Continue to run the process even if a transaction fails.

Adding a Report

Use the following procedure to associate one or more reports with the selected batch process.
To add a report: to the batch process:

  1. Launch the Batch Process Definitions form.
  2. Select the category for the process as described under Selecting a Category for the Batch Process.
  3. Select the batch process from the treeview on the left.
  4. Click Add Reports.
  5. Select one or more reports from the Choose the Reports menu.
    TIP: You can select multiple reports using the left mouse button.
  6. Click Select Reports.

The selected reports are displayed in the List of Reports text box. The parameters for the report are displayed in the Report Parameters list box.
The List of Parameters text box displays the parameters that can be included in the report and that can be used to build an external report; for example, these could include Date To and Date From fields. The purpose is to give you the exact reference and wording of these fields.

Deleting a Batch Process Definition

To delete a batch process:

  1. Launch the Batch Process Definitions form.
  2. Select the category for the process as described under Selecting a Category for the Batch Process.
  3. Select the batch process from the treeview on the left.
  4. Click the Delete button.

Adding Batch Processes Definition to Govern

When you have defined your batch processes, you need to add them to Govern.NET. In order to do this, you need to launch the Govern Security Manager and synchronize your new processes between GNA and Govern. Then, you need to assign access permissions.

Synchronizing Batch Process Definitions

When you have synchronized your new batch process definitions, they appear on the Govern.NET menu.
To synchronize the new batch processes:

  1. Launch the MSGovern Security Manager (GSM).
  2. Select your database connection key.
  3. Right-click on Applications and select Synchronize menu from the dropdown list. A confirmation message appears.
  4. Click Yes on the confirmation message.

Permissions and Batch Processes

Use the following procedure to assign access permissions to the new batch process definitions. You can grant permissions by profiles and grant permissions to the Batch Process Editor application in Govern Administrator.

  1. Launch the MSGovern Security Manager (GSM).
  2. Select your database.
  3. Expand Applications > MSGovern.NET > Batch Process > Batch Process.
  4. Continue to expand the menus until you are the level where you want to grant permission.
  5. Right-click on the item that you want to secure.
  6. Define the permissions and exclusions as required and as described in the Govern Security Manager.

What’s New

 

Related Topics

Govern New Administration (GNA)
Batch Processing in OpenForms

 

 

103-ed-013

 

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...

 

Standard Batch Processes

Standard Batch Processes

Overview

Batch programs are used to calculate and update multiple records at the same time, to post records to the General Ledger accounts, to delete records that are not posted, to apply pending amounts and penalties, to extract or compute amounts for a specific date, and to close a fiscal period or year. This page provides general information on batch processes that applies to all modules and systems.

Batch processing in OpenForms Systems:

 

  • Govern (Standard User Feature)

    100-batchprocess-(ui)-diagram_small.png
    Click on the image to enlarge

     

  • Govern Administrator (Batch Process Editor and Schedule Creation)
  • Govern Scheduler
  • Govern Batch (Govern for Windows OpenForms Batch execution 6.0 and less)

Click here for installation and step by step information or for a tutorial presentation with print screens.

 

Read More...

Standard Features include:

Batch Naming

Distributed Batch Processes include:

Terms and Definitions:

  • Batch Program: Refers to standard or custom code developed in Govern to perform one or more actions for a selection of entries meeting predefined conditions (business rules) and/or user defined parameters.
  • Batch Process Name: Identifies the method or class name executed in code when launched, stored in the VT System, Table Name = ‘BATCH_PROCESS’ as a code
  • Batch Process Definition: A batch process definition is used to setup the batch process options and execution parameters.
  • Audit Batch ID: Once a batch process definition is launched, a batch audit ID sequence is assigned and errors, warnings and information is recorded for the batch ID in the Batch Audit Table
  • Batch ID: When a batch process definition is created, it is assigned a batch id. Listed in the Batch Audit Result window and in the Import/Export EMT function.

Restrictions:

  • Expressions used in the batch process cannot use the Display function for the attributes of type Lookup. The reason being that the lookup information is not loaded for the batch process in this case.

Harris Developers, click here to access the techno page.

Batch Process Setup

System Validation Table

Process Names are updated automatically the first time Verify Database is executed after having deployed a new release.

100-bp-setup-(ui).jpg
Click on the image to enlarge
  • To review, select Govern Administrator > Editors > System Validation Table Editor > and select in the Table list table name BATCH_PROCESS

Batch Process Editor

To create the batch process definition and execution parameters

Linking Batch Process Definitions to Profile
Each batch process definition must first be defined in GNA, and then linked to a profile.

  • To link a batch program to a profile, in GNA, select Editors > Profile > click on the [profile] to add the batch program > on the LINKS tab, click on ADD under Batch Processes

Security Setup

Batch Process Explorer Toolbox and View Menu Security (GOVERN General access)
Govern Security Manager (GSM)

  • To access, select Applications > Govern > MENU > View > View > ‘Batch Process’ and richt-click for permissions
  • With no execute access to this function, it will be impossible to run a batch process – T/C If linked function

Batch Process Editor Security (GNA Editor access)
Govern Security Manager (GSM)

  • Access permissions (execute, insert…) can be provided to the Batch Process Editor by role and user.
  • To access, select Applications, Govern Administrator (GNA), select Editors > Editors > Batch Process Definition Editor – T/C Security Settings

Batch Process Definitions by Profile (linked to)
Govern Administrator (GNA)

  • Each batch process definition must first be defined in GNA, and then linked (added) to a profile.
  • To access, in GNA, select Editors > Profile > click on the [profile] to add the batch program > on the LINKS tab, click on ADD under Batch Processes

Batch Process Definition Security (GNA
Govern Security Manager (GSM)

  • Permissions by batch process definition can be set by profile, role and user, after a batch definition has been added to a profile and a SYNCHRONIZE has been executed in GSM
  • To access, select Applications > Govern > PROFILES > click on [profile] to set > Batch Processes > click on the [batch process definition] to set and right-click for permissions

Tables/Fields & Naming Standards

The following tables and fields are used in batch processing

Batch Process Name

  • Recorded in [VT_SYSTEMS] codes where [TABLE_NAME] = BATCH_PROCESS
  • Note to Developers:
    • Standard Batch Process Names for module applications should not be more than 11 characters (15-4) in case we need to add a customer code (Ex: WPG_postar)
    • System Core Features Batch Process start with CO_

Batch Process Definitions

  • Batch Process Definitions are recorded in the following files by BATCH_ID
    • [USR_BP_DEF] Contains general information, email information, etc.
    • [USR_BP_DEF_SCHEDULE] Contains the schedule setup
    • [USR_BP_DEF_SCHEDULE_RUN_LOG] Contains the start and end date
    • [USR_BP_DEF_SCHEDULE_RUN_DTL] Contains the log details and serialized information

User Batch Audit

  • When a batch definition is executed, information, warnings and errors are recorded in this table:
    • [USR_AUDIT_BATCH] by AUDIT_BATCH_ID
    • IMPORTANT: Archiving schedule should be discussed – T/C best practices

Product Code for Batch Programs

  • Standard Govern Batch Program = System + Module + BP _ Sequence (ex: 101-ar-bp-001)
    • See Standard and Module product maps for the list of batch processes distributed
  • Stand Alone Custom Batch = Customer Number + Module + BP + Sequence (ex: 901-ma-bp-050)
  • Standard Batch Programs Customization (standard code with customized dependencies) = System + Module + BP+ Sequence + Client Code (ex: 101-ar-bp-001-WPG)

List of Standard Batch Processes

Click to view the List of Govern Standard Batch Processes.

Troubleshooting

Service keeps shutting down / Port is used elsewhere

  • Once you install the service, if it keeps stopping after restarting it, most likely the port is used elsewhere in the organization.
  • A message stating Missing Parameters will be listed on the Service Tab of the Scheduler console
  • Uninstall the service, change the port and re-install.

The service is not running

  • In the event the machine where the local service is installed is rebooted, the service might not be restarted.
  • Check the extended service details and make sure the STARTUP TYPE is set to AUTOMATIC.
  • The service is listed under Govern Scheduler [CONNECTION KEY]

The application and the service are not compatible

  • You are trying to install the BSS from a different major release. Download the correct Install pack and start again

Restarting the Service after it was stopped

  • You can start the service directly in Govern Scheduler from the Services Tab or from the Task Manager Service Tab.

Report does not exists

  • When you add a report in a batch definition (rpt scheduler only perhaps), it does not check if it exists or not.
  • If this is the case, you might get a time out or the system will seem to be frozen. Check the report path setup in the General Parameters (SY_REGISTRY) and make sure report exists.
  • After the setup, open the Batch Process Definition in Govern and look in the report tab to validate there is not errors.

Batch Scheduler Service (BSS) Firewall is blocking access

  • If the machine running the Batch Scheduling Service is remote, firewall settings are needed to provide access to the port used.

Existing Service exists for a different connection key

  • Uninstall the service(s) using the SC delete SERVICE NAME (GovernSchedulerService_Connection Key) from the Command Prompt Editor (run as Administrator). Reinstall service.

Access Denied to Path

  • If you get this error message in the batch log, you will need to make sure the folder (log path and other ) has READ/WRITE Access. To validate

Best practices

Clean-Up Unused Applications

  • Unused Govern OpenForms applications should be uninstalled (mandatory for Deploy-EZ)
  • To uninstall applications, Select Program and Features from the Control Panel, locate the program and click uninstalled.

 

 

100-batchprocess

 

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...

 

AR – Delinquency Collection Batch Processes

Delinquency Collection Batch Processes

Overview

The Delinquency & Collections modules includes the following batch processes.
  • Transfer A/R to Delinquency
  • Delinquency Posting

Prerequisites

Before running the batch processes for Delinquency & Cash Collection, verify the following:

  • All A/R records to be transferred to Delinquency must be associated with a Delinquency A/R Class Code.

Defining Security Permissions for the Delinquency & Collections Batch Processes

Security for all batch processes in Govern OpenForms are defined in the Govern Security Manager (GSM) as follows:
To define security permissions for a batch process:

  1. Launch the Govern Security Manager (GSM).
  2. Expand Applications > Govern > Profiles > <name of the Profile> Batch Processes <name of the batch process>.
  3. Right-click on the batch process.
  4. Select Edit.
  5. Assign permissions by role.
  6. Select Exclusions.
  7. Define the exceptions.
  8. Click Save.

Transfer A/R to Delinquency

The Transfer A/R to Delinquency batch process is run in order to automate the process of transferring delinquent A/R records to the Delinquency and Collections module. It performs the same tasks as transferring individual records one by one on the Delinquency form.

Only records that are associated with an A/R Class Code that is linked to a Delinquency Collection A/R Class Code can be included in the process.

There are two procedures contained on this batch process.

  • Process Delinquent A/R: This is the first step. Run this procedure to transfer the delinquent A/R records to Delinquency and Collections.
  • Finalize Delinquent A/R: This is the second step. Run this procedure to finalize the A/R records.

A separate batch process is required in order to post the delinquent records that were included in the two Transfer A/R to Delinquency batch process procedures.
Posting to A/R: Once records are finalized, you can run the Posting to A/R batch process. This procedure is described in the following section.

Running the Process Delinquent A/R Procedure

To run the Process Delinquent A/R batch process from Govern:

  1. Launch Govern.
  2. Open a Profile that contains the Transfer A/R to Delinquency and Collections process.
  3. Select the Batch Processing Explorer.
  4. Select the Transfer A/R to Delinquency and Collections* batch process.*
    The name of the batch process can vary according to the administrative setup.
  5. Select the subsystem under which the delinquent A/R records are saved from the Subsystem drop-down list.
  6. Select a Cycle Code from the A/R Cycle drop-down list.
    The A/R Cycle parameter appears only for the Real Property and Personal Property Tax subsystems.
  7. Select the Process Delinquent A/R option.
  8. Enter a range of years in the From Year and To Year parameters.
    Only the records within the selected range are processed.
    The range of years appears for year-based subsystems only.
    It is used to ensure that the current bills are not accidentally transferred to Delinquency & Collections.
  9. Select a department from the Department drop-down list.The fiscal year from this department is displayed in the Fiscal Year parameter.
    This year is used to create the Delinquency account in the table AR_MASTER. It is also used for all records in AR_DETAIL.
  10. Select a date from the Filing Date drop-down list.
    This is the date of the transfer (Table: DC_MASTER.FILING_DATE)
  11. Enter a unique number in the Claim Number parameter.
    The claim number is applied on all records included in the batch process.
    It is a required field on the Delinquency & Collections user form, as well as on the Transfer A/R to Delinquency & Collections batch process form.
    This Claim Number is selected when you run the process to finalize the records.
  12. Select a warning flag in the Exclude A/R Warning Flag list box if you want to exclude certain records from the batch process.
    Records with the selected warning flag are excluded from the process.
    For example, you may want to exclude all records that are included in the Bankruptcy module from the process.
  13. Enter the minimum balance due on the records that you are transferring to Delinquency in the Minimum Balance Due field.
    Only the records that are greater than or equal to the Minimum Balance Due are transferred.
  14. Select an A/R Reason Code from the drop-down list (Table: VT_USER.TABLE_NAME = ‘ARREASON’)
    The A/R Reason Code is displayed by long description.This reason code is associated with the original record by AR_ID.
    For the delinquency record, it is used for informational purposes only.
  15. Click Execute.

If you are running the batch process from Govern, the status of the process is displayed in the Processing tab. If errors or warnings occur, messages are displayed.
You can run the batch process again in order to include records not included in the first claim. For example, if records are not associated with an A/R Class Code that is linked to a Delinquency A/R Class Code, they are not transferred to Delinquency.

Running the Finalize Delinquent A/R Batch Process

The Finalize Delinquent A/R Batch Process sets all records with the selected Claim Number to Finalized.
Once records are finalized, you can run the Posting to A/R batch process.

To run the Process Delinquent A/R batch process from Govern:

  1. Launch Govern.
  2. Open a Profile that contains the Transfer A/R to Delinquency and Collections process.
  3. Select the Batch Processing Explorer.
  4. Select the Transfer A/R to Delinquency and Collections* batch process.*
    The name of the batch process can vary according to the administrative setup.
  5. Select the subsystem under which the delinquent A/R records are saved from the Subsystem drop-down list.
  6. Select Cycle Code from the A/R Cycle drop-down list.
  7. Select the Finalize Delinquent A/R option.
  8. Select a claim number for the Claim Number drop-down list.
  9. Only the claim numbers that contain records that are not finalized appear in the list.
  10. Click Execute.

Transfer A/R to Delinquency Log Files

The log files for the Transfer A/R to Delinquency batch processes includes the following information:

  • Start and End time of the process
  • List AR_ID and balances being transferred
  • Sum of each class code being transferred to DC
  • Count of AR_ID being transferred to DC

Delinquency Posting

The Delinquency Posting batch process posts the delinquency records to the Govern Accounts/Receivable subsystem.
You can run this process at any time from Govern or create a schedule and run it at a later time or on a regular basis. For details about scheduling batch processes, refer to the Govern Scheduler guide.

The Delinquency Posting form has two sections.
The top section lists all the delinquency records with deposit numbers, by deposit number and A/R balance. The lower section provides the following details about those records:

  • Delinquency Claim Number
  • Balance
  • Finalized status: If the record is finalized, the check box is selected.

Only the Delinquency and Collection records that are Finalized can be posted to A/R.

To run the batch process from Govern:

  1. Launch Govern.
  2. Open a Profile that contains the Delinquency Posting batch process.
  3. Select the Batch Processing Explorer.
  4. Select the Delinquency Posting* batch process.*
    The name of the batch process can vary according to the administrative setup.
  5. Select the record or records that you want to post in the top section of the form.
  6. Click Execute.

If you are running the batch process from Govern, the status of the process is displayed in the Processing tab. If errors or warnings occur, messages are displayed.

Viewing Posted Delinquency and Collection Records

The posted Delinquency and Collection records are displayed in the Balance Forward Detail grid on the A/R Inquiry form.

Refer to the Govern Accounts Receivable documentation for details about the A/R Inquiry form.

Troubleshooting

You can only run the Delinquency Posting process on records that are finalized.
In the following screen shot, some of the records under the selected deposit number are not finalized. Therefore, you cannot run the batch process on this deposit number until you finalize the records.

Documentation

To view the documentation for this feature, click on this link to https://kb.harrisgovern.com/101-ar-bp-039/.

Related Topics

0 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 50 votes, average: 0.00 out of 5 (0 votes, average: 0.00 out of 5)
You need to be a registered member to rate this.
Loading...