Std. Feature – View Query Link

Standard Feature – View Query Link

Overview

Query Links are a powerful feature in Govern for OpenForms. This feature allows the addition of a link in a custom control that will open another form or report. In addition, with this feature users are able to set and pass a Govern ID before opening a report or OpenForm. There are a few ways that this feature is implemented in the Govern for OpenForms application.

View Query Link

Why a View Query Link

The main purpose if this implementation is to have an account set up with a principal record, and all satellite offices associated with that record were to then be presented in a grid. When this ACCOUNT that is based on a name ID, is retrieved, if the current ID is set to NA_ID1, then a click on a link could be made to open the name and address of its satellite offices, NA_ID2, NA_ID3, and so on. Previously this link could be performed to another OpenForm, but it was not possible to change the active Name ID (NA_ID) on the linked form. One previous workaround was to take the ID of the current form, go to the configuration of the form and set the NA_ID as an ID setter, as this was not always desirable, often a button was used to control whether the ID would be set. With the View Query Link feature, a more streamlined solution is obtained. When this feature is configured, there are multiple methods of implementing it.

NOTE: The end results are similar, but the methods of implementation differ.

 

BUSINESS RULES:

  • If the profile is parcel based, and you search for a P_ID that exists in the profile, a reposition will occur, i.e. the focus will be on the new parcel which will be set as active.
  • If the P_ID that is being searched for is not in the profile, that record containing the P_ID will be added to the Treeview, i.e. populate the Treeview.
  • If it’s not the same ID, ex. Only a Name ID, the ID will be set, but nothing will be appended to the Treeview.

View Query Link – Type 1

What are referred to as Type 1 View Query Links are the basic implementation of the View Query Link feature. The link is presented as a hyperlink or a button that will initiate the link. To demonstrate this feature, we will add a link to the Coordinate parameters on the parcel information OpenForms.

Configuration

When a link is placed in the Coordinates group. This link will be set with different properties. As is allowed in the OpenForms Designer (OFD), the link can be initiated as a Hyperlink, or an Action Button.

View Query Link – Type 2

A second implementation is used within the Self Reported Tax Estimate form. A link is created within a View Query. When this link is selected, it will launch the SRT Form on the Tax Filing entity for the specified period.

Configuration

Using the ST Estimate feature as an example, a link to the ST account entity will need to be created. The required configurations are made in the Govern New Administration (GNA) and the OpenForms Designer (OFD). In addition a standard view query will need to be modified through the GNA.

View Query Link – Type 3

The third implementation the View Query Link yields the same link results as the Type 1 and Type 2 implementation, i.e. for SRT, it will launch the Form on the Tax Filing entity for the specified period. Links are created under the Govern Home tab in the Dashboard area.

Configuration

The setup of this View Query Link type is made in the Profile Editor of the Govern New Administration
Examples of the use of the three types of view query links can be observed in the attached documentation.

Importance of Syntax

Modifying the Query

To modify the query, we will use the SQL Query editor in the GNA. The following queries are to be modified for this example:

  • smPC07 – Current Owner Names & Address
  • smPC08 – Previous Owner Names & Address

Before we can modify the column we need to change to a link, we need to add another column.

  1. On the GNA Ribbon, go to GNA > Editors (tab) > Select Query Editor.
  2. Look for the smPC07 query; click to select this query for editing.
  3. In the editor we will add another column BEFORE the column that is to be changed to a link.

‘Form=NA01;NA_ID’ + CAST(NA_ID AS VARCHAR) ‘<LINK>’

Proper use of the <LINK> tag

When the ‘<LINK>’ tag is seen before the column, this is an indication that the column is to be hidden and the link information is to be applied to the next column.
DEVNOTE: The Same column can be added twice if single quotes ‘aLink’ are used; there is a restriction if double quotes “” are used.

NEW Select a specific Entity on the form

An enhancement has added to the View Query Link functionality. It is now possible to open a form and re-position to a specific entity within the form. The ID can then be auto-selected by setting the Govern ID.
To access a specific form and tab item, use the following syntax for the query…
‘Form=FormNum:EntityName;NA_ID=’
…where <FormNum> is the Govern form number, e.g. ST007 immediately followed by a colon:”, then the <EntityName>, e.g. ST-Filing. There are no spaces between any of the names. Here is an example that will access the Self Reported Tax form (ST007), and specifically target the ST-Filing entity. The Govern ID is then specified, in the following case, an NA_ID
‘Form=ST007:ST_Filing;NA_ID=’

NOTE: If the entity specified in the query is not available, the result will default back to the top level form.

Key Parts of the Modification to the Query

The modifications needed for the query are made up of three (3) parts.

  • The column must be named as follows: ‘<LINK>’
  • Indicate what the column is to return NA_ID’ + CAST(NA_ID AS VARCHAR)
  • The form that is to be opened. ‘Form=NA01;NA_ID’
    i.e. the form NA01 is to be set with the NA_ID. Alternatively, the syntax can also be modified to open a report by referencing the report name: ‘Report=NA01;NA_ID’
NOTE: The order of the information is important. The column that will have the link will always be on the next column.

Error Handling Messages:

DEVNOTE: If a code is entered for a non-existent form, an error message is invoked: This form is not accessible, review with your administrator.

If the configuration was performed correctly, the P_ID will be changed. Incorrect configurations can result in errors. Often the error that is encountered is related to syntax. For example an error screen such as the following may be displayed.
In the following, the “=” was missing from the p_id portion of the query.
‘p_id’+ @attrX + ‘;na_id=’ + @attrY (ERROR)
‘p_id=’+ @attrX + ‘;na_id=’ + @attrY (OK)

Documentation

Below is the documentation related to this feature:

101-std-fea-036-View_Query_Link.pdf

Related Topics

Business Tax – Corporate Account

Govern Standard Module Product Map

 

101-std-fea-036

 

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...

Govern System Dictionary (SY_DICT_DESC)

System Dictionary (SY_DICT_DESC)

Version 6.0

Overview

The system dictionary tables (Table: SY_DICT_XXXX), have historically been used to manage and maintain form descriptions in the Govern database.
There are four SY_DICT_XXXX tables in the Govern database. They are as follows:

  • SY_DICT_DATANAMES – Legacy table from Govern for Windows; this table is still maintained during Verify DB process to keep track of structure and for indexing. (May be dropped in OpenForms Release 6.1)
  • SY_DICT_DESC – Active table that is used to maintain descriptions. Refer to process to generate missing dictionary entries.
  • SY_DICT_TABLES – Legacy table from Govern for Windows; this table is still maintained during Verify DB process to keep track of structure and for indexing. (May be dropped in OpenForms Release 6.1)
  • SY_DICT_VIEW – Legacy table from Govern for Windows; table is still maintained during Verify DB process to keep track of structure and for indexing. (May be dropped in OpenForms Release 6.1)

Of the four (4) databases, there is only one table that is relevant to OpenForms, (Table: SY_DICT_DESC). The three remaining tables are only relevant to Govern for Windows, and may be, at some point eliminated in later version 6.1 releases.

Maintenance Process

As indicated above, in OpenForms, the SY_DICT_DESC table is used to manage and maintain form descriptions through the Verify Database process in the Govern New Administrator (GNA).

Verify Database

The following is a description of the DB Verification actions that directly impact the collection of SY_DICT_XXXX tables. The action is used to generate Missing Dictionary Entries. This is an explanation of the process.
During the Check Column process, Govern manages the description of the fields in the SY_DICT_DESC Table.

  1. The Database Verification file, MSGDatabaseStructMods.xml is read.
  2. The content of the SY_DICT_DESC table is read, the columns of each table are reviewed, and the SY_DICT_DESC.DESCRIPTION (ENG / FRA) is verified as to whether it exists.
  3. If an entry does not exist, it will need to be created, i.e. (ADD), or removed (DROP); in cases when a complete removal of a table is required, any description that is connected to it is also removed.

Only the following columns in (Table: SY_DICT_DESC) are updated:

  • LANGUAGE
  • TABLE_NAME
  • FIELD_NAME
  • DESCRIPTION – There is a 50 character limitation, i.e. all characters after the 50th are truncated.
  • DETAIL – Uses the ‘DESCRIPTION’ property.

Generate Missing Dictionary Entries

Select this option to update the dictionary. This populates (Table: SY_DICT_DESC) with data from the user validation tables; i.e., the tables beginning with VT_USR.

Recommended Use

This process should be run under the following conditions:

  • When configuring the system for the first time
  • After updating the database
  • Anytime that data is missing from user forms.

Modification of process starting from the following release:

  • 6.0.1603.0410 / 6.0.1606.0010 / 6.0.1608.0006
  • 6.1.1603.0481 / 6.1.1606.0021 / 6.1.1608.0016

Custom Entities

Users that create their own custom entities should note that the Verify Database process will not overwrite their descriptions. If there are two entities with the same table/column, the SY_DICT_DESC.DESCRIPTION will be taken from the last label entered. As long as modifications are only made to the custom entities that were created there will be no issues will descriptions being overwritten.

 

 

101-std-fea-038

 

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...

User Key Dynamic

User Key Dynamic

Version 6.0

Overview

This standard technology is a control that is used to generate unique keys in Govern.

Functionalities

Workflow Management

Like user key master, a workflow needs to generate ID’s for Application, Number and Certificates when creating workflows.
Unlike user key Master, though, the fields representing those keys are generated dynamically and are strings, not numerical values.
For the workflow. it creates unique keys for Application, Number and Certificates.

Generates 3 keys in USR_KEY_DYNAMIC table with the following key format: <key type>[<type>:<code>]

  • <key type> are APPLICATION, NUMBER and CERTIFICATE
  • <type> are KIND, CATEGORY, etc. Departments and Types will have their own <type> as well.
  • <code> is the record code like the kind and category code.

Related Topics

User Key Dynamics
System Data Dictionary

 

 

101-std-fea-040

 

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...

System Architecture (Dataset Treeview)

System Architecture (Dataset Treeview)

[In Development]

Overview

The following table describes the rules that the Dataset Treeview is adheres to. For flexibility, Views (queries) are used to define the content to be displayed. To improve the user experience, a Standard Iconology provides visual information to identify the type and status of records listed in the treeview.

Database Views

Naming Standard
V_TREEVIEW_(name) Standard system Govern views that are distributed.
VW_TREEVIEW_(name) Custom views to include in the list of Treeview that can be selected for a profile
Database
Security Access No special security required for the view
SQL View Syntax
Primary Govern ID LINE 1
The first field matching a Governs ID name must match the Profile Dataset Type (brule)
Secondary Govern ID LINE 1
Sequential, i.e. Line 1, Line 2, and so on…
Information Displayed LINE 1
The attributes and their order to be displayed are defined in. Formatting is made in the SQL query view…
Mouse-Over (Tool Tip) LINE 1 to Line X (Need to verify)
Each line will be displayed on the mouse-over
Sort Order Primary Sort
Not relevant…
Security
Database Access Set up in Profile Editor
Setup
Profile Editor For each profile, a treeview is selected that matches the correct dataset type access

Supported Views

Standard Views
For name dataset profiles (NA_ID) The following views are supported:

  • V_TREEVIEW_ADDRESS (Name and Address)
  • V_TREEVIEW_BTAX (Name and Business Tax Info)
  • V_TREEVIEW_PP (Name and Personal Property Tax Info)
  • V_TREEVIEW_MB (Name and Misc. Billing Info)
For parcel dataset profiles
(P_ID)
The following views are supported:

  • V_TREEVIEW_LOCATION (Property Location)
  • V_TREEVIEW_PARCEL_INFO (Property General Info)
For A/R dataset profiles
(NA_ID)
For Accounts Receivable Profiles (NA_ID)

Distribution Methods (Govern Techno)

Views are created, updated, included in …

SYSTEM AREA ITEM DESCRIPTION
Database Verification
Create The standard views are created automatically on a Database Verification execution when the view does not exists
Update The standard views are replaced when there is a deletion. They are recreated;
Verify The standard views are executed for errors … errors are thrown
EMT (Import / Export)
Exported When a profile is exported Views are also transferred
Imported No Views are imported
Database Extraction
Extracted with The standard/custom views in use for all Views and Functions and are extracted and copied. >00b050
Mobile
Copied Standard and Custom views are copied.

Standard Iconography

SYSTEM AREA ITEM DESCRIPTION
Standard Icons
Govern IDs Profile Dataset Govern ID Icons that are displayed in front of each record when by:
Parcels = HOUSE icon (p_id)
Names = PERSON icon (na_id)ALL OTHER ITEMS
Accounts = FOLDER icon (ST_ID, PP_ID, MB_ID, UB_ID, RE_ID…)
None or Undefined = Govern ID only
Edit mode turned on = Padlock icon
Record Selected Regular – These use the same icons as the selected identifier
When Edit Mode
The Lock icon is displayed when Edit Mode is Activated. On selecting a record, the EDIT icon is displayed and must be pressed to access record in modification mode
Inactive Records Same Govern ID icon but greyed out

Dynamic Search (eSearch), Saved Datasets and Treeview

The Dynamic Search (AKA e-search) and saved dataset search is highly integrated with the treeview. Users can use the results of searches to append to, or remove records from the treeview.

Dynamic Queries

ACTION CONDITION EXPECTED RESULTS
Send to the Treeview From Dynamic Queries The result of a search 101-std-fea-004
On Append Records are added to the treeview
On Deselect and Load Not Applicable (N/A)
On Add and reposition Custom Control action – Determine Custom Control

Saved Datasets

ACTION CONDITION EXPECTED RESULTS
Get Records
From Saved Dataset The content of a saved dataset101-std-fea-006
From Action Button Send to Treeview If the action button sent to the treeview is used (available in the following standard forms: Split Merge, Parcel Linking, Name Linking

Other Treeview Integration

The treeview can be populated from the Dynamic Search Queries (e-search), from the Query Tool, from a Saved Dataset or from special Action Button Controllers (Send to Treeview). Optionally, if they are setup to this effect, the treeview can be populated by the results of the Matix GIS search, the Web Browser and the Application Browser forms.

ACTION CONDITION EXPECTED RESULTS
Get Records
From Action Button Send to Treeview If the action button send to treeview is used (available in the following standard forms: Split Merge, Parcel Linking, Name Linking
From GIS Matix Search 101-std-frm-008
Manual Mode
Automatic Mode
From Web Browser Form 101-std-frm-003
Manual Mode
Automatic Mode
From Application Browser From 101-std-frm-005
Manual Mode
Automatic Mode
From Query Tool Manual refresh to be performed by user. ()
Selected Record
Default First record is selected
User clicks on a record Record is selected
On Select
Refresh Govern IDs Main Govern IDs
Secondary Govern IDS
First Record is Selected
Refresh Forms

Treeview User Interaction

The users can perform the following Treeview Actions

ACTION CONDITION EXPECTED RESULTS
On Mouse Over
Tool Tip Line 2 to x is displayed as a Tool Tip
On Select
User clicks on a record The Govern IDs are refreshed
The icon changes
The forms are refreshed with the selected record Govern ID
On Remove
X The user can remove records from the Treeview
On Move
Previous F6 Go Up
Next F7 Go Down
On Expand
Form Expand Icon The Forms are displayed below the treeview entry.
The same forms as the Forms Explorer are displayed. Displays the forms that the user/role has access to in GSM
Double Click
On Collapse
Form Expand Icon The Forms are no longer displayed
Double Click

Inactive Business Rules

The users can perform the following Treeview Actions

ACTION CONDITION EXPECTED RESULTS
Parcel
Inactive and Effective year
Effective date
Name
Buildings
Effective and Inactive date
Links
Effective and Inactive date
Accounts
Jurisdictions
TFS13225
Mobile
Checkout Bypass Checkout

Special Features

The users can perform the following actions:

NOTE: The following actions are the same as on load.

 

ACTION CONDITION EXPECTED RESULTS
Auto Synch
Form Refresh
Govern F5 Used to update the treeview
If profile view is changed
If form is added
If date is changed
Hibernate

 

 

101-std-fea-005-Treeview_Architecture

 

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 Feature – Saved Datasets

Saved Datasets

Overview

Govern Saved DatasetsThe Govern Saved Dataset pane is standard in release 6.0 and higher. This pane will allow users to load, save, and delete saved datasets. All saved datasets for the current user, excluding datasets that are present prior to the hibernate process.
In addition, users are able to create new datasets from a search result, append to an existing dataset, load, edit, or delete one or multiple datasets.

What’s New

When applicable, new features, or new ways of performing an old function in Govern will be listed below. Version Numbers and sections will be indicated in the list.

Saved Datasets Interface

The interface is an auto-hide pane. This pane appears with a click on the Saved Datasets icon on the Ribbon, or by hovering the mouse pointer over the tab.

Saved Dataset Grid Behavior

The Saved Dataset grid allows for creation and maintenance of user saved datasets.

Select all saved datasets in the list…

Click on the check box of the first header column to select all items in the grid.

Sort Grid by Headers…

As is standard with Govern grids, a click on a column header will sort the list in ascending or descending order. Ascending or Descending order is determined by the direction of the triangle that appears in the column heading. Typically the list is sorted by the name or the date.

Restoring the default Sort Order

Click the header until the arrowhead indicating the direction of the sort disappears.

Quickly Load a Saved Dataset to the Treeview…

When you want to quickly load a dataset to the treeview pane, double click on a row to clear the Dataset Treeview and load all selected dataset to the tree view.

Grouping by Columns…

The Governs interface drag and drop features allow for additional possibilities in the grid. The space above the columns is referred to as the Grouping Area. When possible, this space expands to accommodate column names when they can be added.
To group according to a column…

  1. Click and drag the column head to the space marked “Drag a column header here to group by that column“.
  2. Release the Column header in the area.
  3. Repeat the drag and drop action for additional required columns.

Removing Column Groupings…

To remove column groupings…

  1. With the mouse pointer, click and drag the column heading from the grouping area.
  2. When your cursor is outside the grouping area, the cursor will change to a large “X”.
  3. Release the cursor; the grouping will be removed.

Command Buttons

The Saved Datasets pane can be displayed by hovering over the auto-hide tab. When you want the pane to display permanently without sliding back, click the Auto-Hide pin icon. The pane will remained fixed in the interface until the Auto-Hide button is re-selected.

Load to Treeview

Click Load to Treeview to load a dataset to the Treeview. The feature is enabled only if at least one item is checked. When clicked, the action will clear the dataset treeview and load all selected datasets to the treeview.

Append to TreeView

To append to the records that are in the treeview, click Append to Treeview. This button will only be active when one or more datasets have been selected in the Saved Datasets grid. When the append action is performed, all records from the selected datasets will be appended to the treeview.

Add / Replace Dataset

Toggle button between add and replace dataset. If at least one item is selected, replace the items in the selected dataset, otherwise create new dataset by showing the Save dataset window.
This button is always visible. When the user selects the Add a New Dataset button, they will be prompted with the Create New Dataset screen. Enter a name and click Save.

Append Dataset

Append Dataset will append all items from the tree view to any selected datasets in the list of saved datasets. This button is only active when one or more saved datasets has been selected in the list.

Delete Dataset

This button is used to delete saved datasets. To delete one or more dataset from the list, select the datasets that are to be deleted, and click Delete Dataset.

Share Dataset

Users that are members of other roles may share their Saved Datasets. This is done through Share Dataset feature.
To share saved datasets…

  1. Select the check box for the dataset that you would like to share.
  2. Click Share Dataset.
  3. In the Share Dataset window, enter a name for the shared dataset.
  4. Select the Roles and or Users that you are a member of, and would like to share the dataset with.
  5. Save the change with a click on the Share button.
NOTES: Saved Dataset names can be up to 50 characters including spaces. The datasets that are displayed are only for current ID’s, as an example if the open profile is based upon a P_ID, then only saved datasets that have a Reference Type of P_ID are displayed.

Video

NOTE: There are no Training Videos available

 

 

101-std-fea-006

 

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...

BP – Generate SSRS Reports by Groups

Batch Process – Generate SSRS Reports by Groups

Overview

Processing time is a factor where batch processes are concerned. In instances where a batch process is to be run on queries that result in an extremely large record set, processing time can be an issue. In order to manage long processing times for a single large record set, an SSRS report can be run that will break down the record set into multiple smaller, manageable groups. Each individual group will require less time to process. The Generate SSRS Reports by Group batch process will scan for any existing groups generated by the SSRS report, and print or save in the .PDF file format.

SSRS Report name: co_genssrsgprpt

Batch Process Name: Generate SSRS Report by Groups

 

Read More...

Functionality

Report

The report will provide the records of groups for the .PDF file. For example, a query generates 1000 records. In our report we will specify that the resulting record set of 1000 parcels be divided into N groups; where N = 10. The resulting record set is broken up into 10 groups consisting of 100 parcels per group. Both the number of groups to print (N), and the Year will be hard coded in the report as a parameter. During processing, the SSRS report will create a temporary table, (Table: PID_GROUP), to manage the breaking up of the parcels into groups.

NOTE: The temporary table name is selected at the users discretion.

The SSRS report will use the following SQL functions:

  • NTILE()
  • ROW_NUMBER()
  • RANK()
  • DENSE_RANK()

Batch Process

This batch process will print or save .PDF files of all groups it finds in a defined folder. For our example, the Batch Process will scan and locate the 10 groups, and will process 10 times, in order to generate the 10 .PDF files that will contain the record details.
To process, the groups, the user will need to set a path to the location where the .PDF files will be generated to.

NOTE: This is a standard batch process and definition that is designed exclusively for SQL Server Reporting Services (SSRS) reporting.

For more information see General OpenForms Batch Processing

 

 

101-std-bp-012

 

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...