ibi.broker.api.ws
Class ScheduleManagerClientSF

java.lang.Object
  ibi.broker.api.ws.ScheduleManagerClientSF

All Implemented Interfaces:

ScheduleManager

public class ScheduleManagerClientSF
extends java.lang.Object
implements ScheduleManager

Constructor Summary

ScheduleManagerClientSF(java.lang.String base, java.lang.String userName, java.lang.String password)

Method Summary

TimeInfo	addCustomInterval(TimeInfo timeInfo)
java.lang.String	addSchedule(Schedule schedule) Takes a Schedule object and adds it to the ReportCaster repository.
Schedule	createScheduleInstance(int intervalType, java.lang.String methodCode, int taskType) Creates a new Schedule object with specified integer constant values for IntervalType, distributionType, and taskType.
Schedule	createScheduleInstanceDefault() Creates a new Schedule object with default schedule property values.
void	deleteSchedule(java.lang.String scheduleId) Deletes the schedule as identified by its unique schedule identifier from the ReportCaster repository.
AmperParameter[]	getAmperParameterList(Task task) Obtains an Array of AmperParameter objects that are associated with a scheduled task.
AmperParameter[]	getAmperParameterList(Task task, java.lang.String owner) Obtains an Array of AmperParameter objects that are associated with a scheduled task.
java.lang.String[]	getOwnerList() Retrieves a String Array representing the list of schedule owners from ReportCaster repository.
Schedule	getSchedule(java.lang.String scheduleId) Retrieves an existing schedule from the ReportCaster repository based on a given schedule identifier.
java.lang.String	getScheduleId(java.lang.String owner, java.lang.String scheduleDescription) Retrieves the unique schedule identifier from the ReportCaster repository based on specifying the schedule description (see Schedule.getDescription()) and owner.
Schedule[]	getScheduleInfoList(java.lang.String[] scheduleId)
Schedule[]	getScheduleInfoList(java.lang.String owner, java.lang.String method, java.lang.String priority, java.lang.String active, java.util.Calendar startDate, java.util.Calendar endDate)
Schedule[]	getScheduleInfoListByCaller() Retrieves an array of Schedule objects from the ReportCaster repository that are owned by the current logon user (or API caller).
Schedule[]	getScheduleInfoListByOwner(java.lang.String owner) Retrieves an array of Schedule objects from the ReportCaster repository that belong to a specified owner.
Schedule[]	getScheduleList(java.lang.String[] scheduleId)
java.lang.String	run(Schedule schedule) After a Schedule object has been created and its properties populated with data, this method immediately submits the schedule to the ReportCaster Distribution Server, which runs the schedule.
java.lang.String	run(Schedule schedule, JobOptions jobOptions) After a Schedule object has been created and its properties populated with data, this method immediately submits the schedule to the ReportCaster Distribution Server with a JobListener class name, which runs the schedule.
java.lang.String	run(java.lang.String[] scheduleIdList, JobOptions jobOptions)
TimeInfo[]	selectCustomIntervalList()
void	updateSchedule(Schedule schedule) Updates a Schedule object which already exists in the ReportCaster repository.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ScheduleManagerClientSF

public ScheduleManagerClientSF(java.lang.String base,
                               java.lang.String userName,
                               java.lang.String password)
                        throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

getSchedule

public Schedule getSchedule(java.lang.String scheduleId)
                     throws CasterException

Description copied from interface: ScheduleManager

Retrieves an existing schedule from the ReportCaster repository based on a given schedule identifier. The schedule Id uniquely identifies a schedule and can be used to retrieve all schedule data including any information pertaining to tasks associated with the schedule. This method is available to the administrator and the schedule owner only.

Specified by:

getSchedule in interface ScheduleManager

Parameters:

scheduleId - Id that uniquely identifies the schedule in the repository.

Returns:

A Schedule object.

Throws:

CasterException

getScheduleInfoList

public Schedule[] getScheduleInfoList(java.lang.String[] scheduleId)
                               throws CasterException

Specified by:

getScheduleInfoList in interface ScheduleManager

Throws:

CasterException

getScheduleList

public Schedule[] getScheduleList(java.lang.String[] scheduleId)
                           throws CasterException

Specified by:

getScheduleList in interface ScheduleManager

Throws:

CasterException

getScheduleInfoListByCaller

public Schedule[] getScheduleInfoListByCaller()
                                       throws CasterException

Description copied from interface: ScheduleManager

Retrieves an array of Schedule objects from the ReportCaster repository that are owned by the current logon user (or API caller). Because this is designed just to retrieve information for each schedule, for performance reasons, each schedule object has all its properties populated with data with the exception of the task information, which are all NULL (see Schedule.getTaskList()). An administrator will receive all schedules, end user will receive only those schedules owned by him.

Specified by:

getScheduleInfoListByCaller in interface ScheduleManager

Returns:

An array of Schedule objects.

Throws:

CasterException

getScheduleInfoListByOwner

public Schedule[] getScheduleInfoListByOwner(java.lang.String owner)
                                      throws CasterException

Description copied from interface: ScheduleManager

Retrieves an array of Schedule objects from the ReportCaster repository that belong to a specified owner. If the API caller is admin, any owner can be specified. If the caller is an enduser, the owner must be the caller itself. Otherwise, an Exception will be thrown during the permission check. Because this is designed just to retrieve information for each schedule, for performnce reasons,Each schedule object has all its properties populated with data with the exception of the task information, which are all NULL (see Schedule.getTaskList()). This method is available to the administrator and the schedule owner only. An administrator will receive all schedules, an end user will receive only those schedules owned by him.

Specified by:

getScheduleInfoListByOwner in interface ScheduleManager

Parameters:

owner - The schedule owner's username.

Returns:

An array of Schedule objects.

Throws:

CasterException

getScheduleInfoList

public Schedule[] getScheduleInfoList(java.lang.String owner,
                                      java.lang.String method,
                                      java.lang.String priority,
                                      java.lang.String active,
                                      java.util.Calendar startDate,
                                      java.util.Calendar endDate)
                               throws CasterException

Specified by:

getScheduleInfoList in interface ScheduleManager

Throws:

CasterException

addSchedule

public java.lang.String addSchedule(Schedule schedule)
                             throws CasterException

Description copied from interface: ScheduleManager

Takes a Schedule object and adds it to the ReportCaster repository. The schedule object may have been created in any of several ways (for example by using the Schedule object's Constructor or one of ScheduleManager's createScheduleInstance methods). The object itself exists in memory, but does not actually exist in the repository until this method is called. Once the schedule is added to the repository, the newly generated scheduleId (same Id as returned by Schedule.getId()), which uniquely identifies this Schedule>/code> object in the ReportCaster repository, is returned to the caller. This method is available to the administrator and the schedule owner only.

Specified by:

addSchedule in interface ScheduleManager

Parameters:

schedule - A Schedule object encapsulating the new Schedule object.

Returns:

A newly generated schedule identifier or scheduleId.

Throws:

CasterException

updateSchedule

public void updateSchedule(Schedule schedule)
                    throws CasterException

Description copied from interface: ScheduleManager

Updates a Schedule object which already exists in the ReportCaster repository. Before modifying the schedule, ReportCaster checks the scheduleId (see Schedule.getId()) to determine if this schedule object, as identified by its unique Id, is already in the repository/database. If it is, the caller can modify the properties. If it is not already in the database, an exception is thrown (see CasterException below). This method is available to the administrator and the schedule owner only.

Specified by:

updateSchedule in interface ScheduleManager

Parameters:

schedule - A Schedule object encapsulating the existing Schedule.

Throws:

CasterException - The msgId for the Exception thrown if the scheduleId is not in the database is "SCH001".

deleteSchedule

public void deleteSchedule(java.lang.String scheduleId)
                    throws CasterException

Description copied from interface: ScheduleManager

Deletes the schedule as identified by its unique schedule identifier from the ReportCaster repository. This method is available to the administrator and the schedule owner only.

Specified by:

deleteSchedule in interface ScheduleManager

Parameters:

scheduleId - Id that uniquely identifies the schedule in the repository.

Throws:

CasterException

getOwnerList

public java.lang.String[] getOwnerList()
                                throws CasterException

Description copied from interface: ScheduleManager

Retrieves a String Array representing the list of schedule owners from ReportCaster repository. The owner list contains the user names of individuals who have created schedules or have the right to create schedules in ReportCaster. Only the schedule admin user can call this method.

Specified by:

getOwnerList in interface ScheduleManager

Returns:

A String Array of schedule owners.

Throws:

CasterException

run

public java.lang.String run(Schedule schedule)
                     throws CasterException

Description copied from interface: ScheduleManager

After a Schedule object has been created and its properties populated with data, this method immediately submits the schedule to the ReportCaster Distribution Server, which runs the schedule. When the schedule runs, the Distribution Server creates a unique job number or jobId for this schedule, which is returned to the caller upon the completion/execution of the job. This method is available to the administrator and the schedule owner only.

Specified by:

run in interface ScheduleManager

Parameters:

schedule - A Schedule object encapsulating the job that is to be run.

Returns:

A job number generated by the Distribution Server.

Throws:

CasterException

run

public java.lang.String run(java.lang.String[] scheduleIdList,
                            JobOptions jobOptions)
                     throws CasterException

Specified by:

run in interface ScheduleManager

Throws:

CasterException

getScheduleId

public java.lang.String getScheduleId(java.lang.String owner,
                                      java.lang.String scheduleDescription)
                               throws CasterException

Description copied from interface: ScheduleManager

Retrieves the unique schedule identifier from the ReportCaster repository based on specifying the schedule description (see Schedule.getDescription()) and owner. If the API caller is admin, any owner can be specified. If the caller is an enduser, the owner must be the caller itself. Otherwise, an Exception will be thrown during the permission check.

Specified by:

getScheduleId in interface ScheduleManager

Parameters:

owner - The username of the schedule owner

scheduleDescription - The description of the schedule (see Schedule.getDescription()). Note that maximum field length is 90 characters

Returns:

A unique schedule id as a String

Throws:

CasterException

createScheduleInstanceDefault

public Schedule createScheduleInstanceDefault()
                                       throws CasterException

Description copied from interface: ScheduleManager

Creates a new Schedule object with default schedule property values. The default values are: intervalType = ONCE, distributionType = MAIL, and taskType = WEBFOCUS_SERVER_PROCEDURE,priority = 3, and notification is off.

Specified by:

createScheduleInstanceDefault in interface ScheduleManager

Returns:

A new Schedule object.

Throws:

CasterException

createScheduleInstance

public Schedule createScheduleInstance(int intervalType,
                                       java.lang.String methodCode,
                                       int taskType)
                                throws CasterException

Description copied from interface: ScheduleManager

Creates a new Schedule object with specified integer constant values for IntervalType, distributionType, and taskType. The acceptable CONSTANTS are as follows: intervalType: TimeInfo.ONCE, TimeInfo.MINUTE, TimeInfo.HOUR,TimeInfo.DAY,TimeInfo.WEEK,TimeInfo.MONTH, TimeInfo.YEAR distributionType:Distribution.MAIL,Distribution.FTP,Distribution.PRINT,Distribution.MRE,Distribution.LIBRARY taskType: Task.WEBFOCUS_SERVER_PROCEDURE,Task.STANDARD_REPORT,Task.MY_REPORT,Task.URL,Task.FILE If a Notification object isn't attached the default is never, and the default priority is 3.

Specified by:

createScheduleInstance in interface ScheduleManager

Parameters:

intervalType - The time interval (see TimeInfo class).

methodCode - The method of distribution (see Distribution class).

taskType - The type of task (see Task class).

Returns:

A new Schedule object.

Throws:

CasterException

See Also:

TimeInfo.ONCE, TimeInfo.MINUTE, TimeInfo.HOUR, TimeInfo.DAY, TimeInfo.WEEK, TimeInfo.MONTH, TimeInfo.YEAR, Distribution.EMAIL, Distribution.FTP, Distribution.PRINT, Distribution.MRE, Distribution.LIBRARY, Task.WEBFOCUS_SERVER_PROCEDURE, Task.STANDARD_REPORT, Task.MY_REPORT, Task.URL, Task.FILE

getAmperParameterList

public AmperParameter[] getAmperParameterList(Task task)
                                       throws CasterException

Description copied from interface: ScheduleManager

Obtains an Array of AmperParameter objects that are associated with a scheduled task. The only task types for which Amper Parameters are meaningful are Standard Report and My Report (i.e, applying to reports that exist within Managed Reporting or MRE). See AmperParameter for more information. This method is available to the administrator and the schedule owner only.

Specified by:

getAmperParameterList in interface ScheduleManager

Parameters:

task - The Task object containing the Amper variables that get encapsulated in Array of AmperParameter objects..

Returns:

An array of AmperParameter objects.

Throws:

CasterException

See Also:

AmperParameter

getAmperParameterList

public AmperParameter[] getAmperParameterList(Task task,
                                              java.lang.String owner)
                                       throws CasterException

Description copied from interface: ScheduleManager

Obtains an Array of AmperParameter objects that are associated with a scheduled task. The only task types for which Amper Parameters are meaningful are Standard Report and My Report (i.e, applying to reports that exist within Managed Reporting or MRE). See AmperParameter for more information. This method is available to the administrator and the schedule owner only.

Specified by:

getAmperParameterList in interface ScheduleManager

Parameters:

task - The Task object containing the Amper variables that get encapsulated in Array of AmperParameter objects..

owner - The username of the schedule owner

Returns:

An array of AmperParameter objects.

Throws:

CasterException

See Also:

AmperParameter

run

public java.lang.String run(Schedule schedule,
                            JobOptions jobOptions)
                     throws CasterException

Description copied from interface: ScheduleManager

After a Schedule object has been created and its properties populated with data, this method immediately submits the schedule to the ReportCaster Distribution Server with a JobListener class name, which runs the schedule. When the schedule runs, the Distribution Server creates a unique job number or jobId for this schedule, which is returned to the caller upon the completion/execution of the job. This method is available to the administrator and the schedule owner only.

Specified by:

run in interface ScheduleManager

Parameters:

schedule - A Schedule object encapsulating the job that is to be run.

Returns:

A job number generated by the Distribution Server.

Throws:

CasterException

addCustomInterval

public TimeInfo addCustomInterval(TimeInfo timeInfo)
                           throws CasterException

Throws:

CasterException

selectCustomIntervalList

public TimeInfo[] selectCustomIntervalList()
                                    throws CasterException

Throws:

CasterException