### Scheduling report sets via URL

A schedule contains two kinds of properties. The first is about time information and the second is about task information (for detailed information about each property, see Appendix 4: Properties - scheduling report sets via URL).

When report sets are scheduled via URL in a web browser, the method jrs.submit_schedule is called. The following is a description of this method.

- Constant: `jet.cs.util.APIConst.CMD_SUBMIT_SCHEDULE.`
- Description: Submits a scheduled task to JReport Enterprise Server. If the report set has no parameters then it directly run the URL. If the report set has parameters and no parameter specified in the URL or the parameters provided in the URL fail to include all necessary parameters, the server then returns the parameter dialog for entering parameter values.
- HTTP Method: GET/POST.
- Response: Returns the task ID to JRClient API, and returns the scheduled tasks page to web browsers.

#### Specifying parameters using dialog when scheduling via URL

When scheduling reports in a report set via URL, if the reports contain parameters, you need to manually enter the parameters in the URL string without any mistakes. You may find this painful sometimes because it's not easy to remember all parameters in a report set. However, JReport provides you with the special command jrs.submit_schedule, which enables to display the Enter Parameter Values dialog to manage parameters.

The display of the parameter dialog requires:

- The reports have parameters.
- The URL contains the command jrs.submit_schedule.
- No parameter specified in the URL or the parameters provided in the URL fail to include all necessary parameters.

With the above three conditions fulfilled, the Enter Parameter Values dialog will be displayed right after you finish the URL in the address bar and make it run. After setting the values and clicking OK in the dialog, JReport Enterprise Server will append the values to the URL string for you and execute the URL. However, if you click Cancel in the dialog, the URL running will be cancelled.

Tip: If you want to specify parameters via dialog when scheduling reports via URL, the most effective way to display the parameter dialog is that you do not specify parameters at all in the URL.

The following are some specific examples on how to schedule a report set via URL:

- Publishing a report set to the versioning system immediately
- Publishing a report set to the versioning system periodically
- Publishing a report set to the versioning system at a specific time
- Publishing a report set to the file system immediately
- Publishing a report set to e-mail immediately
- Publishing a report set to printer immediately
- Publishing a report set to the versioning system immediately and notifying others whenever success or failure

###### Related topics:

- Setting dynamic parameter values when running or scheduling a report set via API