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.
Lotus Training Learning Objectives
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.
Lotus Training 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.
Lotus Training Course duration
1 day
Lotus Training Course design
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.
Lotus Training Course outline
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
|