Академический Документы
Профессиональный Документы
Культура Документы
0
Users Guide for Windows and UNIX
19992000 by Remedy Corporation. All rights reserved.
This documentation may not be copied in whole or in
part without the prior written consent of Remedy
Corporation.
Remedy, the Remedy Corporation logo and design,
Action Request System, AR System, ARWeb,
Flashboards, Remedy Approval Server, Remedy
Purchasing@Work, Remedy SetUp@Work, and Remedy
Change Management are registered or other trademarks
of Remedy Corporation, Mountain View, CA, USA.
All other trademarks are the property of their respective
owners.
U.S. GOVERNMENT RIGHTS. Use, duplication, or
disclosure by the Government is subject to Remedy
Corporations commercial software license(s). If you are
the U.S. government, you agree that these written
materials are commercial computer software-related
documentation licensed pursuant to the terms of Remedy
Corporations commercial computer software license(s)
in accordance with 48 C.F.R. 12.212 of the Federal
Acquisition Regulations and its successors and 48 C.F.R.
227.7202-1 of the DoD FAR Supplement and its
successors. Unpublished rights are reserved under the
copyright laws of the United States.
Part Number: ARAS-400-UG-01
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
Related Remedy Documents . . . . . . . . . . . . . . . . . . . . . . . . xiv
Conventions Used in This Manual . . . . . . . . . . . . . . . . . . . . . xiv
3 Working as an Approver
Processing an Approval Request . . . . . . . . . . . . . . . . . . . . . . 3-2
Viewing Approval Requests . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Performing Other Approval Actions . . . . . . . . . . . . . . . . . . . . . 3-3
Requesting More Information . . . . . . . . . . . . . . . . . . . . . 3-3
Reassigning an Approval Request . . . . . . . . . . . . . . . . . . 3-3
Specifying the Next Approver . . . . . . . . . . . . . . . . . . . . . 3-4
Handling Approval Errors . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
iv Table of Contents
6 Using a Sample Application
Using a Sample Application. . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Summary of Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9
Table of Contents v
9 Defining an Approval Process
Using the Process Definition Form. . . . . . . . . . . . . . . . . . . . . . 9-2
Creating a Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
Working with Existing Processes . . . . . . . . . . . . . . . . . . . . . . 9-9
Modifying Processes . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9
Deleting Processes. . . . . . . . . . . . . . . . . . . . . . . . . . 9-10
Renaming Processes . . . . . . . . . . . . . . . . . . . . . . . . 9-11
vi Table of Contents
Working with Approval Process Done Rules . . . . . . . . . . . . . . . 10-30
Defining Approval Process Done Rules . . . . . . . . . . . . . . . 10-30
Working with Existing Rules. . . . . . . . . . . . . . . . . . . . . . . . 10-32
Modifying Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-33
Deleting Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-33
C Application Commands
Basic Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2
Specific Approval Server Commands . . . . . . . . . . . . . . . . . . . . C-4
Add-Sig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-4
Det-Approved . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-4
Det-Cancelled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-5
Det-Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-5
Det-Rejected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6
MoreInfo-Return . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6
New-Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6
Rename-Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7
Rename-Process . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7
Sig-Approved . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7
Sig-Cancelled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8
Sig-Notify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8
Sig-Notify-Change. . . . . . . . . . . . . . . . . . . . . . . . . . . C-8
Sig-Notify-State . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-9
Table of Contents ix
Sig-Reassign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .C-9
Sig-Rejected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-10
Update-Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-10
D Approval Forms
Approval Central . . . . . . . . . . . . . . . . . . . . . . . . . . . .D-2
AP:Administration . . . . . . . . . . . . . . . . . . . . . . . . . . .D-3
AP:Alternate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .D-9
AP:Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-11
AP:Detail-Signature . . . . . . . . . . . . . . . . . . . . . . . . . D-12
AP:Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-15
AP:More Information . . . . . . . . . . . . . . . . . . . . . . . . . D-16
AP:Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-17
AP:Process Administrator . . . . . . . . . . . . . . . . . . . . . . D-20
AP:Process Definition . . . . . . . . . . . . . . . . . . . . . . . . D-21
AP:Reserved Word. . . . . . . . . . . . . . . . . . . . . . . . . . D-26
AP:Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-26
AP:Rule Definition . . . . . . . . . . . . . . . . . . . . . . . . . . D-27
AP:Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-30
Business Time Holidays . . . . . . . . . . . . . . . . . . . . . . . D-31
Business Time Workdays . . . . . . . . . . . . . . . . . . . . . . D-32
User Form xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-33
E Troubleshooting
Installation Concerns . . . . . . . . . . . . . . . . . . . . . . . . . . . .E-2
Previous Approval Server Installations . . . . . . . . . . . . . . . . .E-2
Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .E-2
Application Pending Form . . . . . . . . . . . . . . . . . . . . . . .E-2
Approval Web Concerns . . . . . . . . . . . . . . . . . . . . . . . . . . .E-3
The Approval Central URL . . . . . . . . . . . . . . . . . . . . . . .E-3
Browser Buttons Log Out User. . . . . . . . . . . . . . . . . . . . .E-3
Cannot Display Approval Web Pages . . . . . . . . . . . . . . . . .E-3
Missing Tabs in Netscape . . . . . . . . . . . . . . . . . . . . . . .E-3
Sample Application Concerns . . . . . . . . . . . . . . . . . . . . . . . .E-3
Sample Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . .E-3
x Table of Contents
Miscellaneous Runtime Concerns . . . . . . . . . . . . . . . . . . . . . E-4
Approver Receives Request but Cannot Respond . . . . . . . . . . E-4
Approval Server Wont Start Up With Oracle 8.0.x . . . . . . . . . . E-4
Glossary
Index
Table of Contents xi
xii Table of Contents
Preface
Audience
This guide is written for:
Action Request System (AR System) users who want to understand Approval
workflow.
AR System Administrators who are responsible for installing and licensing the
Remedy Approval Server.
Note The Approval Server Process Administrator is not the same as your Remedy
Action Request System Administrator. Refer to Chapter 7, The Process Administrators
Guide for a discussion of the Process Administrators responsibilities.
This guide assumes you are familiar with the Remedy Action Request System.
The administration sections assume you want to add the Approval Server to an
existing application.
This guide includes instructions for installing Windows NT and UNIX Approval
Server forms and workflow, and assumes you are familiar with the environment in
which you install the software.
Note Refer to Appendix A, Installation and Configuration, for instructions on how to install
Action Request System.
Preface xiii
Related Remedy Documents
Action Request System Workflow Procedures for creating and modifying an AR Administrators Print and
Administrators Guide System application for tracking data and PDF
processes
Action Request System Server Server administration topics on configuring Administrators Print and
Administrators Guide servers, optimizing performance, and PDF
maintaining the AR System; technical essays
Unless otherwise noted, online documentation is available in Adobe Acrobat (PDF) format on Remedy product installation CDs and on
the Remedy Customer Support web site.
xiv Preface
1 Understanding the Approval
Process Chapter
This chapter is written for all users and administrators of the Remedy Approval
Server. This chapter introduces key concepts by answering these questions:
Note Refer to Appendix A, Installation and Configuration, for instructions on how to install
the Approval Server.
1-1
The Basic Approval
An approval indicates agreement or rejection of a request. In business, approvals
are generally signatures of key individuals, recorded for the purposes of
providing an audit trail or proof of authenticity.
Approval Examples
When you ask your boss to sign for your vacation or a new computer, you are requesting
an approval. Your signed check is an approval of the transfer of funds from your account,
and your signed lease is an approval for living under the terms of your landlord.
Imagine an office employee requesting a faster personal computer. The request to purchase
a new computer has to be approved by the employees manager. If the manager approves,
a separate MIS department approval process then determines the model of computer to buy.
These approval processes are separate, but both must be completed successfully for a
computer to be delivered.
Flexibility
Todays diverse demands require the Approval Server to be flexible enough for
any AR System application. There are often differences in how approvals should
work between different applications within the same company.
Who needs to sign this next?
Do I have all of the signatures I need? How many is enough?
Agreement or Acknowledgment
Imagine you had to turn off an important system for maintenance. It would be helpful to
send out approvals to affected customers in advance. While the customers are not really
approving the downtime, their approval is an acknowledgment of the coming change
and the fact they are prepared for it. If they reject the change, those customers are
indicating that they are not prepared, and may need additional assistance.
Where to Go Next
2-1
Key Concepts of the Approval Server
An approval requires a process for people to acknowledge. This chapter discusses
process, the people, and the acknowledgment.
Complex processes
Sometimes a single operation actually involves multiple approval processes
chained together, such as when a manager has to approve a new computer
purchase, but MIS has to pick out a specific model of computer. Process
administrators need to set up these chained processes carefully. Properly
designed, a chained approval process is transparent to the approvers and people
requesting approval, so that it appears as one smooth operation.
Requesters
Requesters are the people who want something to be approved. Requesters work
within an application that starts an approval process. They enter requests within
the application and at some stage their application request must be approved.
Their requests are routed to all required approvers and the results returned
without further action by the requesters.
Approvers
Approvers are people with the authority to approve or reject a request in a given
process.
Once you approve a request, you never see it again, and have no chance to change
your mind. The request is routed only to the remaining approvers. Likewise, once
you reject a request, you cannot change your mind. No one else sees it; the routing
stops and the request is closed.
Valid approvers for each process are set up in the Approval Server, and they are
used to form a specific Approver List for each request. Different requesters may
have different approver lists for the same process.
An approver list specifies the exact list of signatures required for a specific
request. A signature can come from an individual, or it can come from a role
containing multiple individuals. The Approval Server allows you the flexibility to
work with any combination of individuals and roles to create an Approver List
for a particular process.
Franks company rules say he can get the signature of any manager to authorize reimburse-
ment for office supplies. However, company rules say Frank must get his direct supervisor
to authorize reimbursement for travel related expenses.
Jack, Larry, and Samantha have the role of manager, so any of them can approve Franks
office supplies.
Jack is the individual who supervises Frank, so only Jack can authorize Franks travel
expenses.
Alternate
Approvers are not always available. When vacations or business trips occur,
someone needs to cover for the individual who is out. Approvers can define an
alternate with exactly their own capability and authority within an approval
process.
Having an alternate is not the same thing as having a peer with authority to
approve the same process as you. An alternate is someone who substitutes for
you and acts with your authority and privileges for a duration of your choice.
Approvers have the option to set up any number of alternates, and each alternate
may be set up to substitute within one or more approval processes.
When approvers designate you as an alternate, the Approval Server gives you the
option to see your own approvals, or to see this other persons approvals as his or
her alternate. You are always logged in as yourself, but you must specify whether
you are acting as: yourself or as an alternate.
After Jack logs in to the Approval Server, he must select whether he wants to act as Jack, to
act as Samantha, or to act as Brigid. Although Jack can switch between three approver
identities, Jack can act as only one identity at a time.
Because Jack must specify one identity before he sees any approval requests, there is no
possibility that Jack can sign Samanthas requests with Brigids authority, or his own.
When Jack acts as Samantha, it is irrelevant that he also has authority within the technical
review process when acting as himself. When Jack acts as Samantha, he sees only
Samanthas technical review requests and approves or rejects them with Samanthas
authority. Likewise, when Jack acts as Brigid, he has Brigids authority within the legal
review process, and cannot act as Brigid for technical reviews.
Process Administrator
To automate approval processes, one person or authority must define each
process. The Process Administrator is the person with the ability to define
processes for the Approval Server.
A second ability of the Process Administrator is the override. Sometimes
emergencies require someone to override the normal flow of a process.
The third ability of the process administrator is to grant others limited authority,
allowing specific individuals an ability to configure a process, to override a
process, or both.
The Process Administrator also has the ability to designate alternates for any
approver.
Process Administrator actions are performed using one central form, called
AP:Administration.
Note An Approval Server Process Administrator is not the same as your Remedy Action
Request System Administrator. Refer to Chapter 7, The Process Administrators Guide
for an explanation of the Process Administrators responsibilities.
Notification
For every stage of the approval process, AR System notifications can be defined
to inform interested parties of the status of an approval request.
Audit Trail
All activity within the system is recorded within the Detail Record. The
AR System captures approver activity, the time an activity occurred, and what
that activity was. This allows you to track the progress of the entry and see which
activity was performed at each stage.
Where to Go Next
Now that you understand the basic concepts of the AR System Approval Server,
you can review the following chapters covering approvers, installation and
process administrators
Chapter 3 through Chapter 6 contain concepts, procedures, and examples for
approvers.
Chapter 7 and later contain information for Approval Server Process
Administrators.
Appendix A contains installation instructions for AR System administrators.
Performing Overrides
3-1
Processing an Approval Request
Approvals typically follow this sequence.
1. Someone submits a request that requires your approval.
2. You receive notification of the approval request.
3. You review the approval request and take one of the following actions:
If the request appears to be in order, you can approve it.
If you need more information, you can enter a question or comment for the
Approval Server to route to the requester or other individual.
If the request appears unacceptable you can reject it. Rejection ends the process
for this request.
If you feel that you are not the appropriate person to approve the request, you
can reassign it.
For procedural information with Remedy User, see Processing an Approval
Request on page 4-2. For procedures using ARWeb, see Processing an Approval
Request on page 5-2.
You can also view the Detail-Signature record for requests that have you as an
approver. This is useful if you need historical information about a completed
As an approver, you can use the More Information request to ask a question
regarding the original request. The original request then pauses until you respond
to it. Others can see that the request is paused in a More Information status.
Your response to the original approval is independent from the More Information
routing. You never have to wait for the More Information answer. However, if you
do approve or reject the original approval request, the Approval Server
immediately closes your outstanding More Information request(s).
For procedural information, see Processing More Information Requests on
page 4-4. For procedures using ARWeb, see Requesting More Information on
page 5-6.
Note Specifying the next approver is not the same as reassigning an approval request.
The option to specify the next approver requires you to approve or reject the request first.
Use the option to reassign a request if instead of you, you want someone else to approve or
reject a request.
Note Errors from an improperly designed approval process are not correctable by an
approver. Process administrators can refer to Get Next Approver - Automatically on
page 7-10, for information to ensure a process validates the next approver properly.
Note If your alternate designates an alternate, authority to sign your approvals is not
passed on. Only the specific person you designate can act as your alternate.
Violet is out of the office for a week and designates Larry as her alternate. Larry departs on
a surprise business trip, and designates Jack as his alternate. Jack does not have signature
authority for Violets requests. Jack cannot see Violets requests.
Jack goes out of town to a trade show August 18. Jack designates Samantha as alternate
for all his approval processes from August 15. However, from August 68 Samantha is
limited to acting as alternate for only the office supply approval process, because the
When you have been designated as an alternate, you see and respond to
approvals in the same manner as when you are a normal approver, but the system
knows you are acting as another person. The Approval Server shows you only
approval requests for one person at a time.
Acting As an Alternate
The Approval Server reinforces the separate identities Larry can act as, by asking him to
choose for whom he is acting: as himself, or as an alternate.
If Brigid designates Larry as alternate, when Larry acts as himself, he reviews only his own
approval requests. When Larry acts as Brigids alternate, he reviews requests only within
processes where she has designated Larry as alternate. Acting as Brigid, Larry responds to
Brigids requests with her authority in that process, even if Larry normally has weaker or
stronger signature authority.
Note Although an approver uses the Approval Central form when acting as an alternate,
you must use the AP:Alternate form to designate and change information regarding
alternate approvers.
Note A process administrator can give out override-only administrator privileges to any
user without granting other approval process administrator privileges.
Global Overrides
There is also an advanced global override. This closes all open signatures, stops
routing the request, and terminates the approval process for that request. This
global override is useful for emergencies such as ending an approval process for a
request that is no longer necessary.
Imagine Sue makes a time-sensitive request that requires the approval of Samantha and
Ned, in that order. Samantha is delayed by traffic and will not arrive in time to approve the
request before it is required, therefore the sympathetic process administrator performs an
override, immediately approving the request, which routes the request to Neds desk.
Should it happen that Samantha and Ned are both delayed in traffic, the process
administrator can perform a global override, approving or rejecting the request for all
approvers at once, so Sue can react before her time limit expires.
This chapter covers the following procedures for processing approvals with the
Remedy User tool:
4-1
Processing an Approval Request
The following procedure outlines the basic steps for processing an approval
request. For information about additional approval actions you may need to
perform, refer to Performing Other Approval Actions on page 4-5.
Action
Buttons
4. From the Application list, select the application for which you are processing an
approval.
Note While most of the fields are optional, you must select an application before you click
the View Approvals action button.
Warning There is no undo when you respond to a request. Once you respond to a
request, you do not have any opportunity to change your mind.
If you do not want to respond with approval or rejection, you can ask for more
information, as shown in the following procedure.
3. In the To field, enter the name of the person from whom you want more
information.
4. In the Question field, enter your question or a description of the information you
need.
5. Click Save.
The Approval Status for the approval request automatically changes to reflect
your request for more information.
Note You cannot respond to a More Information request from a notification window.
3. Click Save.
To specify multiple approvers, separate each name with a semicolon (;). If you
choose to specify multiple approvers, determine the appropriate option for the If
Multiple Approvers field:
To allow the request to be approved by a single signature, select One Must Sign.
To require all specified approvers to sign for the request to be approved, select
All Must Sign.
To use the default process setting for multiple approvers, leave this field blank.
3. Click Save.
3. In the Alternate field, enter the name of the individual you want to designate as
an alternate.
4. In the Covering field, select the process for which you want the alternate to have
your signature authority.
To authorize all processes for which you have signature authority, select All.
To authorize a specific process, select Specific Processes, and then select a
process from the Process list. The drop-down list is not available until you
select Specific Processes.
Note Use this form to assign one alternate to one or all processes. If you want to
designate one alternate for multiple processes, but not all, you must repeat this procedure
for each process. If you want to designate multiple alternates for one process, repeat this
procedure for each alternate.
3. In the Current Approver field, enter the name of the person for whom you are
acting as the alternate approver.
Performing Overrides
If you have override capability for an approval process, you perform the same
steps to approve or reject the request as the original approver; however, you must
specify that you are performing an override. For conceptual information about
overrides, refer to Performing Overrides on page 3-7.
To specify an override in an approval process, perform the following steps.
This chapter covers the following procedures for processing approvals with
ARWeb.
Note The ARWeb interface allows approvers to process approval requests from a web
browser. Process Administrators must use Remedy Administrator and Remedy User to
configure approval processes and perform overrides.
5-1
Processing an Approval Request
The following procedure outlines the basic steps for processing an approval
request using ARWeb. For information about additional approval actions you
may need to perform, refer to Performing Other Approval Actions on page 5-6.
Warning Use only the Approval Web links and buttons to navigate within ARWeb. You can
log out of ARWeb unintentionally if you use the Back or Forward buttons of your web
browser.
3. Click a tab at the top of the main window to select an AR System application.
Approval Web displays the list of pending approval requests within that
application.
4. For each request, select the appropriate response: approve, reject, or no action.
5. Click Save when you have completed the entire page of requests.
You do not have to click Save after each response.
Warning There is no undo when you respond to a request. Once you respond to a
request, you do not have any opportunity to change your mind.
2. Click the Approve or Reject button to respond to the request, or if you make
changes to the request, click Submit to save your changes.
A Modify Results message appears to display result of your action.
Note You do not have to click Submit if you use the command pane to approve or reject the
displayed request.
3. In the To field, type the AR System login ID of the person you want to ask a
question.
4. In the Request field, type your question for this person.
5. Click Submit to save your More Information request.
The Approval Server routes your request to the person in the To field.
3. Click on your name for the More Information request you want to respond to.
The More Information request form opens.
3. In the Alternate field, type the AR System login name for the person to designate
as your alternate.
4. Use the Start Date and End Date fields to specify the time frame in which you
want the alternate to act on your behalf.
5. In the Covering field, select the process for which you want the alternate to have
your signature authority.
To authorize all processes for which you have signature authority, select All
from the pull-down menu.
To authorize a specific process, select Specific Processes from the pull-down
menu, and then select a process from the Process pull-down menu.
6. Select No from the Notify Alternate list if you want to prevent notifications from
being sent to the alternate for each new approval.
7. Click Submit to save your changes.
Click GO
to Act as an Alternate
Enter Login ID
of Alternate
3. In the Acting As field, type the AR System login name of the person for whom
you are acting as alternate.
4. If the radio button does not change, click the radio button to change from Myself
to Acting As.
5. Click Apply to log in as an alternate approver.
The welcome screen appears. You can now approve requests with the signature
authority of the person who designated you as alternate.
This chapter demonstrates how to use Get Agreement, one of the sample
applications bundled with the Approval Server.
Note The procedures in this chapter require sample users Frank Williams, Jack Miller,
Larry Goldstein, Violet Anderson, and Sue Smith to be licensed AR System login names. If
you find you cannot log in or write AR System records as the sample users, ask your
Approval Server process administrator to license the sample application login names.
6-1
Using a Sample Application
This sample application Get Agreement demonstrates an Ad Hoc process. Refer
to Ad Hoc - Approvers Choose Who Is Next on page 7-21 for the definition of
an Ad Hoc process type.
First we will use Get Agreement to request a new computer. Then we will log on
to the AR System Approval Server as different approvers to request and respond
to a More Information request, and to reassign the approval request. After all
approvers have approved the request, we will retrieve and examine the approved
form.
Approving a Request
This procedure demonstrates how an approver responds to a request. It requires
that you have completed the previous procedure, Requesting a New Computer.
1. Use Remedy User to log on as sample user Jack Miller.
2. Choose File Open All tab.
The list of forms appears.
3. From the list of forms, choose Approval Central, and click Search
4. The Approval Central form appears.
Note If you see a warning saying you do not have permission to write to certain fields, this
means Jack Miller is not a properly licensed AR System user. To continue with this
example, your AR System administrator must license the sample users.
7. Select the request I need a new computer from the Matching list.
The Detail Signature form appears for that request.
8. In the Approval Status field, select Approved from the menu list.
5. Type a question in the Question field. The exact words are not critical for this
example.
6. Type the name Violet Anderson in the To field.
A More Information request can be assigned to any valid AR System login name,
including the requester. For the purposes of this example, were asking for more
information from another approver.
7. Click Save to create the More Information request.
8. Click Cancel on the More Information dialog box to close that window.
9. Return to the Approval Central Form and click the View My Approvals button.
10. Notice the Approval Status field has changed from Pending to More Information.
For Larry Goldstein, the status of this request becomes More Information until
Larry changes it. However, for other approvers the status field displays Pending.
Note Larry could approve or reject the approval request without waiting for Violets
response to the More Information request. In this event Larrys More Information request
will be closed when Franks computer request is done, regardless whether the More
Information request was seen by Violet.
5. Type a response to the More Information request in the Response field. The exact
wording is not critical to this example.
If Violet wants to review Franks original request, she could click the button Open
Related to display it.
6. Click Save to make your changes permanent.
7. Refresh the list of matching forms.
The More Information Request is no longer visible to Violet after she responds to
it.
Note The Manage My More Information button on Approval Central displays questions for
you. Questions for others to answer are displayed with the Manage More Information
button on the Detail Signature form for the associated request.
4. Double-click the request I need a new computer from the Matching list.
Note The Manage More Information button displays all associated More Information
requests, regardless who created or answered them. Clicking the Manage My More
Information button on Approval Central displays questions for you to answer.
Summary of Sample
The procedures in this chapter demonstrated how to respond to an approval
request, as well as how to create and respond to a More Information request. You
also learned how to reassign a request to another person when that option is
available.
Notifications
7-1
The Process Administrator
A Process Administrator is an AR System user with the authority to define an
approval process for others to use. The first Process Administrator must be set up
by the AR System administrator, but others can be set up by an existing Process
Administrator.
The Process Administrator is a more powerful authority than the signature
authorities (approvers) who actually sign off for approval requests. As a Process
Administrator, you perform three major tasks, and determine who can share each
responsibility with you.
Approval Data
The most important data generated by an approval request consists of the
signatures of every person who approves or rejects the request. Other data useful
for an audit trail includes More Information requests and specific dates and
times for each activity. The Approval Server collects this information on a Detail
record for each request.
Detail Record
All data about the approval are held in the Detail record. The Approval Server
stores data about who authorized or rejected a request using the AP:Detail form.
You can use this form to determine the status of a request, and see a history of
activity on the request for a given approval process. The AP:Detail form captures
and displays the essential data of every authorization and rejection generated by
an approval process.
Supporting Records
A number of supporting forms store and display information regarding each
approval request.
AP:Signature stores and displays the data regarding the signatures collected in
the approval process.
AP:More Information stores and displays the response should an approver ask
for additional information before approving or rejecting a request.
Approval Process
When a group of employees needs to sign off on somethinga birthday card for
another employee, for exampleyou must make sure every appropriate
employee has a chance to sign the card, and that the card is delivered afterwards.
Workers route approvals such as this birthday card without conscious thought
to the rules for routing it. Yet there are rules in place. Usually it does not matter
what order people sign the card, but it would be inappropriate to request a
second signature from someone who has already signed. Additionally, no one is
usually required to sign a birthday card. And finally, it is inappropriate to request a
signature from the person with the birthday!
Processes abide by rules such as these without anyone thinking of them as rules.
However, the Process Administrator setting up a business process must
determine and implement all the rules.
Note The difference between complete and done is important. When a request is
complete, this means that it has been routed to all approvers. Even when routing is
complete, all required approvers have not necessarily responded. The request is not done
until all approvers have approved or rejected the request.
Sue has a purchase order which has to be approved by two committee members, Samantha
and Ned, in no particular order. Sue makes two photocopies and puts one in each of the
approvers mailboxes. The approval process is complete at this point. No more routing
actions need to occur. All approvers have received Sues request.
However, Sues request is still active. Until Samantha and Ned have responded, the
approval process for Sues purchase order is not done.
The Approval Server uses rules to determine the exact sequence of events to
process an approval request. As Process Administrator, you should have some
background on the types of rules available before you attempt to create your own
approval processes.
If a rule says everyone in your company can be reimbursed for a business lunch up to $40,
and Frank requests approval for a $25 lunch, this scenario would trigger an auto approval
condition. Since it does not matter who is asking as long as the amount is less than $40, this
companys auto approval rule automatically approves Franks request for his $25 lunch.
When auto approval occurs, the request is done, and routed back to the requester.
Note There is a third type of Get Authority rule, called Get Authority Regular, that is
performed only during Completion processing. Refer to Get Authority Regular Rules on
page 7-14 for a discussion of Get Authority Regular rules.
The information collected by your Get Authority rules is used by Self Approval
rules in the next operation of the Self Check.
Self Approval Rules The Self Approval check is completed when it executes
Self Approval rules. Data collected earlier under the Get Authority rules are
tested under Self Approval rules. The result of this test determines whether the
requester has sufficient authority to complete the request.
When Self Approval occurs, the request is done, and routed back to the requester.
If Frank requests approval for a $50 business lunch, a $40 auto approval rule does not
occur. After failing the auto approval test, the Self Check continues with a Get Authority or
Get Authority Self rule to collect Franks employee status, as a permanent employee who
has authority to approve lunches up to $100. The Self Approval rule then tests whether
Frank-the-permanent-employee has authority to approve his own $50 lunch.
To summarize, the Self Check tests a request using Auto Approval and Self
Approval rules. If the rules test successfully, the request is done, and the
approved workflow is returned to the requester.
Imagine your company allows any manager to approve a business lunch for up to $100. As
Process Administrator, you would set up a manager role within the Approval Server and
attach the names of all your managers to that role. Then when Frank requests approval for
a $75 lunch, the request can be approved by any individual assigned to the manager role.
Franks actual manager Jack can approve the request, or any of Jacks peers can do so, as
long as they have the role of manager assigned within the Approval Server.
Alternately, if your company requires a lunch request above $100 to be approved by only
the individual who supervises the requester, you can set up the process so only Jack,
Franks direct supervisor, is allowed to approve Franks $150 request. In this case, the
individual Jack has a specific relationship with Frank, and this relationship is set up within
the Approval Server.
The relationships and roles held by individuals determine the valid Approver List
for any given process. With a valid Approver List, you can set up rules to find
them. These rules, called Get Next Approver rules, are discussed in the next
section.
Note If you are familiar with AR System workflow, consider that a set field action occurs
with Prep Get Next Approver rules. Values are placed in certain fields, but nothing acts
upon these values yet.
Get Next Approver rules These rules route requests to the next valid
approver. When the Process Administrator sets up an approval process, he or she
determines a list of valid approvers. Get Next Approver rules determine who is
next in the Approver List and creates signature lines for the people found.
Note An Ad Hoc process type, discussed in Approval Process Types on page 7-17,
should not be confused with the Ad Hoc override described here. Ad Hoc overrides allow
specific approvers an option to alter a predetermined routing. In an Ad Hoc process, there
is no predetermined routing, and the current approver must always select the next
approver.
Note As Process Administrator, you should set up notifications to indicate when a request
is waiting for an approver, and when an erroneous Ad Hoc selection is waiting for
correction.
Hold
When an approver places a request on hold, the Approval Server identifies the
approval request with a Hold status, but no other action occurs within the
approval processing. Process Administrators should establish escalations to
prevent requests in Hold status from being neglected indefinitely.
Figure 7-4 Approvers Have an Option to Pause and Ask for More Information
Reject
If the approver rejects a request, the request moves to the Process Done stage, as
described in Process Done Rules on page 7-15. No more routing occurs, and it is
withdrawn from approvers who have it on hold or requested More Information.
Approve
When an approver approves a request, the Approval Server processes the request
against the Routing Completion Check, discussed in the next section.
When Jack approves a business expense for $100, a Completion Check determines whether
Jack has sufficient authority for that amount, for $100. If Jack can authorize that amount,
the process passes the Completion Check. If Jack does not have such authority, then the
Completion Check fails, and the routing of this request continues to another approver.
It is important to construct your processes such that the Approval Server does not
run out of approvers before the Completion Check has routed the request to a
person with sufficient authority. For example, if you have a process to handle
expenses up to $1000, it is important that the Approver List includes an
individual or role with sufficient authority to sign for that amount. Otherwise
your process will generate an error when it runs out of approvers without finding
someone who can authorize a $1000 expense.
However, some processes are designed to run out of approvers. A process which
requires a fixed number of signatures will complete successfully when the process
exhausts the Approver List. For example, you can create a process that completes
routing when any five approvers respond, instead of completing with one
approver of a specific authority.
Get Authority
The Completion Check has Get Authority rules to collect information as
discussed in Self Check Rules - Preventing Unnecessary Routing on page 7-7.
Imagine a different process that ignores dollar amounts, and instead requires the sign off
from two steps up the chain of command, so Frank needs both his manager Jack, plus
Jacks manager Larry to approve Franks business lunch request. When Frank gets his two
signatures, no more approvers are required, so the process is complete.
Chained Processes
By chaining processes, you can initiate a new approval process automatically
when the first is done. For example, if a manager approves a new computer
purchase, the MIS department can start another chained approval process that
determines the exact model of computer to buy.
Note Process Administrators should ensure a chained process starts only when the first
process returns an appropriate result.
Figure 7-6
The next section shows how the Approval Server assembles these concepts into
four process types, useful for various business practices.
Imagine that both marketing and engineering need to approve each product change. Using
Parent Child processes, there would be two parallel approval hierarchies, in which market-
ing approvers send the request to their marketing managers, and the engineering approv-
ers send the request up the engineering chain of command.
The important factor to notice is the hierarchical relationship between approvers. The Par-
ent Child process ensures that persons X will never see this approval request. Persons X do
not have parent relationships with anyone on the departmental hierarchies.
This approval process consists of two Parent Child hierarchies to illustrate flexibility. As a
secondary benefit, the Approval Server can route a request simultaneously within both
departmental hierarchies. Neither department has to delay until the other has finished
routing the request.
Whether in a single or parallel Parent Child process, a rejection from any given
approver could reject the request for everyone. Process Administrators should set
up notifications to inform each hierarchy when a parallel hierarchy has rejected a
request.
When you use a Parent Child process for approval requests, be aware of the
following considerations:
Imagine Frank wants to announce a new product at a New England trade show, and to do
this he needs approval from any project manager and at least one division manger.
Although Frank is in the West Coast Division, a Level process would permit any one
project manager to approve, Wester, Central or Eastern. Likewise a Level process would
pass the request to all three division managers for one to sign off. The order in which the
approvers see the request is defined by level, and there is no requirement that Frank has a
relationship with any approver.
None of the committees reports to another, nor si there any fixed relationship, but the order
in which the committees see the request is defined by the Level process.
A Level process does not dictate the number of approvers on each level, nor how
many signatures must be gathered within a given level. You could set up a level
consisting of one person, or many. The approvers for a given level can be made up
of individuals or roles. You can set up routing to the next level to require only one
approval, to require signatures from any number of individuals on a given level.
Unlike Parent Child, Level processes are not concerned with relationships. A
Level process is concerned only with the order in which the approvals are
generated. In a Level process, a request must be approved within each level
before it passes to the next level, in order.
A Level process uses a level value to indicate the position of individuals or roles.
The value in the level field is used by the Approval Server to determine an
approval sequence, starting with Level 0, with 1000 as the highest level. The
Approval Server skips over any unused levels when it proceeds to a new level
value.
When you use a Level process for approval requests, be aware of the following
considerations:
A Level process requires a rule defining how to find the next approver. This
rule must return two values: a level indicator, and a string of individuals or
roles. Working with Get Next Approver Rules on page 10-12 provides
additional information and specific procedures for defining this type of rule.
An Ad Hoc process gives routing authority to each approver without requiring the
Process Administrator to set permissions for every individual or role. Ad Hoc
overrides are appropriate when specific people should have the option to route a
request, overriding an otherwise fixed process.
Note Each approver in an Ad Hoc process must enter the exact AR System login ID of the
next approver. Process Administrators can prevent errors due to typos if your AR System
administrator constructs menu lists containing the appropriate Ad Hoc approvers.
Notifications 7-25
7-26 Chapter 7 The Process Administrators Guide
8 Working with the Approval
Server Chapter
Where to Go Next
8-1
Using the Approval Administration Interface
The AP:Administration form is the main form for managing and configuring the
Approval Server. With this form Process Administrators create or configure
processes, rules, notifications, roles, forms, Process Administrators, or alternates.
You can also configure the server settings and rename forms and processes from
the Approval menu when the AP:Administration form is displayed.
Note To access the AP:Administration form, you must be an Approval Server Process
Administrator, or an AR System administrator. Refer to Setting Up Administrator
Capabilities on page 8-6 for information about creating the first Process Administrator.
Note For components other than Role and Form, you can first select a value in the For
Process field. This limits the list of items displayed to those associated with the selected
process.
3. Select the Process option button to change a process name, or the Form option
button to change a form name.
4. Select an item to rename from the From Old Name menu list.
5. Enter a new name for the process or form in the To New Name field.
Warning: If you renamed a process manually instead of using the Rename dialog box, the
Rename command wont change names of attached rules. You must restore the process
name manually and then rename the process to rename the attached rules.
Note If you have already manually changed the process or form name, you can deselect
this option and only the Approval Server references are updated. Type the original name in
the From Old Name field, and in the To New Name field, type the one you have already
manually changed.
2. Select the Approval option button if you want the Approval Server to generate a
log of approval activity.
Debug mode is an optional field. The log is a text file.
3. If you activated the preceding option button, type a system path for the debug log
file.
Log File Name is an optional field. It is required if the Debug Mode option button
is activated, but otherwise ignored.
4. Type a number in the Definition Check interval field.
This is the number of seconds before the Approval Server checks for changes to
process definitions.
A larger number increases AR System performance.
A smaller number is useful while creating and testing a process.
Note The first Process Administrator must be set up with Full Admin capabilities by an
AR System Administrator. Subsequent Process Administrators can be set up by this
Process Administrator or by any subsequently defined full admin capable Process
Administrator.
Note This user must be defined as a member of the group Approval Admin, ID 402, in the
User form for this AR System server before the settings you make here will take effect.
4. Select Full Admin or Override Only Admin from the Authority menu list.
Full Admingrants this user the ability to modify processes as well as the
ability to approve or reject a request regardless of the normal process.
Override Only Admingrants this user the ability to approve or reject a
request regardless of the normal process.
5. Select one of the four following options from the Notify Method menu list.
NoneNo message is sent.
NotifierUsers are notified when they run Remedy Notifier. For more
information about Remedy Notifier, see the AR System Server Administrators
Guide.
EmailUsers are notified through email. If the contents of the Send To field do
not match an existing user or group definition, the system interprets the field
contents as a literal address and sends the notification to that address by SMTP
mail (UNIX) or MS-Exchange (Windows NT). When you use this option, it is
possible to send notifications to users not using the AR System, an alias for a
group, or an email address representing a program.
User DefaultUsers are notified using the default notification method defined
in their User record. If the User record does not contain a default notification
method, Remedy Notifier is used.
6. Select Active from the Status field menu list.
The Status field allows you to disable administrator capabilities for a specific
individual without the need to delete and re-enter information for the same
individual should it be needed later.
Warning: Activating events on this form does not guarantee that this event will generate a
notification or escalation. However, if you do not activate an event on this form, all other
notification and escalation settings are ignored for that event.
6. Select one of the following Notify On options from the menu list. This option
specifies the approval cycle event that triggers the notification.
9. Select one of the following notification options for the Method field:
Notification Description
None Send no notification.
Notifier Users are notified when they run Remedy Notifier. For
more information about Remedy Notifier, see the
Remedy User online help.
Email Users are notified by email. If the contents of the Send To
field do not match an existing user or group definition,
the system interprets the field contents as a literal
address and sends the notification to that address by
SMTP mail (UNIX) or MS-Exchange (Windows NT).
When you use this option, it is possible to send
notifications to users not using the AR System, an alias
for a group, or an email address representing a program.
User Default Users are notified by the default notification method
defined in their User record. If the User record does not
contain a default notification method, Remedy Notifier
is used.
Send To Target
Notify List Send to the default notify list for the selected Notify On
option.
Other Specify an individual, a role, a list of individuals, or
roles, or a field reference to a field containing
individuals or roles.
11. If email or User Default is the message delivery method, enter a subject line for
the notification message.
You can use the field list button to include field values in the subject line.
12. To attach additional field information to the notification, enter or select the field
names in the Additional Fields text box.
13. Enter a text message in the Message field.
You can use the field list button to include field values in the Message field.
14. Click Apply to save your changes.
4. In the Tag field, use the menu list to select an existing workday schedule or type
in a new name.
5. Modify the Open Time and Close Time fields, as appropriate for your company.
6. Click Apply to save your changes.
4. In the Tag field use the menu list to select an existing holiday schedule or type in a
new name.
Where to Go Next
Setting up Processes, Rules, and Roles are covered in separate chapters:
Chapter 9, Defining an Approval Process
Chapter 10, Defining Approval Rules
Chapter 11, Managing Users and Roles
This chapter describes the procedures for using Remedy User to create and
modify approval processes.
Creating a Process
9-1
Using the Process Definition Form
Use the AP:Process Definition form to create and modify approval processes.
This form contains multiple sections for defining the process:
Process DefinitionFor basic information about the process, such as process
name, application, type, and approval success criteria.
Signature EscalationsFor scheduling notifications when approval requests
are awaiting action. This section includes the following subsections: Normal
Priority Notification, Urgent Priority Notification, and Low Priority
Notification.
More Information EscalationsFor scheduling notifications when an
approval request is in the More Information state.
Administrative InformationFor displaying assignment, help text, and
change history.
Creating a Process
This section describes how to create a process using the Process Definition form.
In most cases, you need only one process for your approval request, but it is
possible to create multiple processes.
Use the following procedures to create an approval process. Each of the tabs on
the AP:Process Definition form is described in a separate procedure. You may not
need to follow all of the procedures, depending on how you decide to define your
approval process.
Note Applications must be entered in the Form tab of AP:Form to be available in the
Application pull-down list.
No More Use this value to indicate that the Approval Server should
Approvers consider the approval process finished when all signature lines
are complete. (A completion rule can also be used to end the
process.)
Completion Use this value to indicate that the Approval Server should
Rule expect a Completion rule to determine the successful
completion of the approval process. If you select this option,
you must create a Completion rule and associate it with this
process or the process will never complete.
All Must Sign Use this value to create a separate signature line for each
approver on the approver list.
If an approver list includes roles, the If Multiple Approver
setting for the specific role determines whether the role is
expanded into individual signature-line records for each
member of the role or a single signature-line record is created
for the entire role. See Defining Roles on page 11-2 for more
information on the If Multiple Approver setting for roles.
Allow Only One Use this value to create a single signature line for one
Approver individual.
If you specify multiple names the Approval Server returns an
error.
Anyone Allows anyone to specify the next approver. This includes the
requester and approver.
Approver Allows only the approver and not the submitter to specify the
next approver.
Note If you are creating an Ad Hoc process, the Allow Ad Hoc Next Approver field does not
apply.
10. From the Request Owner Field menu list, select the field identifying the owner of
the approval request.
11. From the First Approver field menu list, select the field identifying the first
approver.
If the process is an Ad Hoc process or if you specified Anyone for the Allow Ad
Hoc Next Approver, then you must specify a field to contain an initial approver
value.
12. From the Require Password list, indicate whether approvers must enter their
password when acting upon an approval request.
Use the Validate Approvers menu list to specify whether an entry in your Next
Approver List field on the approval request must be verified at the time of entry
with a Validate Approver rule.
13. From the For Self Assignment field, specify how the Approval Server determines
the next approver when the requester is not the person who submitted the
approval request. For example, when an assistant enters an approval request for
someone else. The options are.
Use Get Next To use a Get Next Approver rule to determine the first
Approver Rules approver.
Assign To Owner If To use the requester as the first approver if the requester
Approver is defined as a valid approver within the Approval Server.
If you select this option, you must define a Validate
Approver rule to verify whether the owner is a valid
approver.
Always Assign To To use the requester as the first approver in all cases.
Owner
Note If you do not enter parameters for either urgent or low priority notifications, the
parameters you enter for normal priority are used. You can use the urgent or low priority
sections to enter only parameters that are different than those you set for normal priority.
4. Enter the names of the Workday Schedule and the Holiday Schedule you want to
use for signature escalation notifications.
These names must match existing schedule names from the Business Time
Workdays or Business Time Holidays forms. Refer to Configuring Business
Times on page 8-16 for information about setting up business times.
3. Enter the names of the Workday Schedule and the Holiday Schedule you want to
use for More Information Escalation notifications.
These names must match existing schedule names from the Business Time
Workdays or Business Time Holidays forms. Refer to Configuring Business
Times on page 8-16 for information about setting up business times.
4. If you want to send notifications when a signature line has been outstanding (in
any state) for too long, specify the Notifications: Still Outstanding parameters:
a. Enter a number in the First Interval field to indicate when you want the first
notification sent, and select what this number represents for the Unit list.
For example, if you want the first notification sent two days after the approval
request enters the More Information state, enter a 2 in the First Interval field
and select Day from the Unit list.
b. If you want a second notification, enter a number in the Repeat Interval field
and select what this number represents from the Unit list.
5. Click Save to save your process.
Modifying Processes
Follow these steps to modify an existing process.
Modifying a Process
1. Open the AP:Administration form.
See Using the Approval Administration Interface on page 8-2 for the procedure.
2. Select the Process Definition tab.
3. Double-click the process you want to modify or select the process and click the
Open button.
The Process Definition form appears (Figure 9-4).
Note The delete operation is permanent and cannot be undone. When you delete a
process, all of the associated rules are deactivated.
Deleting Processes
1. Open the AP:Administration form.
See Using the Approval Administration Interface on page 8-2 for the procedure.
2. Select the Process tab.
3. Select the process you want to delete.
4. Click Delete.
5. Verify the name of the process and click Yes to delete this approval process.
The process is deleted and longer appears in the list of processes.
Note The Admin menu appears only when the AP:Administration form is open.
5. Select the appropriate Rename option button.
Form renames only the form.
Process renames the process, forms, and cross references.
6. Select the old proces name from the menu list in the From Old Name field.
7. Enter a new process name or select one from the menu list in the To New Name
field.
8. Select the appropriate Update option button.
All renames both closed and current AP:Detail records.
Only Active Objects renames only current AP:Detail records.
This option button setting determines whether the closed AP:Detail records are
renamed. All structured definitions and current AP:Detail are renamed for either
setting.
This chapter describes how to use Remedy User to create and modify approval
rules.
10-1
The Rule Definition Form
The AP:Rules Definition form consists of three tabbed views (depending on the
type of rule):
BasicFor identifying information about the rule and, depending on the rule
type, a qualification statement.
Set FieldsFor specifying the action to be executed by the rule if a transaction
passes the qualification statement.
Administrative InformationFor reviewing assignment, help text, and change
history.
Creating a Rule
1. Open the AP:Administration form.
See Using the Approval Administration Interface on page 8-2 for the procedure.
2. Click the Rule tab and click the Create button.
The AP:Rule Definition form appears.
Other Allows you to specify an Action Request filter. See the Action
Request System Workflow Administrators Guide for more
information on filters.
This example illustrates the Query assignment type allowing you to define a
query to another form to retrieve additional data.
Note Auto-Approval rules cannot use values retrieved from other forms, such as a persons
authorization limit or job title. See Working with Self-Approval Rules on page 10-7 for
information on defining another type of rule that creates an automatic approval function.
Self-Approval rules, in conjunction with Get Authority or Get Authority Self rules, can base
approval on a value retrieved from another form.
In this example, the value in the approval request Total field is tested to see if it is
less than $15. In addition, if this rule passes, the customized audit trail message,
as shown in the Audit Trail Text box, is written to the audit log.
Note See Working with Get Authority Rules on page 10-20 or Working with Get
Authority Self Rules on page 10-25 for the procedures on creating rules to retrieve values
for temporary fields.
In addition to the rule condition action, this sample rule includes a customized
audit trail message to be written to the audit log in the event that the rule passes.
2. Enter a name for the rule (or update the existing name if necessary) in the Rule
Name field.
Rule names must be unique. There is no enforced convention for specifying rule
names, but it is helpful to make the name descriptive and indicative of the rule
function. Names can be as many as 30 characters, including spaces.
3. Select the process name from the For Process menu list.
All rules must be attached to a process in order to be active.
4. Select Prep Next Approver in the Rule Type field.
5. Select a rule status from the Status field menu list.
Select either Active or Inactive to indicate the status of the rule. While you are
developing a set of rules for a process, it may be helpful to use the Inactive status
and then later activate the rules when you have completed all the necessary rules.
6. Type an execution order number in the Order field.
This number determines the sequence if you have two or more Prep Next
Approver rules.
7. Enter the rule condition in the Run If text box.
9. Select a value from the Set Fields Type field menu list to indicate the Set Field
action assignment.
See Using the Set Fields Tab on the Rule Definition Form on page 10-4 for a
description of the available choices.
10. If appropriate, select a form name from the From Form field menu list.
This value indicates where the rule should search for a matching approver name
to validate the user entry.
11. If appropriate, select a value from the On Server field menu list to indicate the
form resides on a different server.
Current Select to indicate the form resides on the current server.
Note When the Approval Server creates a first approver list, it is assuming that the
previous level was -1. Therefore, finding the first level means finding the level with the
lowest number.
The Approval Server keeps track of the current approver level of each approval
request as it goes through the approval cycle.
When defining a Get Next Approver rule for a level process, be aware of the
following considerations:
You must identify the field containing the level identifier.
If you define a qualification that includes a clause to retrieve only entries with
a level greater than the current level, you save processing time by allowing the
Approval Server to skip over individuals or roles in the previous levels. This
type of clause is not required, as previous level entries are simply ignored if
they are retrieved.
Value from first Uses the value from the first record retrieved.
Return error Returns an error message if more than one record is retrieved.
One must sign A single signature-line record is created and only one of the
approvers listed in the record is required to act upon the
approval request to consider the record complete.
All must sign A separate signature-line record is created for each individual in
the approver list, including individuals within a role. These
require all of the approvers retrieved by the Get Next Approver
rule to act upon the approval request.
9. Select a value from the Next Approver Rule Is field menu list.
The value in this field determines how retrieved data is treated, with regards to
the current approver list, when there are multiple Get Next Approver rules.
Additive Select to indicate that anything this rule assigns to the approver
list is added to the existing approver list, and further rules are to
be processed.
Ending Select to indicate that anything this rule assigns to the approver
list is added to the existing approver list, but no further rules are
to be processed.
Exclusive Select to indicate that this rule assigns the entire approver list,
and no further rules are processed. In addition, if a previous rule
created an approver list, that list is ignored.
Defining the Set Fields Data for a Get Next Approver Rule
1. Open the Rule Definition form.
See The Rule Definition Form on page 10-2 for the procedure.
2. Click the Set Fields tab on the Rules Definition form.
3. Select a value from the Set Fields Type field menu list to indicate the Set Field
action assignment.
See Using the Set Fields Tab on the Rule Definition Form on page 10-4 for a
description of the available choices.
4. Select a form name from the From Form field menu list.
This value indicates where the rule should search for a matching approver name
to validate the user entry.
Determines
number of
signature line
records created
Warning Approver names in Validate User rules are case sensitive. Ensure approver
names are entered correctly or your users will be unable to approve requests that are
assigned to them.
Qualification bar
Qualification bar
Qualification bar
Defining the Set Fields Data for a Get Authority Regular Rule
1. Open the Rule Definitions form.
See The Rule Definition Form on page 10-2 for the procedure.
2. Click the Set Fields tab on the AP:Rules Definition form.
3. Select a value from the Set Field Type field menu list.
The Set Field Type indicates the type of assignment to be used for the rule action.
See Using the Set Fields Tab on the Rule Definition Form on page 10-4 for a
description of choices available.
4. Select a form name from the From Form field menu list.
This value indicates where the rule should search for the requested data; for
example, the AP:Signature Authority form.
5. Select a value from the On Server field menu list to indicate the form location.
6. Enter a qualification statement to define the parameters for retrieving the
authority data.
For example, if you want to retrieve the current approvers signature authority
limit, you would define a qualification statement that sets $Approver$ (current
approver) to equal the Login Name (name of the person currently acting upon the
approval request).
7. Enter the name(s) of the fields to receive the data and the name(s) of the fields
where the data is located.
You can use the field list button to the right of each of these fields to select the
appropriate field names.
Qualification bar
Define the Set Fields Data for a Get Authority Self Rule
1. Open the Rule Definitions form.
See The Rule Definition Form on page 10-2 for the procedure.
2. Click the Set Fields tab on the AP:Rules Definition form.
3. Select a value from the Set Field Type field menu list.
The Set Field Type indicates the type of assignment to be used for the rule action.
See Using the Set Fields Tab on the Rule Definition Form on page 10-4 for a
description of available choices.
Qualification bar
Defining the Set Fields Data for an Approval Process Done Rule
1. Open the Rule Definitions form.
See The Rule Definition Form on page 10-2 for the procedure.
2. Click the Set Fields tab on the AP:Rules Definition form.
3. Select a value from the Set Field Type menu list.
Rule trigger
Modifying a Rule
1. Select the Rule tab on the AP:Administration form and click the Refresh button.
A list of rules appears in a Query List window, as shown in Figure 10-21.
Deleting Rules
Follow these steps to delete an existing rule.
Be aware of any rule dependencies before deleting a rule. For example, Self-
Approval and Completion rules may depend on a Get Authority, Get Authority
Regular, or Get Authority Self rule. If the Get Authority (Self and Regular) rule is
deleted, the dependent rule will no longer function as designed.
This chapter describes how to define user capabilities and roles for use by the
Approval Server in the approval process.
Defining Roles
11-1
Defining Roles
The following procedure takes you step-by-step through the fields on the AP:Role
form.
Defining a Role
1. Select Role on the AP:Administration form and click Create New.
Note See Using the Approval Administration Interface on page 8-2 to learn how to use
the AP:Administration form.
One Must Sign Use this value to create a single signature line record for the
role. The signature line is complete when one of the members
of the role acts upon the approval request.
All Must Sign Use this value to create a separate signature line for each
member of the role.
This option is overridden when the If Multiple Approver setting
for the process is defined as One must sign. When this is the
case, the role follows the One must sign action. See
Creating a Process on page 9-2 for more information on the If
Multiple Approver setting for processes.
Note If you include a role on the member list of another role, the If Multiple Approvers
option of the parent role, in some cases, takes precedence. For example, if Role A is
defined with If Multiple Approvers set to All must sign and you include Role A in the
member list of Role B, which is defined with If Multiple Approvers set to One must sign, the
settings for Role B are the ones used by the Approval Server.
Note Alternates must be licensed with change permissions. You should not make an
alternate of an individual who does not have this capability.
Defining an Alternate
1. Open a new AP:Alternate form. The AP:Alternate form appears.
Specific Use this option to authorize a user as alternate for one specific
Process process. The Process field becomes enabled so you can
specify which process this alternate is authorized for.
If this person is to be alternate for more than one process, you
must create a separate alternate record to authorize each
process.
Notifier Specified users are notified when they run the Action Request
Notification Tool. For more information about the Notification
Tool, see the Remedy User online help.
User Default The specified users are notified using the default notification
method defined in the User record. If the User record does not
contain a default notification method, the Notification Tool is
used.
All Use this option button to authorize a user as alternate for all
the processes of the person indicated in the For field.
Specific Use this option button to authorize a user as alternate for one
Process specific process. The Process field becomes enabled so you
can specify which process this alternate is authorized for.
If this person is to be alternate for more than one process, you
must create a separate alternate record to authorize each
process.
Note Although you do not have to be an AR System administrator to set up and manage
approval processes, you must be an AR System administrator to connect your application
to the Approval Server.
12-1
Connecting an Application to the Approval Server
Follow these steps to link your applications form to the Approval Server. The
examples in this chapter use xxx for the name of the application connected to the
Approval Server.
Usually you will link only the main form of your application to the Approval
Server. If your application has more than one form that needs to start an approval
process, you will need to join each form, as shown in steps 1 and 2.
4. Create an inner join between xxx and AP:Detail-Signature, with xxx as the
Primary form and AP:Detail-Signature as the secondary form.
a. Join Request ID field ID 1 of your form xxx to the Request field ID 10051 of
form AP:Detail-Signature.
b. Include all fields from xxx form and all fields from AP:Detail-Signature.
c. Double click the Status field ID 7 from AP:Detail. On the Display tab, change
the field access to Read/Write. Click the Database tab. Verify the number
13191 appears in the ID field.
d. Arrange the fields of this form with care.
Note You must run arjoinfix (UNIX) or arjoinfix.exe (Windows NT) on all forms
you create for use with the Approval Server. This executable modifies the join qualifications
to ensure your applications communicate properly with the Approval Server when you have
more than one application requiring approvals.
This program prompts you for the name of the form that you are linking to the approval
server, xxx in this example. It will then find the two joins that you have created and update
the join criteria to include the form name.
6. Launch Remedy User. On form AP:Administration click the Form tab and create
an entry for xxx, the form in your application that launches the approval process.
This registers and connects your application with the Approval Server so that the
AR System can process approvals appropriately with your applications
workflow. In order to perform this step, you must be a Process Administrator
with Full Admin authority for all processes (or an AR System Administrator).
Note These procedures require that you edit files in the web document directory of your
web server. You may need to get access permission from your web server administrator to
modify these files.
Note The web interface allows approvers to process approval requests from a web
browser. Process administrators must use Remedy User to configure approval processes
and perform overrides.
1. Use a text editor, such as Wordpad, to make the following three changes to the file
config.html located in this directory:
<web server document directory>/esapps/approval
a. Copy the contents of config.html.template into your config.html
file. Paste the contents immediately in front of the </script> tag in your
config.html file. Then edit the settings according to the comments
appearing in the file.
b. At the top of the file, add this line after a block of similar lines already present
in the file:
var xxx_Inst=top.xxx_Inst
The xxx prefix is your application name. It is the same prefix that is on the
first line of the template that you loaded in step a.
c. Search for the string portaloc. Review the comments before this line and
update the line as appropriate to identify your home location. This is the
location the system will go to whenever the Home link is selected on any of
the Approval Server pages. This setting is common to ALL applications that
are using the Approval environment.
2. Use a text editor, such as Wordpad, to open the file appstart.html located in
this directory:
<web server document directory>/esapps/approval
C:\ARWeb\forms\<your_computer_name>\<your_app_xxx>
The name of the directory is critical. You must give the directory the name of
your parent application (xxx) using special characters. This is the name of the
form directory that is created by ARWeb. It is the name of the form with
appropriate substitutions for special characters.
You can ensure the correct name by opening the form connected to the
Approval Server in ARWeb, and copying the name from the filename created
for that form. For example, AP%3aLunch+Request is the name of the sample
Lunch Request application, as shown in the sample application form:
apconfig[indset][3]='AP%3aLunch+Request';
h. Copy the modify.for.template file from the base forms directory, rename
it modifyfo.for, and save it in the directory you created in step g.
i. Find the line within the modify.for file that says,
<!_****Paste in ARWeb Form File Here (Remove This line)****-->
Warning If your application join form has non-alphanumeric characters in its name, you
should replace them with a lowercase letter x. For example, for a form named
HPD:Help Desk on server acme, the template would be named
acme_HPDxHelpxDesk_modifyfor.jsp.
Note The password setting is a global setting that affects all processes. Turn this off only if
NO processes require passwords. If any process requires the password, you need to leave
this setting on. The field will show on all lists. The user does not have to enter a password
unless the process requires a password validation.
1. Use a text editor, such as Wordpad, to open the file appstart.html located in
this directory:
<web server document directory>/esapps/approval
2. Add or edit the variable showpassword.
If you do not want the password field to appear in any Approval Server Web
application, add this line to the file:
showpassword=0
The password field will not be displayed. If you have a process that requires
password authentication, it cannot be used on the web.
This optional procedure is for users of ARWeb version 3.x. The following steps
describe how to allow approvers to view existing Diary data from the Comments
or Audit Trail fields.
1. Log in to the Remedy Administrator tool as AR System Administrator.
2. On the xxx-Detail-Signature form, copy your view to create a view named
webModify. On this view, make sure the fields from the AP:Detail form named
Comments Web and Audit Trail Web are in the view, but hidden.
3. Copy the active link AP-Sample:LoadDiaryOnDisplay filter. On the copy, change
the form to which the filter is attached to your xxx-Detail-Signature form.
4. In the custom modifyfo.for file you created (see earlier steps), find the
Comments field. It should appear similar to the following:
<TD VALIGN=top NOWRAP>Comments <textarea
onBlur=parent.blurHandler(this);
onKeyDown=parent.keyDown(event, this)
onChange='parent.onTextChangeHandler (this);' name=F13001F
wrap=virtual rows=3 cols=31>
Insert the contents of the file diary.for.template (in the same directory as the
modifyfo.for.template file) just before the word Comments. It is easiest if
you simply enter a return before the word comments and insert the file contents
on a separate line like the following:
<TD VALIGN=top NOWRAP>
Insert the contents of diary.for.template here.
Comments <textarea onBlur='parent.blurHandler(this);'
onKeyDown='parent.keyDown(event, this)'
onChange='parent.onTextChangeHandler (this);' name=F13001F
wrap=virtual rows=3 cols=31>
Note You can review the sample applications for examples of these edits.
This chapter highlights features, in the sample application Lunch Scheduler, that
you can use in your own approval processes.
Key Forms
Special Techniques
Sample Users
13-1
Overview of Lunch Scheduler
The Lunch Scheduler application is designed to schedule customer lunches for
employees of an imaginary company.
The requester specifies information about the customer, the restaurant, and the
number of attendees. These choices populate fields containing details about the
total costs and some information about the customer and the customers current
state with the company. When a request is entered, it is routed for approval.
Lunch Scheduler includes three different approval processes chained together:
Management Cost Authorization is a managerial approval based on the total
cost of the lunch. The request is routed along the management chain until a
manager with sufficient dollar authority approves.
Major Account Level Approval is a review by the major and enterprise account
teams if the account is a major or enterprise account.
Special Overdue Approval is a special review if the account is currently
overdue. The company has decided that taking a customer to lunch who is
currently overdue needs special permission.
Requests are submitted, go through the appropriate approval processes
enforcing the business rules of the companyand when approved, provide a
record of the business lunch activity at the company.
Key Forms
This section lists the major forms associated with the Lunch Scheduler
application.
Note You must run arjoinfix (UNIX) or ARJOINFIX.EXE (Windows NT) on all forms
you create for use with the Approval Server. This executable modifies the join qualifications
to ensure your applications communicate properly with the Approval Server when you have
more than one application requiring approvals.
AP-Sample:Lunch Scheduler
This is the base form of the application. It is the form that the lunch requests are
entered into and the form that approvals are tied to.
AP-Sample:Lunch-Detail-Signatu
This is the inner join between the AP-Sample:Lunch Scheduler and the AP:Detail-
Signature forms. This is the main working form for approvers who are approving
lunch requests. The join criteria is Request ID to Request.
AP-Sample:Company
This is a supporting form where companies and information about them is
entered. The data here drives menus and settings about the companies.
AP-Sample:Restaurant
This is a supporting form where restaurants and information about them is
entered. The data here drives menus and settings about the restaurants.
AP-Sample:Signature Authority
This is a supporting form where approvers and information about them is
entered. Information about managers is used to drive advancement along the
management chain. Information about their signature authority determines when
someone has sufficient authority to be the last person needing to sign. Account
Approval Level indicates whether someone is on the major or enterprise account
team and involved in the second stage approval process.
AP-Sample:Lunch-Detail 13-3
Management Cost Authorization
This approval process runs first and acts on every request. This process is an
example of the Parent Child process type, with Auto Approval and Self
Approval rules. If requesters do not have authority, then the approval process
routes requests to their managers as identified in the AP:Signature Authority
form. The system continues to route to subsequent managers until a manager
with sufficient authority signs the request. If no one with sufficient authority can
be found for an individual, or if an individual has no manager, the process
terminates with an error.
The Management Cost Authorization process is launched by the filter AP-
Sample:StartCostApproval. The command within the filter is shown here:
Application-Command Approval New-Details -T
ManagementCostAuthorization
The tag argument identifies the process to run. Refer to New-Details on
page C-6 for more information on this Approval Server command.
In Lunch Scheduler, the status field is a character field named Approval Workspace, ID
536870920. This field is loaded with a string to represent the current state of the flow
through the three chained approval processes.
Note The Approval Workspace field is updated with a setting to indicate success of the
Major Account Level Approval process even when there is no action to be taken on the level
process. It is important that the process be marked successful in this case, so that the test
for the next process can simply be for approved or not approved, without having to worry
about how it got to the approved state.
Special Techniques
This section introduces techniques that you may want to use in your own
approval processes. These techniques include:
More Information
Show Summary and Signatures
Show Password Field If Required
They detail how you can add a little more than the minimum needed to link your
application to the Approval Server, and get a richer integration with additional
capabilities for your users.
Rename
Active Link
Attach to Your
Form xxx
Sample Users
The Approval Server samples include records for a number of imaginary users
preconfigured for testing the Lunch Scheduler application.
Note The procedures in Chapter 6, Using a Sample Application, require sample users
Frank Williams, Jack Miller, Larry Goldstein, Violet Anderson, and Sue Smith to be licensed
AR System login names.
Change
Sample
Names to
Licensed
Users
Windows NT Installation
UNIX Installation
ARWeb Configuration
Where to Go Next
A-1
Installation Notes and Warnings
Warning Approval Server version 4 is incompatible with the version of Approval Server
bundled with certain Remedy applications. Do not install Approval Server version 4 on a
system with any of these Remedy applications:
Remedy Purchasing@Work 2.x, or earlier
General Notes
You must be an AR System Administrator to install this product.
You should obtain a license for the Approval Server before you install.
Otherwise you must reboot or manually start the service (Windows) or daemon
(UNIX).
Warning If your web server fails to display Approval Web pages, verify the ARWeb server
is configured so the ARWeb\ENU directory has execute permissions.
If you configured your web server as shown in Appendix D of the ARWeb 4.0 Installation
and Getting Started Guide, the permissions for the ARWeb\ENU directory are set to
script rather than execute.
4. Select the language for this installation from the pull-down menu and click OK.
5. Click Next.
The software license agreement appears.
7. Type this information into the appropriate fields and click Next.
A dialog box appears asking for the path to install the Remedy Approval Server.
10. Click Yes to install forms and workflow for two sample applications that
demonstrate Approval Server features.
If you have never used or configured the Approval Server, Remedy recommends
you install and examine the samples. Refer to Chapter 6, Using a Sample
Application, and Chapter 13, Implementing Sample Application Features, for
information regarding these applications.
Progress windows appear to display the status of the installation.
The installer begins transferring data.
The installer begins checking for conflicts, examining your system for previous
versions of the Approval Server.
Warning If you see a warning about new forms and workflow not matching the existing
ones, please verify that you do not have Remedy products installed that use an
incompatible version of the Approval Server. Refer to Installation Notes and Warnings on
page A-2 for a list of incompatible products.
If you see a message asking if you want to install new forms, click Yes to upgrade your
forms, or click No to use your old forms and preserve existing data.
The installer imports configuration data. This could take several minutes
depending on the speed of your machine.
If you install the sample forms the installer checks for a previous installation of
the sample applications. The installer does not delete old sample applications.
You have to delete them from within the AR System.
The installer starts the service required for the Approval Server.
3. Click the button for the Approval Web installer you prefer.
The top button installs Approval Web 3.x for ARWeb 3.x
The bottom button installs Approval Web 4.x for ARWeb 4.x
Warning Do not install both versions of Approval Web on the same server. This
configuration is not supported.
5. Click Next.
The software license agreement appears.
If you clicked Yes, you must type the number of the port and click Next.
A dialog box appears asking for the path to the directory where your web
documents are stored.
Warning Do not begin the URL with http:// and do not type a backslash at the end.
This is the URL that leads to the directory you selected in step 9. For example,
with a web server named acme, the fully qualified URL can appear similar to the
following:
acme.company.com
Note You must perform the following procedure for all UNIX servers before you install the
Approval Server.
If you install the Approval Server without setting the Public Group (0) to Change
privilege, approvers cannot change any fields except the Approval Status field. In
this situation you must delete all Approval Server forms and menus, perform this
procedure, and re-install the Approval Server.
Search for
Group ID 0
Verify
Change
Option
Is Set
4. Verify that the Change option is set for the Group Type field.
If this option is not set, click the control for Change and then click Save.
Note Proceed with the UNIX installation only after completing the procedure Preparing
UNIX Servers for the Approval Server on page A-18.
You do not need to quit any applications before running the installer.
Note If there is not enough disk space available, the installer displays a message asking
Do you want to try to install in <directory xxx> anyway?
Press Enter or type Y to proceed. Type N to return to the previous step.
Note If you do not install the Approval Server forms the Approval Server cannot function.
Answer No only if you are restoring the forms in another way.
ARWeb Configuration
Note These are web server settings, not file system permissions. Refer to the
documentation for your web server administration software for the exact procedure to
change web directory permissions.
Note The following procedures use example port number values. Your configuration can
use any port numbers that do not conflict with existing ports. You can discover your existing
ports in use with the command netstat -a (Windows) or rpcinfo -p (UNIX).
Note You must modify this file on each AR System server.to be used without portmapper.
Note You must modify this file on each AR System server.to be used without portmapper.
Note If you do not use Approval Web then skip the steps Configuring Approval Web
Without Portmapper, and Configuring ARWeb 4.x without Portmapper.
Warning The UNIX uninstallers reference other files relative to their own directories. Set
the current directory to the one in which the uninstaller executable resides.
Where to Go Next
Refer to Chapter 1, Understanding the Approval Process for basic Approval
Server concepts. Refer to Chapter 7, The Process Administrators Guide for
process administration concepts.
Refer to Chapter 6, Using a Sample Application for a demonstration of
acting as an approver using one of the sample applications. Refer to
Chapter 13, Implementing Sample Application Features for a demonstration
of process administration using one of the sample applications.
Refer to Chapter 12, Adding Approvals to Your Application for instructions
on how AR System administrators configure the Approval Server to work with
existing applications.
The worksheets in this appendix are intended to assist you in designing the
various components of Approval Server. Reproduce the worksheets as needed.
Process Worksheets
Rule Worksheets
B-1
Process Worksheets
The following process worksheets help you set up your process and escalations.
Defining a Process
More Information Escalations
Signature Escalations
Defining a Process
Use this worksheet to help you design a process.
Process Name
Process Type
Workday Schedule
Holiday Schedule
Global Notifications
Workday Schedule
Holiday Schedule
Automatic Action
Global Notifications
Workday Schedule
Holiday Schedule
Automatic Action
Global Notifications
Workday Schedule
Holiday Schedule
Automatic Action
Global Notifications
Purpose
Condition
Audit Trail
Message
Purpose
Run If
Statement
From Form
Qualification
Purpose
Run If
Statement
From Form
Qualification
Self-Approval Rules
Rule Name
Purpose
Condition
Audit Trail
Message
Purpose
Run If
From Form
Qualification
Purpose
Run If
Statement
From Form
Qualification
Purpose
Run If
Statement
From Form
Qualification
Purpose
Run If
Statement
From Form
Qualification
Completion Rules
Rule Name
Purpose
Condition
Purpose
From Form
To support close interaction between the AR System server and the Approval
Server, a special process, Application-Command, has been introduced. This
process can be run from filters, escalations, and active links using the Run
Process action.
Basic Information
C-1
Basic Information
The new process that has been introduced is Application-Command. This
command allows the specification of commands to be executed by an application.
There is a special form named Application Pending that is automatically created
and managed by the AR System Server. Whenever the Application-Command
process is run, a request is created in this form with details about the command
issued. The Approval Server process retrieves commands from this form for
processing.
This process uses the Run Process action. Although no actual process is run, it
follows all the rules and restrictions of a process. This means that you must be
sure to quote parameters with spaces just like you would for a traditional process.
In addition, it is a process that exists on the server. So, if you are performing an
operation from an active link, you must be sure to use the syntax that indicates
that the process should be run as a remote process on the server (versus on the
client).
The basic command format is:
Application-Command category command [-s form] [-e request-
id] [-t tag] [-1 field-1] [-2 field-2] [-3 field-3] [-o other-
string-<-255] [-l other-string-unlimited]
The category and command parameters are positional. The other parameters are
optional and can appear in any order after the two positional parameters.
The following list defines each parameter:
categoryA character string with a maximum of 30 characters that identifies
which application the command is for. For the Approval Server, this value is
always Approval.
commandA character string with a maximum of 30 characters that indicates
a specific operation to be performed within the category. Commands for the
Approval Server are defined in the next section.
formThe name of a form that the command is related to. If no form is
specified, this value defaults to the form the filter or active link is attached to.
request-idThe ID of the request that the command is related to. If the
request is a join form, the request ID string consists of the ID of each request
separated by a vertical bar, such as: 000000000012344|000000000084934.
tagA tag that is specific to the category and command. This might be a
further identifier for the operation. For example, for many approval commands,
the tag is the name of the approval process.
field-1The ID of a field or an integer code associated with the category or
command.
Example Command
This command would start the approval process named MyProcess against the current
entry:
Notice the quotes around the arguments. We suggest you always use quotes around
arguments to insure that they are processed correctly when they contain spaces.
Add-Sig
Add-Sig {-s form} {-e request-id} [-t process-name] {-o
approver-list} [-1 {0|1}] [-2 {0|1|2|999}]
This command adds an additional signature line to an existing approval request
(or creates a new approval request if there is not one) for the specified request.
The form and request that are being approved are required, because they identify
the request that is being processed.
The process-name parameter is optional. If it is supplied, the specified
approval process is activated. If it is not supplied, the system searches for a
process against the specified form. If there is only one process specified, that
process is used. If several processes are specified, an error is reported, and no
approval process starts.
The approver-list argument contains the approvers to add. If omitted, this
command performs no work. Multiple approvers are separated by a semicolon.
The 1 option indicates whether the new signature line is identified as
independent Yes or independent No, based on whether the value is set to 1
(no) or some other value (yes).
The 2 option indicates the action to take on multiple approvers. 0 (the default)
means one of, 1 means all of, 2 means only one, and 999 means to pull the
value from the process definition.
The operation of this command generally links to an existing approval details
record, although it creates one if none exists. It then adds one or more signature
lines for the value specified in the other option.
Det-Approved
Det-Approved {-s form} {-e request-id} [-t process-name]
This command marks the approval detail item Approved. Any outstanding
signature lines or More Information records are marked Closed. The Process
Det-Cancelled
Det-Cancelled {-s form} {-e request-id} [-t process-name]
This command stops an approval process that is in progress, marking the
approval detail item Cancelled. Any outstanding signature lines or More
Information records are marked Cancelled. The Process Done phase notifies the
associated request of the cancellation.
The form and request-id parameters identify the request that the detail record
is associated with.
The process-name parameter is optional. If it is supplied, only the detail record
tied to the associated process is updated. If it is not supplied, all detail records
from all processes associated with the record are updated.
Det-Error
Det-Error {-s form} {-e request-id} [-t process-name]
This command marks the approval detail item to be in error. Any outstanding
signature lines or More Information records are marked Closed. The Process
Done phase notifies the associated request of the error. This command is intended
only to be used internally by Approval Server.
The form and request-id parameters identify the request that the detail record
is associated with.
The process-name parameter is optional. If it is supplied, only the detail record
tied to the associated process is updated. If it is not supplied, all detail records
from all processes associated with the record are updated.
Det-Cancelled C-5
Det-Rejected
Det-Rejected {-s form} {-e request-id} [-t process-name]
This command marks the approval detail item Rejected. Any outstanding
signature lines or More Information records are marked Closed. The Process
Done phase notifies the associated request of the rejection. This command
corresponds to a rejection by global override.
The form and request-id parameters identify the request that the detail record
is associated with.
The process-name parameter is optional. If it is supplied, only the detail record
tied to the associated process is updated. If it is not supplied, all detail records
from all processes associated with the record are updated.
MoreInfo-Return
MoreInfo-Return [-s form] {-e request-id}
This command takes data from the specified More Information request and copies
the response back to the associated signature request. The More Information
request identified must be marked Completed.
The form parameter is optional. If it is supplied, it must be the More Information
form.
The request-id parameter is the ID of the More Information record.
New-Details
New-Details {-s form} {-e request-id} [-t process-name] [-1
priority]
This command starts the Approval Server process for the specified request.
The form and request to be approved are required because they identify the
request that is being processed.
The process-name parameter is optional. If it is supplied, the specified
approval process is activated. If it is not supplied, the system searches for a
process against the specified form. If there is only one process specified, that
process is used. If several processes are specified, an error is reported, and no
approval process starts.
The priority parameter is also optional. If supplied, it sets the priority to
Urgent (1), Normal (2), or Low (3). Any other setting is ignored, and the
defaultNormal (2)is applied.
The operation of this command creates an approval details record. It then
searches for auto- and self-approval rules; if one of them passes, it marks the
Rename-Form
Rename-Form {-t old-name} {-o new-name} [-1 only-active] [-2
do-rename]
This command changes the name of a form. All references in the definition forms
are updated.
If the only-active parameter is set to 1, only active entries are updated. Any
other setting causes all entries to be updated. This setting controls which
AP:Detail records are updated. All definition records are always updated.
If the do-rename parameter is set to 1, the form itself is renamed. Any other
setting assumes the form has already been renamed by using the Remedy
Administrator tool and you are simply updating cross-references.
Rename-Process
Rename-Process {-t old-name} {-o new-name} [-1 only-active]
[-2 do-rename]
This command changes the name of a process. All references in definition forms
are updated.
If the only-active parameter is set to 1, only active entries are updated. Any
other setting causes all entries to be updated. This setting controls which
AP:Detail records are updated. All definition records are always updated.
If the do-rename parameter is set to 1, the process itself is renamed. Any other
setting assumes the process has already been renamed by using the AP:Process
form and you are simply updating cross-references.
Sig-Approved
Sig-Approved [-s form] {-e request-id} [-t process-name]
This command performs approval processing on a signature line that has been
marked Approved. The rule process continues to the next approvers. This
command is issued when a signature line is changed to Approved.
The form parameter is optional. If supplied, it must be the AP:Signature form.
The request-id parameter is the ID of the signature entry.
Rename-Form C-7
The process-name parameter is optional. If supplied, it must match the process
specified by the detail record that is associated with the specified signature line.
Sig-Cancelled
Sig-Cancelled [-s form] {-e request-id} [-t process-name]
This command performs cancellation processing on a signature line that has been
marked Cancelled. The request can be in any active state (Pending, Hold, More
Information) for this operation to be performed. The signature line is cancelled
and appropriate moves within the process are performed, depending on whether
other signature lines are active.
The form parameter is optional. If supplied, it must be the AP:Signature form.
The request-id parameter is the ID of the signature entry.
The process-name parameter is optional. If supplied, it must match the process
specified by the detail record that is associated with the specified signature line.
Sig-Notify
Sig-Notify [-s form] {-e request-id} [-1 num-notifies]
This command causes a notification message to be sent, indicating that the
specified AP:Signature record has exceeded its defined time limit without being
resolved. The notification message is sent to the corresponding form-AP:Detail-
Signature join.
The form parameter is optional. If supplied, it must be the AP:Signature form.
The request-id parameter is the ID of an AP:Signature form request.
The num-notifies parameter indicates that this is the initial notification for a
value of 0 (the default) or that this is a repeat notification for any other value. This
triggers delivery of the notification or repeat notification message.
Sig-Notify-Change
Sig-Notify-Change [-s form] {-e entry-id}
This command causes a notification message to be sent, indicating that the
specified entry has been changed. The notification is sent to any approvers who
have previously approved the process that is indicated. The notification is
informational, to let previous approvers know of a change. The notification
message is sent to the corresponding form-AP:Detail-Signature join.
The form and entry-id parameters are required. They identify the entry that is
to be notified.
Sig-Notify-State
Sig-Notify-State [-s form] {-e request-id} [-1 num-notifies]
{-2 state} [-3 0|1]
This command causes a notification message to be sent, indicating that the
specified AP:Signature record has exceeded its defined time limit for a given state
without being resolved. The notification message is sent to the corresponding
form-AP:Detail-Signature join.
The form parameter is optional. If supplied, it must be the AP:Signature form.
The num-notifies parameter indicates that this is the initial notification for a
value of 0 (the default) or that this is a repeat notification for any other value. This
triggers delivery of the notification or repeat notification message.
The state parameter is the numeric value for the state the notification is for. It
can be set to 0 (Pending), 3 (Hold), 4 (More Information), or 6 (Error). Any other
setting will default to 0 (Pending).
Set the 3 parameter to 0 (the default) to indicate the notification is for an
escalation or 1 to indicate that the notification is simply a direct notification. Any
other value assumes the default.
Sig-Reassign
Sig-Reassign [-s form] {-e request-id} [-t process-name] {-o
short-list | -l long-list}
This command reassigns the signature line to another approver list by using
either the -o (for an approver list less than 255 characters) or -l option. The
signature line must be in an active state (Pending, Hold, or More Information) for
this operation to be performed.
The form parameter is optional. If supplied, it must be the AP:Signature form.
The process-name parameter is optional. If supplied, it must match the process
specified by the detail record that is associated with the specified signature line.
Sig-Notify-State C-9
Sig-Rejected
Sig-Rejected [-s form] {-e request-id} [-t process-name]
This command performs the rejection processing on a signature line that has been
marked Rejected. The process of marking the associated detail line Rejected is
performed. This command is issued when a signature line is changed to Rejected.
The form parameter is optional. If supplied, it must be the AP:Signature form.
The request-id parameter is the ID of the signature entry.
The process-name parameter is optional. If supplied, it must match the process
specified by the detail record that is associated with the specified signature line.
Update-Config
Update-Config {-t label} [-o value]
This command updates the administrative configuration settings for the
application.
The specific setting being updated is identified by the label parameter. This
label is defined in arstruct.h and is placed in the ar.cfg (ar.conf) file.
The value parameter can be omitted to cause the setting to be reset to its default
value or to a value in the appropriate format for the ar.cfg (ar.conf) file. The
Approval Server reacts immediately to changes in settings that are not start-up-
only.
For the approval notification option, no value resets all options to their default
value. Otherwise, only the option that is defined in the value parameter is reset.
For the debug mode, other debug options can be defined and, if they are, this
setting takes effect. However, if only a 0 or 65536 (the setting for approval
debugging) are set, only that flag is changed, and other settings remain as they are
in the file.
This appendix displays Approval Server forms and provides field descriptions. The
forms appear in alphabetical order.
Approval Central
AP:Administration
AP:Alternate
AP:Detail
AP:Detail-Signature
AP:Form
AP:More Information
AP:Notification
AP:Process Administrator
AP:Process Definition
AP:Reserved Word
AP:Role
AP:Rule Definition
AP:Signature
D-1
Approval Central
Approvers use this form as a launch pad to review their own approval requests
and More Information requests. All fields are optional except the Application
field.
Refer to Chapter 4, Processing Approval Requests with Remedy User for a
discussion of how to use this form.
Application Use the menu list to select the AR System application with
workflow to be approved. This is a required field when
searching for approvals.
Request Use this field to search for a specific approval request using its
AR System ID.
Approval Status Use the menu list to select a status for a search. Leave the field
empty to view all your approvals.
Acting As Use this option button to select the capacity you are acting in.
Myself means you are working as yourself.
User This is the name of the user you are acting as. This field is
ignored during global overrides.
Process Use the menu list to select a process from the application
selected in the Application field above.
My More Click this button to search for open More Information requests
Information that are awaiting your response.
Requests
Application Click this button to open a search window for the form specified
Approval in the Approver Reporting field in AP:Form.
Search
This button appears only when a form is defined in the
Approver Reporting field in AP:Form on page D-15.
AP:Administration
Process administrators use this form as a launch pad to create and modify records
that make up approval processes. Refer to Using the Approval Administration
Interface on page 8-2 for a discussion about using this form.
Refresh Click this button to have the AR System reload the displayed
list.
Search Click this button to open a search form for items of the category
determined by the current tab.
AP:Administration D-3
Delete Click this button to discard the currently selected item. It opens
the form that appears in AP:Admin-DeleteVerify on page D-4.
For Process Use the menu list to limit the display list to items associated
with the selected process. This field is not active for the Role
and Form categories.
Rename Click this button to open the form that appears in AP:Admin-
Rename on page D-5 to rename the currently selected item.
Process, Click a tab to display a list of items of that type. This also
Rule, selects which category of items is involved when you click the
Notification, buttons on this form.
Role,
Form,
Administrator,
Alternate
AP:Admin-DeleteVerify
This dialog box appears when a process administrator clicks the delete button on
the AP:Administrator form.
Yes Click this button to delete the item selected in the previous
form.
From Old Name Type a name or use the menu list to select an item to be
renamed.
To New Name Type the replacement name for the item in the From Old Name
field.
Including Click this option button to include the form or process you are
Object Itself renaming. Generally this option is on.
This is useful if you are renaming all references to the name of
an item that has been manually renamed previously.
Cancel Click this button to close the form with no action performed.
Note If you renamed a process manually instead of using the Rename dialog box, the
Rename command wont change names of attached rules. You must restore the process
name manually and then rename the entire process.
AP:Administration D-5
AP:Admin-ServerSettings
Process administrators use this form to change server settings regarding the
Approval Server. To open this form choose Approval menu Server Settings.
This custom menu appears when a process administrator views the
AP:Administrator form.
Debug Mode Click this option button to enable the Debug mode, which
creates entries in the log file.
Log Filename Type the directory path and file name in which to store log
entries for the Debug mode.
Reload Click this button to reload the form with previously stored
values.
Cancel Click this button to close the dialog box without saving
changes.
AP:Administration D-7
New Signature, On the Notification tab, click Enabled next to an event to have
Approve, the AR System issue a notification when such an event occurs.
Reject, Disabled means Approval Server disables notifications for
Alternate this event during an approval process.
Approve, Enabled means the Approval Server enables notifications
Alternate for the approver list when this event occurs during an
Reject, Override approval process.
Approve,
Enabled Including Alternate means the Approval Server
Override Reject,
enables notifications to approver list as well as all active
Close Approve,
alternates when this event occurs during an approval
Close Reject,
process.
Reassign, Error,
Cancel, More These option buttons do not guarantee notifications occur for
Info Return, an enabled event. These settings enable notification as
Reject by Later established elsewhere in the process rules.
Level, Cancel at
Later Level,
Reject by
Another
Approver, Hold,
More Info,
Change After
Approval
AP:Alternate
Approvers use this form to create, delete, and maintain alternates.
For Type the name of the person for whom the Alternate will
substitute.
AP:Alternate D-9
Process Enter the process for which the alternate has authority. Use the
menu list to ensure you select only a process that exists on this
server.
Start Date Click the calendar menu to select the date on which the
alternates authority begins.
End Date Click the calendar menu to select the date on which the
alternates authority ends.
Notify Alternate Use the menu list to select whether the alternate is notified
when a request comes to the original approver.
Yes notifies the alternate when a request is pending.
Last Modified The AR System populates this field with the name of the
person who last modified this alternate.
Help Text Type information to aid users who are setting up alternates.
Create Date The AR System populates this field with the date this alternate
was created.
Modified Date The AR System populates this field with the date of the last
modification to this alternate.
AP:Detail
Process administrators use this form to track and override approval requests.
Request The AR System populates this field with the AR System ID for
the request.
Process The AR System populates this field with the name of the
approval process of this request.
Priority Use the menu list to select the priority attached to this request.
Each process defines the meaning behind Urgent, Normal,
and Low.
Submitter The AR System populates this field with the name of the
person who requested the workflow to be approved.
Status The AR System populates this field with the status of the
request.
AP:Detail D-11
Approval Audit This field contains an audit trail of date, time, and approver
Trail when approval activity occurs to this request. This information
becomes part of the permanent record for this request.
Global Approve Click this button to approve the request, overriding the regular
approval process. You must have process administrator
override authority to perform this action.
Global Reject Click this button to reject the request, overriding the regular
approval process. You must have process administrator
override authority to perform this action.
AP:Detail-Signature
Process Administrators use this form to track the history of responses to an
approval request.
Approval Use the menu list to select the priority attached to this request.
Priority Each process defines the meaning behind Urgent, Normal
and Low.
Next Approver Type the name(s) of the next approver(s) to see this request.
Approvers The AR System populates this field with the names of persons
who have already approved this request.
AP:Detail-Signature D-13
Approval Audit This field contains an audit trail of date, time, and approver
Trail when approval activity occurs to this request. This information
becomes part of the permanent record for this request.
Application The AR System populates this field with the name of the AR
System application workflow to be approved with this request.
Request The AR System populates this field with the AR System ID for
the request.
Process The AR System populates this field with the name of the
approval process of this request.
Submitter The AR System populates this field with the name of the
person who originated this request.
Approver This field contains the name of the approver of this request.
Signature The name appears only after an authorized person modifies
the Approval Status field.
Alternate This field contains the name of the alternate approver who
Signature modifies the Approval Status field.
More This field contains any requests for more information and the
Information responses when they occur to this request. This information
becomes part of the permanent record for this request.
Show Details Click this button to open the form for the workflow the requester
wants to be approved.
More Click this button to open the More Information form with which
Information you can request additional information.
AP:Dtl-Sig-MoreInfoDialog
Approvers use this dialog box to examine More Information records. To access
this dialog box click the More Information button on the AP:Detail Signature
form.
Create a New Use this button to open the More Information form and create a
new More Information record.
Open Click this button to open the currently selected item in the field
above.
AP:Form
Process Administrators use this form to attach forms to an Approval Server
process.
Form Name Type a form name or use the menu list to select a form on the
current server.
Used By Type the name of the AR System application that uses the
form.
Approval Type the name of a form or use the menu list to select a form
Reporting that users may search using the Application Approval Search
button described on Approval Central on page D-2.
Approval Reporting is an optional field.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
AP:Form D-15
AP:More Information
Approvers use this form to ask questions about a request.
To Type the name of the person you want the Approval Server to
ask for more Information. Unlike some fields, this field can
contain only one name.
From Type the name of the person who is asking for more
information. This field is read-only once the record is saved.
Status Use the menu list to select the status of the approval request
that this More Information record is attached to.
Application The AR System populates this field with the name of the AR
System application workflow that needs to be approved with
this request.
Request The AR System populates this field with the AR System ID for
this request.
Open Related Click this button to open the form for the AR System application
that needs to be approved.
Status Use the menu list to select the status of the notification.
Active
Inactive
AP:Notification D-17
Figure D-16 AP:Notification Form, Qualification Tab
Notify On Use the menu list to select an event in the approval process
that triggers this notification.
Figure D-17
Subject Type a subject line for the notification message. Use the menu
list to select AR System variables to add to the subject.
Additional Use the menu list to select AR System variables to add to the
Fields additional fields.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
AP:Notification D-19
AP:Process Administrator
Process administrators use this form to create, delete, and modify the abilities of
other process administrators. The AR System administrator uses this form to
create the first process administrator after installation. Refer to Setting Up
Administrator Capabilities on page 8-6 for a discussion of this form.
Note The first process administrator must be created by your AR System Administrator.
Individual This field contains the user name of the individual who is to be
a process administrator.
Authority Use the menu list to select the privileges allocated to the
individual in the field above.
Full Admin grants this person full authority as a process
administrator.
Override Only Admin grants this person only the authority
to override a process.
Notify Method Use the menu list to determine the manner of notification.
None sends no notification message.
Status Use the menu list to determine the status of this persons
process administration privileges.
Active
Inactive
Specific Process
Process Name Use the menu list to select a process name if you selected
Specific Process in the Covering field above.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
AP:Process Definition
Process administrators use this form to create and modify approval processes.
Refer to Using the Process Definition Form on page 9-2 for a discussion about
using this form.
Type Use the menu list to select the process type for this process.
Refer to Approval Process Types on page 7-17 for a
description of approval process types.
Request Owner Type a valid user name or use the menu list to select the owner
Field of a request in this approval process.
First Approver Type in the name or use the menu list to select the approver to
Field first see a request in this process. This field is required for Ad
Hoc process type, optional if you allow Ad Hoc overrides, and
otherwise unused.
Approval Use the menu list to select the manner with which the Approval
Success Server determines a request is complete.
No More Approvers means a request is complete when all
approvers have approved the request.
Completion Rule means the request is complete when
defined conditions have occurred.
If Multiple Use the menu list to select the number of signatures required
Approvers when multiple approvers appear on a signature line.
One Must Sign means there is one signature line and the
first approver to approve/reject a request determines the
response. The request is withdrawn from the other
approvers.
All Must Sign means every approver on the signature line
must approve the request.
Allow Only One Approver means a response from more
than one approver generates an error, and stops the
approval process.
Allow Ad Hoc Use the menu list to determine who can select an Ad Hoc next
Next Approver? approver.
Anyone means the requester and any approver can select
an Ad Hoc next approver.
Approver means any approver can select an Ad Hoc next
approver.
No one means this process never allows an Ad Hoc next
approver.
Validate Use the menu list to determine Yes or No, whether Ad Hoc
Approvers? next approvers are validated before they can respond to a
request.
Require Use the menu list to determine Yes or No, whether the
Password? approver must enter a password to save changes to an
approval request.
The three tabs on the Signature Escalation tab contain identical fields.
Workday Use the menu list to select a schedule created on the form,
Schedule Business Time Workdays on page D-32.
Holiday Use the menu list to select a schedule created on the form,
Schedule Business Time Holidays on page D-31.
Unit Select the unit of Hours or Days as the unit for the interval in
the previous field.
Change State Use the menu list to select the status you want to force on this
request if there is no activity in the interval defined in the two
preceding fields. Leave this field and the preceding two empty
if you do not want the status of a request changed
automatically.
First Interval Type a numeric value for the amount of time to pass before this
notification first occurs
Unit Select the unit of Hours or days for the interval in the previous
field.
Repeat Interval Type a numeric value for the amount of time to pass before this
notification recurs. For example, type a 2 for two hours or two
days. The unit is determined in the next field.
Unit Select the unit of Hours or days for the interval in the previous
field.
On Save Set the separate escalation and repeat intervals to occur when
a form is saved with the status of Pending, Error, Hold, or More
Information.
First Interval Type a numeric value for the amount of time to pass before this
notification first occurs. For example, type a 2 for two hours or
two days. The unit is determined in the next field.
Unit Select the unit of Hours or Days for the interval in the previous
field.
Repeat Interval Type a numeric value for the amount of time to pass before this
notification recurs. For example, type a 2 for two hours or two
days. The unit is determined in the next field.
Unit Select the unit of Hours or Days for the interval in the previous
field.
Workday Use the menu list to select a schedule created on the form,
Schedule Business Time Workdays on page D-32.
Holiday Use the menu list to select a schedule created on the form,
Schedule Business Time Holidays on page D-31.
First Interval Type a numeric value for the amount of time to pass before this
action first occurs. For example, type a 2 for two hours or two
days. The unit is determined in the next field.
Unit Select the unit of Hours or days for the interval in the previous
field.
Repeat Interval Type a numeric value for the amount of time to pass before this
action recurs. For example, type a 2 for two hours or two days.
The unit is determined in the next field.
Unit Select the unit of Hours or days for the interval in the previous
field.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
Name Type Click the option button to select whether the word is a keyword
or function.
AP:Role
Process administrators use this form to create roles within approval processes.
Refer to Defining Roles on page 11-2 for a discussion about using this form.
If Multiple Use the menu list to select how the approval process operates
Approvers when many approvers appear in the Member List field.
One must sign determines that only one signature is
required from everyone indicated in the Member List field.
All must sign determines that everyone indicated in the
Member List field must approve the request.
This field is valid only if there is more than one entry in the
Member List field.
Status Use the menu list to select the status of this role.
Active means this role currently can be used by any
approval process.
Inactive means this role is disabled for all approval
processes.
Member List Type the user name for each person to participate as a
member of this role.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
AP:Rule Definition
Process administrators use this form to create and modify rules for approval
processes. Refer to The Rule Definition Form on page 10-2 for a discussion
about using this form.
For Process Use the menu list to select a process for this rule.
Status Use the menu list to select the status of this rule.
Rule Type the rule here. Use the buttons and menu list to help. Refer
to The Rule Definition Form on page 10-2 for a discussion of
creating rules.
Audit Trail Type any text you want to appear the permanent record for the
request whenever this rule executes. Use the menu list to
select keywords to include in your audit trail message.
If Multiple Rows Use the menu list to select the behavior when there are
multiple rows.
Value from first uses the value from the first record
retrieved.
Value from all uses all of the values retrieved.
If Multiple Use the menu list to select the behavior when there are
Approvers multiple approvers.
One Must Sign means the Approval Server requires only
one signature when there are multiple signature lines.
All Must Sign means the Approval Server requires a
signature for every signature line when there are multiple
signature lines.
Next Approver Use the menu list to select the behavior when there are
Rule Is multiple Get Next Approver rules.
Additive means this rule appends approvers to the existing
approver list, and further rules are processed.
Ending means this rule appends additional approvers to the
existing approver list, but no further rules are processed.
Exclusive means this rule assigns the approver list, and no
further rules are processed. If a previous rule created an
approver list, the process ignores it.
This field is generally used for a rule-based process that has a
set of Get Next Approver rules for building an approver list.
Set Fields Type Use the menu list to select how this rule will populate a field.
From Form Type the name of the form that contains the field you want to
populate. Leave this field blank to use this rule on more than
one form. This field is disabled with some options available in
the Set Field Type field.
On Server Use the menu list to select the server that contains.
Current means the form resides on the server with the
Approval Server.
Alternate means the form resides on another server
indicated in the Server field.
This field is disabled with some options available in the Set
Field Type field.
Server Type the name of the server that holds the form. This field is
available only when the On Server field contains the value
Alternate.
Field Name Type a field name or use the menu list to select a field name.
The Field Name field is disabled with some options available in
the Set Field Type field.
One rule can populate more than one field by using separate
lines for Field Name and Value.
Value Type the value to use for populating the field. The Value field is
disabled with some options available in the Set Field Type field.
One rule can populate more than one field by using separate
lines for Field Name and Value.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
AP:Signature
Approvers use this form to review the responses to a request.
Approval ID The AR System populates this field with the AR System ID for
this request.
Approvers The AR System populates this field with the names of persons
who have approved this request.
More The AR System populates this field with the questions and
Information answers to More Information requests.
Approval Status The AR System populates this field with the status of the
request.
If Multiple This option button is valid only if there is more than one entry in
Approvers the Next Approver field.
One must sign determines that only one signature is
required from everyone indicated in the Next Approver field.
All must sign determines that everyone indicated in the
Next Approver field must approve the request.
Alternate The AR System populates this field with your name if you are
Signature acting as alternate for this approval.
Holidays Type the date(s) included in this holiday period in the normal
AR System format.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
Open Time Type a numeric time to indicate the hour and minute your
company opens for business for each day of the week.
If you are not open on a day, for example weekends, leave the
Open Time fields for those days blank.
Close Time Type a numeric time to indicate the hour and minute your
company closes for business for each day of the week.
If you are not open on a day, for example weekends, leave the
Close Time fields for those days blank.
Refer to the description of Figure D-9 on page D-10 for field definitions of the
Administrative Information tab.
Installation Concerns
E-1
Installation Concerns
This section discusses known concerns regarding Approval Server installation.
Licensing
If you do not license the Approval Server before installation, you must reboot, or
manually restart the service (Windows) or daemon (UNIX). Refer to Manually
Starting and Stopping the Approval Server on page A-23.
Sample Users
You must license the sample users to perform the procedures in Chapter 6, Using
a Sample Application.
F-1
Default Installation Directories
Without intervention, the Approval Server installs files into the following default
directory, depending on your platform.
Windows
C:\Program Files\Remedy\Approval
UNIX
/usr/ar/approval
Glossary 1
auto approval A rule type that allows for default An AR System administrator- or user-
automatic approval of a request for any defined setting or value that automatically
submission that meets specified criteria. applies to a field if users do not supply a
different setting or value when submitting a new
button A field on a form that a user can click to
execute an active link. A bitmap can represent a request. See also administrator default, user
default.
button. See also menu item, toolbar button.
Detail pane The part of the main window that
cancel at later level An indication for
displays fields for entering data.
notifications when an approval process is
cancelled after it has been approved by a dialog box A set of fields that are displayed to
previous approver. users and must be responded to before they
continue to fill out a form. The administrator
cancelled The status of a completed approval
request which was withdrawn by the requester. creates a dialog box by using an active link
action.
chained approval process A sequence of
diary data type The data type used for fields
approval processes which appear to the user as
that enable you to capture a history of the
one approval, but in fact are made up of many
separate approval processes. actions taken for a request. The field stores
character data. It is an append-only field, and
close approve An indication for notification each addition is stamped with the time, date,
when a request has multiple possible approvers and name of the user who entered the item.
and another of the approvers approves the
request. done See approval process done.
closed The status of an approval request that error The status of an incomplete approval
request in which routing problems have
has been resolved and is no longer waiting for
occurred.
an approver or more information response.
field In the AR System, the main entity of a
close reject An indication for notification
when a request has multiple possible approvers form. All of the following are AR System fields:
data, table, page, active link control fields
and another of the approvers rejects the request.
(buttons, menu items, and toolbar buttons), and
completion rule A rule type that checks trim.
whether conditions exist to stop routing a
request. If a completion check is successful, then file menu A menu with items that are
retrieved from a file that contains a formatted
no new approvers will see the request. The
character menu.
request may not be done, but the request has
been routed to everyone who must respond. get authority A rule type that gathers
control pane The part of the browser window information about the current approver or
environment that is used by subsequent self
that displays the command buttons to process
approval or completion rule tests.
data.
control panel A form that is used as a
centralized entry point from which users choose
the business tasks they need to accomplish.
2 Glossary
get authority regular A rule type that gathers more information an approvers query for
information about the current approver or additional data that becomes part of the audit
environment that is used by subsequent trail of the approval request. The approver is not
completion rule tests. Note that these rules are required to delay the approval request until
not run before self approval tests. someone responds.
get authority self A rule type that gathers more info return An indication for
information about the current approver or notifications when a more information request
environment that is used by subsequent self has been responded to.
approval rule tests. Note that these rules are not new signature An indication for notifications
run before completion tests.
that a new signature record has been created
get next approver A rule type that finds the with an individual as an approver.
next approvers in the current process, including notification An alert that an AR System event
the first approver at the start of processing.
has occurred.
hold An indication for notifications when a
override approve An indication for
request is changed to the Hold status. This is
notifications when a process administrator has
also a status where an approval request is approved a request in a manner that
assigned to an approver but no Approval Server
circumvents the normal process.
activity occurs.
override reject An indication for notifications
join form A type of form that contains
when a process administrator has rejected a
information from two or more AR System forms. request in a manner that circumvents the normal
Although join forms function like regular AR
process.
System forms in most respects, they do not store
independent data. Join forms point to the data parent-child An approval process type with a
stored on the two AR System forms that were fixed relationship between approvers, such as
used to create the join form. found in a management hierarchy.
level An approval process type with no fixed See also: level, Ad Hoc, and rule-based process types.
relationship between the approvers, but rather pending The status of an incomplete approval
some relationship based on their membership in request that is waiting for response from an
some group. Often used with approval processes approver or more information.
requiring consensus from set of committees
permission The property setting that enables
where the individuals are related only by their
AR System administrators to control who can
membership on the committees.
view and change individual fields of a form.
See also: Parent child, Ad Hoc, and rule-based process Administrators also set permissions for forms
types. and active links. Permissions are defined for
menu item A command that is accessed from a each access control group. See also access
menu. control, group, user.
prep get next approver A rule type that
gathers information to be used by the get next
approver rules.
Glossary 3
process administrator An AR System user requester A user who submits a form that
who is a member of the Approval Admin group requires authorization, triggering the Approval
(402) and has authority to set up and maintain Server.
approval processes.
role A named alias for one or more approvers.
See also AR System administrator. Allows the definition of a position regardless of
reassign An action for an approver to reroute a the individual approvers who are currently
fulfilling that position.
request by changing the assigned approvers.
rule-based A custom approval process type set
reject by another approver An indication for
up by the process administrator. There are no
notifications when there are multiple required
assumptions about relationships between
approvals outstanding and one of the other
approvers. Everything is built into the rules.
approvers rejects the request.
See also: Parent child, level, and Ad Hoc process
reject by later level An indication for
notifications when an approval process is types.
rejected by an approver after it has been self approval A rule type that allows for
approved by a previous approver. automatic approval of a request if the submitter
of the request has sufficient authority for the
rejected The status of a completed approval
request when an approver has disagreed. request to be approved.
Remedy Administrator The AR System client signature record a database record for the
signature of an approver. If an approval request
tool used by AR System administrators and
requires more than one signature, then multiple
subadministrators to set up the system for use
by support staff and users. This includes setting signature records are generated for that single
approval request.
up forms, setting access permissions (users and
groups), and creating filters, escalations, active toolbar The row of buttons below the menu
links, menu lists, guides, and applications. bar that enables easy access to commonly used
Remedy Notifier The AR System client tool menu commands.
through which a notification can be sent to a toolbar button An icon for a menu item that
user. See also notification. triggers an active link. See also button, menu item.
Remedy User The AR System client tool in validate approver A rule type that is used to
which users enter and track requests through the verify that a name specified as the next approver
resolution process. Users can also search the is a valid user. Only used to verify a user
database, generate reports, and modify existing specified in an Ad Hoc process or an Ad Hoc
requests with Remedy User. override of another process type.
request A collection of information that
describes an event (transaction), such as a
problem or a service request.
See also: approval request.
4 Glossary
Index
A alternate approvers
accessing assigning 3-5, 4-7, 5-8
approval module forms 8-2 creating for others 4-10, 11-4
Approval Server 8-2 defined 2-4
Action Request filters 10-4 modifying information 4-9, 5-11
active links for Lunch Scheduler 13-8 reviewing information 4-9, 5-11
ad hoc serving as 3-5, 4-8, 5-9
approvers 7-10 alternate reject Glossary-1
defined Glossary-1 answering
defining processes 9-4 approval requests 4-2
process type vs. ad hoc override 7-10, 7-21 More Information requests 4-5, 5-7
sample application 6-2 AP:Admin-DeleteVerify dialog D-4
ad hoc process AP:Administration form 8-2, 12-4, D-3
described 7-21 AP:Admin-Rename dialog 8-4, D-5
Get Next Approver rules 10-13 AP:Admin-ServerSettings dialog 8-5, 8-8, D-6
adding AP:Alternate form 11-4, D-9
alternate approvers 4-10 AP:Detail form 7-3, 12-9, D-11
Manage More Information button 13-7 AP:Detail-Signature form 12-3, 12-7, D-12
Add-Sig command C-4 AP:Dtl-Sig-MoreInfoDialog dialog D-14
administrators AP:Form form D-15
defined Glossary-1 AP:More Information form 7-3, B-2, D-16
setting capabilities 8-6 AP:Notification form 8-11, B-3, D-17
administrators, process AP:Process Administrator form 8-6, 11-5, D-20
assigning capabilities 8-6 AP:Process Definition form 9-2, B-2, D-21
authority of 7-2 AP:Reserved Word form D-26
defined 7-2 AP:Role form 11-2, D-26
delegating authority 7-2 AP:Rule Definition form
Override Only 7-3 entering rule information 10-3
responsibilities of 7-2 field descriptions D-27
Specific Process 7-3 opening the form 10-2
All must sign field 10-14, 11-3 setting field values on forms 10-4
tabbed views 10-2
Index 1
AP:Signature form 7-3, D-30 Approval Process, types of
apjoinfix 12-4 ad hoc 10-13
Application Pending form A-2, C-2, E-2 level 7-19, 10-12
Application-Command process C-2 parent-child 7-17, 10-12
applications rule-based 7-22, 10-13
configuring for Approval Web 12-6 summary table 7-23
connecting to Approval Server 12-2 approval processes for Lunch Scheduler 13-3
defined Glossary-1 approval requests
Get Agreement 6-1 audit trails 7-3
Lunch Scheduler 13-1 defined Glossary-1
troubleshooting sample E-3 diagram of 7-5
Approval Central login list 5-3
form D-2 processing 3-2, 4-2, 5-2
hidden characteristic 12-2 reassigning 3-3, 4-6, 5-8
URL 5-2, E-3 responding to 4-2, 7-12
approval errors 3-4 sample application 6-1
approval module, accessing forms 8-2 specifying next approver 3-4, 4-6
approval notifications 7-24 status of 3-3
Approval Process viewing 3-2, 4-3, 5-4
ad hoc 7-21 approval routing, setting up 7-2
creating 7-2, 9-2 approval rules
defined 1-2 defined 7-4
deleting 9-10 deleting 10-33
diagram of 7-5, 7-16 modifying 10-33
done vs. complete 7-6 approval rules, types of
error handling 3-4 Approval Process Done 10-30
modifying 9-9 Auto-Approval 10-5
reassigning requests 3-3, 4-6, 5-8 Completion 10-28
requesting more information 3-3 Get Authority 7-8, 10-20
restarting 13-6 Get Authority Regular 10-23
specifying next approver 3-4, 4-6 Get Authority Self 7-8, 10-25
viewing approval request records 3-2 Get Next Approver 7-10, 10-12
Approval Process Done rules Prep Next Approver 10-10
creating 10-30 Self-Approval 7-8, 10-8
described 10-30 Validate Approver 7-10, 10-17
example of 10-32 Approval Server
Set Fields tab 10-31 accessing components 8-2
worksheet B-10 configuring 8-5
connecting applications to 12-2
2 Index
defined Glossary-1 AP:Detail-Signature D-12
incompatibility with bundled version AP:Form D-15
A-2, E-2 AP:More Information D-16
installing on UNIX A-19 AP:Notification D-17
installing on Windows NT A-4 AP:Process Administrator D-20
licensing before installation E-2 AP:Process Definition D-21
manually starting and stopping A-23 AP:Reserved Word D-26
moving applications to Approval Web 12-6 AP:Role D-26
Oracle 8.0.x and E-4 AP:Rule Definition D-27
previous installation E-2 AP:Signature D-30
URL 5-2 Approval Central D-2
Approval Server commands Business Time Holidays D-31
Add-Sig C-4 Business Time Workdays D-32
Det-Approved C-4 User D-33
Det-Cancelled C-5 Approval Web
Det-Error C-5 configuring applications for 12-6
Det-Rejected C-6 configuring without portmapper A-25
MoreInfo-Return C-6 hiding password fields 12-8
New-Details C-6 processing requests 5-2
Rename-Form C-7 requesting more information about
Rename-Process C-7 approvals 5-6
Sig-Approved C-7 responding to More Information requests 5-7
Sig-Cancelled C-8 reviewing requests 5-4
Sig-Notify C-8 showing password fields 12-8
Sig-Notify-Change C-8 troubleshooting E-3
Sig-Notify-State C-9 URL 5-2
Sig-Reassign C-9 viewing More Information requests 5-7
Sig-Rejected C-10 Approval Web, alternate approvers
Update-Config C-10 designating 5-8
Approval Server dialogs modifying 5-11
AP:Admin-DeleteVerify D-4 reassigning approval requests 5-8
AP:Admin-Rename D-5 reviewing 5-11
AP:Admin-ServerSettings 8-5, 8-8, D-6 serving as 5-9
AP:Dtl-Sig-MoreInfoDialog D-14 Approval Web, installation
Approval Server for the Web. See Approval Web notes on A-2
Approval Server forms UNIX A-22
AP:Administration D-3 Windows NT A-11
AP:Alternate D-9 Approval Workspace field 13-5
AP:Detail D-11 approval, defined 1-2
Index 3
Approve button 5-5 ARWeb
approvers configuration A-24
ad hoc 7-10 directory permissions A-24
approving requests 7-6 ARWeb 3.x
assigning alternate 3-5, 4-7, 5-8, 11-4 diary fields 12-9
completed vs. done requests 7-6 installing A-2
defined 2-3 required versions A-11
list of, defined Glossary-1 ARWeb. See Approval Web
modifying alternates 4-9, 5-11 Assigned To field 12-3
multiple 4-6 assigning
overriding 3-7, 4-10 administrator capabilities 8-6
problem with responses E-4 alternate approvers 3-5, 4-7, 5-8
rejecting requests 7-6 approval requests 4-6, 5-8
response in sample application 6-3 limited administration rights 7-2
reviewing alternates 4-9, 5-11 override capabilities 11-5
roles and 7-9 audit trail of approval requests 7-3
serving as alternate 3-5, 4-8, 5-9 authority
approving requests 6-3, 7-6, 7-12 process administrator and 7-2
appstart.html 12-6, 12-8 signature 4-8, 5-9
AP-Sample auto approval
LoadDiaryOnDisplay filter 12-9 checks 7-7
AP-Sample:Company form 13-3 defined Glossary-2
AP-Sample:Lunch Scheduler form 13-2, 13-7 Auto-Approval rules
AP-Sample:Lunch-Detail form 13-3 creating 10-5
AP-Sample:Lunch-Detail-Signatu form example of 10-7
13-3, 13-8 worksheet B-7
AP-Sample:Restaurant form 13-3
AP-Sample:Signature Authority form 13-3, 13-10
B
Business Time Holidays form
AR System administrator Glossary-1
configuring 8-17
AR System server Glossary-1
described D-31
AR System server, installation notes A-2
More Information escalations 9-8
ar.cfg C-10
Business Time Workdays form
ar.conf C-10
configuring 8-16
ar_apinstall A-19
described D-32
ar_apweb4install A-22
More Information escalations 9-8
ar_apwebinstall A-22
buttons
arstruct.h C-10
Approve 5-5
defined Glossary-2
Manage More Information 13-7
4 Index
Reject 5-5 Sig-Rejected C-10
Show Approval Summary 13-8 Update-Config C-10
Show Signature 13-8 complete vs. done 7-6
web browser 5-2, E-3 completing processes 7-6
Completion Checks
C diagram of 7-14, 7-16
cancel at later level Glossary-2
routing and 7-13
cancelled Glossary-2
rules 7-14
cancelling approval processes 13-6
Completion rules
category parameter C-2
creating 10-28
chained processes 7-15, 12-5, 13-5
described 10-28
Change Management A-2, E-2
example of 10-29
changing
worksheet B-10
alternate approvers 4-9
components, Approval Server 8-2
processes 9-9
config.html 12-6
rules 10-33
configuring
checks, auto approval 7-7
applications for Approval Web 12-6
checks, self approval 7-7
Approval Server 8-5
close approve Glossary-2
Approval Web without portmapper A-25
close reject Glossary-2
ARWeb A-24
closed Glossary-2
Business Time Holidays form 8-17
command format C-2
Business Time Workdays form 8-16
Command Pane 5-5
connecting applications to Approval Server 12-2
command parameter C-2
control pane Glossary-2
commands, Approval Server
control panel Glossary-2
Add-Sig C-4
Courier font xiv
Det-Approved C-4
Create Date field 12-3
Det-Cancelled C-5
creating
Det-Error C-5
actions for rules 10-4
Det-Rejected C-6
alternate approvers 4-10
MoreInfo-Return C-6
Approval Process 7-2
New-Details C-6
notifications 8-11
Rename-Form C-7
processes 7-4, 9-2
Rename-Process C-7
roles 11-2
Sig-Approved C-7
rules 10-2
Sig-Cancelled C-8
creating rules
Sig-Notify C-8
Approval Process Done 10-30
Sig-Notify-Change C-8
Auto-Approval 10-5
Sig-Notify-State C-9
Completion 10-28
Sig-Reassign C-9
Index 5
Get Authority 10-20 Det-Approved command C-4
Get Authority Regular 10-23 Det-Cancelled command C-5
Get Authority Self 10-25 Det-Error command C-5
Get Next Approver 10-13 Det-Rejected command C-6
Prep Next Approver 10-10 dialogs
Self-Approval 10-8 AP:Admin-DeleteVerify D-4
Validate Approver 10-18 AP:Admin-Rename 8-4, D-5
AP:Admin-ServerSettings 8-5, 8-8, D-6
D AP:Dtl-Sig-MoreInfoDialog D-14
daemon A-2, A-21
diary data type Glossary-2
debug mode C-10, D-6
Diary fields 12-9
debugging the Approval Server 8-5
diary.for.template file 12-9
default Glossary-2
directory permissions A-24
default directories F-2
directory structure F-2, F-20
defining
directory, web server permissions A-24, E-3
actions for rules 10-4
done vs. complete 7-6
alternate approvers 4-10, 11-4
Done, Process 7-6
notifications 8-11
roles 11-2 E
defining rules editing
Approval Process Done 10-30 alternate approvers 4-9, 5-11
Auto-Approval 10-5 processes 9-9
Completion 10-28 rules 10-33
Get Authority 10-20 enabling
Get Authority Regular 10-23 diary fields in ARWeb 3.x 12-9
Get Authority Self 10-25 notifications 8-8
Get Next Approver 10-13 Password field 12-8
Prep Next Approver 10-10 entering rule information 10-3
Self-Approval 10-8 errors
Validate Approver 10-18 approval 3-4
delegating authority 7-2 defined Glossary-2
deleting process 7-14
processes 9-10 escalations
rules 10-33 creating D-9
designating alternate approvers 3-5, 4-7, 5-8 enabling 8-8
designing processes B-2 More Information 9-7
Detail pane Glossary-2 signature 9-6, D-23
Detail records 7-3 signature worksheets B-3
Detail-Signature records 3-2 events that trigger notifications 8-12
6 Index
F AP:Detail-Signature 12-3, 12-7, D-12
feedback 1-4 AP:Form D-15
field Glossary-2 AP:More Information 7-3, B-2, D-16
field ID 1 12-2 AP:Notification 8-11, B-3, D-17
field ID 102 13-8 AP:Process Administrator 8-6, 11-5, D-20
field ID 13191 12-4 AP:Process Definition 9-2, B-2, D-21
field ID 536870920 13-5 AP:Reserved Word D-26
field ID 7 12-2, 12-3, 12-4 AP:Role 11-2, D-26
field ID 8 12-2 AP:Rule Definition 10-2, D-27
fields AP:Signature 7-3, D-30
All must sign 10-14, 11-3 Application Pending A-2, C-2, E-2
Approval Workspace 13-5 Approval Central D-2
Diary 12-9 Business Time Holidays 8-17, D-31
One must sign 10-14, 11-3 Business Time Workdays 8-16, D-32
Password 12-8 User D-33
Reassign 3-3, 4-6 forms, Lunch Scheduler
Request 12-2 AP-Sample:Company 13-3
Request ID 12-2 AP-Sample:Lunch Scheduler 13-2, 13-7
Status 4-2, 12-2, 12-4 AP-Sample:Lunch-Detail 13-3
file menu Glossary-2 AP-Sample:Lunch-Detail-Signatu 13-3, 13-8
filters AP-Sample:Restaurant 13-3
AP-Sample AP-Sample:Signature Authority 13-3, 13-10
LoadDiaryOnDisplay 12-9 installing A-8
AP-Sample:StartCostApproval 13-4
AP-Sample:StartLevelApproval 13-4
G
Get Agreement application
AP-Sample:StartOverdueApprov 13-4
ad hoc process 6-2
New-Details command 12-5
approving requests 6-3
specifying for rules 10-4
installing A-8
first approver list 10-13
licensing sample users 13-9
first level of approvers 10-13
parent-child hierarchy 13-10
flat file database A-2
reassigning requests 6-6
fonts xiv
requesting items 6-2
format of commands C-2
requesting more information 6-4, 6-6
forms
reviewing answers to More Information
AP:Administration 8-2, 12-4, D-3
requests 6-7
AP:Alternate 11-4, D-9
AP:Detail 7-3, 12-9, D-11
Index 7
Get Authority Regular rules H
creating 10-23 Hidden characteristic, Approval Central 12-2
defined Glossary-2 hold
described 7-14 defined Glossary-3
example of 10-24 response to requests 7-12
Set Fields tab 10-24
worksheet B-10
I
ID, reserved 12-2
Get Authority rules
IIS, Miscrosoft Internet Information Server A-24
creating 10-20
inner join 12-3
defined Glossary-2
installation notes A-2
described 7-8
installer script, UNIX A-20
example of 10-22
installing
Set Fields tab 10-21
Approval Server for UNIX A-19
worksheet B-8
Approval Server for Windows NT A-4
Get Authority Self rules
Approval Web for UNIX A-22
creating 10-25
Approval Web for Windows NT A-11
defined Glossary-3
Approval Web notes and A-2
described 7-8
AR System server notes and A-2
example of 10-27
directory structure F-2, F-20
Set Fields tab 10-26
licensing Approval Server E-2
worksheet B-7
troubleshooting E-2
Get Next Approver rules
ad-hoc process 10-13 J
creating 10-13 join forms
described 7-10, 10-12 applications with Approval Server 12-2
example of 10-16 defined Glossary-3
level process 10-12 join, inner 12-3
parent-child process 10-12
rule-based process 10-13 L
Set Fields tab 10-15 Last Modified By field 12-3
worksheet B-9 level
global approve D-12 approvers 10-13
global overrides 3-7, 4-11 defined Glossary-3
global reject D-12 identifier 10-13
group (402) Glossary-3 level process
described 7-19
Get Next Approver rules 10-12
8 Index
License Agreement A-6 modifying
licensing alternate approvers 4-9, 5-11
before Approval Server installation E-2 processes 9-9
sample users 13-9, E-3 rules 10-33
limiting administration rights 7-2 More Information
linking applications to Approval Server 12-2 defined Glossary-3
lists records D-16
first approver 10-13 worksheet B-2
signatures 13-7 More Information escalations
log file notifications 9-7
debugging and 8-5 setting parameters 9-8
Low Priority Notification worksheet B-5 worksheet B-2
Lunch Scheduler application More Information requests
approval processes 13-3 entering information 4-4, 5-6
chaining approval processes 13-5 responding to 4-5, 5-7, 7-12
forms 13-2 reviewing answers 4-5, 5-7
installing A-8 reviewing answers in sample 6-7
licensing sample users 13-9 using in sample application 6-4, 6-6
overview 13-2 MoreInfo-Return command C-6
parent-child hierarchy 13-10 multiple approvers 4-6
restarting approval processes 13-6
reviewing information 13-7
N
Netscape Enterprise Server A-24
showing password field 13-8
new signature Glossary-3
showing signatures 13-7
New-Details command 12-5, C-6
showing summaries 13-7
Next Approver rules 7-9
M Normal Priority Notification worksheet B-3
Major Account Level Approval approval notifications
process 13-4 creating D-8
Manage More Information button 13-7 defined Glossary-3
Management Cost Authorization approval enabling 8-8
process 13-4 escalation worksheets B-3
manually starting Approval Server A-24 examples of 7-24
manually stopping Approval Server A-24 methods 8-15
menu item Glossary-3 More Information escalations 9-7
Modifed Date field 12-3 process administrators and 8-7
modify.for.template file 12-7 setting up 8-10
Index 9
O Prep Get Next Approver rules
One must sign field 10-14, 11-3 described 7-10
Oracle 8.0.x E-4 example of 13-4
Other, Set Fields value 10-4 Prep Next Approver rules
Override Only Admin privileges D-20 creating 10-10
Override Only process administrators 7-3 worksheet B-9
override reject Glossary-3 previous Approval Server installation E-2
overrides, ad hoc 9-4 process administrators
overriding adding alternate approvers 4-10
approvers 3-7 assigning capabilities 8-6
assigning capabilities 11-5 authority of 7-2
global 3-7, 4-11 creating processes and rules 7-4
process administrators and 7-2 defined 7-2
single signatures 4-10 delegating authority 7-2
described 2-5
P Override Only 7-3
parameters C-2
overriding approvals 4-10
parent-child process
responsibilities of 7-2
described 7-17
Specific Process 7-3
Get Next Approver rules 10-12
Process definition worksheet B-2
sample applications and 13-10
Process Done rules 7-15
Password field 12-8, 13-8
Process, Set Fields value 10-4
passwords
processes
Approval Web and 12-8
chained 7-15
saving changes and 5-3
creating 9-2
setting up for users D-23
deleting 9-10
verifying D-13
designing worksheet B-2
pending Glossary-3
done vs. complete 7-6
performing overrides 3-7
errors 7-14
permissions
modifying 9-9
change 11-4
renaming 9-11
connecting applications and 12-2
restarting 13-6
defined Glossary-3
rules and 7-4
directory A-24
types of 7-17
web server directory A-24, E-3
processing approval requests 3-2, 4-2
portaloc string 12-6
Purchasing@Work A-2, E-2
portmapper A-25
portmapper and Approval Web A-25 Q
Query, Set Fields value 10-4
10 Index
R Rename-Process command C-7
reassigning repeat interval D-24
approval requests 3-3, 4-6 Request field 12-2
approval requests in Approval Web 5-8 Request ID field 12-2, 12-3
requests in sample application 6-6 request, defined Glossary-4
records requesters 2-2
Detail 7-3 requesting
Detail-Signature 3-2 items in sample application 6-2
Reject button 5-5 more information 3-3, 4-4, 5-6
reject response to requests 7-12 requests, approval
rejected Glossary-4 audit trails 7-3
rejecting defined Glossary-1
by another approver 7-6, Glossary-4 diagram of 7-5
by later level Glossary-4 login list 5-3
relationships processing 3-2, 4-2, 5-2
level approval process 7-19 reassigning 3-3, 4-6, 5-8
parent-child approval process 7-17 responding to 4-2, 7-12
roles and 7-9 sample application 6-1
Remedy Notifier 8-15 specifying next approver 3-4, 4-6
Remedy User status of 3-3
creating approval rules 10-1 viewing 3-2, 4-3, 5-4
modifying approval rules 10-1 requests, More Information
overriding approvers 4-10 described 3-3
processing approval requests 4-2 entering information 4-4, 5-6
reassigning approval requests 4-6 responding to 4-5, 5-7
requesting more information about reviewing answers 4-5, 5-7
approvals 4-4 reviewing answers in sample 6-7
responding to More Information requests 4-5 using in sample application 6-4, 6-6
reviewing answers to More Information reserved ID 12-2
requests 4-5 responding to
specifying next approver 4-6 approval requests 4-2
Remedy User, alternate approvers More Information requests 4-5, 5-7, 6-6
defining for other approvers 4-10 responses
designating 4-7 problem with E-4
modifying 4-9 types of 7-12
reviewing 4-9 responsibilities of process administrators 7-2
serving as 4-8 restarting processes 13-6
renaming a process 9-11 restoring forms during installation A-21
Rename-Form command C-7
Index 11
reviewing Completion B-10
alternate approvers 4-9, 5-11 Get Authority B-8
approval requests 5-4 Get Authority Regular B-10
Lunch Scheduler application and 13-7 Get Authority Self B-7
More Information responses 4-5, 5-7 Get Next Approver B-9
roles Prep Next Approver B-9
approver 7-9 Self-Approval B-8
creating 11-2 Validate Approver B-8
defined Glossary-4 Run Process action C-2
vs. relationships 7-9 runtime, troubleshooting E-4
routing, setting up for 7-2
RPC socket number D-6
S
sample Get Agreement application
rule-based process
ad hoc process 6-2
described 7-22
approving requests 6-3
example of 13-4
installing A-8
Get Next Approver rules 10-13
licensing sample users 13-9
rules
More Information requests 6-4, 6-6, 6-7
approval process and 7-4
parent-child hierarchy 13-10
completion 7-14
reassigning requests 6-6
creating 10-2
requesting items 6-2
deleting 10-33
sample Lunch Scheduler application
modifying 10-33
approval processes 13-3
rules, types of
chaining approval processes 13-5
Approval Process Done 10-30
forms 13-2
Auto-Approval 10-5
installing A-8
Completion 10-28
licensing sample users 13-9
Get Authority 7-8, 10-20
overview 13-2
Get Authority Regular 7-14, 10-23
parent-child hierarchy 13-10
Get Authority Self 7-8, 10-25
restarting approval processes 13-6
Get Next Approver 7-10, 10-12
reviewing information 13-7
Prep Get Next Approver 7-10
showing password field 13-8
Prep Next Approver 10-10
showing signatures 13-7
Process Done 7-15
showing summaries 13-7
Self Check 7-7
sample users, licensing 13-9, E-3
Self-Approval 7-8, 10-8
Self Check
Validate Approver 7-10, 10-17, E-4
approvals 7-5, 7-7
rules, worksheets for
rules 7-7
Approval Process Done B-10
Self-Approval
Auto-Approval B-7
defined Glossary-4
12 Index
overview 7-8 Prep Next Approver 10-10
Self-Approval rules Prep Next Approver worksheet B-9
creating 10-8 Self-Approval 10-8
described 10-7 Self-Approval worksheet B-8
example of 10-9 Validate Approver 10-18
worksheet B-8 Validate Approver worksheet B-8
server settings D-6 Setup@Work A-2, E-2
serving as alternate approver 3-5, 4-8, 5-9 Short Description field 12-3
Set Fields tab Show Approval Summary button 13-8
AP:Rule Definition form 10-4 Show Signature button 13-8
Approval Process Done rules 10-31 showpassword 12-8
assignment types 10-4 Sig-Approved command C-7
examples 10-5 Sig-Cancelled command C-8
Get Authority Regular rules 10-24 signature
Get Authority rules 10-21 authority 4-8, 5-9
Get Authority Self rules 10-26 escalations 9-6, D-23
Get Next Approver rules 10-15 escalations worksheets B-3
Validate Approver rules 10-19 line errors 3-4
setting up overriding single 4-10
alternate approvers 4-10 record Glossary-4
approval routing 7-2 signature-line records 10-12, 10-14
field values on forms 10-4 Sig-Notify command C-8
notifications 8-10 Sig-Notify-Change command C-8
roles 11-2 Sig-Notify-State command C-9
setting up rules Sig-Reassign command C-9
Approval Process Done 10-30 Sig-Rejected command C-10
Approval Process Done worksheet B-10 single signature overrides 4-10
Auto-Approval 10-5 socket number D-6
Auto-Approval worksheet B-7 Special Overdue Approval approval
Completion 10-28 process 13-4
Completion worksheet B-10 Specific Process process administrator 7-3
Get Authority 10-20 SQL, Set Fields value 10-4
Get Authority Regular 10-23 starting Approval Server manually A-23
Get Authority Regular worksheet B-10 starting the Approval Server E-4
Get Authority Self 10-25 status
Get Authority Self worksheet B-7 approval requests and 3-3
Get Authority worksheet B-8 Approval Status field 4-2
Get Next Approver 10-13 defining notifications 8-11
Get Next Approver worksheet B-9 Status field 4-2, 12-2, 12-3, 12-4
Index 13
Status field ID 7 12-2 Set Fields tab 10-19
stopping Approval Server manually A-23 worksheet B-8
Submitter field 12-3 viewing
alternate approvers 4-9, 5-11
T approval requests 3-2, 5-4
trails, audit, of approval requests 7-3
approvals 4-3
transfering requests 6-7
More Information responses 4-5, 5-7
tree, directory F-2, F-20
triggering notifications 8-8 W
troubleshooting web browser buttons 5-2, E-3
Application Pending form E-2 web document directory D-7
Approval Web E-3 web server A-24, E-3
approver cannot respond E-4 Windows NT
installation E-2 arjoinfix.exe 12-4
licensing E-2 default directories F-2
Oracle 8.0.x E-4 directory structure F-2, F-20
runtime E-4 installing Approval Server A-4
sample applications E-3 installing Approval Web A-11
manually starting Approval Server A-23
U manually stopping Approval Server A-23
uninstall A-28
starting the service A-23
UNIX
worksheets, process
arjoinfix 12-4
Low Priority Notification B-5
daemon A-2, A-21, A-24
More Information B-2
default directories F-2
Normal Priority Notification B-3
directory structure F-2, F-20
Process definition B-2
installing Approval Server A-19
Urgent Priority Notification B-4
installing Approval Web A-22
worksheets, rule
manually starting Approval Server A-24
Approval Process Done B-10
manually stopping Approval Server A-24
Auto-Approval B-7
Update-Config command C-10
Completion B-10
Urgent Priority Notification worksheet B-4
Get Authority B-8
URL, Approval Central 5-2, E-3
Get Authority Regular B-10
User form D-33
Get Authority Self B-7
V Get Next Approver B-9
Validate Approver rules Prep Next Approver B-9
approver cannot respond E-4 Self-Approval B-8
creating 10-18 Validate Approver B-8
described 7-10, 10-17 write licenses 13-9
example of 10-19
14 Index
Reader Response
Remedy Approval Server 4.0
Users Guide for Windows and UNIX
ARAS-400-UG-01 October 2000
Remedy Corporation welcomes your ideas about how to improve its documentation. Please take a moment to
answer the questions below. Explain any No responses in the Comments section, and include any other com-
ments you may have. Mail this page to the address printed on the reverse side (the address is on the next page if
you are using the PDF version of this guide), or fax it to (650) 903-9001 (U.S.). You can also send comments
through electronic mail to doc_feedback@remedy.com. (If you need product support, send electronic
mail to support@remedy.com, or log on to the support web site at
http://supportweb.remedy.com.)
Yes No
Does this manual contain all the information you expected?
Is all the information in this manual technically accurate?
Is this manual easy to read and understand?
Are there enough examples and illustrations?
Are the examples and illustrations accurate and helpful?
Comments:
Name: Title:
Company:
Address:
City: State: ZIP:
Phone number: Email address:
Place
Stamp
Here
Information Development
Remedy Corporation
1505 Salado Dr., Bldg. 2
Mountain View, CA 94043
USA
Fold Here