| |
|
|
Running Scheduled Integra profiles
Integra for Notes allows profiles to be run in a scheduled manner, however a number of things need to be set right for scheduled profiles to run properly. This document outlines the points that need to be addressed.
- What Operating Systems are supported
- Do I need Word &/or Excel installed on the server
- Considerations for deployment of Word & Excel on a Domino server
- What limitations are there for Integra scheduled profiles
- Enabling Scheduled Profiles in the Integra database
- Security Requirements
- Signing the Scheduled Agent
Detailed descriptions about each of these points are found in the .
What Operating System is Supported?
As Integra for Notes is a standard Lotus Notes database, it is supported on all IBM supported operating system versions of Lotus Domino including Windows, Linux, OS/400 etc and therefore scheduled profiles can also run on any flavour of Domino.
However, there are some specific advanced features that can be used in an Integra profile that will only be able to run on a Windows based version of Lotus Domino as they would require Microsoft Word and/or Excel to be installed on the server. See the next section below.
Do I need Word & Excel installed on the Domino server?
There are some specific advanced features that can be used in an Integra profile that will only be able to run on a Windows based version of Lotus Domino as they would require Microsoft Word and/or Excel to be installed on the server.
 These advanced functions relate to any attempt to undertake a task which is Excel or Word related at the time of running a report and which will require the use of Microsoft's COM facilities. These would require the Export Method found either in the Excel or Word tab of an Integra profile to be set to Advanced COM or XML.
For example, if you use Integra's Event driven LotusScript facility () which would allow processing of data as each row of data is written to Excel, then clearly Excel must be available to perform this task.
Another example which would require Word to be installed on the server is if you are generating an e-mail shot to a number of customers which would contain a personalised individual Word document as an attachment to each e-mail.
If however this type of advanced functionality is not required, then scheduled profiles can run on any IBM supported version of Domino. If you require to use such advanced functionality and are not using a Windows based Domino server See this FAQ for a possible work-around: Running Scheduled Integra Profiles on a local workstation.
Considerations for Word & Excel Deployment to a Domino server?
If you require the use of Integra's advanced functionality into be available even for scheduled profiles and choose to deploy Word and/or Excel onto the Domino server, we suggest that you refer to the following FAQ Considerations for server-side Automation of Microsoft Office which explains some settings which may need to be set).
What limitations exist on Scheduled Profiles?
Since Integra's scheduled profiles are running on the Domino server, they can only make use of functionality able to be processed by a Domino server based agent. As an example, no UI functionality is available on Domino agents because no user is present at the server to interact with the agent. As a result for instance, an Integra scheduled profile cannot be set to prompt the user for data input of a date range as there is no concept of a user with a Domino agent. Equally, this restriction is extended to Integra's scheduled profiles.
If Integra's event driven facility is being used to execute either Notes formula language code or LotusScript, it is important that no UI functionality is utilised in such code. The LotusScript UI classes cannot be used.
Enabling of Scheduled Profiles
All Integra scheduled profiles run using one agent. This reduces the need to have multiple agents running, each supporting a different scheduled profile. This scheduled profiles agent needs to be enabled for the functioning of scheduled Integra profiles and Integra allows the enabling of the scheduled profiles agent through the Scheduled Profiles tab in the Configuration document (see screen shot below) where the link is found entitled "To Enable Scheduled Profiles Click Here"
Security Requirements
When this configuration is enabled, the Domino agent which runs all the scheduled Integra profiles will be enabled using the ID of the user who enabled the agent. As a result, it is essential for enablement to be undertaken using an ID which has rights to run restricted agents on the specific Domino server where this is enabled. If this agent is enabled with an unauthorised ID, then the agents will not run. This agent is classified as a Restricted Agent and therefore the server must be entitled to run Restricted Agents.
Set this security feature within the Security tab of the Server document in the Domino directory where there are a set of options related to Agent Restrictions as shown alongside.
Equally, the access to data available to the scheduled agent will be the level of access granted to the ID that enabled the scheduled agents.
Signing the Scheduled Agent
The scheduled agent running on the server is actually calling a few other script agents, which in turn use a number of script libraries. All these design elements are signed with a Shireburn ID file called Notes Developer/Shireburn. You have two choices to avoid the agent for scheduled profiles not running correctly:
- You sign all design elements either of the Integra template or of your copy of the Integra database with an ID file of your organisation. If you decide to sign the Integra database rather then the template, make sure that you remove the design inheritance if you keep the template on server. The ID file used should be the one placed into the security fields in the server document as explained in the previous point.
(recommanded procedure)
- If you do not want to sign the design elements with an ID of your organisation, you can add the entry Notes Developer/Shireburn in the security fields in the server document as explained in the the previous point.
See FAQ: Scheduled Integra profiles result in no output. |
. |
|
FAQ# 0112
|
|
|
| |