Contents
Index
PerfectForms™ Help Guide
Creating and Managing an Account
Signing Up for an Account
Changing or Resetting Your Password
Editing Your Personal Details
Navigating PerfectForms™
Overview of PerfectForms™ Components
PerfectForms™ Dashboards
Form Designer
Report Designer
Logging in to PerfectForms™
User Type Affects Navigation Options
Getting Started Page
Bypassing the Getting Started Page
Forms Dashboard
Edit Forms
Edit Forms Overview Page
Importing a Form File (.PF)
Using a Sample Application from the PerfectForms Web Site
Importing a Form from the Forms Library
Moving Forms Between Folders in the Tree
View Forms
Organizing Forms
Searching Forms
Accessing the Data History of a Form Instance
Exporting Data History of a Form Instance
Reports Dashboard
Edit Reports
View Reports
Organizing Reports
Notifications Dashboard
Attention Needed
No Attention Needed
Searching Notifications
Viewing All Notifications for a Given Instance
Connections Dashboard
Settings Dashboard
Account Settings
Settings
License Information
Users View
Resources
Adding a List as an Account Resource
Adding an E-mail Server as an Account Resource
Archiving Settings
Assigning Archiving Permissions
Initiating a New Archive
Reviewing Previously Archived Instances
Restoring Archived Instances
Permanently Deleting Archived Instances
Filtering Your Results List
Accessing Archived Instances from the Form Instance Summary Area
Personal Settings
Editing Your Personal Details
Embedding the Dashboards into Any Web Page
Resizing the Dashboard
Dashboard Options Reference Table
Exiting PerfectForms™
Accessibility and JAWS Compatibility
Designing a Form
Creating a New Private Form
Editing an Existing Form
Importing a Form File
Importing a Form from the Forms Library
Form Designer Overview
Form Toolbox and Browser Bar
Form Canvas
Form Properties Bar
Help Links and Help Center
Laying Out a Form
Applying or Resetting a Theme
Modifying Form Styles
Changing a Form Size
Setting the Form Instance Name
Show Locking Information for a Locked Form
Adding a Page
Setting a Page Background
Changing Page Order
Renaming a Page
Unloading or Reloading a Page
Deleting a Page
Adding a Page Border
Adding Objects to your Form
Labeling an Object
Adding a Drop-down
Adding Check Boxes
Adding a Picture or Graphic
Adding Radio Buttons
Adding a Print Button
Adding a Submit Button
Using a Submit Button Object as a Save Button
Adding Image Acquisition Capabilities
Adding a File Attachment Object
Managing Object Properties
Setting the Form Instance Name
Setting or Modifying Tab Order and Tab Stops
Validating Data Entry
Modifying Common Properties of Multiple Objects
Applying or Resetting a Theme
Mandatory Answer Property
Selecting a State
Working with Tables
Adding a Table
Printing Table Contents
Managing Table Properties
Working with Columns
Performing Row Calculations
Performing Column Calculations
Using the Set Table Rows Behavior Command
Using a Table to Manage Child Forms
Aligning, Spacing and Layering Objects
Selecting Multiple Objects
Aligning Objects
Aligning with Snap to Grid
Aligning with Snap to Text Neighbor
Moving Objects a Pixel at a Time
Grouping Objects Together
Grouping Radio Buttons
Grouping Check boxes
Adding Behaviors
How Behaviors Are Triggered
Adding Behaviors to a Form or Form Object
Adding Behaviors to a Workflow Path
Checking for Mandatory Fields
Checking for Mandatory Fields on Multi-Page Forms
Calculations and Setting Field Values
Simple Branch or Multiple Branch
Connect Commands and Integration
Calling JavaScript from a Form
When Not to Use Behaviors
Do Not Manage Field State with Behaviors
Do Not Manage Object Properties with Behaviors
Do Not Overuse Branch Commands
Do Not Attempt to Manage Workflow with Behaviors
Adding Workflow
Planning Your Workflow
Drafting the Workflow
Form Layout and Workflow Needs
The Workflow Diagram
Workflow Roles
Adding a Role
Mapping Roles
Understanding Default Person Options
Workflow Stages
Adding a Workflow Stage
Default Stage
Closed Stages
Workflow Paths
Adding a Path Between Stages
Path Styles
Workflow Path Conditions
Simple Conditions on a Path
Advanced Conditions
Setting Notifications, Reminders, Escalations
Adding a Notify Behavior to a Path
Notify Command - General Tab
Notify Command - Person Tab
Notify Command - Time Tab
Notify Command - Cancellation Tab
Notify Command - Message Tab
HTML in Notifications
Mobile Approval Forms
Designing for Mobile Approval
Anatomy of a Mobile Approval Form
Adding a New Mobile Approval
Editing an Existing Mobile Approval
Removing a Mobile Approval
Accessing Mobile Approval Forms
Processing Mobile Approval Forms
Notify Command - Email Tab
Dashboard or E-mail Notifications
No Attention Needed
Requiring Login from Notification Link
Notifying Multiple E-mail Addresses Stored in a Table Object
Limiting User Access to Form Fields
Planning Your Field State Strategy
Explanation of State Priority
Sequence of Events for Field States
Understanding the Default State
Showing Field State Markers
Overview of Field State Scenarios
All Stages, All Roles
Setting a State for One Role Across All Stages
Setting a State for All Roles in a Specific Stage
Setting a State for One Role in a Specific Stage
Setting a Series of States on a Form Object
Setting State on a Group Object
Resetting Field States
Loading the Object States Overview
Marking as Mandatory
Overriding Persisted Field State
Using the Formula and Condition Editor
Formulas
Numeric Calculations
Text Calculations
Date and Time Calculations
Special Fields and Properties
Helper Fields as Variables
Working with Tables
Working with List Values
Conditions
Operators
Functions
Functions in the Formula Editor
Linking Forms and Using Parent-Child Relationships
Linked Forms vs. Parent-Child Forms
Parent Form Example
Form Instance IDs
Parent Instance IDs
Getting at the Form Instance ID or Parent Instance ID
Instance ID is Not the Instance Number
Creating and Managing Child Instances
Using the Show Form Button
Setting Up Custom Parameters
Show Form Behavior Command
Creating Multiple Child Instances
Submitting Parent and Child Instances
Finding and Viewing Related Forms Instances
Reading and Writing Data Between Form Instances
Passing Data to Forms by Querystring Example
Previewing a Form
Saving and Closing a Form
Publishing and Deploying Your Form
Testing Your Form Using Draft Instances
Providing Users with a Link to Your Published Form
Embedding a Form into a Web Page
Passing Data from a Web Page into a New Form Instance (External Callback)
Using the API Reference Text
Preloading the PerfectForms™ Player
Migrating a Form and Exporting Form Data
Granting Form Permissions
Allowing Others to Edit Your Form
Migrating Form or Report Ownership to Another User
Allowing Access to All Form Instances (for Process Owners)
Working with Versions
Reverting to a Previous Version of a Form
Mapping Form Instances to Another Version of the Form
Deleting all Form Data and Earlier Versions
Editing Form Settings on the Dashboard
Accessing the Data History of a Form Instance
Interactive Examples and Sample Forms
Date and Time Calculations Example
Parent and Child Forms Interactive Example
Timer Object Example
Mandatory Field Checking and Field States Example
Allowing a Form User to Save Then Submit Later
Confidential Save and Return Example
Tab Order Management Example
Joining Numbers Example
Capitalizing Words Example
Radio Buttons and Check Boxes Example
Passing Data to Forms by Querystring Example
Calling JavaScript from a Form
Working with Tables
Extracting Data from a Table
Using HTML Tags
Managing Employee Evaluations Example
Mobile Approval Form Example
Form Designer Reference
Browser Bar Reference
Layout Toolbox Reference
Layout Objects Properties Bars Reference
Form Properties
Page Properties
Text Properties
Picture Properties
Button Properties
Submit Button Properties
Page Button Properties
Group Properties
Text Input Properties
Multiline Text Input Properties
Numeric Input Properties
Date Input Properties
Time Input Properties
Date Calendar Properties
Check Box Group Properties
Check Box Properties
Radio Button Group Properties
Radio Button Properties
Drop-down Properties
List Properties
Bullet Text Properties
Vertical Separator Properties
Horizontal Separator Properties
Sound Properties
Movie Properties
Link Properties
Progress Bar Properties
Timer Properties
Print Button Properties
Captcha Properties
Mask Text Input Properties
Numeric Stepper Properties
Password Input Properties
File Attachment Properties
Image Import Properties
Vertical Slider Properties
Horizontal Slider Properties
Table Properties
Ranking Properties
Show Form Button Properties
Show Report Button Properties
Behaviors Toolbox Reference
Behaviors Properties Bars Reference
Start Properties
Exit Properties
Simple Branch Properties
Multiple Branch Properties
Connector Properties
Run Behavior Properties
Comment Properties
Submit Data Properties
Close Properties
Show Message Properties
Show Page Properties
Show URL Properties
Cancel Submission Properties
Print Properties
Set Field Properties
Copy Fields Properties
Set Property Properties
Show Properties
Set State Properties
Check Mandatory Properties
Set Selection Items Properties
Start/Stop Properties
Set Table Rows Properties
Notify Properties
Set Next Stage Properties
Cancel Notify Properties
Connect Properties
Connect and Search Properties
Transaction Properties
Show Form Properties
Show Report Properties
Get Field from Other Instance Properties
Set Field in Other Instance Properties
Call JavaScript Properties
Workflow Toolbox Reference
Workflow Properties Bars Reference
Stage Properties
Comment Properties
Workflow Properties
Path Properties
Form Designer Menu Options Reference
Functions
Filling in Forms
Filling in and Submitting a Form
Viewing Form Instances After Submission
Printing a Form Instance
Designing a Report
Report Designer Overview
Report Toolbox and Browser Bar
Report Canvas
Report Properties Bar
Help Links and Help Center
Creating a New Report
Report Permissions
Changing the Report Size
Adding a Datasource
Reporting on Table Data
Including Form Meta Data
Adding Objects to Your Report
Adding a Heading
Adding a Pie, Bar or Line Chart
Adding a Picture
Adding a Page
Adding Page Navigation
Adding a Data List or Data Grid
Delegating Sort Order for Data Lists and Data Grids
Exporting Data From a Data List or Data Grid
Adding a Gauge
Setting up Drill-Down and Filtering
Adding a Filter Selector
Adding a Filter Input
Clear Filter Button Object
Creating a Reporting Portal
Adding Behaviors to Reports
Adding a Print Button
Deploying Your Report
Previewing Your Report
Exporting or Importing a Report
Deleting a Report
Report Designer Reference
Report Designer - Layout Objects Properties Bars Reference
Reporting Objects Reference
Report Properties
Administering and Integrating PerfectForms™
Administering Users, User-Groups and Positions
Creating a New User
Inactivating or Suspending a User Account
Creating a User-Group
Creating a Position
Unblocking a Locked-Out User
Resetting a Password
Administering Account Settings
Public User Sign-Up in Player
License Information
Assigning Account Administrator Permissions
Setting Up Single Sign-On for a User Account
Synchronizing with a Network Directory Service
Administering Connections and Integration
Steps to Integrating Your Forms
Typical Outbound Integration Scenarios
The Connection Agent
System Requirements
Pre-Installation Step: Installing Tomcat
Installing the Connection Agent
Updating the Connection Agent (Reinstalling)
Security
Connection Agent Configuration Editor
Installing the Connection Agent Editor
Using the Connection Agent Editor
Config File
Login Parameters
Access Statement
Datasources
Exposing a Database
Connection Agent Troubleshooting
Creating PerfectForms™ Connections
Editing Connections - Special Consideration
Database Connections
Directory Services (LDAP) Connections
LDAP Lookups Examples
Web Services Connections
Sending Basic Authentication and Header Parameters
Forms Connections
Text/CSV Database
Connection Permissions
Migrating Connections
Defining Connection Actions
Form Connection Action Types
Directory Services (LDAP) Connections Action Types
Database Connections Action Types
Web Service Connection Actions
Calling the Connection from a Form
Setting Up a Background Lookup Using a Connect Command
Setting Up Popup Lookups
Database Transactions
System Meta Data Connection
Connection Error Handling
Using Single Sign-On
Installing the SSO Gateway
Troubleshooting Single Sign-On
Passing Data from a Web Page into a New Form Instance (External Callback)
PerfectForms™ API
API Security
Setting Up API Account Access
Setting Up API User Access
Account API
Account API Methods
AccountSignUp
Create User
DeleteFormInstance
GetAsset
GetFormData
GetFormInstanceData
GetFormInstanceMetaData
GetFormInstanceMetaData2
GetFormInstancePDF
GetListOfFormInstances
GetListOfUsers
GetUserDetails
Login
Notify
PutAsset
SetStage
UpdateUserDetails
Form API
Form API Methods
Add
Delete
Edit
GetList
View
Building a Sample Project
Setting Up a Test Form
Form Specific WSDL
Creating Your Project
Logging In
Setting Up a Simple Test Form
Instances List
Portal API
Portal API Methods
GetFormsList
GetNotificationsList
GetReportsList
Login
PlayerLogin
Interactive Examples and Sample Forms
Database Lookups Examples
PayPal Integration Example
How the PerfectForms™ Example Form Works
How to Set Up a Connection to the PayPal API
How to Set Up Your Own Account and Example
How to use the PayPal Example in Your System
Web Service Example
Calling JavaScript from a Form
View Picture Example
PerfectForms™ On-Premise
Installing PerfectForms™ On-Premise
Client Side Requirements
Server Side System Requirements
Server Side Hardware Requirements
Disk Storage and RAID Levels
Performance Guidelines
Basic System
Typical Two-Server System
Load Balanced System
Database Configurations
Installation Procedure
Preparing for the Installation
Running the Installation
Testing the Installation
Optional Troubleshooting: Verify IIS Setup
Application Reinstall and Database Restore
Updating Your PerfectForms™ On-Premise Version
Running the Version Update
Administering PerfectForms™ On-Premise
Logging in to the On-Premise Administration Console
Administration Console Overview
Accounts
Send Password Link for On-Premise User‘s Password
Unblocking a Locked-Out User through the Administration Console
Undelete a User, Form or Report
Viewing a List of Forms for an Account
Viewing a List of Reports for an Account
Viewing and Setting Up Account Logs
Packages
Creating a Package
Deleting a Package
Documents
Creating a New Default Form
Creating a New Library Form
Importing an Existing Library Form
Linking to a Library Form
Exporting a Library Form
Enabling the Forms Library
Updating Form Design of a Library Form or Sample Form
Settings
Administering Archiving Settings
Managing Archiving Settings
Archiving Setup
Initiating a One-time Archive
Establishing an Archiving Schedule
Initiating a One-time Deletion of Archived Instances
Establishing a Deletion Schedule
Setting the Application Root URL
File Attachment Storage
Updating the System E-mail Server Configuration
Setting Maintenance Options
Permanent Data Record Deletion
Database Index Optimization
Enabling the Forms Library
Enabling the Help Center
Customizing the PerfectForms™ Application
Customizing System and Error Messages
Removing the PerfectForms™ Logo
Customizing the Internet Browser Tab
Displaying a Custom Logo on the User Interface
Using the Data Export Scheduler
Installing the Data Export Scheduler Service
Configuring the Data Export Scheduler Service
Setting Up a Scheduled Export
PerfectForms™ Offline Form Manager
Installing Offline Form Manager
Client Side Requirements
Installation Procedure - Windows
Installation Procedure - Other OS
Configuration and Security
License Information
UI Branding
Unsupported Functionality
Managing Forms
Adding / Updating Forms
Managing Form Instances
Saved Form Instances
Completed Form Instances
Submitting Form Instances to the Server
Submitted Form Instances
Updating User Settings
PerfectForms™ Web Parts Collection
PerfectForms™ Web Parts
Proxy Web Part
Proxy Configuration
Connecting to the Proxy Web Part
Dashboard View Web Part
Dashboard View Configuration
Dashboard View Connection
WorkPage View Collection
Notification Icon Web Part
Notification Icon Configuration
Notification Icon Connection
Customization of Appearance
Tree-View Web Part
Tree-View Configuration
Tree-View Connection
Notification Grid Web Part
Notification Grid Configuration
Notification Grid Connection
Page-View Web Part
Page-View Configuration
Page-View Connection
Accessing SharePoint Lists
Single Sign-On After First Login
Site Configuration Options
Installing PerfectForms™ Web Part Collection
Prerequisites
Instructions for Farm Administrators
Instructions for Site Administrators
Error Codes Reference