Setting Up Application Parameters

Application parameters are used to define system behavior across all organizations and organization units. Application parameters are predefined when Personify is delivered, but customers should review all of the application parameter definitions to evaluate whether the default settings meet the needs of the customer.

To set up application parameters:

1.    Select System Admin > System Setup > Application Parameters from the toolbar.

2.    Search for an existing record and select it.
The System Parameter Maintenance screen displays, as shown below.
Application_Parameters_Setup.png

3.    Edit the appropriate information.

4.    Click Save.

Screen Element

Description

Subsystem

Drop-down. The subsystem associated with the parameter.

Parameter Name

Text box. The name of the parameter referenced in the system.

Description

Text box. The description of the parameter.

Parameter Value

Text box. The value of the parameter. For example, No, Yes, Default, or Random.

Comments

Text box. A free-form field to enter any comments related to the parameter. This could include additional information on the parameter or its values.

Available Application Parameters

The following table describes the available application parameters.

Sub-system

Parameter Code

Parameter Value

Description

APP

ALLOW_EMAIL_USER_PASSWORD

N

This setting enables Personify Administrators to communicate the user id and the password to the users via e-mail, whenever new user account is created or password is reset. For security reasons, this information will be mailed as image file and not as clear text message. Please note that PADSS does not recommend e-mailing user passwords.

Valid values are Y/N

APP

APPLICATION_IMAGES_URL

http://[your server/folder]

URL of the server folder where pictures displayed in the CRM360 and Donor360 are stored.  A service uploads these pictures from the database after a user adds the picture to the customer's record.

APP

AUTOMATIC_SEARCH_GROUP_ASSIGNMENT

Y

Based on the country code and postal code, Personify can automatically assign a customer to a specific primary_search_group.  To do this, you need to populate the CUS_Search_Group_Postal_Map table with the appropriate mappings and create a Personify search-group record for each of the chapters and units within the chapter (guild, branch, etc).

APP

BLOCK_BROWSER_POPUPS

N

Blocks browser pop-up windows.

APP

DEFAULT_EMAIL_SERVICE_ACCT

n/a

This is the email of the system administrator who is contacted if the e-Business server fails a login to the Personify database server because the password is expired.

 

This application parameter, along with PASSWORD_EXPIRATION_PERIOD,

PASSWORD_REMINDER_PERIOD, and PSM_SERVICE_ACCT_PREFIX are required for the "Notify Service User Expiration" notification service to work.

APP

DEFAULT_MAX_QUERY_SIZE

2000

Maximum number of records to be fetched by a query/search. In addition to all search screens in Personify, the following choosers use this application parameter:

  • AccountChooser

  • GenericChooser

  • GenericChooserSQL

  • GenericChooserWithFilter

APP

HOME_PAGE_URL

http://dd-1744/PersonifyHomePage/

URL of the Website where the home page is hosted.

APP

IDEA_MANAGER_DEST_ADDRESS

timsscare@tmaresources.com

The intent is to provide users with an easy way to send suggestions for improving your organization's workflows within Personify. The email address should be a contact within your organization who will coordinate an evaluation of the suggestions.

APP

MAX_LEVELS_OF_CROSS_SELL_UP_SELL

3

Default value is 3 and can be changed up though higher values will affect performance

APP

PASSWORD_EXPIRATION_PERIOD

3

The period (in months) in which the user’s password expires.

 

This application parameter, along with  

PASSWORD_REMINDER_PERIOD, PSM_SERVICE_ACCT_PREFIX, and DEFAULT_EMAIL_SERVICE_ACCT are required for the "Notify Service User Expiration" notification service to work.

APP

PASSWORD_REMINDER_PERIOD

14

The number of days in which the Password Change Notification appears before the date a user’s password expires.

 

This application parameter, along with  

PASSWORD_EXPIRATION_PERIOD, PSM_SERVICE_ACCT_PREFIX, and DEFAULT_EMAIL_SERVICE_ACCT are required for the "Notify Service User Expiration" notification service to work.

APP

PASSWORD_REPEAT_LIMIT

4

The number of previous passwords stored in the database that a user can not repeat when creating a new password.

APP

PASSWORD_VALIDATION_MASK

^(?=.*\d)(?=.*[\w]).{6,10}$

You can define the security settings for the password, such as a certain number of digits or special characters. The sample mask requires users to enter passwords which have between 6-10 characters, where at least one character is a digit.

Note.pngThe value for this system parameter is blank by default. If you do not want to set security settings for the password, you can leave this parameter blank. However, once you set the parameter, you cannot change it back to blank. You must enter “.*” for the Parameter Value instead.

APP

PERSONIFY_DATABASE_VERSION

7.2.0

The Personify database version number.

APP

PSM_SERVICE_ACCT_PREFIX

n/a

This is a special name prefix assigned to the Personify user that holds the eCommerce site connection password. For example, "EBIZ" for EBIZUSER.

 

This application parameter, along with PASSWORD_EXPIRATION_PERIOD, PASSWORD_REMINDER_PERIOD, and DEFAULT_EMAIL_SERVICE_ACCT are required for the "Notify Service User Expiration" notification service to work.

APP

SHOW_CODE_VALUE

Y

This value indicates whether or not to display code in the drop-downs.

APP

TCMS_MAX_LOGIN_TRIES

99

The maximum number of times a TCMS user can attempt to log in if he/she continues to receive an authentication failure.

APP

UNIFIED_SEARCH_DEFAULT_FILE_UNC_PATH

http://pdweb.mc.tmaresources.com/xml_files/search/

This parameter defines the UNC File location on your App Server/ File Server for file default.HTML and Customer Search files. Enter the URL for the “search” folder on your Unified Search website.

APP

UNIFIED_SEARCH_DETAIL_FILE_UNC_PATH

http://pdweb.mc.tmaresources.com/xml_files/detail/

This parameter defines the UNC File location on your App Server/ File Server for Customer Detail files. Enter the URL for the “details” folder on your Unified Search website.

APP

UNIFIED_SEARCH_MAX_RECORD_COUNT

50

This parameter defines the maximum record count for the number of Customer/ Prospect data to include in the search universe. This number is dependent on the license limitation for the Google Mini search appliance.

APP

UNIFIED_SEARCH_URL

http://dd-1744/UnifiedSearch/Search.aspx

URL of the Website where the Unified Search is hosted’

AUD

AUDITLOGGINGCOMPONENT

10

Displays the Audit Logging screen based on the specified tool.

COM

COM_MBR_REPS_EMPLOYER_FLAG

Y

Determines if the committee member represents his/her primary employer. If set to Y, the customer ID of each committee member’s primary employer is automatically set on the committee membership record when a new committee membership is created.

CUS

AUTOMATIC_SEARCH_GROUP_ASSIGNMENT

Y

Based on the country code and postal code, Personify can automatically assign a customer to a specific primary_search_group.  To do this, you need to populate the CUS_Search_Group_Postal_Map table with the appropriate mappings and create a Personify search-group record for each of the chapters and units within the chapter (guild, branch, etc).

Note that this is not segmentation but simply automatically assigns values to each new customer based on the country and postal code of their primary address and then optionally uses these in customer searches to reduce the number of records returned based on the primary-search-group of the user.

CUS

CHECKDUPLEMAIL

Y

Enables a duplicate primary email address check for a customer.

CUS

COMMITTEE_TREE_RELATIONSHIP_TYPE

COMMITTEE

Determines the Relationship Type used to create the hierarchal tree that is generated from Committee Central when a user opens a committee record.

CUS

COMPANY_TREE_RELATIONSHIP_TYPE

CORPORATE

Determines the Relationship Type used to create the hierarchal tree that is generated from Customer Central when a user opens a customer record.

CUS

CRM360_YTD_START_MONTH

1

The start month for Spending and Score year-to-date (YTD) calculations displayed in the Overview section in CRM360.

CUS

CUSTOMER_ID_LENGTH

12

Length of the Customer ID.

Note.pngAs of 7.4.2, the MKT500 process looks at this parameter and supports Master Customer IDs with the number of characters defined here.

CUS

DEDUP

SOUNDEX

Selects the criteria based on the functionality you use to identify a duplicate customer.

CUS

DEFAULT_BILL_PRIMARY_EMPLOYER

N

When new customers are created, the system will automatically default the "Bill Primary Employer" checkbox to selected on the Customer Demographics screen. For every new order for this customer, the current primary employer relationship customer will be the bill-to customer on the order.

CUS

DUPADDRESSCHECK

N

Duplicate addresses found can be merged or added.

CUS

INCLUDE_PREFIX_IN_LABELNAME

Y

If set to “Y,” the prefix will be included in the label name. It is only applicable for the Individual record type.

CUS

ONLINE_DUP_CUST_CHECK

Y

If set to “Y,” controls the duplicate customer pop-up while adding a new customer.

CUS

PRIMARY_ADDR_PROPOGATION

SELECT

When the primary address of a customer is changed from one address to another, this parameter is used to determine how the new primary address should be propagated to current and unfulfilled orders that refer to the previous primary address. Enter AUTO, SELECT or NONE. If "AUTO" is entered, the system will NOT propagate a new primary address to shipped order lines.

CUS

PRIMARY_FAMILY_CONTACT_DESIGNATION

Primary Family Contact

Identifies the term to be used to describe a primary family contact; for example, Head of Household, Family Bill-to Contact, etc. The term entered here will be displayed as the caption for the primary family contact person.  In the base application, this is set as "Primary Family Contact".

CUS

REQ_USE_OF_CONSTITUENT_ROLES

Y

If set to "Y", the system will require that each new individual or company customer record that is created must have at least one record in the Cus_Constituent_Role table.  If set to N, an individual or company record is not required to have a record in Cus_Constituent_Role.

If the organization wishes to require that each individual or company customer record have at least one Cus_Constituent_Role record, the organization will need to create a record for each existing individual and company record before setting the value of this parameter to Y.

CUS

SHOW_CERTIFICATION_CURRENT_ORGUNIT

Y

If set to "Y", user can display a customer's certifications based on the current org/org unit of the logged in user AND all certifications across org/org units. If set to "N", only certifications in the org/org unit of the logged in user will display.

CUS

SHOW_COMMITTEE_CURRENT_ORGUNIT

Y

If set to "Y", display Committees from the currently logged in organization unit in the search results on the Committee Central screen.

CUS

SHOW_MBRSHIP_CURRENT_ORGUNIT

Y

If set to "Y", display customer membership essential information for the current primary, level one of the Organization Unit of the logged in user in the Essential Information section on the Customer Central screen. If set to "N", display customer membership essential information for all Organization Units.

CUS

SSN_FORMAT

FULL

If parameter value FULL then user can store 9 character SSN number. If parameter value is LAST_FOUR then allow to store last four character of SSN number.

CUS

SUBGROUP_TREE_RELATIONSHIP_TYPE

SUBGROUPS

Determines the Relationship Type used to create the hierarchal tree that is generated from Subgroup Central when a user opens a subgroup record.

CUS

TAX_EXEMPT_ONINVOICE

Y

ORD700 process will not process any orders if the value is “N.”

CUS

TAX_REEXEMPT_SELECTION

PROFORMA

Selects the orders for recalculating the Tax Exemption.

CUS

TELEPHONY_ACTIVITY_BUTTON_CAPTION

Activity

This parameter defines the text to display on the call alerts pop-up button that will open the activity screen.

CUS

TELEPHONY_ACTIVITY_SCREEN_NAME

MRM003

This parameter points to the screen which you would like to open when the user clicks the Activity button on the integrated telephony pop-up. Please note that the button label is based on the TELEPHONY_ACTIVITY_BUTTON_CAPTION application parameter defined above.

CUS

TELEPHONY_CUSTOMER_BUTTON_CAPTION

CRM360

This parameter defines the text to display on the call alerts pop-up button that will open a customer screen.

CUS

TELEPHONY_CUSTOMER_SCREEN_NAME

CRM360

This parameter defines the screen to open when the user clicks [CRM360] button on the integrated telephony pop-up. Please note that the button label is based on the TELEPHONY_CUSTOMER_BUTTON_CAPTION application parameter defined above.

CUS

TELEPHONY_INSTALLED

Y

This parameter defines whether or not the call alerts integration is enabled.

CUS

TELEPHONY_POPUP_TIMEOUT

5

This parameter defines the value in seconds that the call alerts pop-up will remain visible. This value MUST be greater than zero when TELEPHONY_POPUP_TIMEOUT_RULE is set to TimeInterval.

CUS

TELEPHONY_POPUP_TIMEOUT_RULE

TimeInterval

This parameter determines how long the call alerts pop-up stays visible. Valid values are TimeInterval, AfterCallEnd, or UntilNextCall. When set to TimeInterval, the value (in seconds) of the parameter TELEPHONY_POPUP_TIMEOUT will be used.

CUS

USE_CONSTITUENT_IMAGES

Y

Allows organizations to enable the display of customer images in the header of customer-oriented screens. Set to N in the base application.  To 'turn on' the display of images in CRM360, Donor360 and Volunteer Central, set this parameter to Y. The Image Service must also be installed and running for images to display.

CUS

USE_CREDENTIALS_IN_LABELNAME

Y

If set to “Y,” the credentials will be included in the label name. Otherwise, the credentials will not be included in the label name.

CUS

USE_HOUSEHOLDING

N

Personify 7.4.2 includes functionality for householding. If the organization wishes to use householding, the parameter should be set to "Y". Otherwise, this value should be set to "N". When this is set to "N", the ONLINE_DUP_HOUSEHOLD_CHECK parameter is also set to "N".

When set to "N", the Household360 screen cannot be opened by any menu items; the ability to search for a household will be disabled from CRM360 and Donor 360; and tasks related to householding will not be visible to end users.  If this is set to "Y", organizations should set the org unit parameter to define whether the household should get a soft-credit for household member donations. Households should get a soft credit if the organization wants to award recognition to households based on the level of giving of all household members combined.

CUS

USE_PREFIX_DESCR_LBL

Y

If set to “Y,” the Prefix Description from App Code will be used. Otherwise the Prefix code will be included in label name.

CUS

USE_SUFFIX_DESCR_LBL

Y

If set to “Y,” the Suffix Description from App Code will be used. Otherwise the Suffix code will be included in label name.

CUS

WEB_NEW_CUSTOMER_SOURCE_CODE

WEB

Defines the customer’s ORIGINAL_SOURCE_CODE parameter value when you create a new customer.

CUS

WEB_PASSWORD_GENERATION

RANDOM

Controls the Web User password generation method.

CUS

WEBUSERNAME_FORMAT

CUSTOMER_ID

If CUSTOMER_EMAIL_ADDRESS is selected, then the primary email address will be added as the New User Name on the Web Access Control screen. If CUSTOMER_NAME is selected, then the first initial and last name will be added as the New User Name on the Web Access Control screen. If CUSTOMER_NUMBER is selected, then the Customer ID will be added as the New User Name on the Web Access Control screen.

FAR

DEFAULT_BATCH_FORMAT

YYYY

Determines the default format for a batch. Set this to “YY” to increase the number of new batches you can create for a particular day from 99 to 9,999.

FAR

MAXIMUMRECORDSTOPROCESSFORFAR610

YY

Acceptable values are YY and YYYY. YY would create batch in the format YYMMDDXXXX. YYYY would create batch in the format YYYYMMDDXX. If no value is specified then YYYY format is used.

FAR

PROCESS_NO_OF_ORDERS_PER_RECEIPT

100

The maximum number of orders one receipt can process.

FND

DEFAULT_PLEDGE_PERIODS

1

Identifies the default number of payment schedule payments that will be created for a pledge donation.

FND

DEFAULT_PLEDGE_PYMT_FREQUENCY

IMMEDIATE

Identifies the default payment frequency for scheduled fundraising pledge payments. This defaults to “Monthly.”

FND

FND_GENERAL_INFO_URL

n/a

This parameter is no longer used in the system.

FND

WALKER_EMPLOYMENT

Yes

If vales set to "NO" create primary employment relationship with the selected company on walker registration screen.If vales set to "YES" show the validation message "Do You Want to Create primary employment relationship" if Yes, create primary employment relationship with the selected company on walker registration screen, if No clear the field and save the record.

MRM

CALLCENTER_ORDTAB_DEFAULT

ORDINVOICED

If ORDINVOICED is selected, the Invoiced Balance option is selected on the Orders tab. If ORDALL is selected, the All Orders option is selected on the Orders tab.

MRM

ORDERVIEWMONTHLIMIT

6

Number of months to go back for open orders. The orders display on the Order History tab of the Call Center screen.

MTG

DROP_CREDENTIALS_BADGES

N

Controls whether the credentials must be included in the full name for badges.

MTG

DROP_SUFFIXES_BADGES

N

Controls whether the suffix must be included in the full name for badges.

ORD

AUTO_VALIDATE_PRODUCT_SETUP

N

This parameter allows organizations to control how a product setup gets validated.  Some organizations want this to be done manually by a manager, so that setups (particularly GL accounts) can be reviewed.  Other organizations only allow managers to create products, so they want the product validation to happen automatically, as soon as all required setups have been completed.  When set to Y, the system will automatically update the Product.VALID_FLAG to Y as soon as all required product setups have been completed.  When set to N, a user must manually check the Validate Product task.

ORD

CC_ACCEPTED

DEFAULT

Credit cards accepted by the organization.

ORD

DEFAULT_WRITE_OFF_ON_CANCEL

YES

Controls whether the Cancellation screen will include a write-off option by default.

ORD

DEFER_CALCULATION

N

When set to “Y,” the order calculations will be deferred until the order is saved or the user opts to compute the calculations before saving.

ORD

MAXIMUMORDERSTOPROCESSFORORD660

25000

The parameter will decide the number of records to process. For ex: If the value is 25000, then maximum number of Orders/Invoices can be processed are 25000. The parameter is used for Invoice Printing.

ORD

NUMBEROFRECORDSTOPROCESS

1000

The number of records that can be processed at one time.

ORD

RECALC_NAMED_ASSOC_DUES

N

If set to “N,” the named associate dues will not recalculate when a user changes an active Corporate Membership. Otherwise, the dues will recalculate upon a change to the active Corporate Membership.

ORD

STOP_SHIPPING_ON_REJECT

YES

Controls whether the inventoried item can be shipped, in case the deferred credit card gets rejected.

ORD

USE_BILL_TO_PRIMARY_ADDRESS_CURRENCY

Y

If set to “Y,” the Bill To customer primary address determines the order currency. Otherwise, the Bill To customer primary address does not determine the order currency.

SUB

ABC_NTH_SELECTION

‘QP’

Identifies the Sub_Audit_Stats records that should be included in the Nth Selection Report (ABC910) based on the Qualification Codes set for this parameter.

SUB

AUTOMATE_SUB_AUDIT_QUAL_DATA

Y

If set to “Y,” the subscriptions audit qualifications are automated. Otherwise, they are not.

SUB

USE_ABC_AUDIT

N

Enables the ABC auditing functionality.

SUB

USE_BPA_AUDIT

Y

Enables the BPA functionality.

TRS

CLEAR_ABORTED_JOB_REQUESTS

Y

This parameter will govern the functionality of deleting the Aborted/Cancelled Jobs Report form the BO Server.

XBT

USEEXPOCADINTERFACE

N

Use EXPOCAD Interface for Show Management.