Jenoo Training Course
CategoryLotus Notes R5.0
Sub CategoryApplication Development
Course TitleApplication Development Server Agents for Lotus Domino Designer
Duration (days)1 day
Jenoo Code
Details Last Updated09/12/2000

Description
During this course you will create agents that run in memory of the Domino Server. These agents run on a scheduled or event-driven basis, and are written using Simple Actions, Formulas, or LotusScript.

Emphasis is placed on understanding the security requirements and server resources required to safely and effectively run agents.

You will also learn about the Agent Manager, including its configuration, operation, and troubleshooting.

This course also covers the LotusScript NotesLog object class, with which you will log agent actions and errors to keep track of their operation.


Course Goals

This course will:
  • define the purpose of scheduled and event-driven agents and provide examples of their effective use
  • describe the four components of every agent design
  • explain how to use the Agent List to create and modify agents
  • explain the relationship between full text search indexes and agent scheduling
  • show how to programmatically execute agents
  • provide experience designing agents written using Simple Actions, Formulas, and LotusScript
  • describe the role of the Agent Manager and Router in executing scheduled and event-driven agents
  • provide scheduling and programming techniques to increase agent potency and reduce overhead
  • explore the many security requirements for successful agent operation
  • provide agent troubleshooting and logging techniques.

Intended Audience
This course is designed for Domino Programmers, but may also be of interest to Domino Administrators who want to know about the Agent Manager server task. The course assumes that you have:
thorough knowledge of the Domino Designer development environment, including form and view design, as well as how to use properties boxes, and how to set the ACL
mastered the topics covered in Basic Applications for Domino Designer, Programming Languages for Domino Designer: Function Language, and Programming Languages for Domino Designer: LotusScript.
Though not required, experience in any computer programming or application scripting language (including spreadsheet formulas) is helpful in understanding how to maximize the use of the @Formula language.

Course Overview
This lecture-lab course involves significant hands-on agent development experience using Simple Actions, @Formulas, and LotusScript. It only peripherally explores the principles of programming and does not attempt to cover every option of every function.
The course takes a task-oriented approach, during which you will increase your understanding of how agents operate.
Topic 1: Agent Basics
Key points
The purpose of agents
Agent examples
Four components to all agents
The Trigger
The Scope
The Search
The Task
Language choice and execution speed
Agent considerations
Agent alternative
Topic 2: Creating Agents
Key points
Agent List
New agent dialog box
Agent options
Search using the Full Text Index
Full text index settings
Agent testing
Running agents programmatically
Topic 3: Run Simple Action
Key points
Adding Simple Actions
How Simple Actions operate on documents
Simple Action actions and equivalents
Exercise: Simple action agent
Topic 4: Run Formula
Key points
How Formulas operate on documents
Search using SELECT statement
Cannot select response documents
Accessing Rich Text fields with SELECT
Create or modify documents
Field operations
Single-value versus multi-value fields
Exercise: SELECT and FIELD keywords
Conditionally save changes
Delete field
Rename field
Change document attribute
Remove form stored in document
Delete document
Usage guidelines
Exercise: Response document consolidation
Topic 5: Agent Manager
Key points
Agent management
Agent Manager functions
Server document schedule settings
Agent Manager queues
Starting Agent Manager
Database properties
Replicating agents
Run one agent or many?
Topic 6: Agent Security
Key points
Agent platform principles
Agent creation rights
Agent signature
Exercise: View agent signature
Agent signer authentication
Security layer
Server access
Agent execution rights
Exercise: Agent execution rights
Database ACL
Effective Document Editor
Execution Control List
Topic 7: Run LotusScript
Key points
Language Option and Initialize event
Select a "pool" of documents for processing
Event-driven agent document pool
Process pool of documents
Exercise: Process pool of documents
Select a single document for processing
Process single document
Exercise: Updating the response document with parent ation
Before New Mail Arrives trigger
Batch operations
Using the Search Builder
Usage guidelines
Exercise: Response document consolidation
Topic 8: Agent Scheduling
Key points
Agent settings
Enable the agent
Show Agent Manager schedule
Exercise: Schedule agent
Programmatically enable agent
Weekend definition for daily agents
Event-driven agent latency
Configuring latency
Avoiding replication conflicts
Dedicated agent servers
Topic 9: Agent Troubleshooting
Key points
Configuration review
Failure to run
Agent Manager debug mode
Code debugging
Performance
Topic 10: Logging
Key points
Notes Log
Agent Log
Exercise: Agent Log
Agent Log Actions
Exercise: Agent Log Actions
Custom logging
Creating a custom log database
Coding the custom logging
Exercise: Logging to a Notes Database
Agent performance