Arena Administrator Manual - Shelby Systems Select Admin Manual... · Arena Select 2014.2.100 5...
-
Upload
duongquynh -
Category
Documents
-
view
231 -
download
0
Transcript of Arena Administrator Manual - Shelby Systems Select Admin Manual... · Arena Select 2014.2.100 5...
Select Administrator Manual The Power of Community
shelbysystems. Shelby Systems, Inc. 7345 Goodlett Farms Parkway Cordova, TN 38016
800-722-0222 www.shelbysystems.com
Copyright ©2015 Shelby Systems, Inc.
Arena Select 2014.2.100 2 Table of Contents
Arena Select Administrator Manual
Table of Contents Arena Select Administrator Manual ..................................................................................................................................... 2
Welcome to Arena, the Power of Community ...................................................................................................................... 5
Getting Started .................................................................................................................................................................... 6
Data Conversion ................................................................................................................................................................ 9
Set up Security ................................................................................................................................................................. 10
Agents ............................................................................................................................................................................. 11
The Community ..................................................................................................................... Error! Bookmark not defined.
Understanding Updates ......................................................................................................... Error! Bookmark not defined.
Implementing Global Features ......................................................................................................................................... 12
Implementing Specific Features ....................................................................................................................................... 13
Membership ........................................................................................................................................................................... 13
Person Detail Page .......................................................................................................................................................... 13
White Pages ....................................................................................................................................................................... 13
Mailing ................................................................................................................................................................................. 13
Public and My Lists .......................................................................................................................................................... 13
Family Registration ......................................................................................................................................................... 14
Prayer .................................................................................................................................................................................. 14
Groups .................................................................................................................................................................................... 15
Tags (for All Tags) ................................................................................................................................................................... 15
Serving Tags .............................................................................................................................. Error! Bookmark not defined.
Event Tags ................................................................................................................................. Error! Bookmark not defined.
Communications ....................................................................................................................... Error! Bookmark not defined.
Missions .................................................................................................................................... Error! Bookmark not defined.
Check-In ................................................................................................................................................................................. 18
Contributions ............................................................................................................................ Error! Bookmark not defined.
Assignments ........................................................................................................................................................................... 20
Prayer ..................................................................................................................................................................................... 20
Dashboard ................................................................................................................................. Error! Bookmark not defined.
Security ............................................................................................................................................................................. 22
Security Roles .................................................................................................................................................................. 22
Deleting Records .............................................................................................................................................................. 30
Security Templates........................................................................................................................................................... 31
Person Details Field Security ............................................................................................................................................ 33
Application Security ......................................................................................................................................................... 35
Arena Select 2014.2.100 3 Table of Contents
Website ................................................................................................................................... Error! Bookmark not defined.
Portals ................................................................................................................................... Error! Bookmark not defined.
Templates ........................................................................................................................................................................ 39
Pages ............................................................................................................................................................................... 40
Visibility .................................................................................................................................................................................. 41
Modules .......................................................................................................................................................................... 42
Customizing Arena ............................................................................................................................................................. 47
Custom Field Groups ........................................................................................................................................................ 47
Lookups ........................................................................................................................................................................... 50
Peer Types ....................................................................................................................................................................... 53
Person Attributes ............................................................................................................................................................. 54
Relationship Types ........................................................................................................................................................... 59
Report Services Configuration .......................................................................................................................................... 61
Reports ............................................................................................................................................................................ 62
System Emails .................................................................................................................................................................. 64
Arena Hub ....................................................................................................................................................................... 66
Configuring Arena .............................................................................................................................................................. 70
Agent Configuration Utility .............................................................................................................................................. 70
Agent Jobs .............................................................................................................................................................................. 72
Worker Settings ..................................................................................................................................................................... 73
Schedules ............................................................................................................................................................................... 74
Notifications ........................................................................................................................................................................... 75
Application Settings ......................................................................................................................................................... 79
Mailing Application Settings ................................................................................................................................................... 85
Background Checks (Optional) ......................................................................................................................................... 86
Campaigns ....................................................................................................................................................................... 91
Document Types .............................................................................................................................................................. 92
Email Configuration.......................................................................................................................................................... 94
Exceptions ....................................................................................................................................................................... 95
List Configuration ............................................................................................................................................................. 96
Lists ................................................................................................................................................................................. 107
List Sorting Options ...................................................................................................................................................... 107
List Categories ................................................................................................................................................................ 107
Organization .................................................................................................................................................................. 109
Payment Gateways ................................................................................................................ Error! Bookmark not defined.
Refresh Cache ................................................................................................................................................................ 117
Report Registration ........................................................................................................................................................ 118
Arena Select 2014.2.100 4 Table of Contents
Small Group Structure .................................................................................................................................................... 119
SMS Text Messaging ...................................................................................................................................................... 125
Facilities Management................................................................................................................................................... 127
Implementing Arena-Managed Website Features ............................................................................................................ 128
Making Your Website Public .......................................................................................................................................... 128
Arena Administrator ..................................................................................................................................................... 128
Page Structure ............................................................................................................................................................... 129
Required Pages ..................................................................................................................................................................... 130
Root Page ............................................................................................................................................................................. 130
Home Page ........................................................................................................................................................................... 130
Visibility ......................................................................................................................................................................... 131
Implementing Specific Features ....................................................................................................................................... 132
Login Pages .................................................................................................................................................................... 132
Online Giving ................................................................................................................................................................. 137
Pledge Entry ................................................................................................................................................................... 141
Online Events ................................................................................................................................................................. 142
Small Group Locator....................................................................................................................................................... 158
Online Small Group Leader Toolbox ............................................................................................................................... 160
Missions ........................................................................................................................................................................ 163
Giving Kiosk Portal ......................................................................................................................................................... 167
Mobile Portal ................................................................................................................................................................. 172
Appendix ......................................................................................................................................................................... 222
Appendix A- Check-In Click Once Installation Guide ....................................................................................................... 222
Install Prerequisites .............................................................................................................................................................. 222
Wedge Scanner Configuration ............................................................................................................................................. 222
Printers ................................................................................................................................................................................. 223
Recommended Windows Settings ........................................................................................................................................ 224
Security for Label printing .................................................................................................................................................... 225
Arena Select 2014.2.100 5 Welcome
Welcome to Arena, the Power of Community
This document covers the Administration section and setup features of the Arena application. The
intent of this document is to be a resource for Arena Administrators, Network Administrators,
members of the web team and anyone granted permission to administer the Arena application and
its contents. This guide will assist in the configuration of and managing an Arena-managed website.
Our goal is for Arena documentation to provide Arena Administrators the necessary resource to
implement and customize Arena to meet the needs of your organization. While this document
serves as a guide for overall understanding of Arena’s administrative functions, you can also access
additional information on the Arena Community (http://community.arenachms.com/) website.
The Shelby Education Department is responsible for Arena documentation and we welcome your
feedback. Please email feedback and suggestions to [email protected].
Trademarks: Certain brand names and product names used in this publication are trade names,
service marks, trademarks, or registered trademarks of their respective owners. Shelby Systems,
Inc. is not affiliated or associated with any product or vendor mentioned in this publication.
© 2006, 2007, 2008, 2010, 2015 Shelby Systems, Inc.
Arena Select 2014.2.100 6 Welcome
The Community
The Community (http://community.shelbysystems.com/arena/) is available to all Shelby v.5
and Arena Administrators and maybe a member of your finance and web teams. This website is
a central place for Arena Administrators and Arena Staff to share ideas of how they are
leveraging Arena for their organization and where we post announcements. Contact the Arena
Project Manager regarding access.
Use the top filters to narrow results. Use the My Subscriptions tab to subscribe to topics of
interest to you. Once you subscribe, emails are sent to you as new threads are posted.
Search – Use this field to search for specific content. Use the product filter to narrow results.
Forums – Use this page to search for topic specific information posted by other Arena
organizations and Shelby Arena staff.
Arena Select 2014.2.100 7 Welcome
After selecting a topic, a list of current threads display. You can select any thread to read all
thread posts or add your own thread post.
Select the Documentation tab to download documents such as manuals and table layout files.
Select the Videos tab to access training videos.
Arena Select 2014.2.100 8 Welcome
Select the Downloads tab to access download files such as updates, technical papers, reports
and shared modules.
As a Premium Developer client, you can access developed forums and files.
Under the More tab, you can access the Arena Vote page where you can access feature
requests, review known issues, update your information and submit a feature request. Be sure
to read the guidelines for feature requests on The Process page.
Arena Select 2014.2.100 9 Getting Started
Data Conversion
The initial conversion is in intended to be a starting point for data evaluation in preparation for the
final conversion. If your organization has an Arena Sandbox and a Production Arena instance, the
initial sync is to the Sandbox. The final sync is to Production. If your organization has one Arena
instance, you will use a template DB to build core structure which will be used the final Production
conversion.
After the initial sync, you will want to evaluate the data, making note of any changes needed for
the final conversion. While Arena has several tools available to move data, you may find it
necessary for SQL scripts for any data that does migrate by default or should be migrated to an
area that is not supported by one of the available tools. An Arena trainer is available to assist with
data evaluation needs.
One of the common aspects to conversion is understanding equivalent features from Shelby v5 and
Arena. Below is introduction to some core equivalents:
Shelby v5 Shelby Arena
Personal Information Person Attributes
Profiles Ministry Tags
Organizations Imported Ministry Tags or Groups
While the initial conversion migrates data to one default location, you can determine the ‘best fit’
location in preparation for final migration.
Arena Select 2014.2.100 10 Getting Started
Set up Security
Arena security is applicable to Arena portals, pages, modules and person attributes. This
documentation addresses each of topics in further detail but for now, we will focus on security
basics.
Portal Security – Each portal can be setup to use either Forms (Database) Authentication or
Active Directory authentication. There are aspects to consider with either option especially if the
goal is to enable staff to access the Arena (Staff) portal when off campus. In order to do so, Forms
authentication is required. In addition to reviewing the available options with your Arena
Administration team and senior staff, it may be beneficial to research Forums on
http://community.arenachms.com/ to see how other organizations have approached each option.
User Security - As you begin to evaluate security, you will need to decide which users will perform
specific tasks such as adding, merging, editing and deleting records, adding tags, etc. It is common
practice to build security roles based on function/department, not individual staff members. While
individual security may be needed for specific features, using security roles and security templates
allows for a systematic approach for managing access for all staff and all non-staff.
Before beginning the process of building out security, it is recommended to first identify all staff and
non-staff who will need access, the features each staff member will need to access and the
permission level to each feature. Arena has the option to set view, edit and approval for many
features. Along the same lines as identify which feature each staff and non-staff member can
access, you will also want to determine the permission level for each individual.
In addition to determining staff and non-staff who will need access to Arena, you will want to also
determine necessary page(s) and module(s) access to grant access. While most security is set at the
Security Role level, some permissions are at the module level.
Arena Select 2014.2.100 11 Getting Started
Agents
Agents are stored procedures that can be set to run automatically on specific day(s), specific
time(s) and a specific frequency. There is an Arena Automation Service that you will first need
to start. Follow the below steps for configuration of this service.
1) Go to Services.
2) Right click on the Arena Automation Agent Service.
3) Select Properties.
4) Select either Automatic or Automatic (Delayed Start). Automatic (Delayed Start) is
recommended for the purpose of the Service starting after the server startup is complete,
on the occasion of a server reboot.
5) Click Start.
6) Close the window.
7) Verify the Service is running.
Arena Select 2014.2.100 12 Implementing Specific Features
Understanding Updates
At this time, full updates are available on the Shelby Community site. For self-hosted clients,
you can install the updates as best fits your organization. For hosted clients, Shelby Systems will
handle the updates for your organization. It is advisable to subscribe to the Arena
Announcement thread to receive emails when there is a new release or update.
Self-Hosted Environments Updates are available on the Shelby Community/Arena/Downloads page for self-hosted
environments. Follow the below steps to install updates. If your organization has an Arena
Sandbox, install a test update on the Sandbox prior to installing on Arena Production.
Steps to Install Updates:
1. Verify there are no active users.
2. Login to Arena.
3. Verify your installation. Click the About icon in the top right corner of the Arena home page
to verify your Arena installation. The results will confirm website files and the database in the
popup windows. Changes made to Arena core will display below the verify box so you will be
aware of areas the update may effect.
4. Make a backup of your database. You might consider backing up the ArenaChMS folder on the
web including the web.config file and the Arena Shelby v.5 sync.exe.config file if you are
running the Arena Shelby v.5sync.
5. Stop Automation Agents.
6. Download the update. Some releases may require installing a patch or update so be sure to
check for any prerequisite updates.
7. Install the release.
8. Log into Arena and verify. If your organization uses Arena Mailing, you will also need to update
Shelby Mailroom. Install this on your Arena server when users are not on the database.
Hosted Environments Updates for hosted environments are automatically applied after notifications are sent.
Arena Select 2014.2.100 13 Implementing Specific Features
Implementing Specific Features As you identify and evaluate each feature for implementation, you will want to evaluate and
customize specific options for each feature. Some options are module settings while others may
involve agents, system emails, organization settings, person attributes, lookups and/or security.
Use the below checklist as guide to review and customize specific features.
Membership
Person Detail Page
• Consider using the optional Dockable Person Details page so each user can configure the Person
Detail. To implement load the Dockable Person Details on Arena Hub.
White Pages
• Customize the White Pages module on the White Pages page such as adding Person Attribute
and turning on/off search fields.
Add New Family
• Review all associated Lookups. Consider changing the order of Membership Status Lookup so
the default status is in the first position.
Person Bulk Update
• Set the Secure Fields module setting on the Bulk Update module to “True” in order for
Arena to honor security for all associated fields on the Person Bulk Update page.
Merge Members
• Customize the Delete Merge Organization Setting. Set to “True” to delete duplicate records,
once merged.
• Consider implementing the option to enable general users to ‘request’ records to be merged
but select users to complete the merge and customize the email address of the person to notify
of merge requests to the Merge Request Recipient Organization Setting. Identify the two
different security roles, assuming one will grant permission to select records to merge and the
other will complete the merge. For the security role of users who can select (request) records to
merge, set permission to view the Merge Members page and Member Merge module. For the
security role of users who can complete (approve) the merge process, set permission to view
the Merge Members page to view, edit and approve the Member Merge module. Customize the
Merge Person Request System Email.
Mailing
• If using Mailroom, install the Mailroom Service on the Arena server. Technically, Mailroom can
be installed on the Arena server or on a completely different server as long as the Mailroom
Service is installed and the Mail Room Server Organization Setting points to the server where
Mailroom is installed.
• Customize Mailroom Application settings on the Application Settings page. For Arena Hosted
install Mailroom on each workstation. Enter the server name for Shelby v.5 workstat folder in
the Mailroom Server Organization setting. We recommend using a mapped drive.
• If using Mailing for bulk mail, this requires a subscription to Shelby Mailroom. From the
mailroom DVD you will need to install Mailroom on the server (if using Arena Hosted, install on
individual workstations) and the Arena Agent. If you would like information about Mailroom,
please contact Shelby Systems at (800) 877-0222.
• Install .Net 4.0 and Report Viewer (8.0, 9.0 and 10.0) on all workstations using the Mailing
application.
Public and My Lists
• Customize List Configuration so applicable criterion are available in My List and Public
Lists. Arena honors security permissions for both lists.
• To restrict access to List Types, consider copying the Report Wizards module to the same
page, and adjust module settings for each module instance. Set security so that only one
module displays for each user.
Arena Select 2014.2.100 14 Implementing Specific Features
• Customize the List Category Lookup to give users to ability organize lists by department and
ministry.
Family Registration
• Review and customize Family Registration Application Settings such as default
member status, attribute groups, default campus, and allowing Check-In.
• Set the Small Group Category ID in the Family Registration application.
• Determine the process for volunteers and staff for entering visitor information to insure a
speedy check-in. Remember, additional information can be entered at a later time.
• Establish the process for managing any duplicates that may be created.
Prayer
• Custom the Prayer Category and Prayer Source Lookups.
• Set security for users who can approve prayers, approve answers, approve comments and
view private prayers.
• Customize the Prayer Request Days Active and Prayer Request Renewals Organization
Settings.
• Start the Process Prayer Requests agent and be sure to add the Prayer Page URL to this
agent.
Arena Premium 2014.2.100 15 Implementing Specific Features
Groups
• After assessing ministries that will use Groups, customize or create Cluster Types as needed.
Be sure to specify to allow registration, the level for unassigned registrants, levels to email
registrant notifications and to allow occurrences or not.
• Customize the Small Group Tab Module on the Groups and Group Details pages.
• Customize the Small Group Role, Small Group Topic, Small Group Type, Age Range and
Preference Lookups so that prospective group members can easily find a group that fits his or
her interest on the Locator page of your Arena-managed website, and staff can apply requested
preferences on the Add Registration page. Lookups apply to all Groups.
• Verify that Attendance Type ID and Default Occurrence IDs on the Small Group Table
Control module are valid.
• Verify that the Small Group Registrations Agent is using Add Registration or Group Locator.
• Customize Group Leader Registration and Group Member Registration System Emails.
Tags (for All Tags)
• Once you determine how your organization will use Tags, it is important to understand Tag
Security. It is common to create Ministry, Serving and Event Root tags (the first level) for
each department and set security at the root tag. As Child Tags are created for Root tag,
security will cascade to child tags.
• Evaluate Profile Details and Profile Tab Control modules on the Profile Member Details
page, and the Profile Activity and Tag Member Activity modules on the Tag Member page.
Customize as needed.
Serving Tags
• Customize the Add Profile Member module on the Add Volunteer page to designate a default
member status as users enter prospective volunteers.
• Customize Critical Profile Days and Warning Profile Days Organization Settings and start
the Process Critical Serving Agent. Once settings are in place, Arena sends an email to
serving tag owner when the status of a prospective volunteer in a Serving Tag has not been
changed in the number of days specified in the Organization Settings. You will need to add a
valid Arena URL (i.e., http://arena.church.org/) to the Arena URL field in this agent.
• Customize the Volunteer Signup System Email that is sent to prospective volunteers when
the individual signs up on the Arena-managed website or a staff member uses the Add
Volunteer option.
• If using the Serving Reminder option to reminder workers of the next time he/she is expected
to server, customize the Serving Reminder System Email, start the Serving Reminder
Agent and add future occurrences to applicable Serving Tags. Emails are sent to connected
tag members according to the occurrence date.
• Customize Ministry Type, Commitment, Commitment Level, Classification, Duration and
Tag Status Lookup. Use the Include as Critical “Y” indicator for any existing or new status you
want to trigger an email notification to the tag owner of prospective volunteers when added via
your organization’s Arena-managed website or Add Volunteer. Keep in mind Connected, In
Process and No Contact statuses are in use by other modules and settings. All other tag
statuses apply only to Serving Tags.
Arena Premium 2014.2.100 16 Implementing Specific Features
• If using the Volunteer Scheduling feature, added via Arena Hub, review and customize the
below elements:
Customize the Ministry Type, and Commitment Types Lookups.
Customize Volunteer Category Title, Volunteer Request No URL, Volunteer Request
Yes URL and Volunteer Service Name Organization Settings.
If using the Class Level option to identify Class Level:
Create an Attendance Type Category and Attendance Type(s) for each class.
Add the Attendance Type Category ID to the Class Level Organization setting.
Event Tags
• Customize the Event Profile Detail module on the Event Tags page. Consider setting the
Show Account Numbers module setting to “True” so users can enter the account number per fee
or payment. This is particularly beneficial when exporting transactions to V5 General Ledger.
• Set the additional Edit Registration and Allow Refund security permissions, by tag and
user, and the Occurrence Detail page so that users can create occurrences for event tags. A
future occurrence is required in order for an event tag to display on the external website.
• Start the Event Email Agent. Be sure to enter a comma-delimited list of Tag IDs for which to
send email reminders.
• Customize the Event Visibility, and Topic Area Lookups. Use this lookup to specify which
topics to display on Arena’s external website calendar.
• Add Payment Gateway on the Administration/Payment Gateways page to enable online event
registration payments. Connect the payment gateways to the applicable modules.
• Verify a General Ledger Export page is available. This page is required in order to use the
export button on the Event Tag Transactions tab/page. This page requires the Event General
Ledger Export (popup) module and is referenced in the Event Detail Tab module.
• Customize Event Refund and Event Registration Notification system emails.
• Consider editing the Event Profile Detail/Tools File module setting to enable the full RAD
Editor. This setting requires the file path to the RAD editor tool (e.g.,
ToolsFileAdvancedText.xml).
• To enable users the option to adjust the default registration steps, add the Event Registration
Steps page with the Registration List module. Also, you will likely want to change the
Registration page setting on the Event Detail module on the web portal. Custom Registration
steps will apply to ALL Event Tags and users will need to replicate the same steps for all events.
• If using a third party resource management application:
Add the account information on the Facilities Management Setup page with the Resource
Manager Setup module. Arena integrates with MinistrEspace facilities management resource.
Set the Event Resource and Event Resource Admin Role settings on the Event Profile Detail
module.
Start the Update Resourced Events Agent.
Arena Premium 2014.2.100 17 Implementing Specific Features
Communications
• Configure the email server on the Administration/Email Configuration page.
• Customize the Mail Merge module on the New Communication page. If using thresholds,
consider adding the Communications Approval List module to a new page in order to
centralize all pending communications to one page for communication approvers.
• If using SMS via email:
Set SMS via Email Enabled Organization Setting to True.
Verify all desired ISPs are available in the SMS Provider Lookup.
Add phone numbers to all applicable records with SMS checked and provider selected.
Verify your emails limits can accommodate the increase emails.
• If using SMS via StrikeIron:
Verify that StrikeIron has the account as a Global 2.5 account.
Set SMSViaEmail Enabled Organization Setting to False.
If not currently available, add the following Organization Settings and enter the applicable
values for each, as provided by StrikeIron: SMSProvider_UserName, SMSProvider_Password
• To enable the option for email recipients to unsubscribe to emails, add a hidden page to the
external portal with the Bulk Email Unsubscribe module and reference this page on the
communication’s mail merge module.
• To limit previous communications sent by the current user logged in, set security permissions to
view only on the Communications/Previous page.
• Consider setting up the Email Clean option. It uses the Email Clean Agent. The Email Clean
automation agent can delete or inactivate bad email addresses from the Arena database. It
monitors a specific POP3 email account looking for bounced messages from the Arena
membership and newsletter subscription tables. Arena flags email addresses determined to be
'bad' as inactive and noted with an appropriate reason. Specific setup instructions can be found
on the Community/ArenaWiki/Arena Agents page.
• Consider adding a default name and email address to a communication template.
• Due to email security and spam issues, email providers have tightened up rules regarding
sending and receiving emails. Below is an explanation of the business rules Arena follows when
sending emails.
The “From Email” domain is not equal to “SmtpFromDomain”
Set “From Email” = Organization Email
Set “Sender” = Organization Email
Set “ReturnReceiptAddress” = Organization Email
IF “Reply To Email” is blank Set “Reply to Email” = Original “From Email” address ELSE No
Change
If “From Email” domain is equal to “SmtpFromDomain”
“From Email” = No Change
“Sender” = No Change
“ReturnReceiptAddress” = No Change
IF “Reply To Email” is blank Set “Reply to Email” = Original “From Email” address ELSE No
Change
Missions
• Add an integrated payment gateway account on the Payment Gateways page.
• Customize the Mission Arrangement, Mission City, Mission Country, Mission Purpose,
Mission Region, Mission Register Type, Mission Support Type, Mission Trip Role, and
Mission Trip Status Lookups. Users can also add values as needed.
Arena Premium 2014.2.100 18 Implementing Specific Features
• Customize Mission Registration module. This module contains the Require Goer Approval
setting to prevent on-line contributions for non-approved mission trip goers (travelers). To
restrict users by Mission Type, consider adding the module to the same page to limit access to
specific trips by user.
• Customize the Mission Details module on the Mission Detail page. Use this module to limit
available tabs and set permission for users who can reassign mission trip payments to other
travelers.
• Customize the Mission Trip Registration Deposit Reminder, Mission Trip Registration
Reminder and Mission Trip Contribution System Emails.
• Start the Mission Trip Deadline Reminder and Mission Trip Registration Deposit
Reminder Agents.
• Set Security Roles to specify which users have access to mission trips while processing
contributions.
• Start the Mission Trip Deadline Reminder and Mission Trip Registration Deposit
Reminder Agents.
• Customize the Mission Trip Registration Deposit Reminder, Mission Trip Registration
Reminder, and Mission Trip Contribution System Emails.
Check-In
• If using the Check-In application, install .Net 4.0 (or newer) and Report Viewer (8.0, 9.0 and
10.0) on all PC workstations/kiosks and verify kiosks connect to the domain.
• Verify printer and kiosk connectivity. Install updated driver(s) if necessary.
• Verify Kiosk Schedules and printer connection.
• Create Check-In security roles for both Check-In Administrator(s) and volunteers.
• Customize Check-In Application Settings.
• If using roster reports for attendance, add Attendance Upload module to the desired page or
a new page.
• Identify label needs. Minor customization can be accomplished using Report Builder.
• If you plan to customize existing themes or add new themes, be sure to check out the White
Paper on The Arena Community/Downloads page.
• If using tablets via Check URL:
Create applicable security roles.
Add Security Roles IDs to CheckInAccessRoles Organization Setting.
Set Arena to Forms authentication.
Setup a workstation to use a wireless network.
Install/launch Check-In.
Get IP address from Arena database (dbo.comp_kiosk_ip).
Set the tablet to use this IP address.
In SQL, change computer name of system id tied to the recorded IP address to match that of
the iPad device (dbo.comp_system).
Assign a printer to each kiosk by name. You will no longer be able to use the kiosk default
printer option.
Arena Premium 2014.2.100 19 Implementing Specific Features
Contributions
• Customize the Contribution Fund Category, Contribution Range, Contribution Source,
Contributions Adjustment Type and Contributions Motivations Lookups.
• Review and customize all associated modules. To allow refunds, set the public site to “true.”
Set the Default Years contribution history to display on the Person Detail/Contribution tab on
the Contribution List module.
• Install Arena Hub Contribution Reports particularly if using the Donation Kiosk feature.
• Add Payment Gateway provider. Connect the payment gateway accounts to the applicable
modules.
• Customize the Contribution Information section on the Person Detail page. E.g., Select print
or email statement, PIN number for email statement recipients, and Sub-donor.
• If using check scanners, verify all current drivers are loaded. Supported scanners are Canon
CR25/55, 50/80, and 135/180/190. Ranger drivers are required for some Canon scanners. If
using existing scanners, you will want to verify the scanners can produce a text output in
notepad.
• If applicable, customize the Contribution Sub-donor Title Organization Setting and set the
Show Sub Donor module setting to “True” on the Person Detail page.
• If using online giving:
Setup your payment gateway account(s) on the Administration/Payment Gateway page.
If using a provider where redirects are used, provide a return redirect URL (e.g.,
www.organization.com/payment.aspx) to your provider.
Customize Giving Batch Name Organization Setting. The default value is “Online Batch.”
Customize the Repeating Payment Wizard module. Refer to the Implementing Arena-Managed
Website Features in this document for additional setup information.
Setup your member login pages. Refer to the Implementing Arena-Managed Website Features
section.
• If emailing contribution statements:
Start Email Contribution Statement agent.
On the Person Detail page for each recipient, select email statement and a enter PIN.
Both fields are required. PINs can be up to ten characters.
Select a contribution report on the Email Statements module.
Customize Online Contribution System Emails.
Customize the Online Giving Rejected Contribution System Email.
Set the Email Statements Contribution Statement Report module setting to the desired
statement on the Email Statements page.
• If using Donation Kiosk:
Install the Donation Kiosk from Arena Hub
Install Contribution Reports from Arena Hub
Select Funds to make available on the Kiosk Enter Amounts module on the Enter Amounts
page.
Customize Kiosk Swipe Card module on the Enter Payment Info page.
• If using the Contribution Application:
Customize Contribution Application Settings. Changes are global for all users accessing the
Contribution application. You can make user specific changes in the application settings for
each workstation.
Set Contributions Application security.
Install .Net and Report Viewer (8.0. 9.0 and 10.0 versions) on all workstations using the
Contributions application.
Arena Premium 2014.2.100 20 Implementing Specific Features
Assignments
• Set the Person Detail Show Workflow module setting to “True” on the Person Detail page in
order to enable Assignment Workflows from the Person Detail page.
• Verify the AssignmentBaseDetailURL Organization Setting is set properly (e.g.,
http://arena/default.aspx?page=3210&checkId=1). To check the proper page number, go to
Administration/Pages and expand pages to the Home/Assignments/Assignment
Type/Assignment Detail. If needed, replace the above reference page ID (3210) with your
Arena Assignment Detail page ID.
• If using Assignment Workflow, start the Assignment Process Start Agent.
• Set security for each Assignment Type. Assignment security is like Tag security. Users will
need view and edit permissions in order to initiate and edit an assignment.
• Customize the Assignment System Emails.
• To display hyperlinks on the Arena home page for Workers, Requesters, and Subscribers add
the My Assignments module to the Right Content of the Home page. Add the module three
times changing the Mode for each module instance and add a Title for each instance.
Prayer
• Start the Process Prayer Requests agent.
• Customize the Prayer Request Comments, Prayer Request Expire No Renewal, Prayer
Request Expire and Renewal System Emails.
• Customize the Prayer Request Days Active and Prayer Request Renewals Organization
Settings.
• Customize the Prayer Category Lookup.
Dashboard Ideas Use the home page of Arena, or any other page, to provide organization wide or ministry specific
information for all staff or specific staff by module. By using specific modules to display specific
information, you can set security for each module by user.
This is an example of using the 2-Dock Container module with two separate Report Grid from
Query modules to display specific information and statistics.
Arena Premium 2014.2.100 21 Implementing Specific Features
This example uses the Dock-3 Container module, Pages as Tab module and the Report Viewer
module to organize reports by ministry. You can apply security to each tab so that staff can access
the specific reports based on area of ministry.
This example uses the 3-dock container module and several of the Social category modules.
This example uses the Advanced HTML module and Hyperlink Manager within the module to create
hyperlinks to documents.
Arena Select 2014.1.100 22 Security
Security
Security Roles
Security Roles is where you can create user groups and set permissions for each user group. You
can apply permissions to portals, pages, modules and fields. A user cannot view anything unless the
Arena Administrator grants permission to do so by either security role permission or individual
permission. Security roles are cumulative, meaning if you add a user to multiple Security Roles, the
permissions will stack. Therefore, the user will have access to all portals, pages, modules, sections
and fields that each separate role allows.
Arena has four core security roles with permissions set. The remaining security roles are a starting
point for you to customize. No permissions are set for these security roles but they do have access
to default web portal templates. Use the remaining security roles to customize for your
organization.
• All Users – This role applies to all accessible pages for each portal user can view in front of any
login in page such as each home page for each portal. In general, use this role for pages you
want users to view in front of the login page. You cannot delete this role.
• Arena Administrators – Users in this role can view and modify all content for all portals. You
can modify permissions for this role.
• Global Administrators - Users in this role can view and modify all content for all portals. You
delete this role or modify permissions. From a day-to-day basis, Arena Administrators should not
be in this role. When the need arise to use this role, and the Arena Administrator record
temporarily to perform a specific function and then remove the user from this role
• Registered Users – This role applies to any authenticated user on the external portals. Any
user who is successfully logged in (been authenticated) will automatically have the permissions
defined in this role. You cannot delete this role.
Before we cover specifics to create security roles, below are the basics steps.
• Create a Security Role.
• Set Permissions for the security role.
• Add existing records to the Security Role.
• Set login and password for each user or sync with an Active Directory Group.
• Set template permissions, if needed. This step is applicable for new security roles.
• Test.
Arena Select 2014.1.100 23 Security
Steps to Customize a Security Role:
1) Go to Administration/Security Roles.
2) Click the security role to edit. All but the previously mentioned Security Roles are
placeholders for you to customize. They have no permissions set.
3) Click Edit Details button.
4) Customize the Role Name.
5) Complete other fields as desired.
• Sync With – This option will synchronize the security role with Assignment Workers in a
specific Assignment Type, a specific Event, Serving, or Ministry Tag, a specific Group, an
Active Directory Group or a Group Area Role. To use this option, you will need to start the
Sync Role Agent and the ONLY method to add records to the role is to add the record to
Assignment Type, Tag, Group or AD Group. You can optionally sync a role with a Ministry
tag and Arena will create a login (i.e., ASample or ASample2 if this login already exists) for
each person you add to the tag.
• Notify New Members – Check this box for Arena to send an email to users when added to
the role. You will also want to enter a subject and enter an email message. The user will
also need a valid email address on his or her record.
• Notification Subject – Enter a subject for this email. All emails must include a subject.
• Notification HTML/Text Message – Enter the HTML message for this email. Use the
merge fields to include login information in the email.
• Enter Notification Text Message – Enter the plain text message for this email. Use the
merge fields to include login information in the email.
6) Click Update.
Arena Select 2014.1.100 24 Security
Steps to set Permissions for a Role:
1) Click Edit Permissions, from the Security Role page. You will also need to make sure that the
All Users role does not have permission for any area of your website that will require a Login.
2) Select the portal you want to apply permissions. We will use the Arena (Internal) portal for this
example.
• Arena (Internal) – This is the internal portal where the majority of staff will access.
• Arena (Internal) – This is the internal portal where the majority of staff will access.
• Arena Web – This is the external (Arena-managed) portal accessed on the web.
• Arena Mobile – This is the mobile portal available on any browser-enabled smart phone.
3) Set permissions on the Portals/Modules tab. On this tab, you can set permissions for the
page and for the modules applied to the page.
• View – Users with view permission can view the page or module. It is important to remember
that while a security role or individual may have view permission to a module, if they do not
also have view permission to the page they will not have permission to view or use the
modules.
• Edit – Users with view and edit permission can edit the page or the module. In cases where
you users will need to use the module, select edit. Setting edit on a page allows users the
permission to edit the HTML page, which is global.
• Edit Security – Users with edit security permission can edit security for the page or module.
• Edit Modules – Users with edit module permission can edit module settings directly from the
page. Module setting changes are global for all users and are typically restricted to Arena
Administrators.
• Approve – Users with approve permission can approve the object such as promotions, events,
registrations, etc. Approval is required for some features on your Arena-managed website.
Arena Select 2014.1.100 25 Security
4) Click the Applications tab. You can also make changes on the Application Security page.
5) Set application permissions.
6) Click the Attributes tab. Attributes are the Person Attributes on the Person Detail page.
Permission applies to all records.
7) Set attribute permission. In order for users to edit a field they also need to view and edit
permissions for the section .
8) Click the Person Fields. Person Fields are fields on the Person Detail page that are not Person
Attributes.
9) Set person field permissions.
10) Click the Tags tab.
11) Select a Tag Type.
Arena Select 2014.1.100 26 Security
12) Set permissions. Serving, Ministry and Event Tags all have the same permissions. Event Tags
have the additional permissions to edit registrations and process refunds.
• View – This permission gives users the ability to view the tag and tag members.
• Edit – This permission gives users the ability to edit the tag details and add child tags.
• Edit Security – This permission gives users the ability to edit tag security.
• Edit People – This permission gives users the ability to edit people in the tag to include
editing tag status, adding and removing records from the tag.
Event Tag Permission
• Edit Registration - This permission gives users the ability to edit the information for
registrants on the Edit Registration tab.
• Allow Refunds - This permission gives users the ability to process registration refunds.
13) Select the Groups tab and select Groups Type. The default options are Small Groups and Sport
Teams.
14) Click the Groups tab and set permissions.
15) Click Save.
Arena Select 2014.1.100 27 Security
Steps to Add an Existing Record to a Security Role:
1) From the security role page, click the Add New Person icon to search and select an existing
record.
2) Search and select record(s).
3) Click the Security tab of the Person Detail for each person to add.
4) Click Add New Login button in the Arena Logins section.
5) Enter login information.
• Login – Arena assigns a login using the first initial and last name. If more than one user has
the same first initial and last name, Arena adds the next sequential numerical value to the
login, e.g., JSmith2. You can optionally change logins. You can use alpha, numerical and
special characters.
• Password – Enter the password if using Database authentication. Passwords must be
between 5 and 30 characters long and must contain at least one digit.
• Authentication Type – Select Database or Active Directory. For Arena Hosted you must
select Database.
• Active –Check this box to make this login active.
• User must change password at next login – Check this box if to enable users to create a
new password.
• Account is locked – Check this box to lock the account
6) Click Update.
Arena Select 2014.1.100 28 Security
Steps to Copy a Security Role:
As you create security roles for your organization, it can be more efficient to copy an existing role
and edit permissions for the copied role, than to create a new security role from scratch. At the
bottom of the Security Role page, there is a Copy Role option. This option allows for quick
duplication of a role.
1) Select the role to copy from the Copy Role list of existing security roles.
2) Enter the name for the new security role in the As: field.
3) Click Copy to create the duplicate Security Role.
4) Edit Permissions, as desired, for the copied Role.
5) Add the new security role to the Login Logout, Quick Search Navigation modules on the Arena
Basic template.
Arena Select 2014.1.100 29 Security
Steps to Set Permission for the Templates:
For Hosted clients, contact Arena Support.
1) Go to Administration/Templates.
2) Click on the Arena Basic template or the template used for the internal Arena portal.
3) Click the Login Logout Content tab.
4) Click the security key button for the Login Logout module.
5)
6) From the Available Roles drop-down, select the new security role.
7) Set permission for this role. View and edit permissions are all that is required.
8) Click Update.
9) Repeat steps 3 through 7 for the Quick Search module Navigation module on the Left Content
tab.
10) Refresh cache and test.
Arena Select 2014.1.100 30 Security
Deleting Records You may find it necessary to delete records as opposed to making them inactive. On this occasion,
Arena offers the ability delete records through a module setting on the Person Detail module. The
module setting works in conjunction with selecting existing security roles. Users with Global Admin
permission can delete records. When a user attempts to delete a record, if the record contains
associated data, a friendly message will display to notify the user to delete all associated data in
order to delete this record. Users will also need to reassign contributions in order to delete any
record.
Steps to Enable Specific Users to Delete Records:
1) Create a Security Role for the users. View and edit permissions are required on the Individual
Information page.
2) Go to Administration/Pages.
3) Expand Home/Membership/White Pages/Person Detail.
4) Select the Individual Information page.
5) Select the Main Content tab.
6) Select the Person Detail module.
7) Set the Allow Delete module setting to “True.”
8) Select the security roles, as desired.
Arena Select 2014.1.100 31 Security
Security Templates
Security templates allow you to define different permission sets that you may use often, rather
than manually adding all the security roles each time you edit security. These templates are
defined by their object types (tags, person notes, pages, etc.).
Steps to Create a Security Template:
1) Go to Administration/ Security Templates.
2) Click Add New Security Template icon.
3) Enter the Name for this Security Template.
4) Enter a Description for this Security Template.
5) Select Object Type. Available objects include Portal, Page, Module (module), Tag, Attribute,
Attribute Group, Metric, Report, Group Cluster, Application, Person Field, Person Note,
Document Type, Assignment Type, Background Check Type, and API Application.
6) Select the Security Roles or Person to add to this Security Template.
7) Set permissions.
8) Click Update.
Arena Select 2014.1.100 32 Security
Applying Security Templates to Person Notes
With a Person Note Security Template available, users can add the security template to a person
note allowing other users access to notes marked private. Refer to the User manual for more
information regarding creating Person Notes.
Using Security Templates with Other Object Types
For other available objects, users can select the security templates from the security popup window
for that object.
Arena Select 2014.1.100 33 Security
Person Details Field Security
This page works in tandem with the Attribute and Person Fields tabs in Security Roles. While the
record Arena displays is the current user logged in, security settings apply to all records. To display
all field security options and for Arena to starting applying your security roles to this page, set
Secure Fields to “True” on Person Detail module on the Individual Information page. Due to the
nature of this function, it is best practice to limit access to this page.
Arena Select 2014.1.100 34 Security
Steps to Modify Security from Person Detail Field Security page:
1) Select the security key of any field or section you want to adjust.
2) Make desired changes, by Security Role or by Individual. Any changes also update the respect
security roles.
3) Click Update.
Arena Select 2014.1.100 35 Security
Application Security
On this page, you can apply security permissions to Arena’s Check-In, Family Registration,
Contributions, Mailing and Arena Hub.
Steps to Update Application Security:
1) Go to Administration/Application Security page.
2) Select the desired application.
3) Click Edit Security.
4) Select a Security Role or a Person.
5) Modify permissions. If using Security Roles, permissions will update in the Security Role.
6) Click Update.
Arena Premium 2014.2.100 36 Website Structure
Website Structure
Arena Select 2014.1.100 37 Website
Portals
Before customizing any of Arena features, it is a good to start with understanding Arena’s
structure. Arena is a web-based church management software designed to complement your
organization’s ministries. Users can access your organization’s Arena from any browser (e.g.,
Internet Explorer®, Google Chrome®, Safari®, or Firefox®). Check with Arena Support for version
validation and if compatibility view is required. For some specific functions such as, the Check-In
click-once application, Mailing, Family Registrations and Contributions click-once applications
Internet Explorer® is required due to using .NET framework.
Each Arena installation includes three portals. Each portal is a separate set of pages, modules, and
security settings. Portals use the primary domain information from your IIS (Internet Information
Services) website host headers to direct web traffic from a particular domain to a specific Arena
website such as your Arena-managed website. Each portal is designed to have a distinct URL so
keep in mind which portal you are accessing within the same browser. Toggling between portals in
the same browser session could result in the browser caching to the previously selected portal.
If your organization elected to install two instances of Arena—Production and Sandbox, you will
have a total of six default portals—the three default listed portals for each instance. The instances
are separate and do not have any shared files or data. Work performed in an Arena Sandbox
instance does not convert nor connect with the Arena Production instance. For Hosted clients, you
can request a local installation for testing purposes.
The paths in Arena’s web.config file route users to the specified home page and login. When a
user accesses Arena, regardless of his or her location, the web server consults the web.config
file as referenced in IIS. The web.config file has a default portal ID. The web server then queries
the Arena database to determine the page to display and if the user is required to login.
• Arena (Portal 1 = Staff) – This is the primary portal designed to be used by staff on a day-to-
day basis. This is a default portal.
• Arena Web (Portal 2 = Members) – This is the member portal designed to be used by
prospects, guests and members of your organization. This is a default portal.
• Arena Mobile (Portal 3 = Staff) – This is the mobile portal designed for staff and is accessible
using any browser-enabled smart phone. This is a default portal.
• Donation Kiosk (Portal 4 = Staff + Members) – This is an optional portal you can install from
Arena Hub where staff can process contributions from a browser enabled device using a card
reader. This is not a default portal but is available for download on the Arena Hub page.
Arena Select 2014.1.100 38 Website
Click any portal to display the portal details.
• Portal ID – This is the ID number of the portal. When accessing different portals in the same
browser, it is suggested to use the portal ID to point to the specific portal to avoid browser
caching to the previous portal such as, http://arena/default.aspx?portal=1&refreshcache=true.
• Portal Name – This is the name of the portal.
• Portal Title – This is the portal title.
• Portal Description – This is the description of the portal.
• Portal Notes – This is an optional field for portal notes.
• Default Page ID – This is the landing page for the portal.
• Portal Style Sheet – This is the default cascading style sheet for the portal. You can set a
different CSS for any page in the Page Details
• Tree Style Sheet – This is the default page tree style sheet. This CSS will be used for tree styles
unless specified otherwise on the specific page.
• Navigation Style Sheet – This the default navigation style sheet. This CSS will be used for tree
styles unless specified otherwise on the specific page.
• Login Page ID – This is the page for members to login.
• Not Found Page ID – This is the page to direct users to when a page is not available.
• Person Popup Page ID – This is the page that displays the person popup information.
• Default Domain – This is the portal domain.
• Mobile – Check this box if the portal is for mobile devices.
• Authentication – Authentication options are Forms Authentication or Windows Authentication.
Hosted clients will use Forms. Self-hosted can select Forms or Windows Authentication.
• JQuery Include – This is AJAX query to exchange data with the server and update parts of a
web page without reloading the whole page.
Arena Select 2014.1.100 39 Website
Portal Separation
It is important to remember that each portal has a separate set of pages, security settings and
permissions. For this reason, it is critical that no page or module reference a page or module in a
different portal (e.g., crossing or jumping portals). Should such a reference seem necessary, you
should instead copy the target page into the referencing page tree and then target that copy
instead of the original page.
Portal Security
An Arena portal can be set to allow access by one of two methods. The first method is Windows
Authentication where the username that the individual uses to log into their computer is passed to
Arena as their user ID automatically (no password is required for login, as Arena assumes that
Windows has already verified the User ID and Password via Active Directory).
The second method, Forms Authentication requires users to enter a user ID and password every
time they access the Arena portal. In order for staff to access the Arena (internal) portal without
using a VPN connection, set the portal to Forms Authentication so that users can access Arena
using any Internet browser, while being secured using Arena Security Roles.
While your internal access to the Arena program (through the default portal 1) can usually remain
in Windows Authentication mode, it is highly advised that you set any externally accessible portals
to Forms Authentication to make sure your data remains secure.
Customization Options:
• Arena has a default timeout setting of 10 minutes if no activity. This time can be adjusted in the
webconfig file.
• To use a different CSS, you will first want to add the CSS file in the ~Program Files (x86)\Arena
ChMS\Arena\CSS folder.
Templates
Templates are the framework that defines the appearance and layout of your site. Templates are in
HTML inside of an ASP.NET page and allow a huge amount of versatility both in their own content
and design and in the design of your website. The HTML format of templates is coded in C# and is
saved as an ASP module file (.ascx).
The template files are located in the ~ArenaChMS/Arena/Templates folder on the web server. Your
web team can customize the existing templates.
Arena Select 2014.1.100 40 Website
Pages
The page structure is how Arena defines website layout and
navigation. It is frequently referred to as a page tree because it
uses a hierarchy structure consisting of parent pages with one or
more child pages which can be parent pages as well.
Your Arena install includes three page collections. Each collection of pages represents three Arena
portals. Each Arena portal has predefined page trees with applicable modules. Pages display in an
expandable tree view and represent the order in which they appear. Faded folders indicate that a
page is set to not display in navigation. Click on a page to display the content tabs of that page.
Templates determine the content area tabs. The majority of modules are on the Main Content tab
of a page.
Home is Portal 1 used by staff on a daily basis
Mobile Pages is Portal 3 used by staff via smart phones
Web Pages is Portal 2 used by members via a browser
Page Details
Click the Edit Details button on a page to display the page details.
• Template – This is the template applied to the page.
• Parent Page – This is the page above the current page in the page tree hierarchy. You can move
a page by selecting an existing parent page in the drop-down. All child pages will stay bound to
the moved page.
• Page Name – This is name of the page and will display in the navigation bar, if the page is visible.
You can customize the name of any page.
• Menu Name – This is an additional page name for web analysis purposes.
• Display in Nav – Check this box to display the page in navigation.
• Require SSL – Check this box to use SSL (https) for a portal/page. You can apply SSL to any
portal/page with the exception of Arena Check-In.
• Validate Request - Check this box to prevent cross-site scripting attacks. The installer checks
this box on all pages except for page 2297 (Organization Settings) and page 32 (Role Details).
Any page in Arena where this setting is set will cause an error if it detects any dangerous input
such as <script> tag or any HTML tags.
• Description – This is the page description.
• Page Settings – This is where you can set options like the Page CSS, Navigation icons, and other
settings specific to the current page.
Arena Select 2014.1.100 41 Website
Visibility Occasionally you will find that you need to have pages in your page structure that you do not want
to be visible in the navigation bars on your website. These pages can be ‘hidden’ by un-selecting
the Display in Nav checkbox in the Page Details of each specific page. Note that this is separate
from a security option. A user with proper security permissions can still navigate to these pages by
redirects, saved links, or other means but if they do not have the proper security permissions for
the pages they will be unable to access them by any means.
The All Users security role must be able to view your Login page, as all visitors count as members
of the All Users security role until they have passed through the Login page. It is also important to
give view rights to the Login page to every security role with any permissions on this page tree, as
certain modules may attempt to re-verify the identity of a user by passing their login and password
to the Login page.
Page Security Tab
The Security Tab for each page works just like Page Security in Security Roles, except the Security
Tab sets permissions only for the current page. Click Cascade Permissions to apply security to all
child pages.
Arena Select 2014.1.100 42 Website
Modules
As you navigate around the Arena application you will see many different ways in which you can
interact with the data in your Arena database, each appearing as its own separate piece. These
separate pieces of the Arena application are called Modules. Modules are small applications or
‘applets’ which can be stand-alone or operate in tandem with other modules. These applets deal
with a specific function of the Arena application in a highly specialized method, allowing them to be
very small and very efficient. This also allows you to place a portion of the application virtually
anywhere, from adding forms to various internal pages to displaying information from your
database on an external site.
There are several hundred modules already in use with several more available for use. These
modules can serve utilitarian functions such as the Page Dropdown Menu module for navigation
or the Login Logout module for secured sections of your web site. They can also be static
modules for displaying information such as an Advance HTML Text module used to display a
Flash animation file or an image. Some optional modules can even be interactive, such as a Poll
Display Active in Category module to gain information from visitors to your website. You are
encouraged to explore the available modules and place them as needed throughout your
website.
Two of the most underestimated modules in Arena, and worthy of special mention are the
Advanced HTML Text and Report Grid From Query (commonly referred to as RGFQ) module. The
Advanced HTML module can be used for nearly any type of HTML code, from formatted tables to
Flash animation files to image maps, and still be edited as easily as any text file. For example,
you could create an image from a map of your city and the surrounding area, place it in the
Advanced HTML Text module, then create an image map linking to pages for your small group
areas so that a visitor can select a small group near their home or work. Just about anywhere
where you might think you need to write an element into your template, such as a link, some
header text, or a Flash animation, you can instead use an Advanced HTML module so that you
can later edit the element without needing to modify your template. The RGFQ module can be
effectively used to display SQL query data. This module can display the results of a query less
than 2,000 characters in length or run a custom stored procedure.
Each module has specific function and may or may not contain module settings. Some module
settings are required and some are optional. You will want to evaluate each module currently in use
on every page of features your organization is using.
Arena Select 2014.1.100 43 Website
All modules display on the Administration/Modules page.
• Use the Module Name, Category and Added in last <#> days filters to display specific
modules.
• Name – This is the module name.
• Module URL – This is the file path of the ascx file stored in the ~ArenaChMS/Arena/UserControls
folder.
• Allows Child Modules – A green check mark indicates this module can contain child modules.
Click the Pages link to display the file path of the pages where this module is currently applied.
• The shaded delete icon displays for modules you cannot delete due to the module being
applied to at least one page. The delete icon displays for modules not currently in use.
• Use the Import Modules to browse and select modules to upload.
• Click Export Modules to display a popup to select module to export, creating an XML file that will
contain the contents of the .ascx file and the module reference for the database.
Arena Select 2014.1.100 44 Website
Module Security Arena allows you to customize the pages and modules that can be seen and edited by your users in
several different ways. The primary method is to use security roles to manage view and edit rights.
Alternatively, you can grant individual access to pages and modules to specific users, for when you
need a very small select group of individuals to have a specific set of access rights to those pages
or modules. It is important to remember that while a security role or individual may have view
rights to a module, if they do not also have view rights to the page that module is on they will still
be unable to view that portion of your web site.
In general, you will want the publicly viewable areas of your web site to include the All Users
security role with view permissions, to allow users who have not logged in to view those pages.
You will also need to make sure that the All Users role does not have any permissions for any areas
of your web site which will require a Login. You will want to maintain at least one user or security
role (typically a Web Admin security role) with edit rights to every page, to update your web site in
the future.
Module Settings
Many modules have required settings and you cannot update the module until you enter a value for
the required settings. If you attempt to update a message will display indicating a field is missing
with an * asterisk next to the required field. Once you enter all required fields, click update.
In most cases, you can access applied modules on the Main Content tab of the specific page.
You can optionally click in the top right corner on most pages to directly access
module settings. If more than one module is on the page, use the Module dropdown to select
desired module.
Arena Select 2014.1.100 45 Website
Then you can make the desired module setting changes.
When you make adjustments using the Edit Settings page option, click Save then Done.
Arena then will display a refresh cache window. Click OK to apply changes.
Arena Select 2014.1.100 46 Website
Steps to add a Module to a page:
1) Click on the desired page. Expand page tree as needed to access the desired page. The screen
will refresh and display the Page Details. This will also display the tabs that represent the
various content areas that define the page layout.
2) Click the desired content tab. For default Arena templates, most modules are on the Main
Content tab. Any modules already on that page will display.
3) Click the Add New Module button. By default, the new module name will be New Module and
the type will be “Advance HTML Text.” Optionally, you can change an existing module.
4) Click New Module.
5) Select the desired module.
6) Based upon the selected module, make required and desired changes. Many modules have
required settings, and you cannot update the module until you enter or select all required fields.
If you click the Update button with a required field empty, a message will display indicating that
a field is missing, and a small * asterisk will display next to the field.
7) Click Update.
8) Set permissions for the module. You can also set permission through Security Roles.
9) Use the drag-n-drop button to change the order of the modules.
Module Security
Module security is similar to working with permissions in Security Roles. Click the Security button
to the right of the module to make module security adjustments. This is especially valuable when
applying the same module to a page, yet with different module settings such as working with the
List Report module.
Arena Select 2014.1.100 47 Customizing Arena
Customizing Arena
Custom Field Groups
Custom Field Groups are a predefined collection of fields Arena Administrators create for use with
Groups, Tags, Assignments and Mission Trips. You can edit Custom Field Groups only on this page.
Users are not able to edit the fields.
Steps to Create Custom Field Groups:
1) Go to Administration/Custom Field Groups.
2) Click Add. Arena creates a New Field Group placeholder.
3) Click the Edit button.
4) Enter a Group Name for this custom field group. This is the group name users select, not the
specific fields.
5) Select a Category. You can customize this Custom Field Module Category Lookup.
6) Click the Update button to save.
7) Select the name of the new Custom Field Group.
8) Select the Add New Field button to create a field.
Arena Select 2014.1.100 48 Customizing Arena
9) Complete fields, as desired.
• Title – Enter the name for this the custom field.
• Title Location – Select where to display the field. Options are left, right, top, bottom, and
none.
• Type – Select a field type. Options are below.
Address – This field gives users the ability to enter an address.
Area – This field enables you to select an available area. You can create Areas in Groups.
Checkbox – This field enables you the ability to create a multi-select list of options for
users. Enter values in comma-delimited format in the Values box that displays below
the Type dropdown.
Custom Query – This field enables you the ability to enter a custom SQL query.
Date – This field allows users to enter a date.
Document – This this field gives users the ability to attach a document. You must create
at least one Document Type for this field to be available. Refer to Document Types in this
manual for additional information.
Dropdown List – This field enables you the ability to create a drop-down list of options for
users to select. Enter values in comma-delimited format in the Values box that displays
below the Type dropdown.
Image – This field enables users the ability to upload an image.
Lookup Type – This field enables users the ability to select a drop-down from existing
Lookups.
Person – This field enables users the ability to search for a single existing record. Person
Page ID is “7.”
Phone Number – This field enables users the ability to enter a 10-digit telephone
number with the option to enter an extension.
Radio List – This field enables you the ability to create a single-select radio list of option for
users.
Enter values in comma-delimited format in the Values box that displays below the Type
dropdown.
Rich Text Field – This field enables users the ability to enter rich text.
Static HTML Content – This field enables you the ability to enter static content, with the
option to use HTML.
Textbox- This field enables users the ability to enter text.
• Rows – Used to expand area for fields; enables word wrapping for the number of entered
rows.
• Pixels Wide – This option widens the custom field box, often used with Checkbox, Radio
List, Rich Text Field, Static and HTML Content.
• Visible – Check this box to make the field visible.
Arena Select 2014.1.100 49 Customizing Arena
• Required – Check this box for fields that are required.
• Read Only – Check this box to indicate fields that are view only. This will make the field
display as a disabled field (grayed out).
• Enable Auto-Fill – Check this box for the field to auto-populate, using existing Arena data.
This option is for fields behind a login.
• Show on List – Check this box for fields to display on the confirmation page of event
registration.
10) Click Update.
11) Repeat steps 8 and 9 for all fields you want to add to the Custom Field Group.
Steps to Delete a Custom Field and Custom Field Group:
1) Remove where custom field is used.
2) Go to Administration/Custom Fields Groups.
3) Select the Custom Field Group.
4) Identify the custom field you want to delete.
5) Click red to delete the field. If any field is in use, Arena will display the below popup.
6) Go back to Administration/Custom Fields Groups.
7) Click red to delete for the Custom Field Group.
Arena Select 2014.1.100 50 Customizing Arena
Lookups
Lookups under Administration display a list of all current Lookup Types. Each Lookup Type contains
specific Lookup Values. It is common to first evaluate and customize existing Lookups. You can also
create new Lookups.
Lookup Types
Lookup Types are groups of values used throughout the application.
• ID – This is the identification number for the Lookup Type.
• Lookup Type – This is the name of the lookup and a hyperlink to view lookup value.
• Description – This is the description for the lookup. Descriptions for default lookup provide you
information as to where and how the lookup is used.
• Qualifiers – This is an optional qualifier setting.
• Edit – Click this button to edit the lookup name.
• Delete – Click the delete button to delete the lookup type. You cannot edit or delete some
System Values Lookup Types but you can make a lookup inactive.
Arena Select 2014.1.100 51 Customizing Arena
Lookup Type Values All Lookup Types have values. The values are the options users can select where the Lookup is
used. It is common to review and customize default Lookup Type Values.
• ID – This is the identification number for the Lookup.
• Value – This is one of the options in the lookup dropdown.
• Security Indicator – This column varies by Lookup with options such as Column Security
Indicator, Area Map Image, and Propagation.
• Active – The green checkmark indicate the lookup is available.
• Change Order – Use the change order button to drag-n-drop values in the desired order. You
can also click the Sort Alphabetically link at the bottom.
• Delete – Click the delete button to delete the lookup. You cannot edit or delete some System
Values Lookup Types but you can make a lookup inactive.
Steps to Edit a Lookup Type and Lookup Value:
You can edit Lookups at any time. Features using the lookup will reflect any changes.
1) Click the Edit button of the lookup type.
2) Make desired changes.
3) Click green save button.
4) Click the Lookup Type.
5) Click the edit button of the value you want to change.
6) Make desired changes.
1) Click green save button.
Arena Select 2014.1.100 52 Customizing Arena
Steps to Create a Lookup:
You can use alpha and numeric characters when creating new lookups. Do not use special
characters.
1) Click the Add New Lookup Type button at the bottom. This will add a new lookup type called
[New
2) Lookup Type].
3) Click the [New Lookup Type].
4) Complete all desired fields. Override the default [New Lookup Type] name.
• ID – This number is the field identification number Arena assigns.
• Lookup Type – This is the name of the lookup type.
• Description – Enter a description for this Lookup Type such as, what kind of values this type
will hold.
• Qualifiers –This option can perform certain tasks when the value is used. Typical user-
created values will not have any qualifiers, but you can use them for reporting purposes to
group multiple values together.
• – This is the save icon.
• – This is the cancel icon.
• – This is the delete icon.
5) Click Save.
6) Click the new Lookup Type.
7) Click the Add button.
8) Enter lookup value.
• ID – This number is created by the database when a new lookup value is created
• Value – Enter in the Lookup Value name.
• Active – Leave this checkbox checked to use this Lookup Value immediately.
• Foreign Key – Only the Arena Sync or modifying the Database will enter a value in the
Foreign Key field.
9) Click the Save button.
10) Repeat all steps for each Lookup. After you create the first lookup, the Add Lookup button
moves to the button right corner.
Arena Select 2014.1.100 53 Customizing Arena
Peer Types
Peer Network Relationships represent a connection between people in Arena based on the people
being in the same Group, Tag or Relationship Type. Use this option to identify where members
connect to other members based on how he or she connects within your organization. The Peer
Network value displays on the person details page with the name, score, and up or down trend
for the records. The larger the numerical value represents a stronger connection. The Arena
Calculate Peer Agent must be running prior to using peer network.
Steps to Setup Peer Types:
The peer types are the stored procedures that run to calculate the individual scores.
1) Click the Add button.
2) Enter a name for the peer type.
3) Select Active if not already selected.
4) Enter a description.
5) Select a peer network stored procedure.
6) Enter Organization description and ID #.
7) Enter the value for this peer type. A large value indicates a stronger ‘peer’ connection.
8) Click Update
9) Repeat steps 1-7 for to setup additional peer types.
10) Adjust the peer type order. The peer types run in order from top to bottom. If you are
using the calculate_declining_stored procedure, you must make it the last one in the list or
it will not calculate any below itself.
Arena Select 2014.1.100 54 Customizing Arena
Person Attributes
Person Attributes are data fields that display on the Person Detail page. In many cases, you can
customize the default attributes or create new attributes. Attributes can record several types of
data, including numerical values, date values, and string (text) values. Users can also create
lists using available person attributes.
At first, you will want to customize existing Person Attributes and eventually add new Person
Attributes and Person Attribute Groups. Before adding new Person Attribute Groups, you will
first want to determine the location of the Person Attribute Group. There are four available
sections on the Individual Information tab of the Person Detail page where you can add Person
Attribute Groups—the Profile section which is located in the top portion, the Activity section
where Groups, Tags and Member Data display, the Attendance section and the Personality
section.
• ID – This is the Person Attribute ID number.
• Attribute Group Name – This is the name of the collection of attributes. This name
displays on the Person Detail Page.
• Attributes – This hyperlink connects to the values associated with this attribute group.
• Display Location – This is where the person attribute will display on the Person Detail page.
• System Group – This reflects if the attribute is core or not. You cannot delete system groups
but you can elect not to display them through module settings. You may also elect to
customize system attributes instead of creating new ones.
• Security – Click this button to make security permission changes. Changes you make will also
reflect in Security Roles.
• Change Order – Use the change order arrows to drag-n-drop attributes to the desired order.
• Edit – Click this button to edit an attribute.
• Delete – Click the red to delete an attribute. To delete an attribute, you must first
remove it from all records.
Arena Select 2014.1.100 55 Customizing Arena
Steps to Customize a Person Attribute:
You can also add new Person Attribute. The only exception in the below steps is to add new fields.
1) Click the edit button.
2) Customize name or location.
3) Click Update.
4) Click Attributes for the new Person Attribute Group to add attributes for this group.
5) Click the Attribute you want to change.
Arena Select 2014.1.100 56 Customizing Arena
6) Make desired changes.
• Group – This is the attribute group for the attribute. Changing this will move this
Attribute to a different Attribute Group.
• Name – Enter the name of the field, such as How Received, Uniform Size, Background
Check, etc. The name of an Attribute can be up to 125 characters.
• Type – Choose the type of field. Options are:
Integer – This allows the user to enter a numerical value.
String – This allows the user to enter text.
DateTime – This allows the user to enter a date, with calendar lookup.
Lookup – This option enables you to select an existing lookup type.
YesNo – This allows the user to select a “Yes” or “No” checkbox.
Decimal – This allows the user to enter a decimal numerical value.
Currency – This allows the user to enter currency values.
URL – This allows the user to enter a HTTP link that will open a new web browser to that
link.
Document – This allows the user to upload a document. A Document Type is required.
• Visible – Select this option to display this Attribute on the Person Details page.
• Read Only – Select this option to display only the attribute. It is not editable.
• Required – Select this option to require the user to update the attribute when in
editing the attribute group.
• Enable History – Check this box to enable Arena to keep the history as users change the
value.
Number of Previous Values – Enter the number of values you want to track.
7) Click Update.
8) Repeat steps 7 through 13 for each Attribute for this Attribute Group.
Arena Select 2014.1.100 57 Customizing Arena
9) As you add attributes, use the change order button to drag-and-drop the attribute
to the desired position.
10) Set security for the Attribute Groups and each Attribute. You can also set security
through Security Role Permissions. Users will need view and edit permission to the
Attribute Group in order to edit any field associated with the Group.
Attribute Group Security
Attribute Security
11) On the List Configuration page, you may also want to make the new attributes available
for users to select as criteria for My and Public List.
12) Optionally, customize the White Pages module to display attributes on the
Membership/White Pages page.
Arena Select 2014.1.100 58 Customizing Arena
Steps to Delete an Attribute:
1) Go to List Configuration.
2) Click the Attribute Controls for Person List.
3) Uncheck the specific attribute(s) and field group.
4) Go to the Administration/Person Attributes.
5) Click the Attributes link of the desired Person Attribute.
6) Click the red to delete the attribute.
7) A notification window will display.
8) Click Ok. Arena will delete any lists using the attribute.
Arena Select 2014.1.100 59 Customizing Arena
Relationship Types
Relationship Types enable the user to show a relationship between two records outside of the
immediate family. Some common uses would be grandparent to grandchild, aunt/uncle to
niece/nephew, or Shepherd to Sheep. No Relationship Types exist for new installations. If your
organization uses Arena Check-In and you would like to allow non-family members to check one
another in, create a Relationship containing the phrase "can checkin" (case insensitive, no
quotes) to permit this action.
Arena Select 2014.1.100 60 Customizing Arena
Steps to Add Relationship Types:
1) Go to Administration/Relationship Types.
2) Click Add.
3) Enter a Name for this Relationship. The first Relationship Type will not have an Inverse.
4) The first relationship you enter will have no Inverse Relationship, so leave the inverse blank.
After you create at least one Relationship Type, you can select it as the inverse of the second
one you create. Each Type can only have one Inverse. Each Relationship Type can have one
inverse.
5) Set the Relationship Strength, as desired.
6) Add another Relationship Type.
7) Select the Inverse Relationship. This will likely be the Relationship Type you previously
created.
8) Set the Relationship Strength, as desired.
9) Click Update.
Arena Select 2014.1.100 61 Customizing Arena
Report Services Configuration
The Report Services Configuration page displays the connection information from Arena to
your Microsoft Reporting Services server. This may or may not be the same as the SQL server.
This connection is required in order for any Arena Reports to load properly.
Arena Select 2014.1.100 62 Customizing Arena
Reports
The Reports page has identical functionality as other Reports pages in Arena. The intention of
this page is reports for Arena Administrators. Use the Report Builder to edit to existing reports.
Editing an existing report using Report Builder
Verify the Run Report Builder is available on the Reports page.
1) Go to the desired reports page.
2) Click Run Report Builder.
3) Select the Open option on the Getting Started window.
4) Locate and open the RDL file you want to edit. Report file location will vary by organization.
Arena Select 2014.1.100 63 Customizing Arena
5) Now you are ready to edit the report. From this view, you can use available datasets to
add, remove or arrangements report elements.
6) Run the report to verify edits.
7) Save the report.
Arena Select 2014.1.100 64 Customizing Arena
System Emails
System Emails are global emails sent based on the feature. Below is a list of system emails
along with a brief description. In order to use system emails, you must complete and save the
required fields and start Agents where applicable.
System Email Description
Advanced HTML
Sends system email to the specified recipient when changes the
Advanced HTML module is changed.
Agent | Birthday
Sends system email to all recipients, based on the Arena Send
Birthday Emails automation agent such as the minimum age of
recipients.
Agent | Contribution Statement Email
Agent | Daily Email Sends a list of all birthdays for the day to a specified person.
Agent | Group Leader Registration
Sends system email based on the Arena Small Group Registrations
automation agent.
Agent | Group Member Registration Sends all pending emails from small group registrations.
Agent | Mailing(CASS/Move) Sends an email when the Cass/Move agent runs.
Agent | Mission Trip Registration
Deposit Reminder
Sends system email to mission team member, with deposit
reminder.
Agent | Mission Trip Registration
Reminder Email
Sends an email to all mission trip travelers who have missed a
deposit deadline to remind them to make the payment.
Agent | Serving Reminder
Sends an Email Reminder to the members of the serving tags
within a defined period of time, prior to the event. Creates
future occurrences.
Agent | Voicemail Notification
Sends system email when the Arena PBX Voicemail automation
agent is run.
Assignments | Email to Remind
Worker
Sends email to the designated assignment worker when an
assignment is not updated or closed by a specified period.
Assignments | Email to Requestor on
Close Sends email to the Requestor when a worker closes an Assignment.
Assignments | Email to Requestor on
Entry
Sends email to the Assignment Requestor when an Assignment is
entered.
Assignments | Email to Requestor on
update
Sends email to the Assignment Requestor when an Assignment is
updated.
Assignments | Email to Worker on
Close
Sends email to the Assignment Worker when the assignment is
closed.
Assignments | Email to Worker on
Entry Sends email to the worker of the Assignment.
Assignments | Email to Worker on
Update Sends email to the worker when the assignment is updated.
Assignments | Notify Assignment Type
Subscriber Sends email to the subscriber when an assignment is updated.
Background Check | Received From
Provider
Sends an email to the person who Approved the request when the
results of the background check are picked up by the Arena Agent.
Background Check | Requested
Sends an email to the owner of the Background Check Type when a
background check of that type is requested.
Background Check | Updated
Sends an email to the requestor when the background check is
approved or rejected.
Arena Select 2014.1.100 65 Customizing Arena
Event Refund Sends an email to the registration when a payment is refunded.
Event Registration Notification If Notify Owner is checked in an Event Tags, Arena sends an email
to the tag owner when someone registers for the event.
Login Request Sends system email when new account request module is used.
Merge Person Request
Sends system email when a user with no edit permission attempts
to merge records.
Mission Trip Contribution
Sends system email once a mission trip payment is made through
online giving.
New User Account | Email
Verification Sends system email to registered user.
Online Giving Contribution Sends system email once payment is made through online giving.
Online Giving | Rejected Contribution
Sends a system email to the designated person with a list of
rejected Contributions.
Password Request
Sends system email once password request is made using Request
Login Information module.
Prayer Request | Comments
Sends system email when the Arena Process Prayer Requests
automation agent is run.
Prayer Request | Expire No Renewal
Sends system email when the Arena Process Prayer Requests
automation agent is run.
Prayer Request | Expire With
Renewal
Sends system email when the Arena Process Prayer Requests
automation agent is run.
Serving Opportunity Details
Sends systems email to the specified person, when a potential
volunteer submits a question online.
Small Group Locator
Sends system email when request is submitted through the Small
Group
Locator.
Subscribed Announcements
Sends systems email to persons who have subscribed to
announcements.
The setting is modeled by the ArenaSubscribedAnnouncement
agent.
User Confirmation Notification
Sends a system email to the email address in the User Confirmation
module.
Volunteer Signup
Sends an email to the Tag Owner when someone clicks the “Join the
Team” button on the external portal.
Arena Select 2014.1.100 66 Customizing Arena
Arena Hub
The Arena Hub is a Microsoft NuGet® plugin technology that enables the ability to upload to a
central repository (Hub) and all Arena clients can access. NuGet plugins provide a way to install
SQL code, files and reports directly to Arena without needing access to the web server or SQL
server, removing the necessity for an executable.
In the past, the installer implemented the reports, which took additional time in the installation
process. The installer will now only place the reporting services folders in the proper locations.
All current customers can install the plugin, but it will simply check to make sure the reports are
there and up to date.
Arena Select 2014.1.100 67 Customizing Arena
Steps to Download Arena Hub Items:
At install, users in the Global Administrator security role have access to Arena Hub. Prior to
installing Arena Hub items, you will first want to make desired security adjustments.
1) Log in as a Global Administrator. Temporarily add yourself to the Global Administrator
security role.
2) Go to Administration/Application Security.
3) Select Arena Hub from the Application dropdown.
4) Click Edit Details.
5) Add the Arena Administrator security role.
6) Select View, Edit Settings and Edit Security permissions.
7) Click Update.
8) Refresh cache.
9) Remove your record from the Global Administrator security role.
10) Login in again and verify access.
Arena Select 2014.1.100 68 Customizing Arena
11) Select the item you want to add.
12) Review the details for this install.
13) Click Install to complete.
14) Verify. Arena will install reports in default folders, assuming the folders are accessible in
Arena. If the folder is not visible, you can add a page with the folder specified in the Report
Viewer module.
Arena Select 2014.1.100 69 Customizing Arena
Steps to Update Arena Hub Items:
On occasion Shelby Arena will update different elements of Arena such as, reports. Follow the
below steps to update such elements.
1) Log in to Arena with the needed Arena Hub permissions.
2) Go to Administration/Hub.
3) Locate the element to update.
4) Click Refresh.
5) Review the update details.
6) Click Refresh.
Arena Select 2014.1.100 70 Configuring Arena
Configuring Arena
Agent Configuration Utility
The Arena Automation Agents handles features such as email, Active Directory synchronization,
and Metric Processing. The Agent Configuration utility manages the detailed settings of each
Worker in the Arena Automation Agent service. It enables an administrator to quickly set or
modify the worker settings, designate schedules in which workers can operate and specify
notification preferences. If the service will not start or the expected data changes do not occur,
check the Event Viewer on the Web Server for possible causes.
Some agents work in conjunction with specific systems emails. Agents should be scheduled to run
when the backup is not running. If an agent is scheduled to run when the backup is running, it can
cause the agent to stop running and you will have manually start each agent that was stopped. Once
you evaluate the Arena implementation plan for your organization, refer to the Agent section for
starting the agents. At installation no Agents are scheduled to run.
You can access all agents in the ~Program Files/Arena ChMS/Arena Automation
Agents/AgentConfiguration folder located on the web server. The Arena Automation Agent
should be set to start automatically.
To verify settings:
• From Start/CMD, open msconfig
• Select Services tab
• Verify Arena Automation Agent is
running
If not running:
• Right click on Compute
• Select Manage
• Select Services
• Right click on Arena Automation Agent
• Select Properties
• Set to Automatically Start
Arena Select 2014.1.100 71 Configuring Arena
The interface contains five major areas for each agent: Agent Jobs, Agent Service, Worker
Settings, Schedules, and Notifications.
The Agent Service shows the status of the selected Arena Automation Agent. From this page,
you can start and stop the service in order to implement changes. Select the Add button to add
an agent or select the Remove button to remove and agent.
Arena Select 2014.1.100 72 Configuring Arena
Agent Jobs The Agent Jobs area, as shown to the below, lists the active workers in Arena’s Agent service.
Remove any workers not currently in use, as they may cause conflicts with other workers if not
properly configured. Even with proper settings, unused active agents may be changing records
and fields that you may not want automatically updated.
Arena Select 2014.1.100 73 Configuring Arena
Worker Settings The Worker Settings tab displays the configuration options for the worker currently selected.
These configuration options can display either by category or in alphabetical order. Each field
must have a value, and a brief description of the purpose of the field. Valid values for the field
display in the dialog box at the bottom of this tab, as shown below. Once a worker is removed, all
worker settings with a future date will clear and must be re-entered if the worker.
Arena Select 2014.1.100 74 Configuring Arena
Schedules Each worker in the Arena Automation Agent service can operate on its own unique time line,
which you can define on the Schedules tab. This tab displays the operating schedule for the
selected worker and a description of each agent’s purpose. Multiple schedules allow a worker to
operate during specific intervals, such as early morning or late evening. We recommend setting
each Agent schedule so that it can run successfully prior to the agent starting again. Similar to
the Worker Settings tab, each field is required.
Make sure that the frequency is set to run only once within a period-of-time. For example, if the
Start Time = 07:00:00 and End Time = 19:00:00 then set the frequency to 16:00:00 so that the
agent will fire at 7 am and since it only runs from 7 am to 7 pm the agent will not run again in that
12 hour window. For agents set to run multiple times during a time period we recommend to not
cycle the agent too quickly (less than 15 minutes for some) as it can cause the agent to stop
running.
Arena Select 2014.1.100 75 Configuring Arena
Notifications You can configure the threshold, frequency, and recipient email of who to notify when the agent
runs and when an error occurs. Select one of the Notify on Worker Results Status options for
when to send an email. Just like Schedules, you can add multiple notifications to accommodate
different settings.
Arena Select 2014.1.100 76 Configuring Arena
Steps to Start an Agent:
1) Go to ~Program Files/Arena ChMS/Arena Automation Agents folder.
2) Select AgentConfiguration.exe folder.
3) Click the Add button.
4) Select the desired Agent from the Agent Jobs list.
5) Click OK.
6) Adjust Worker Settings, Schedules and Notifications, as desired.
7) Click Start.
8) Click Save.
9) Close Agent Configuration.
Arena Select 2014.1.100 77 Configuring Arena
Arena Automation Agents:
Below is a list of arena agents and a description of each. Keep in mind, some agents work in
conjunction with System Emails.
• AD Sync (Active Directory) Sync – This agent synchronizes User passwords to Active Directory
(AD). If the Agent finds the same username in the Active Directory that is in the Arena database,
the user’s password will change in Arena to match the Active Directory password. The AD
Configuration must be set under Administration in order for this Agent to function.
• Area – This agent updates addresses with Areas.
• Background Checks – This agent processes background checks completed by the provider.
• Calculate Peers – This agent executes all of the active relationship type stored procedures for
the peer network.
• Computer Audit – This agent searches the Domain the web server is part of for other
computers. It is capable of listing all the computers on the Domain, along with hardware and
software specifications about those computers. This agent is heavily dependent on specific
hardware configurations.
• Create Occurrences – This agent creates occurrences for use in Check-In.
• Daily Email – This agent sends daily a list of all birthdays, within a specific age range, to
individuals in a specific tag. You will also need to customize the Daily Email System Email.
• Email Clean – This agent utilizes a POP3 (Post Office Protocol) email account to delete or
inactivate email addresses that are invalid, determined by a mailer return to the POP3 account.
• Emails Contribution Stmt – This agent identifies contribution statements by email.
• Event Email – This agent sends all pending emails from the event, including reminder emails.
• Historical Contributions – This agent processes historical payments.
• Mail Queue – This agent separates Communications in batches and submits automated email
notifications to the SMTP server on the domain.
• Mission Trip Deadline Reminder – This agent sends an email to the mission team member to
remind him or her of the registration deadline, if registration is not complete.
• Mission Trip Registration Deposit Reminder – This agent sends an email to the mission team
member to remind him or her of the deposit.
• PBX Cdr – This agent works when integrating Arena with an Astericks Phone System.
• PBX Peers – This agent works when integrating Arena with an Astericks Phone System.
• PBX Voicemail – This agent works when integrating Arena with an Astericks Phone System.
• Process Critical Serving – This agent sends the respective Serving Tag owner and email
communication for all people who are registrants in a serving profile that meets the following
criteria: The value of the status lookup is 'No Contact'; The status lookup has a lookup_qualifier3
value of 1 AND they were last modified more than [Critical Profile Days Organization Setting] days
ago. Additionally, they are marked as critical if the value of the status lookup is 'No Contact' and
last modified more than [Critical Profile Days Organization Setting] days ago. You can also
customize the Tag Member Status Lookup to include other statuses as critical by adding “Y” to
include as Critical indicator.
• Process Prayer Requests – This agent processes the prayer requests from the website and
sends the appropriate emails.
• ProcessPOP3 Account – This agent processes emails in a specific POP3 account to create the
communication in Arena.
• Send Birthday Emails - This agent sends an email to any person in the database that has a
birthday on this day. You will also need to customize the Birthday System Email.
• Serving Reminder – This agent sends an email reminder to the members of the serving tags
based on future occurrences.
Arena Select 2014.1.100 78 Configuring Arena
• Small Group Registrations – This agent processes automatic Small Group
registrations.
• Subscribed Announcements – This agent sends an email to individuals who
subscribe to email communications designated for the announcement email.
• Sync Roles – This agent Synchronizes people in a profile attached to a role. When
you add records to a profile, they get the role automatically attached to that
profile.
• Transaction Settlement – This agent is designed to provide additional information for
organizations using the Payflow Pro payment gateway and populates the
pmnt_transaction_settlement table.
• Update Resource Events – This agent updates Event Tags that use an external event-resource
management application.
Arena Select 2014.1.100 79 Configuring Arena
Application Settings
On this page, you can configure default setting for the Contributions, Mailing, Check-In and
Family Registration Click-Once applications. You can also configure some of these settings in the
applications.
• Load .Net 4.0 and Report Viewer on each network workstation that will use any
one of the click-once applications.
• Whenever you install a new Arena release or patch, click-once applications will
update automatically.
• The next time the user runs the click-once application, it will automatically update.
The first time a user runs an application, the user will have the option to install a desktop
shortcut. Thereafter, the user can launch the application from the desktop shortcut or from
Arena.
From the dropdown, select an application to make changes. Changes are global for all users
accessing the application. You can make specific workstation adjustments through the
workstation application settings option.
Arena Select 2014.1.100 80 Configuring Arena
Check-In Application Settings
Arena Select 2014.1.100 81 Configuring Arena
Family Registration Application
Arena Select 2014.1.100 82 Configuring Arena
Family Registration Workstation Settings
Arena Select 2014.1.100 83 Configuring Arena
Contributions Application Settings
Arena Select 2014.1.100 84 Configuring Arena
Contribution Application Workstation Settings
Arena Select 2014.1.100 85 Configuring Arena
Mailing Application Settings If using Arena’s MOVE Agent, enter the organization’s Shelby Mailroom Customer ID and Customer
Password.
• System – This dropdown displays the computers that have launched the Mailing application.
• Contribution Report Location – This is the contribution statement report for contribution
statements.
• Document Location – This is the file path for word merge documents.
• Customer ID – This is your Shelby Mailroom customer ID.
• Customer Password – This is your Shelby Mailroom password.
• Workstation Install Path – This is the file path to the Mailroom (e.g., C:\MailRoom\Workstat)
Mailing Workstation Settings
Arena Select 2014.1.100 86 Configuring Arena
Background Checks (Optional)
Arena offers the ability to manage background screenings. Once you establish an account with
the background check processing company, your organization can request, approve and maintain
background checks for all records. Currently Arena integrates with Protect My Ministry and
SecureSearch. Your organization can use one of the other. We recommend to establish policies
and procedures for processing staff and volunteer background checks. Your insurance provider,
HR professional or legal counsel can also advise you.
Configured properly, Arena will:
• Populate the name, social security number, date of birth and address.
• Provide a simple process to run a background check.
• Provide levels of authorization so that approval can be required prior to processing a background
check.
• Maintain the status of the background check.
• Download the screening results and store it securely on your system, if desired.
• Allow designated staff to review the results and select “Pass” or “Fail” for the candidate.
Requirements for Background Check Set Up if using Protect My Ministry:
• Create a Protect My Ministry account. Contact a Protect My Ministry representative to create
an account.
• Verify and customize Background Check Types in Administration.
• Set Background Check Type security.
• Set up Background Check System Emails. Refer to System Emails in this manual for
more information.
• Start Background Check agent. We recommend running this agent multiple times per day.
Refer to Automation Agents in this manual for more information.
• Modify Background Check Details module settings, as desired, including the Consent Form
Requirement Level module setting.
• Setup the Background Check Base Detail URL on the Administration//Organizations page.
• Verify proper page set up.
Steps to Set Up an Account Provider Account:
1) Go to Administration /Background Check Configuration.
2) Click Add New Provider icon.
3) Enter Account Information.
4) Click Update.
5) Customize Background Types and set security.
Arena Select 2014.1.100 87 Configuring Arena
Steps to Verify and Customize the Background Check Types:
Default types are Basic and Plus. Contact your provider prior to creating new types.
1) Go to Administration/Background Check Types.
2) Click the Edit button on the far right of the Type you want to customize.
3) Click the Change… link to search and select an existing record for the owner. The current
user is the default owner.
4) Select Notifications options, as desired. Be sure the respective background check system
emails are set up.
• Name – Enter a name for this background check type such as, Basic or Plus.
• Provider – Select a Provider from the drop-down.
• Approve – Check this box to make this Background Check type available.
• Notifications:
Owner on Request – Check this box if you want Arena to email the background check
type owner when a staff members creates a request.
Approver on Results Received — Check this box if you want Arena to send an email to
the approver when individual reports are available for review.
Requestor on Approve/Deny — Check this box if you want Arena to send an email to
the requestor when the background check request is approved or denied.
Requestor on Complete — Check this box if you want Arena to send an email to
the requestor when the background check is done.
• Screenings – Select the screening options, as desired. If you modifications to the
default Basic and Plus plans, additional charges may apply.
5) Select Screenings, for the Plus Plan. Basic Plans screening are pre-selected.
Basic Plan Screenings: Plus Plan Screenings:
• National Criminal Database Search
• National Sex Offender Registry
• SSN Verification & Address History
• National Criminal Database Search
• National Sex Offender Registry
• SSN Verification & Address History
• Credit Screening
• Court Search Screening
• MVR Driving History
Arena Select 2014.1.100 88 Configuring Arena
Steps to set Background Check Type Security:
1) Click the Security Key for each Background Check Type.
2) Set Security.
• View – This access allows users to view requests for this background check type.
• Edit – This access allows users to edit requests, including initial requests, for this background
type.
• Edit Security – This access allows users to edit security for this background check type.
• Approve – This access allows the designated security role or person to approve
background check requests.
Security Role Permissions
Person Fields Security
3) Click Update.
Arena Select 2014.1.100 89 Configuring Arena
Steps to Verify Proper Page Set Up and Set Consent Form:
1) Go to the Administration/Pages.
2) Expand Home/Membership/White Pages/Person Detail page.
3) Select Individual Information page.
4) Click the Main Content Tab.
5) Click the Person Detail module.
6) Set the Background Check Details page setting, if needed.
7) Click Update.
8) Go to Administration/Pages.
9) Expand Home/Membership.
10) Select New Background Check page.
11) Click the Main Content Tab.
12) Click the Background Check Details module.
13) Select a Consent Form Requirement Level option from the drop-down, if desired. This
option will require the requestor or the approver to confirm he or she has obtained a
consent form from the applicant.
14) Click Update.
Arena Select 2014.1.100 90 Configuring Arena
Requirements for Background Check Set Up if using SecureSearch:
1) Create a Secure Search account. Go to www.securesearchpro.com to create an account,
select packages and services.
2) Install the SecureSearch plug-in from Arena Hub.
3) Enter the SecureSearch account information.
4) Start the Arena SecureSearch Updates agent.
Arena Select 2014.1.100 91 Configuring Arena
Campaigns
The Campaigns section of Administration is where you can create and manage Calling
Campaigns.
Steps to Create a New Campaign:
1) Go to Administration/Campaign Administration.
2) Click Add.
3) Select the Edit button to edit this campaign.
4) Complete all Campaign information, as desired.
• Name – Enter a name for this Campaign.
• Description – Enter a description for this Campaign.
• Campaign Manager – Select the person who is the Campaign Manager for this campaign.
• Active – Check this box to indicate if this campaign is active.
5) Click the Update button. Once a campaign exists, the list will display the Campaign
Name, Description, Active Status, Edit button and Delete button. Click the Edit button
to change any of these fields. Users can add existing records to active campaigns using Person
Bulk Update.
Once a campaign is complete, users with security permissions can select the Campaign
Name link to display the current statistics and any outstanding notes of the campaign.
Arena Select 2014.1.100 92 Configuring Arena
Document Types
Document Types enable users the ability to upload forms, images, text documents, scanned
images or other file types. Once you create document types, permission s can be set to secure
the type by security role or person. In order to add a document to Arena, at least one
Document Type must be set up.
Steps to Create a Document Type:
1) Go to Administration/Document Types.
2) Click the Add New Document button.
3) Complete fields, as desired.
• Type Name – Enter a name for this Document Type.
• Show on Person Details – Check this box to allow users the ability to upload this type
of document t on the person detail page. This will require a Document type Person
Attribute on the Person Detail page.
• Allow Description – Check this box to allow users the ability to enter a description for
uploaded documents.
• Use Type as Title – Check this box to use the Type Name as the document title, otherwise
users can enter a title for the uploaded document.
• Image – Check this box to allow users the ability to upload an image for the document. Path
must be in the following format: ~/Images/file.ext.
• Icon (Small) – If the image box is checked, enter the file path to the thumbnail image. The
source file must exist in the Images folder in the Arena code folder on the Web Server.
• Icon (Large) – If the image box is checked, enter the file path to the large image. The file
must exist in the
• Images folder in the Arena code folder on the Web Server.
4) Click Update.
5) Set security.
Arena Select 2014.1.100 93 Configuring Arena
Steps to Add a Document Type to a Person Attribute:
1) Go to Administration/Person Attributes.
2) Click the Add New Attribute button.
3) Select the Display Location.
4) Click Update.
5) Select the Attributes for the new Person Attributes.
6) Click Add.
7) Select Group.
8) Enter a Name for this attribute.
9) Select a Document Type.
10) Select Qualifier. This drop-down will list all Document Types marked to Show on the Person
Details page.
• Visible – Check this box for the uploaded documents to be visible.
• Read Only – Check this box for the attribute to be ready only.
• Required – Check this box if users are required to upload a document, when editing this
attribute.
• Enable History – Check this box to enable history for Arena to track when the attribute is
changed.
• Number of Previous Values – If you Enable History, enter the number of previous values to
track.
11) Make additional selections.
12) Click Update.
Arena Select 2014.1.100 94 Configuring Arena
Email Configuration
Use this page for general email configuration or optionally on the Organization Settings page. It is
generally advised to consider the volume of emails being by members of your staff and adjust
email batch size and pause duration as needed.
• SMTP – Enter the email server for your organization (e.g., Microsoft Exchange or Gmail).
• Port – The default port is 25. If you are sending over SSL, this value probably will need to be
changed.
• Timeout – Enter the time (in milliseconds) before the SMTP server is to be unresponsive. If
blank, the default is 20,000.
• Use SSL – Specify if using Secure Sockets Layer.
• SSL Log Path – Enter the path to the log file for SSL logging. If left blank, SSL logging will be off.
• Email Batch Size – The number of emails that to send at one time during batch processing.
• Pause Duration – Enter the number (in milliseconds) to pause between email batches.
• Username – Enter the Email server username.
• Password – Enter the Email server password.
• Email Log Path – Enter the path to the log file for email logging. If left blank, logging
will be off. If the “EmailLogPath” value is set in the web.config file, Arena will ignore this
value.
• Organization Email – The default email address which your organization uses to send out
messages
• Organization Email Name – The default name which your organization uses to send out
messages
• Email Header – This header is added to Classified Requests, Prayer Requests and E-Cards.
• Email Footer – This footer is added to Classified Requests, Prayer Requests and E-Cards.
Arena Select 2014.1.100 95 Configuring Arena
Exceptions
When Arena encounters an error, an Exception automatically generates. Most exceptions will
display on-screen when they occur, and Arena will send an email to the designated recipient.
However, some exceptions, like Access Restrictions, do not display.
All exceptions display on the Exceptions page in reverse date and time order. Clicking on
the Name (exception number) will open a new window with the original error and details.
When contacting Arena Support with exception issues or questions, you may need to access
this page.
Arena Select 2014.1.100 96 Configuring Arena
List Configuration
The List Configuration enables Arena Administrators to select the specific criteria and criteria
controls to make available for each Report Type in My Lists and Public Lists. Arena Administrators
can also set security for a Report Type by using module security, and add custom criteria to
My/Public Lists.
List Types
• Tables – Click this link to display all tables associated with the Report Type.
• Criteria Modules – Click this link to display the collection of criteria available in My/Public Lists.
• Attribute Controls – Click this link to display all available attributes.
List Type Details
Arena Select 2014.1.100 97 Configuring Arena
List Tables
Criteria Controls
On this page, you can enable or disable criteria groups for My Lists and Public Lists.
Arena Select 2014.1.100 98 Configuring Arena
Attribute Groups
On this page you can enable or disable attribute groups. Click the button to display specific
attribute fields.
Attribute Fields
On this page you can enable or disable attribute fields. You will need to enable the attribute
group so that attribute fields are available to users in My/Public Lists.
Arena Select 2014.1.100 99 Configuring Arena
Steps to Enable or Disable My/Public List Criteria:
Arena honors security for any available fields.
1) Go to Administration/ List Configuration.
2) Select Criteria Controls for a List Type, as desired.
3) Click Controls for the List type you wish to modify.
4) Select the appropriate checkbox of the criteria you wish to enable or disable.
5) Click Update.
6) Refresh cache and verify.
Arena Select 2014.1.100 100 Configuring Arena
Steps to Add Existing Fields when Exporting to Excel:
The List Merge Fields define which available fields must be included in the Excel export of a list.
The default fields are for other features such as mail merge documents. You will want to leave
Person_ID checked for use with other features such as mail merge.
1) Go to Administration/List Configuration.
2) Click Tables for the List Type to modify.
3) Click Fields of the table to which you would like to select criteria.
4) Select the Required checkbox of the fields to include when users export to Excel.
Required fields are included with every Excel export.
5) Click Update.
Arena Select 2014.1.100 101 Configuring Arena
Steps to Include Null value for Attribute Dates:
1) Go to Administration/List Configuration.
2) Select Criteria Controls for the Report Type you want to modify.
3) Select Controls for the Criteria Group you want to modify.
4) Select the Edit button of the Module you want to change.
5) Select Include Null Checkbox. This option is not available to all criteria.
6) Click Save.
Arena Select 2014.1.100 102 Configuring Arena
Steps to Change the Setting to Pull Active or Inactive Lookup Values:
1) Go to Administration/List Configuration.
2) Click Criteria Controls for a specific Report Type.
3) Click Controls link that uses Lookup values (e.g., Member Status).
4) Click the Edit button of the Module you want to change.
5) Select the Active Lookup Only checkbox.
6) Click Save.
Arena Select 2014.1.100 103 Configuring Arena
Steps to Add Groups Scoping
1) Go to List Configuration.
2) Select Tables for the Person Report Type.
3) Select the smpg_v_group_member_role table.
4) Verify the Table Prefix is GMR and Join String is for GMR.
5) Click Save.
6) Click Cancel on the Table List page.
7) Select Criteria Controls for the Person Report Type.
Arena Select 2014.1.100 104 Configuring Arena
8) Select Controls for the Small Group Criteria.
9) Select Edit for the Small Group List module.
10) Verify Person_id is the Related Field, Scope Results to Select Groups is selected, and Enabled.
11) Click Save.
12) Click Edit for the Role Name.
Arena Select 2014.1.100 105 Configuring Arena
13) Verify module settings.
14) Click Save.
Arena Select 2014.1.100 106 Configuring Arena
Steps to Add a Custom Person Attribute to Public/My Lists:
1) Create custom Person Attributes.
2) Go to Administration/List Configuration.
3) Select Attribute Controls for the List Type you want to add attributes.
4) Click the attribute edit icon.
5) Check the enabled box for each attribute you want to add to list criteria.
6) Click Update.
7) Check enable for the attribute group.
8) Click Update.
9) Verify.
Arena Select 2014.1.100 107 Configuring Arena
Lists
Lists in Administration functions the same as Lists in Membership, with the exception of ability to
select criteria you may secure for other users, or modified through List Configuration.
List Sorting Options
While a powerful tool, Lists, My Lists and Public Lists in Arena can become cluttered and difficult to
navigate as users create and use lists. Arena has two functions that help to keep lists neatly
organized and easily accessible: List Categories and Public/Private Lists.
List Categories
When creating a new list or by editing an existing list, the user can assign a specific category
value to the list. Users can use List Categories to sort and filter existing lists, making it much
easier to manage a large number of lists. You can create values for the Report Category drop-
down in the List Categories Lookup.
List Category Drop-down
The Report Category will display on the first page of the List Wizard for Lists, My Lists and Public
Lists, as shown below.
List Categories
Arena Select 2014.1.100 108 Configuring Arena
Steps to Enable Both Basic and Advanced of List Types:
1) Go Administration/Pages/Home/Membership/Public Lists.
2) Select the Main Content tab.
3) Select the Report List module.
4) Select the Build List Option, as desired. This module setting allows users the ability to
select an Advanced Build option using ‘OR’ logic instead of the default ‘AND’ logic. We
recommend adding this module to a new page.
List Report Module
This module enables you to limit access by Report Type. You can also add this module to a
new page, enabling you to broaden limited access by Report Type.
5) Click Update.
6) Set security for this module.
Module Security
Arena Select 2014.1.100 109 Configuring Arena
Organization
An Organization is the Organization Entity itself. This page displays the settings for the
Arena application such as SMTP Server information, Report Services URL, and various user
names. These settings work in tandem with settings in the web.config file, located within
the Arena installation folder on the Web Server, to make Arena function properly. Many of
the values are set during the installation process. New Arena installs will not require you to
require new Keys.
Steps to Update Organization Details:
1) Go to Administration/Organizations.
2) Select the <Organization>.
3) Click Edit.
The Code, which is not editable, is the license number.
4) Update fields.
Name – Update the organization name, as desired.
Leader – Click Change… to search, select and add the leader.
Address – Update the address of the main location for the organization, as desired.
URL – Update the URL for the organization, as desired.
Notes – Enter notes for this organization.
Arena Select 2014.1.100 110 Configuring Arena
Organization Settings
To view the settings and their values, click the <Organization Name>. Click the
appropriate Organization Name link to view its details.
Setting – This is the name of the Key, such as “SMTP Server”
Description – This is the description of the Key, such as “Mail server name”
Category – This option allows for grouping of the various Keys. The various
Categories are setup as a Lookup.
Value – This is the actual Key setting, such as “Mailserver” or True/False.
Arena Select 2014.1.100 111 Configuring Arena
Setting Name Category Description
1st Day Of Week Score Organization Score for automatically entering a user into a Small Group based on search criteria. If the user’s first day choice matches, this score is added to the running total.
2nd Day Of Week
Score Organization
Score for automatically entering a user into a Small Group based on search criteria. If the user's second day choice matches, this score is added to the running total.
Active Meter Chart Duration
Organization The duration (in years) to populate the active meter history chart on the person details page.
AD Domain Organization The name of the Active Directory domain.
AD Server Organization The name of the Active Directory server.
Area Score Organization Score for automatically entering a user into a Small Group based on search criteria. If the user lives in the same area as the small group, this score is added to the running total.
Arena Hub Repository The Arena Hub URL.
Arena Notification Role
Organization Name of Arena role that should be shown notification such as a new update being available from the Community. Set to blank if no one should ever be shown update notifications.
Available Slots Score Organization Score for automatically entering a user into a Small Group based on search criteria. If there are available slots still open in the small group, this score is added to the running total.
Bulletin Days Organization Delimited days that the bulletin is created. 0 = Sunday, 1 = Monday, etc.
Bulletin Options Organization Delimited options for the bulletin.
Check-In Access Roles
Enter the Security Role IDs who can access Check-In URL.
Check-In Allow Overlapping Checkin
Organization If this is set to true, then people are allowed to check in to multiple events at one time.
Check-In Include Inactive People
Organization Determines whether or not to display inactive family members in Check-In.
Check-In Print From Server
Check-In Url Organization Check-In root URL.
Classified Approval Page
Organization Link to the classified email to the classifiedEmail person to the approval page.
Close Age Range Score
Organization
Score for automatically entering a user into a Small Group based on search criteria. If the user's age is close to the age range of the small group, this score is added to the running total. “Close” is defined by the lookup qualifiers.
Computer System Image Path
Organization The path to the computer system images.
Contribution Sub Donor Title
Organization Specify the title you wish to use for Sub Donor fields throughout the program
Critical Profile Days Tags The number of days that a prospective volunteer has not been contacted to show a red flag.
Default Max Members Organization The default number of members in a small group.
Delete Merged Organization True/False value to delete original record(s).
Distance Score 0 to 1 Mile
Organization Score for automatically entering a user into a Small Group based on search criteria. If the user lives 1 mile or less away from the small group leader, this score is added to the running total.
Distance Score 1 to 2 Mile
Organization Score to assign to the prospective group member if the entered address is up 1 and no more than 2 miles from a Group location.
Distance Score 2 to 3 Mile
Organization Score to assign to the prospective group member if the entered address is more than 2 miles and up to 3 miles from a Group location.
Distance Score 3 to 4 Mile
Organization Score to assign to the prospective group member if the entered address is more than 3 miles and up to 4 miles from a Group location.
Distance Score 4 Plus Miles
Organization Score to assign to the prospective group member if the entered address is more than 4 miles from a Group location.
Email Batch Size Email Settings The batch size for email throttling.
Email Log Path Organization Path to the log file for email exceptions.
Email Pause Email Settings The time (in milliseconds) to pause between batches of bulk email.
Enable Group Updates
Small Groups If true, some public modules will allow the user to select the option to post an update to their group wall. If false, this option will note be available.
Event Profile Title Tags
Exact Age Range Organization Score for automatically entering a user into a Small Group based on
Arena Select 2014.1.100 112 Configuring Arena
Score search criteria. If the user's age is in the age range of the small group, this score is added to the running total.
Exception Recipient Exception Processing
Email address of the person that should receive exceptions, if SendExceptions settings is 'true'.
Exception User Agent Ignore
Exception Processing
Semicolon list of agents to ignore when an exception occurs.
Generic Female Image
Guid Organization GUID for the generic female image.
Generic Male Image Guid
Organization GUID for the generic male image.
Geo Coding Service Address
Geocoding Set to “StrikeIron” or “yahoo”, as desired.
Giving Batch Name Organization The name of the batch in which all online giving will be assigned.
Includes Online Giving and Missions.
Grade Promotion Date Organization The default email for the group locator. If the administrator’s email is empty this email will be used instead.
Group Locator Email Email Settings The default email for the group locator. If the administrator’s email is empty this email will be used instead.
Mail Room Server Address
Standardization
The server name that ShelbyMAILROOM is installed on. If the
Mailroom Server is specified, it replaces StrikeIron for Address Standardization and potentially increases the amount of time for normal CASS certification.
Marital Preference Score
Organization Score for automatically entering a user into a Small Group based on their search criteria. If the user's marital preference matches the group marital preference, this score is added to the running total.
Merge Request Recipient
Email Settings The email address of the person to receive merge record requests.
Minimum Group Match Score Group
Organization The minimum score that a person registering for a small group must meet before being Organization automatically registered in that group.
Ministry Profile Title Tags The title to use for Ministry Tags.
Organization Email Organization The email address that will be used to send emails from.
Organization Email Footer
Organization The default footer for all outgoing system email messages.
Organization Email Header
Organization The default header for all outgoing system email messages.
Organization Email Name
Organization The name that will be on emails sent from Arena.
Organization Email Name
Organization The name that will be on emails sent from Arena.
Organization Nick Name
Organization This is the nickname for the organization.
Personal Profile Title Tags The title to use for Personal tags.
Phone Expression Organization
Phone Expression Error
Organization
Prayer Request Days Active
Prayer The number of days before a prayer request expires.
Prayer Request
Renewals Prayer Enter the number of times a prayer request can be renewed.
Process Library URL Organization The URL for the processes on a CPU in computer management.
Profile Title Tags The title to use for tags.
Progress Horizontal Position
Organization
Horizontal Position to display the loading section when asynchronous loading occurs. Center, Right and Left are acceptable values.
Progress Text
Organization
Text to display when asynchronous loading occurs. Leave blank to just display an image defined in the CSS.
Progress Vertical Position
Organization
Vertical Position to display the loading section when asynchronous loading occurs. Top, Bottom or Middle are acceptable values.
Rejected Transaction Email
Agent Processing
List of emails for the Rejected Transaction Report to be sent. Separated by (;) e.g. [email protected];[email protected].
Report Server Root Report Settings The root folder of Reporting services.
Arena Select 2014.1.100 113 Configuring Arena
Report Server URL Report
Settings Location of the reporting services server.
Security Lock Account Duration Minutes
Security Settings
How many minutes the user's account will be locked if the [SecurityLockAccountThresholdCount] is reached.
Security Lock Account Threshold Count
Security Settings
The user's account will be locked after this many unsuccessful login attempts within [SecurityLockAccountThresholdMinutes] minutes. Set to 0 to disable the locking feature.
Security Lock Account Threshold Minutes
Security Settings
The user's account will be locked after [SecurityLockAccountThresholdCount] unsuccessful login attempts within
this many minutes.
Security Password Strength Description
Security Settings
Description of password strength requirement defined in [SecurityPasswordStrengthRegex]. e.g., 'Password must be between 5 and 30 characters long and must contain at least one digit'.
Security Password Strength Regex
Security Settings
Regular expression that defines how strong passwords must be. Leave blank for default (5-30 characters and at least one digit).
Send ALERT
Exception Processing
Boolean to tell the system if the exceptions should be sent automatically to Arena via the A.L.E.R.T. tool.
Send Exception
Exception Processing
Boolean to tell the system if the exceptions should be sent automatically to the ExceptionRecipient in the web.config file.
Serving Profile Title Tags The title to use for Serving tags.
Small Group Title Small Groups Enter the name that you want to replace “Small Group” with.
SMS Via Email Enabled
Organization
Set to true to send SMS messages via email by using the cellular provider set in person details per phone number. (NOTE: The email formats per provider are set in the "SMS Email Gateway Formats" lookup type)
SMTP From Domain Email Settings The domain that all emails sent through Arena will be sent from.
SMTP Password Email Settings The password for the mail server Arena will use to send emails.
SMTP Server Email Settings The mail server that Arena will send emails from.
SMTP Username Email Settings The username for the mail server Arena will use to send emails.
StrikeIron Key
Address Standardization
Username to use for the StrikeIron web service for address standardization.
StrikeIron Password Address
Standardicationn
Password to use for the StrikeIron web service for address standardization.
Use Group Areas
Organization
Flag indicating if areas are being used. Set to True to display area information on various modules.
Use Group Type
Organization
Determines which values display in Add Registrations and the Small Group Locator for the Type field. If this setting is false, the types will
be determined by the values in the smgp_cluster_type table. If this setting is true, types are determined by the Lookup Values for the Small Group Types lookup. Those are set in the Groups in Group Details.
UseShelbyV5Contributions
Organization Flag to set if Arena should use v5 as the contribution processor.
Warning Profile Days
Tags The number of days that a prospective volunteer has not the tag status on the individual tag member and places the individual in a warning status.
XML Report Path Organization Absolute path to the xml reports definition.
Yahoo App ID
None
Use this setting to use Yahoo for geocoding. Sign up for a yahoo App ID at http://developer.yahoo.com/wsreapp
Zip Code Score Small Groups
Score for automatically entering a user into a Small Group based on search criteria. If the user's zip code matches the group's zip code, this score is added to the running total.
Arena Select 2014.1.100 114 Configuring Arena
Steps to Add an Organization Setting:
1) On the Organization Settings page, click the Add New Organization Setting button.
2) Complete all fields.
3) Click Update.
Arena Select 2014.1.100 115 Configuring Arena
Payment Gateways
Payment Gateways provide a secure environment for credit card and Automated Clearing House
(ACH) transactions between Arena and a merchant that authorizes the payment. At install, there
are no payment gateways. If accepting both credit and ACH payment options, your organization
will want two merchant accounts, one for each payment method. Once you obtain your provider
account information, you are ready to add them to this page.
A payment gateway is required for online giving, event and mission registration. Arena will parse
the payment information between contributions and events, regardless of payment gateway.
The below payment gateway providers integrate with Arena. As you evaluate providers be sure to
review the implications in respect to PCI compliance and your Arena-managed website. Some
providers require a redirect from your Arena-managed website to the third party processor for
processing. Additionally, some providers deduct fees at the time of processing. Refer to the Shelby
Community for information regarding the different providers.
• Payment Data Systems (PDS)
• PayPal™ Payflow Pro/PayPal™ Express PayFlowPro integration requires a licensed, local
installation of Arena and that the merchant meet the PCI compliance standards to handle
cardholder information on premise.
• CashLINQ
• TransNational Bankcard is an integrated payment gateway provider for Arena Self-Hosted
environments.
Payment Data Systems (PDS) and CashLINQ (Ministry LINQ) are integrated payment gateways for
Arena Hosted environments and uses a redirect to their PCI compliant site where cardholder
information is captured/maintained, meeting the PCI compliance requirements. You will need to
provide the IP address of your webserver and the return redirect URL. The IP address will be either
your web server or the router facing the internet. The return redirect URL will be the public URL
designated for portal 2 (e.g., Arena Web) with the payment.aspx tagged at the end of the domain
(e.g., http://myarenawebsite.com/payment.aspx. If your site has a SSL certificate, you might
consider setting the redirect to https instead of http to encrypt the traffic. From a technical
perspective, Arena passes XML data via web services to the payment gateway provider and then
the payment gateway providers passes XML data back to the Arena site. The payment confirmation
page exists to save the data to the Arena database once the information is passed back to Arena.
Arena Select 2014.1.100 116 Configuring Arena
Steps to Add a Payment Gateway:
1) Click the Add. You can add more than once Gateway account, for example one for credit
card and one for ACH. Once a Gateway exists, click the Add New Gateway Account
button to add more.
• Title – Enter a name for this gateway account. If your organization is going to accept both
credit card and ACH, you will create a separate account for each payment method.
• Payment Processor – Select a provider from the drop-down.
• Process – Select either Credit Card or ACH. ACH is automatic bank drafts where member
provides checking or savings account information. If you have both a credit card and ACH for
a provider, create two payment gateways, one for each payment method.
• Merchant Account – Enter the number provided to you by the provider.
• Sub-Merchant Account – Enter the number provided to you by the provider. This is not used
for all providers.
• User Name – Enter the user name for the provider account. Check with your provider.
• Password – Enter the password for the provider account. Check with your provider.
• Gateway URL – Enter the secure URL provided to you by the provider. In the above example,
this is the one for PDS.
• Log File –This is option to enable logging. You will enter a ‘.txt’ file path to the web
server where you want to store the logging data. (e.g., C:\Program File
(x86)\ArenaChMS\Arena\PDSlog.txt).
• Process Time – Enter the time the provider will batch process payments.
2) Click Update. All fields display on the Gateway List except Sub Account, Password, and
Log File.
3) If using a provider that uses redirects from Arena to the payment gateway, you will need
to provide the IP address of your webserver and the return redirect URL. The IP address
will be either your web server or the router facing the internet. The return redirect URL
will be the public URL designated for portal 2 (i.e., Arena Web) with the payment.aspx
tagged at the end of the domain (e.g., http://myarenawebsite.com/payment.aspx. If your
site has a SSL certificate, you might consider setting the redirect to https instead of http
to encrypt the traffic. From a technical perspective, Arena passes XML data via web
services to the payment gateway provider and then the payment gateway providers
passes XML data back to the Arena site. The payment confirmation page exists to save
the data to the Arena database once the information is passed back to Arena.
Arena Select 2014.1.100 117 Configuring Arena
Refresh Cache
When administrators make changes to an Arena portal, such as adding pages, changing control
settings and setting security, you may need to update the cache in order for the changes to take
effect. You can also add “&refreshcache=true” to the full page address. In some rare instances,
you may need to reopen the browser for the changes to take effect. In some instances, you may
also need to delete the browser’s cache and/or reset IIS.
Arena Select 2014.1.100 118 Configuring Arena
Report Registration
Report Registration connects a report from Reporting Services to specific List types. Before a report
can be registered for use in Lists, it has to be created and in use by Reporting Services. To view
current registered reports, click on Reports in the appropriate section of Arena, or navigate to
http://<reportservername>/Reports.
Click on Report Registration to display a list of Reports currently registered within Arena for use
with Lists. This list shows the Report Name, the Path, the Definition File name, and a delete
button. For installations, there are no reports registered. Not all reports will work with lists.
Steps to Add a New Registered Report:
1) Click Add.
• Name – This drop-down list is all the reports that exist in Report Services.
• Path – This identifies the file path of the report.
• Definition File – This is the type of List
2) Select an existing Report from the Name drop-down.
3) Select a Definition File from the drop-down.
4) Click Update.
5) Set security on the Report Popup module on the Report Popup page.
6) Now the report is available to merge with a List.
Arena Select 2014.1.100 119 Configuring Arena
Small Group Structure
Small Group Structure determines the structure of Small Groups such as the number of levels a
tree has between the highest level and the small groups. The number of Cluster Levels for each
Cluster Type governs the depth of a group tree, the names of cluster level -tab captions for the
Group Details, and separate group trees for viewing on different pages in Arena. A collection of
cluster types and cluster levels make up a Category. You will need to create at least one Cluster
Type before users can create a Group Tree. The Category ID and Cluster Types are necessary for
several module settings, which can specify which groups to display on a given page.
By default, the two categories are Small Group (for Groups Trees) and Team (for Sports), as shown
below.
• ID – This is the ID value for the Category that Arena automatically assigns.
• Category Name – This is the name of the category.
• Cluster Types – This number represents the number of cluster types within the category.
• Groups – This number represents the number of Small Groups.
• Cluster Types – Click this link to display all the Cluster Types in this category.
Arena Select 2014.1.100 120 Configuring Arena
Steps to Edit a Small Group Category:
1) Click the Category edit icon to display the Category details.
2) Customize fields, as needed.
Arena Select 2014.1.100 121 Configuring Arena
• Name – This is the name of the Category and the tab name for the Small Group level for
all Cluster Types in this category. Arena will automatically make this word plural.
• Group Page ID – Click the ellipsis icon to select the group details page.
• Cluster Page ID – Click the ellipsis icon to select the cluster details page.
• Default Role – Use the drop-down to select the default member role assigned to people
when users add people directly to any group in this Category.
• Use Uniform Number – Select this box to use uniform numbers for group members
within this Category such as for Sport groups.
• Use Area – Select this box to include an Area field to set the Area of a Group.
• Allow Bulk Updates – Select this box to allow users to Bulk Update from a Groups page.
• Private History – Select this box if the desire is not display group information in the
History section of the Person Details page. If you select this box, the group history will
display on the group leader’s history information.
• Credit as Small Group – Select this box if all groups in this category should display in Map
Area Statistics.
• Valid Roles – Select the valid roles for all groups in this category, determined by the
Small Group Roles Lookup.
• Captions – Set the caption text to display for the fields used in Group Details. These fields
are determined by correlating Lookups. If you enter no caption, the field will not display in
Group Details for this Category.
3) Click Update.
4) Once you set up the Category, click Cluster Types to create or edit Cluster Types for this
Category.
Arena Select 2014.1.100 122 Configuring Arena
Steps to Create a Cluster Type:
1) Click the Add New Cluster Type button to add a new cluster type.
• ID – This is the Arena assigned Cluster Type ID.
• Name – This is the name of the Cluster Type.
• Allow Occurrences – If checked, attendance is available for the groups in the cluster type.
• Allow Registrations – If checked, people can register for the groups in the cluster type.
• Region Name Lvl – This is the level used with regions.
• Unassigned Registration Lvl – This is the group level where Arena will place unassigned
group registrants.
• Total Groups – The total number of groups using this cluster type.
• Total Levels – This is the total number of levels for this cluster type
• Total Clusters – This is the total number of clusters for this cluster type.
2) Complete as fields, as desired.
• Cluster Type ID- This is the ID number Arena automatically assigns for the cluster type.
• Name – Enter the name for cluster type.
• Region Name Level –Arena assigns a region level. You can modify, as needed.
• Unassigned Registration Level – Enter the (cluster) level for unassigned registrants when
users enter them from Add Registrations page or from your Arena-managed website.
• Allow Registration – Select this box to allow registrations for this Cluster Type.
• Allow Occurrences – Select this box to enable taking attendance.
• Relationships – Set the relationship scale for this cluster type, as desired. Refer to Peer
Network in this manual for set up information.
3) Click Update.
Arena Select 2014.1.100 123 Configuring Arena
Steps to Create Cluster Levels:
When creating cluster levels, keep in mind the number of levels determines the depth of the Group
Tree.
1) Click the Cluster Levels link of the Cluster Type you would like to add Cluster Level.
2) Click the Add Cluster Level link. You will need to add levels in order, starting with Level
“0.” The more levels you add to a Cluster Type, the more levels a Group Tree will contain,
before displaying the small group. Because of this, it is a good idea to have a layout in mind
for small groups before creating cluster types and levels.
3) Complete all fields.
• Name – Enter the name of the Cluster level.
• Level – This is the pre-determined cluster level.
• Allow Groups – Select this option to allow Groups. Only the last (bottom) cluster
level should allow Groups.
• Allow Area – Select this option to allow Areas for Group Clusters, typically the last level.
This is typically set at the last cluster level, where the Groups exist.
• Notify Leader – Select this option for Group Leaders to receive an email when someone
registers for the group.
• Notify Admin – Select this option if for Group Admins to receive an email when someone
registers for the group.
4) Click Update.
5) Repeat steps 2 through 4 until 8 you create the desired number of cluster levels.
6) Once complete, you are ready to create Groups. Refer to Groups in the Arena User
Manual.
Arena Select 2014.1.100 124 Configuring Arena
Steps to delete Cluster Levels:
1) Before you can delete a cluster level, you will first need to delete all groups associated with the
cluster level.
The cluster type page will display this number in the Total Groups column on the cluster type
page.
2) Once you delete all Groups, the Total Groups should display “0.”
3) Now you can click the Cluster Level delete button.
4) Once you delete all Cluster Levels, you can delete the Cluster Type, if desired.
Arena Select 2014.1.100 125 Configuring Arena
SMS Text Messaging
Arena offers the ability to send SMS (Short Message Service), also know at TEXT messaging via
email. The default functionality is a one-way SMS communication and requires the carrier of each
recipient to be identified on each record.
Steps to Allow SMS via Email:
1) Set the SMS via Email Enabled Organization Setting to “True.”
2) Add, update, or deactivate the providers in the SMS Email Gateway Formats
Lookup. A list of major providers is available, by default.
3) Customize Mail Merge module settings on the SMS Communication page such as,
scheduling and thresholds. The Mail Queue Agent must be running to schedule any
Communication.
4) Update all pages where the SMS module setting is available, as desired. Below is a list of the
modules where the SMS link is available.
• Popup Person Results (single) and Popup Person Results (multi) pages
• Individual Information page
• Report Grid page
• Tag Details page
• Volunteer Administration page
• Team Members page
• Mission Details page
• List Report View module
5) If using Thresholds with Approval, add a page with the Communication Approval List
module.
6) Once everything is in place, users can initiate an SMS from the Person Detail page or from a
person list page, as shown below.
SMS from Person Detail Page
SMS from Person List Page
Arena Select 2014.1.100 126 Configuring Arena
Arena also offers the option for two-way SMS communication which requires a subscription with
StrikeIron.
Follow the below steps to enable this option:
1) Verify StrikeIron account is a Global 2.5 account.
2) Customize below Organization Settings.
• SMS Provider Password – Enter the StrikeIron password
• SMS Provider UserName – Enter the StrikeIron UserName
• SMSViaEmailEnabled – Set this to False
Arena Select 2014.1.100 127 Configuring Arena
Facilities Management
Use the Facilities Management page to add the account information for your organization’s facility
management providers. Currently, Arena integrates with MinistrEspace. Follow the below steps to
implement this feature.
1) Add your organization’s MinistrEspace account information on the Facilities Management page.
2) Start the Updated Resource Events Agent.
3) Select MinistrEspace as the Event Resource for the Event Profile Detail module on the
Event Tags page.
Arena Select 2014.1.100 128 Implementing Arena-Managed Website Features
Implementing Arena-Managed Website Features
Making Your Website Public
The first step in developing an Arena-managed website is to make sure it will be accessible to
visitors and members of your organization on the Internet. This involves registering a domain
name for your site and configuring it with your Domain Name System (DNS) server to route users
to the correct server on your network, as well as opening the correct ports in your firewall for the
site. Then you will need to configure Internet Information Services (IIS) on your server to properly
route web-traffic, and configure the Host Headers in your IIS website to route the proper domain
names to your Arena-managed website.
Finally, you will need to configure your portal in Arena to direct users to the correct pages for
your website. Your network administrator will likely complete the majority of these tasks before
your Arena administrator can configure your portal.
Network Administrator You will need to complete the following steps before you create and
configure your Arena portals:
1) Register a unique domain name with a DNS registry service and configure it to point to
the IP address of your web server.
2) Open the required ports in your firewall (typically port 80 for HTTP and/or port 443 for SSL).
3) Add a host header on your IIS website for each unique domain name that you plan to use for
Arena.
Arena Administrator
You can configure multiple Arena portals to work with the same IIS website. You must enter each
unique domain in the host headers for this site and enter the proper Default Domain values in the
portals. While the host header values uses the full domain name, including the sub-domain (e.g.
www.YourOrganizationOnline.com), only the primary domain name is used by Arena and must be
unique for each portal (e.g. YourOrganizationOnline.com).
Arena Select 2014.1.100 129 Implementing Arena-Managed Website Features
Page Structure
The page structure is how Arena defines the layout and navigation of your website and frequently
referred to as a page tree because it uses a hierarchy-type structure consisting of parent pages
with one or more child page, which can be parent pages as well.
While the scope of this section does not include the specific details of the design of your website,
you should consider specific factors designing your website. We highly advise that you create the
entire page structure for each section before adding the associated modules, as some module
settings may require the existence of other pages.
• Home – This is the internal portal for general staff use.
• Mobile – This is the mobile portal for use on browser-enabled smartphones.
• Web Pages – This the external portal for members use.
Arena Select 2014.1.100 130 Implementing Arena-Managed Website Features
Required Pages While your specific site design will be unique, there are several key required pages in order for
your Arena managed website to function properly.
Root Page The first of these is the Root page, which serves to organize all of the pages for your website. This
is a simple container page and it should contain no modules. To create this page (unlike other
pages), you will need to first create it as a child of another page and then change its parent to
“Root” in the Page Details area.
Home Page
Second is the Home page, which is the refer page in the portal details. Your Home page will also
frequently be a different template from the rest of your site to display Flash animations,
promotions, and other links to vital areas of your website. The modules on this page will vary
greatly depending on the needs of your organization. Frequently this page will include a
navigation bar to reach the rest of your site, promotion modules to display your active
promotions, and any number of Advanced HTML Text modules to display the animations and any
other static content not written into your template.
Arena Select 2014.1.100 131 Implementing Arena-Managed Website Features
Visibility
Occasionally you will find that you need to have pages in your page structure that you do not
want to be visible in the navigation bars on your website. These pages can be ‘hidden’ by un-
selecting the Display in Nav checkbox in the Page Details of each specific page. This is separate
from a security option. A user with proper security permissions can still navigate to these pages
by redirects, saved links, or other means. If they do not have the proper security permissions for
the page(s), they will be unable to access them by any means.
Arena Select 2014.1.100 132 Implementing Arena-Managed Website Features
Implementing Specific Features
Login Pages
This requires four pages; one for Login with three child pages for additional login options: New
Login Request, Request Information, and User Confirmation. When you set up a public website
there may be some areas of the site that you want to restrict to login access. These pages handle
that need as well as the option to request a login, or forgotten password etc. The forth (optional)
page is for email verification for new users.
While it is true that good data entry processes can reduce the possibility of duplicate records.
Duplicate records are unavailable and will occur regularly once you enable the User Login module
and its corresponding New Account Request module. Once enabled, users will create an account
so he or she can access additional features of your site, and many of them will probably already
have an existing record. It will be your administrative duty to find these accounts and selectively
merge them with the corresponding person record.
When customizing the external Arena website, one of the most important things to consider is
member logins. There are three solutions available. Each solution has certain trade-offs that
separate if from the others. The two primary tradeoffs are security versus ease of use. Another
aspect to moving to Arena is member access. If your organization currently uses Shelby
WebView, you will want to establish a plan to establish new logins and access to your Arena-
managed website features.
Pre-generated Logins Member-Requested Logins
HTML Email Form
Member-Created Logins
New Account Request Module
• Administrator creates logins by
automated process
• Distributed to members via email
• Logins are assigned to existing
records
• Logins share specific login format
• Members request specific login via
• Login is requested by the user
• Logins created by Administrators
• Members create their own logins
• Logins are assigned to new
records
• Logins are known only by the user
• Optional email verification
• Administrator must manage
possible duplicate records
• Option to add registered users to a
Tag
Increased Ease of Use
Increased Security
Arena Select 2014.1.100 133 Implementing Arena-Managed Website Features
Steps to Implement Pre-Generate Logins:
When the agent runs, Arena will apply the security role permissions to the records in the Tag and
email the user. If a user is an existing user, the email will include user name. If the user is new,
Arena will create one based on first name initial and last name (BJones) and create a random
password. The user will be required to reset the password at first login.
1) Start the SyncRole agent.
2) Add records to a Ministry Tag.
3) Customize a security role and add [login_information] merge field to security role message.
4) Sync the tag with the security role.
Steps to Implement Member-Requested Logins:
Using this option, the new user can
1) Add the HTML Email Form module to the New Login Request page and customize module
settings.
2) Start the SyncRole agent.
3) Customize the New User Account | Email Verification System Email, if using the email
verification option.
Steps to Implement Member-Created Logins:
Use this option to allow new users to create logins and immediately access member pages. If the
email address the new user enters already exists, the user is redirected to the Request Information
page to have login credentials sent to the existing email address. This option can create duplicates
so use the registered users Tag to identify and manage duplicates. Arena attempts to match
existing records by last name, first name, birth date and email address.
1) Create a (Ministry) Tag to which Arena will add new registered users.
2) Add the New Account Request module to the New Login Request page. This module has the
option to set default campus, member status, select default Tag status, and source ID. Set the
redirect page to the Member Homepage. This module has the option for email verification which
requires a separate page with the Verify New User Account module and applicable module
settings. The exception is if the new user enters an existing email address. In this case,
Arena displays a notification window that a login may already exist. If you use the New
Account Request module and want to sync new users with a Tag, you will need to set up a tag
synchronized to a security role with permissions to the website. Enter that tag’s profile ID to this
module to add registrants to the security role.
3) Customize a Security Role for users and add the above referenced Tag to the Security Role.
4) Customize the New User Account | Email Verification System Email, if using the email
verification option.
Arena Select 2014.1.100 134 Implementing Arena-Managed Website Features
Regardless of login option you select for your organization, the All Users security role must be
able to view your Member Login page, as all visitors count as members of the All Users security
role until they have passed through the Login page. It is also important to give view rights to the
Login page to every security role with any permissions on this page tree, as certain modules may
attempt to re-verify the identity of a user by passing their login and password to the Login page.
• The Member Login page requires the User Login module. Set the Allow Remember module
setting to true to display the “Remember Me” checkbox. Set the Create Account Page to the
page to redirect users to login. Set the Redirect page to the page to direct users to after
logging in. Set Send Account Info page to the page for users to request login credentials.
Arena Select 2014.1.100 135 Implementing Arena-Managed Website Features
• The New Login Request page requires either the HTML Email Form module or New Account
Request module.
When a current user completes the New Account Request form and the email address
matches an existing record, the below message will display to email the credentials to the
existing record.
• The Request Information page requires the Request Login Information module to allow
users to have their login information sent to their email address if they forget it.
Arena Select 2014.1.100 136 Implementing Arena-Managed Website Features
• The optional Email Verification page requires the Verify New User Account. If using this option,
you also need to set Email Verification to “True” and the New User Verification page on the
New Account Request module, and customize the New User Account | Email Verification
System Email. Be sure to include the ##VerificationURL## merge field code in the System
Email so that users can be directed to the correct page for verification. The verification URL
link is valid for five days.
Optional User Confirmation Module You can apply the User Confirmation Module to a single page so members can update the
information you specify for the individual or family members. This module has various options such
as the option to send an email notification when users make changes and the option to add
registered users to a Profile ID (Tag). The User Confirmation page requires the User
Confirmation module and allows the user to update email address, birth date, marital status,
gender, street address, home phone work phone cell phone and available attribute groups after
logging in. If you use this option, set the Redirect module setting of your User Login page to
“~/default.aspx?page=<page number>”, (where <page number> is the page ID number of your
User Confirmation page) and the Redirect module setting of this User Confirmation module to
“~/default.aspx?page=<page number>” (where <page number> is the page ID number of either
your home page or your member’s home page).
Arena Select 2014.1.100 137 Implementing Arena-Managed Website Features
Online Giving
Many of your members may wish to do their regular tithing or recurring offerings online. Prior to
working with your web pages, you will need to add all applicable Payment Gateway accounts to
Arena. Arena requires four pages—Online Giving, My Repeating Payments, My Contributions, and
My Contribution Detail. It is suggested to force SSL for online giving pages.
• Online Giving – This page is the primary interface between your members and online giving.
Arena uses a step-by-step wizard for members to confirm their personal information and add or
monitor online contributions. This page should be located in a secure section of your website
and should be visible in navigation. It uses the Repeating Payment Wizard or Online Giving
module that requires selecting the My Contributions and My Repeating Payments pages, as well
as a Cancel page to redirect when they click the Cancel button. You will also need to specify
your Payment Gateways for Credit Card and ACH. Use the Repeating Payment Wizard module to
set the one-time or repeating payment option. If using the Repeating Payment Wizard module
you will need one page with this module for repeating payments and a second page with this
module for one-time payments. Set the Admin Mode setting to false so users will see their
information. The Online Giving module allows both one-time and repeating payments from the
same page so you need only page.
Online Contact Information
Arena Select 2014.1.100 138 Implementing Arena-Managed Website Features
• My Repeating Payments – This page allows users to enter a new repeating payment or view
his or her active giving profiles. He or she can also edit or delete the repeating payment profile.
This page should be located as a child page of your Online Giving page and should be visible in
navigation. It uses the My Repeating Payments module with your Online Giving page selected
as the Repeating Payment Wizard setting and Admin mode set to False. Set the ACH Payment
Gateway and CC Payment Gateway module settings. Profile Name is used for repeating
payments and does not print on default statements.
If a contribution changes his or her email address attached to the repeating payment profile,
the contributor will need to delete the repeating payment profile and create a new one with the
new email address.
New Repeating Payment Profile
Existing Repeating Payments
Arena Select 2014.1.100 139 Implementing Arena-Managed Website Features
The optional Online Giving module provides the contributor the option to select one-time or
repeating payment from the same page. Maximum contributions amount allowed is
$2,147,483,647.00.
Arena Select 2014.1.100 140 Implementing Arena-Managed Website Features
My Contributions – This page allows users to view historical contributions given online or offline.
This page should be located as a child page of your Online Giving page and should be visible in
navigation. It requires the Contribution List module with the Contribution Detail page selected, and
Public Site set to True to display fund names. You can also use the Default Years module setting to
display contributions for a limited number of years. This module will display contributions for all
family members where Contribute Individually is NOT checked.
My Contributions
Members can use the setting to change the number of transactions. The options are to display 5,
10, 15, 20 or all contributions.
• My Contribution Detail – This page displays his or her Contribution Detail page with an in-
depth view of that specific contribution. This page should be located as a child page of your
My Contributions page and should not display in navigation. It uses the Contribution Detail
module with your external Person Details page selected and the Public Site value set to True.
My Contribution Detail
Arena Select 2014.1.100 141 Implementing Arena-Managed Website Features
Pledge Entry
This page allows members to enter online pledges with the option to create a repeating payment.
This page should be located as a child page of your Member Homepage page and should be
visible in navigation. It requires the Pledge Quick Entry module with the Payment Gateway
selected, Personal Detail Page set (to 7) and the Popup Person Search page set (to 16).
Arena Select 2014.1.100 142 Implementing Arena-Managed Website Features
Online Events
Events are an active part of your organization’s ministry. These events can be anything from VBS
to a Women’s Conference. The key to the success of these events and the resulting growth and
development of your membership is event promotion, a function easily accomplished on your
Arena-managed website through on- line promotions. To implement the default on-line
promotions and events on your website, you will need ten pages. You will want to verify the
payment gateway is setup correctly, including your security certificate and customize the Event
Calendar, Event Week and Event Details modules for the web portal.
Event Pages
• Events page – This page is your user’s primary access point to event and promotion details.
It displays a listing of your current events and allows users to navigate to the details and
registration areas for each event. This page does not require a secure login so you can place it
directly under your Home page and should be visible in navigation. This page requires the
Event Week View module with your Event Details page selected. This module includes optional
settings to filter by Campus, customize the number of days to show, filter by Topic Area
Lookup and an optional Lookup filter. If the goal is to have multiple calendars, you can add
another page, changing the Topic Areas.
• Monthly Calendar page – This page displays all of the active and approved events in the
current month in a calendar format, allowing users to click on those event titles to view the
details of each event promotion. Users can also use this page to browse through other month’s
events. You should add this page as a child page of your Events page. You can choose to
display this page in navigation if you wish to allow users to browse to it or you can hide it in
navigation and use a hard-coded link or a redirect module to access it. This page requires the
Event Calendar module and the Event Details page selected. This module includes optional
settings such using a different CSS, filtering by specific ministries (Topic Area Lookup), to
display times or not, and to make Topic Area visible or not. If limiting by Topic Area, enter the
Topic Area ID numbers in the Topic Areas field in comma-delimited format.
• Promotion Details page – This page should be a child page of your Events page and should
be set to not display in navigation. This page requires the Promotion Detail Display module and
has no required settings. When a user selects a promotion that does not tie to an event tag,
the details of that promotion will display on the Promotion Details page. Its largest difference
from the Event Details page is that a user cannot register for non-event-promotions, as they
can for event promotions.
• Event Details page – If a user selects a promotion tied to a specific event tag from any
promotion this page will display with the details of the event promotion as well as the option
to register for the event or add it to their Outlook calendar. Just like the Promotion Details
page, this page should be a child page of your Events page and should be set to not display in
navigation. This page requires the Event Details module with the Event Registration Page 1.
The User Confirmation page normally listed as an option in the Login section above.
Arena Select 2014.1.100 143 Implementing Arena-Managed Website Features
• Event Registration Pages – The default five Event Registration Pages are forms that a user
will need to fill out when they register for an event online. They are very similar in their setup
and should all be located as child pages of your Event Details page and set to not display in
navigation. Each module will be located on the page of the same name (e.g. the Event
Registrations – Page 1 module will be located on the Event Registrations Page 1 page). For
events not using a login in page, you have the option to use anonymous registration, where
first and last name are required.
Event Registration Page 1 – This module requires you to select a Login page, Event
Registration Page 2, and Event Registration Page 3.
Event Registration Page 2 – This module requires you to select an Event Registration
Page 1 and an Event Registration Page 3.
Event Registration Page 3 – This module requires you to select an Event Registration Page
1, Event Registration Page 2, and Event Registration Page 4. To remove the Family Member
option, remove text from the Family Member Description module setting on this default page
and module.
Event Registration Page 4 – This module requires you to select your Event Registration
Page 1, Event Registration Page 3, Event Registration Page 5, and a default Member Status
value for members who add themselves to your database from Event Registration.
Optionally you can also select the Credit Card Verification Explanation page below as the
CIN page.
Event Registration Page 5 – This module only requires you to select an Event Registration
Page
• Credit Card Verification Explanation page – When a registrant pays any registration fees
using a credit card, they will need to enter the Card Identification Number (or CIN) printed on
the back of their card. The specific location of this value and its purpose can be confusing to
some users, so you can use this page to clarify any questions they might have about their
CIN. This page should be a child page of your Event Details page and should be set to not
display in navigation. This page requires the Advanced HTML Text module. You will need to
set this up with your own information. We suggest including an image showing the specific
area of the back of a credit card, as commonly seen on online shopping sites.
Arena Select 2014.1.100 144 Implementing Arena-Managed Website Features
Online Event Calendar The Arena event calendar displays all active Events. In order for an event to display you will
need to make sure of following:
• The start date of the event is a future date.
• The Public Calendar Details tab has the visibility set to “Public” and it is “Approved.”
• The start and end dates on the Event Tag Registration Tab must be in the current timeframe.
• Each event will need a future occurrence such as the first date of the event. If the event
is over multiple days, create an occurrence for each day in order to display the event on
the calendar.
Arena Select 2014.1.100 145 Implementing Arena-Managed Website Features
Registration for a Traditional Event w/ Registration Fee
When a user selects an event, additional details display along with the option to register.
Steps may vary for a traditional event, a RSVP Event and an Event with Sub-Events and
events that include a registration fee.
Step 1: Description and Instructions from the Event Tag displays.
Arena Select 2014.1.100 146 Implementing Arena-Managed Website Features
Step 2: Registrant selects the total number of people to register. The Allow Multiple option
determines the maximum registrants per registration.
Step 3: The registrant completes all required fields. Set required fields in Event Tag details. For
events using the Family Member option, Arena initially auto-fills fields for the person logged in. If
the person logged selects a family member, all fields are automatically auto-filled or re-auto-
filled with the selected person's data, with First, Nick and Last names greyed out. Also note when
someone registers for an event using the default registration field such as birthdate and email
address, Arena updates this data on the existing record.
Arena Select 2014.1.100 147 Implementing Arena-Managed Website Features
Step 4: Registrant selects a payment option, enters an email address where to send the
registration confirmation, and the option to post on the Group wall (optional). If payment
options include any non-full payment, registrants can make additional payments on the “My
Registrations” module.
Step 5: The registrant enters payment information. This step will vary based on payment gateway
provider.
Arena Select 2014.1.100 148 Implementing Arena-Managed Website Features
Registration for RSVP Event with No Fees
A RSVP event allows one person to complete a registration form for an event and if available,
register others without having to complete a registration form for each additional registrant. This
option allows you to obtain a head count for an event without adding additional records.
Step 1: Event description and instructions display.
Arena Select 2014.1.100 149 Implementing Arena-Managed Website Features
Step 2: Registrant will select the total number of people to register. The Allow Multiple
Registration option determines the maximum registrants per registration.
Step 3: The registrant will complete all required fields. Set required fields in Event Tag details.
Arena Select 2014.1.100 150 Implementing Arena-Managed Website Features
Step 4: The Registrant will review the registration summary and total number of registrants.
Step 5: The Confirmation displays for the individual and total registrants.
Arena Select 2014.1.100 151 Implementing Arena-Managed Website Features
Registration for a RSVP Event
The Event Summary displays on the Get More Info page. Registrants click the Register for this
Event link to begin registration.
Step 1: the Description and Instructions display for this event.
Step 2: Registrant selects how many people to register.
Arena Select 2014.1.100 152 Implementing Arena-Managed Website Features
Step 3: Registrant selects if the registrant is a family member or not and complete all
required and optional fields.
Step 4: Registration Summary page confirms the registrant and the total number of people
registered.
Step 5: Confirms the registration.
Arena Select 2014.1.100 153 Implementing Arena-Managed Website Features
Event with Sub-Events and Registration Fees
Step 1: Event description and instructions display.
Arena Select 2014.1.100 154 Implementing Arena-Managed Website Features
Step 2: Registrant will select number of registrants and any sub-events to which they want to
register.
Arena Select 2014.1.100 155 Implementing Arena-Managed Website Features
Step 2: Registrant will complete all required fields. Set required fields in Event Tag details.
Arena Select 2014.1.100 156 Implementing Arena-Managed Website Features
Step 4: Registrant selects a payment option, enter the email address where to send
the registration confirmation, and the box to post on the Groups Social page
(optional).
Arena Select 2014.1.100 157 Implementing Arena-Managed Website Features
Step 5: Registrant will complete all required fields. Set required fields in Event Tag details.
Arena Select 2014.1.100 158 Implementing Arena-Managed Website Features
Small Group Locator
Arena’s Small Group Locator allows registration for groups from the external Arena-managed
website. Prospective Registrants can limit the search by using the customizable lookups and
proximity from a specific address. Once the registrant has selected search filters, the group(s)
matching the criteria will display. The registrant can then select a group from the list and
complete the on-line form. Once the form is complete, Arena will send an email as specified in the
Cluster Type, at which point the leader will need to add the registrant to the group.
• Small Group Locator page – Limits the search to a specified Group ID and Cluster Type. This
page requires the Small Group module set to a specified Group ID and Cluster Type. You will
want to customize all module settings. You can optionally add a new page with the same
module, changing to a different Group ID and Cluster Type. You can also create a specific page
with an Advanced HTML Text module containing a “Thank you for your submission” message. If
your organization plans to use the Group Locator function, the Small Group Locator module
enables you to set an email address, if the group leader does not have a valid email address.
This module will also enable you to choose whether the Cluster Leader should also receive an
email.
Group Locator Search
Arena Select 2014.1.100 159 Implementing Arena-Managed Website Features
Available Groups and Registrant page
Groups display in order based the matched criteria and Group ID. You can customize the following
Organization Settings that calculate the ‘best fit’ match:
• 1st Day of Week Score
• 2nd Day of Week Score
• Area Score
• Available Slot Score
• Close Age Range Score
• Distance Score X to Y Mile
• Exact Age Range Score
• Marital Preference Score
• Minimum Group Match Score
• Zip Code Score
Arena Select 2014.1.100 160 Implementing Arena-Managed Website Features
Online Small Group Leader Toolbox
The Small Group Leader Toolbox is a powerful tool available on your Arena-managed website.
Group leaders with, “allowedit” (Group Role Lookup) has access to the group from the external
portal. They can use it to send emails to the members of their groups, add new members to the
group, and process registrants. Arena’s Small Group Leader Toolbox has ten primary components
and four optional components.
• Group Leader Toolbox page – This page displays the details of the group or groups the user
is a leader of, and allows the user to select a specific group. This page should be located in a
secure area of your website, and should be visible in navigation (or linked to by a hardcoded
link). This page requires the Group List module with Public Site set to true, the proper Category
ID specified, and your View Small Groups page selected as your Group Detail Page setting. With
the Public Site set to True, the tree view does not display.
• Add Member Request page – This page is for when the leader does not have permissions to
add members directly to the group. Instead, the Add Member Request page is a form the leader
will complete, and Arena sends an email to a designated email address (either a staff member
or a volunteer) who will then manually add the member to that leader’s group. This page should
be located as a child of your Group Leader Toolbox page, and should be visible in navigation, if
using this method. This page requires the HTML Email Form module with the From and
Recipient email addresses selected, the Instructions to be displayed at the top of the email
entered, the email’s Subject line entered, and the HTML formatted form entered in the Details
area of the module settings.
• View Small Groups page - Once a user selects a small group on the Group Leader Toolbox
page, Arena directs them to the View Small Groups page where they can view and administer
all of the details of the group. This page should be a child page of your Group Leader Toolbox
page should not display in navigation and requires a specific group ID. Some settings are
required, while others are optional. This page requires the Small Group Details module with
Person Details page set and the Public Site set to True; the Pending Registrations module with
the Registration Details page set and the Public Site set True; and the Small Group Tab module
with the Area Details, Default Occurrence Type ID, Occurrence Details page, your Registration
Details page set, and the Public Site set to True. You will want to review and customize the
Small Group Tab Control module settings.
• Registration Details page – This page displays a registrant’s selection(s) and the leader can
assign him or her to the group. This page should be a child page of your View Small Groups
page and should be set to not display in navigation, as it requires a registration ID be passed to
it. This page requires the Registration Details module with your View Small Groups page
selected as the Cluster page and the Area Details page selected.
Arena Select 2014.1.100 161 Implementing Arena-Managed Website Features
• Person Details page – This page displays Person Detail page of a group member. This page
should be a child page of your View Small Groups page and should not display navigation. This
page requires the Person Details module with the Public Site setting set to True. An important
note to remember is that all Person Details modules will follow the same field security settings,
as set in the Administration are of the Arena application, so long as the Secure Fields module
setting is set to true.
• Person Update page – This page displays if the leader does not have permission to edit a
member’s Person Detail page directly. He or she will use the Person Update page to make any
changes. The pages link from the Person Details page by selecting it in the Person Details
module settings. It should be a child page of your View Small Groups page and set to not
display in navigation. This page requires the HTML Email Form page with the From and
Recipient email addresses selected, the Instructions to be displayed at the top of the e- mail
entered, the email’s Subject line, and the HTML formatted form entered in the Details area of
the module settings.
• Group Roster page – This page displays the Group Roster page with details such as their
pictures, addresses, and phone numbers. This page should be a child page of your View Small
Groups page and should not display in navigation. This page requires the Small Group Roster
module and has no required module settings.
• Occurrence Detail page – This page displays the Occurrence Detail page. This page should be
a child page of your View Small Groups page and should not display in navigation. This page
requires the Occurrence Details module with the Public Site setting set to True and the Area
Detail, Event Detail, Group Detail, Occurrence Type, and Profile Detail pages selected.
• Area Details page – This page displays geographic information about the group and its
members. This page should be a child page of your Group Leader Toolbox page and should not
display in navigation. This page requires the Area Details module with your small group
Category ID entered, external Person Details page selected, and your View Small Groups page
selected as the Area List page.
• Communications – This page displays the Communications page where leaders can create
email communications. This page should be a child page of your Group Leader Toolbox page
and should not display in navigation. This page requires the Mail Merge module, and has no
required settings.
Optional Components:
• Home – As a child page of your Group Leader Toolbox page, use this page as a redirect to
your website home page so members can easily navigate back to that page. This page
requires the Redirect module with a page link to your home page.
• Member Homepage – Just like the Home page link above, the Member Homepage is also a
redirect, this time to the Member Homepage for ease of navigation. This page requires the
Redirect module with a page link to your Member Homepage.
• Your Small Groups – This page is a redirect back to the View Small Groups page. This page
requires the Redirect module with a page link to your View Small Groups page specified in the
module details.
• Small Group Locator – This page is a redirect to the Small Group Locator page, if you have
chosen to implement this structure. This page requires the Redirect module with a page link to
your Small Group Locator page specified in the module details.
Arena Select 2014.1.100 162 Implementing Arena-Managed Website Features
Group Leader Toolbox
From Leader Toolbox page, Leaders can edit the details of the group, emails group members, take
attendance print a roster, process group registrants, and change the status of a group member.
Arena Select 2014.1.100 163 Implementing Arena-Managed Website Features
Missions
The Missions feature allows people to register for a mission trip, non-travelers to make a payment
towards a mission traveler, travelers to pay additional money towards his or her mission trip and
anyone to make a general contribution towards the mission trip. Three pages are required. Mission
Trips that have not met the maximum team size will display. Approved goers can make additional
payments. Non-travelers can contribute to the Mission trip or to an approved traveler. Contributions
made toward the mission trip will create a separate batch. This functionality is required to be
behind the Arena Member Login.
• Missions page – This page allows users to select a mission trip. This page requires the
Mission Registrations module, selecting ACH and CC Payment Gateway Names and a redirect
cancel page.
• Mission List page – This page lists all available Mission Trips. This page requires the
Mission List module, where you can specify which trips to display.
• Mission Registration –This page confirms registrant information. This page requires the
Mission Registrations module, with ACH and CC Payment Gateway Name selected, and Cancel
Page redirect page.
Mission List Page
Arena Select 2014.1.100 164 Implementing Arena-Managed Website Features
Billing Information
ACH Payment Option
Arena Select 2014.1.100 165 Implementing Arena-Managed Website Features
Individuals can also pay towards an approved mission traveler and even select to give
anonymously. The option to require approval is a module setting.
Arena Select 2014.1.100 166 Implementing Arena-Managed Website Features
Arena Select 2014.1.100 167 Implementing Arena-Managed Website Features
Giving Kiosk Portal
The Giving Kiosk solution gives members the ability to give on-site using your organization’s existing
Payflow Pro gateway and browser enabled device using a USB card swipe device.
Steps to Setup the Giving Kiosk:
1) Install the Donation Kiosk plug-in.
2) Register domain or subdomain for this portal.
3) Customize Portal settings. You can optionally customize the CSS which is located in the
Arena\Hub\Plugins\Arena.Plugin.DonationKiosk\CSS folder. If electing to customize the CSS,
be aware the file may be overwritten with an Arena update.
Arena Select 2014.1.100 168 Implementing Arena-Managed Website Features
4) Review all pages and customize as required and desired.
• Kiosk Root page has not required modules
• Phone Search page – This page give the ability to search by phone number for an existing
record. This page uses the Kiosk Phone Search and the Enter Amounts Page module setting
is required. This page also uses the Idle Timeout module.
• Register With Us page – This allows non-registered users to sign up and give. The page
uses the Kiosk Register and the Home, Member Status and Redirect module settings are
required. This page also uses the Idle Timeout module.
• Enter Amounts page – This page is where contributors can select funds. This page uses the
Kiosk Enter Amounts module and the Swipe Page module setting is required. This page also
uses the Idle Timeout module. Be sure to select which funds to make available on this
module.
• Enter Payment Info page – This page where contributors can enter amounts. This page
uses the Kiosk Swipe Cord module where the Enter Amount page, Giving Kiosk Home page,
Payment Gateway, and Thank module settings are required. This page also uses the Idle
Timeout module.
• Thank You page- This page display after a contribution is processed. This page uses the
Kiosk Thank you module and the Giving Kiosk Home Page is required. This page also uses the
Idle Timeout module.
5) Customize Portal settings.
Arena Select 2014.1.100 169 Implementing Arena-Managed Website Features
Steps to Use the Giving Kiosk:
1) Go to the Giving Kiosk portal.
2) Enter the last four digits of the person’s phone number. Use any phone number type on his or
her record.
For non-Arena records, the below screen displays.
Arena Select 2014.1.100 170 Implementing Arena-Managed Website Features
You can also add new records.
3) Enter amount in the applicable fund fields.
Arena Select 2014.1.100 171 Implementing Arena-Managed Website Features
4) Swipe Card.
5) Contribution is complete when the Thank You page displays.
Arena Select 2014.1.100 172 Implementing Arena-Managed Website Features
Mobile Portal
The mobile portal is designed to allow staff members to access arena from browser-enabled
mobile devices. As such, the pages use simple templates and do not have the script handling
capabilities of a full web site. The mobile portal allows staff:
• Search, view and edit records
• Send emails to existing records
• Upload member photos?
• Check-In someone in
• View subscribed Personal and subscribed
Tags
• View My Lists
• View list of Staff
• View and update prayer list requests
• Enter record notes with the option to mark
them private
The mobile portal, template, pages and modules are already in place. You can elect to
implement all available features by simply setting security permissions accordingly.
Mobile Portal Settings
On the main page of the mobile portal, logged users can search by first and last name.
Arena Select 2014.1.100 214 Implementing Arena-Managed Website Features
Next, you will want to review the pages and module settings of the available pages. You can elect
to implement all available features or just the ability to search and view records.
Mobile Pages
• Login – This page is for users to login and requires the User Login module.
• Home – This is the home page to direct users to after login and requires the Mobile Person
Quick Search module with Person Search page setting, the Page Navigation module with
required XsltUrl setting. You can also add the LoginLogout module.
• Person Search – This page is for searching for records and requires the Person Search
module with Mobile Person Details Page setting.
• Person Details – This page is the mobile version of the Person Detail page and requires
the Person Details module with optional mobile Check-In setting.
• Subscribed Tags – This page displays all Tags the user subscribes and requires the Mobile
Profile List module with required Profile Details page, Profile List Type page, and XSLT Path.
• Profile Details – This page displays the Tag details and requires the Profile Details module
with Mobile Profile Member Detail Page setting.
• Profile Member Details – This page displays a tag member and requires the Profile Member
Details module with Mobile Person Detail page setting.
• Subscribed Groups – This page displays all Groups the user subscribes and requires the
Subscribed Groups module with the XSLT Path.
• Check-In – This page displays the mobile Check-in and requires the Mobile Check In module
with the Mobile
• Check Out page and Mobile Person Details page settings.
• My Lists – The page displays all lists from the My List page for the current user and
requires Mobile Person Details Page setting.
• Prayer – This page displays all prayers for the selected or specified Prayer Categories and
requires the Mobile Prayer Session mobile and the desired categories selected.
• Personal Tags – This page displays Personal Tags for the current user and requires the
Mobile Profile List module with the required Profile Details Page, Profile List Type page,
and XSLT Path setting.
• Staff – This page displays all records marked as Staff and requires the Staff List module with
optional
• Description Attribute and Mobile Person Details page settings.
• Assignments – This page displays assignments for the current user and uses the Mobile
Assignments module with the Mobile Person Details page setting.
Arena Select 2014.1.100 215 Implementing Arena-Managed Website Features
Mobile Home Page
From the search results page, users can view and edit individual information. Security
permissions determine view and edit rights.
Arena Select 2014.1.100 216 Implementing Arena-Managed Website Features
Individual Information
Arena Select 2014.1.100 217 Implementing Arena-Managed Website Features
Users can check a person into an available class, add the person to a Personal Tag or start
an Assignment Workflow.
Check in someone
Add him or her to a Personal Tag
Start an Assignment
Arena Select 2014.1.100 218 Implementing Arena-Managed Website Features
Users can start a Workflow Assignment from the Person Detail page.
View Assignments of which the user is a worker, requestor or a subscriber.
Assignment Type
Workers can access and update assignments.
Arena Select 2014.1.100 219 Implementing Arena-Managed Website Features
Users can check-in someone in, displays a list of people checked in and check someone out. You will
need at least one active Attendance Type and at least one occurrence.
Available Classes
Searching for People Currently Check-In Checking Someone Out
List of People Currently Checked In
Arena Select 2014.1.100 220 Implementing Arena-Managed Website Features
Users can view subscribed Tags and all Personal Tags.
Subscribed Tags Personal Tags
Users can view My Lists and a List Records marked Staff.
Arena Select 2014.1.100 221 Implementing Arena-Managed Website Features
The Prayer Team can access the Prayer Ministry Toolbox.
Prayer Ministry Toolbox
Arena Select 2014.1.100 222 Appendix
Appendix
Appendix A- Check-In Click Once Installation Guide
Install Prerequisites
Below prerequisites apply if running the click-once Check-In application and running in a
self-hosted environment.
1) Install .NET4.0.5 full version, if not already installed. Use Windows Update in Internet Explorer
to do this, or go to www.microsoft.com.
2) The Kiosk you are using must have access to the SQL Server and the Report Server on the
domain.
3) Install Reporting Viewer locally on each computer running Check-In.
4) Review Check-In Application Settings.
5) Customize Check-In Organization Settings (e.g., Check In Allow Overlapping, Check In Include
Inactive People, and Check-In Overlap Threshold).
Steps to Install Check-In Application:
1) Go to Check-In.
2) Select the Check-In Run Once application button.
3) Follow the steps in the wizard. It may prompt for an installation path and the connection
information to the SQL server.
4) If not prompted at initial install, navigate to the installation path of the application, and create
a shortcut to the .exe file for your desktop.
5) Install the “Free 3 of 9 font” on the kiosk (‘FREE3OF9.TTF’ is included in folder) by
copying into the C:/Windows/Fonts folder.
Wedge Scanner Configuration
1) You must configure scanners in ‘wedge’ mode, to save scans as plain text.
2) You must add a “Carriage Return” character to the end of the scanned value in order for the
kiosk to accept the value. Please consult your scanner’s manual for configuring the scanner.
Steps to Configure Non-Wedge Scanner (e.g. the NCR kiosk):
1) Download and install latest CCO runtime from http://monroecs.com/oposccos_current.htm
2) Install WEPOS SDK
http://www.microsoft.com/downloads/details.aspx?familyid=B04C4D8B-88AD-4F6D-
AC0D-17490261CDB4&displaylang=en
3) Modify the value of “ScannerName” in the CheckInApplication.exe.config to “SCANNER.”
4) Configure scanner to read barcode format of code 39.
Arena Select 2014.1.100 223 Appendix
Printers Steps for Windows Configuration, using the kiosk physically connected to the printer:
1) Install print drivers.
2) Share the printer on the network if other kiosks will print to this printer.
3) For the Brother QL-550, you must set printing defaults.
4) Go to Module Panel / Printers and Faxes, right-click on the printer.
5) Choose Properties.
6) Go to the ‘Advanced’ tab and click ‘Printing Defaults…’
7) Select ‘Width’ of 2-3/7” (this is the size of the default Arena labels, but this can be
changed through Reporting Services).
Printers in Two Places
1) Under Check-In/ Kiosks, edit a kiosk and set up a default printer. The ‘Printer Name’
must be the full network share path (e.g. ‘//hostcomputer/printer’). You can use any
networked printer as the default.
2) Under Check-In/Attendance Type Categories/Attendance Types/Labels, either add a new
label for the attendance type and select, a specific printer or select ‘[Use Kiosk’s Default
Printer
• If you select [Use Kiosk’s Default Printer], then the label’s printer uses the kiosk’s default
printer set up under Check-In/Kiosks. If three kiosks are set up to take attendance for the
same attendance type, then each kiosk can print to its own default printer.
• If you select a specific printer, Arena sends every print job to that specific printer.
If your organization will use the Print from Server option, please consult with Arena
Support.
Arena Select 2014.1.100 224 Appendix
Recommended Windows Settings Steps to Turn Off Notification Pop-ups:
1) Open Printers and Faxes.
2) Click on File/Server Properties.
3) Click the Advanced tab.
4) Uncheck “Show Informational Notification for Local Printers.”
5) Uncheck “Show Informational Notifications for Network Printers.”
Steps to Turn Off System Notification Balloons:
1) Go to Start/Run.
2) Enter ‘gpedit.msc’ (no quote).
3) Under User Configuration, expand Administrative Templates.
4) Click Start/Taskbar.
5) Enable Remove Balloon Tips.
6) Turn off “Always on Top” for the Taskbar.
7) Right-click on the Taskbar.
8) Click Properties.
9) Uncheck “Keep Taskbar on Top of Other Windows.”
10) Click OK.
Steps to Turn Off Start Navigation Sounds:
1) Go to Module Panel/Sounds.
2) Click the Sounds tab.
3) Go to Windows Explorer section.
4) Set the sound for Start Navigation to “None.”
Arena Select 2014.1.100 225 Appendix
Security for Label printing The local user on the Kiosk does not have to have permission set on the SQL or Report server, as
Arena handles all the communication for label printing. The ArenaReports domain or local user
must have permission to log onto the kiosk station in Active Directory, however. This is necessary
for Report Services, which uses the ArenaReports user, to access the kiosk’s printer.
Steps Check-In Performs to Print a Label:
1) Guest signs in and chooses his or her Attendance Type.
2) The occurrence_attendance ID is created by the SQL Create Occurrences job.
3) The occurrence_attendance ID value is passed to the Report Server via the ArenaReports
user to run the Label as set up in the Attendance Type.
4) Report Services creates the label and submits the label data to the printers set up in the
Attendance type as the ArenaReports user.
5) The label prints out at all designated printers, the guest is now checked in successfully.
Checklist of Settings for Check In to function:
1) There must be at least one existing Attendance Type Category.
2) There must be at least one Attendance Types with a minimum and maximum age. These
represent the types of events, groups, or meetings that a person can check in. Arena Check-
In recognizes these as classes.
Every Attendance Type that uses an age range or birth date will require for everyone person
using the
Attendance Type to have a complete birth date on his or her record. Arena uses the
birthdates to verify that the person is eligible.
3) There must be a Frequency set up for the Attendance Type. Arena uses these to create
Occurrences. An Occurrence is literally a record of a meeting and the attendees. Arena uses
the terms Occurrence and Attendance interchangeably. The Occurrence allows a person to
check in to the Attendance Type. (Note: The Check In start and end times dictate when the
class is available to check in at the kiosk, while the Class Start and Class End time create the
times for the Occurrence itself.)
4) There must at least one Location for the Attendance Type. These are the physical locations
where the Check-
In Kiosk will be.
5) There must be at least one Kiosk and kiosk schedule setup. The Arena Check In application
will read the schedules for each kiosk to see if it is available for Check-In. You may also set
up the kiosk by launching the CheckInApplication.exe on the kiosk itself. This is generally the
recommended method of adding a computer to Arena as a Kiosk. Doing so will also generate
a schedule automatically for every day, from 12:01AM to 11:59PM.
General Troubleshooting:
• Kiosk Issues:
Is Internet access available?
Is the kiosk schedule set properly?
Is the default printer set properly?
Are the locations set properly?
• Person Issues:
Is age, grade or date of birth required?
Is the Attendance Type set to require membership?