87088d71d9df57d7fced28ce357d8d1febdde586
FAQ/Questions/How-do-I-use-the-Izenda-Reports-report-email-scheduler.md
| ... | ... | @@ -4,22 +4,41 @@ |
| 4 | 4 | |
| 5 | 5 | ##Izenda Reports Scheduler Setup Instructions |
| 6 | 6 | |
| 7 | -It is recommended that you perform these installation steps on the Web Server on which Izenda Reports is installed. |
|
| 7 | +First, a little background about how the scheduler works. The scheduler requires the use of the Izenda Scheduler executable that is found in the root of the directory you installed Izenda Reports in. You then need to add a scheduled task to your system that runs every minute. The task uses the Izenda Scheduler to access a page in the application that determines if any reports need to go out. The Izenda Scheduler executable does not actually send out the files or access anything else except for the specific page in the reporting application that you give the .exe file as a parameter. |
|
| 8 | + |
|
| 9 | +Here are the steps to install the Izenda Scheduler. It is recommended that you perform these installation steps on the Web Server on which Izenda Reports is installed. |
|
| 10 | + |
|
| 11 | +1. Click the **Start** button in Windows Server |
|
| 12 | +2. Click on the **Control Panel** menu option |
|
| 13 | +3. The **Control Panel** will then expand and show a larger menu. Find the menu option **Scheduled Tasks** and click on it |
|
| 14 | +4. After it expands click **Add Scheduled Task**. |
|
| 15 | +5. The **Scheduled Task Wizard** will start. Click **Next** |
|
| 16 | +6. Select the Izenda scheduler program by clicking **Browse** |
|
| 17 | +7. Browse to the folder that you installed Izenda Reports in and select the Izenda scheduler program ( **IzendaScheduler.exe** ) |
|
| 18 | +8. Enter a name for the scheduled task and select the frequency. Click **Next** |
|
| 19 | +9. Set the start time and start date and click **Next** |
|
| 20 | +10. Enter the user name and password of a user with administrative rights and click **Next** |
|
| 21 | +11. Check the **Open Advanced Properties for this Task...** checkbox |
|
| 22 | +12. Click **Finish** |
|
| 23 | +13. Now we need to add the proper command line parameter into the **Run** box. This will be the path to the rs.aspx page. (ex: **http://yourhost/yourapp/rs.aspx** ) |
|
| 24 | +* Click **Apply** and then Click **Ok** |
|
| 8 | 25 | |
| 9 | -First, we must allow the schedule controls to be shown in the Report Designer page. This can be done in one of two ways. |
|
| 26 | +Now that you have setup the scheduler, we will need to setup Izenda Reports. There are two ways to do this. We recommend using the [[InitializeReporting()|/FAQ/InitializeReporting]] method in your CustomAdHocConfig class to do this, but you may also use the settings.aspx page included with our demo to create a config file that will take the place of any settings in code. |
|
| 27 | + |
|
| 28 | +Next, we must allow the schedule controls to be shown in the Report Designer page. This can be done in one of two ways. |
|
| 10 | 29 | |
| 11 | 30 | **Via Settings.aspx** |
| 12 | 31 | |
| 13 | -* Navigate to the Izenda Reports settings.aspx page (e.g. http://yourhost/yourapp/settings.aspx) |
|
| 14 | -* Click the "Email & Scheduling" tab |
|
| 15 | -* Check the box next to "Show Schedule Controls" |
|
| 16 | -* Click "Save to Izenda.Config" in the upper left-hand corner |
|
| 32 | +1. Navigate to the Izenda Reports settings.aspx page (e.g. http://yourhost/yourapp/settings.aspx) |
|
| 33 | +2. Click the "Email & Scheduling" tab |
|
| 34 | +3. Check the box next to "Show Schedule Controls" |
|
| 35 | +4. Click "Save to Izenda.Config" in the upper left-hand corner |
|
| 17 | 36 | |
| 18 | 37 | **Via Code** |
| 19 | 38 | |
| 20 | -* Open your global.asax file in your IDE/favorite text editor |
|
| 21 | -* Look for the [[InitializeReporting|/FAQ/InitializeReporting]] method |
|
| 22 | -* Add the following line of code into the method |
|
| 39 | +1. Open your global.asax file in your IDE/favorite text editor |
|
| 40 | +2. Look for the [[InitializeReporting|/FAQ/InitializeReporting]] method |
|
| 41 | +3. Add the following line of code into the method |
|
| 23 | 42 | |
| 24 | 43 | ```csharp |
| 25 | 44 | Izenda.AdHoc.AdHocSettings.ShowScheduleControls = true; |
| ... | ... | @@ -27,29 +46,6 @@ Izenda.AdHoc.AdHocSettings.ShowScheduleControls = true; |
| 27 | 46 | |
| 28 | 47 | The schedule controls will now be shown in the report designer under the [[Misc tab|http://wiki.izenda.us/Guides/ReportDesign/9.0-Misc-Tab]]. |
| 29 | 48 | |
| 30 | -Next, a little background about how the scheduler works. The scheduler requires the use of the Izenda Scheduler executable that is found in the root of the directory you installed Izenda Reports in. You then need to add a scheduled task to your system that runs every minute. The task uses the Izenda Scheduler to access a page in the application that determines if any reports need to go out. The Izenda Scheduler executable does not actually send out the files or access anything else except for the specific page in our application that you give the .exe file as a parameter. |
|
| 31 | - |
|
| 32 | -You must follow the steps below or the reports will not be e-mailed. |
|
| 33 | - |
|
| 34 | -Click the "Start" button in Windows Server, then click on the"Control Panel" menu option, the "Control Panel" will then expand and show a larger menu, Find the menu option "Scheduled Tasks" and click on it, after it expands click "Add Scheduled Task", the "Scheduled Task Wizard" will start. The screen shots and captions below demonstrate how to enable the Izenda scheduler. |
|
| 35 | - |
|
| 36 | -* Click on the Windows "Start Menu" and open the "Control Panel" |
|
| 37 | -* Click on the "Scheduled Tasks" menu option |
|
| 38 | -* Click "Add Scheduled Task" |
|
| 39 | -* The "Add Scheduled Task" wizard will start. Click "Next" |
|
| 40 | -* Select the Izenda scheduler program by clicking "Browse" |
|
| 41 | -* Browse to the folder to which you installed Izenda Reports and select the Izenda scheduler program ( IzendaScheduler.exe ) |
|
| 42 | -* Enter a name for the scheduled task and select the frequency |
|
| 43 | -* Set the start time and start date |
|
| 44 | -* Enter the user name and password of a user with administrative rights and Click "Next" |
|
| 45 | -* Check "Open Advanced Properties for this Task..." |
|
| 46 | -* Click "Finish" |
|
| 47 | -* Now we need to add the proper command line parameter into the "Run" box as indicated by the arrow. |
|
| 48 | -* IzendaScheduler.exe takes the path to the rs.aspx page as a parameter (ex: http://yourhost/yourapp/rs.aspx ) |
|
| 49 | -* Click "Apply" and then Click "Ok" |
|
| 50 | - |
|
| 51 | -Now that you have setup the scheduler, we will need to setup Izenda Reports. There are two ways to do this. We recommend using the [[InitializeReporting()|/FAQ/InitializeReporting]] method in your CustomAdHocConfig class to do this, but you may also use the settings.aspx page included with our demo to create a config file that will take the place of any settings in code. |
|
| 52 | - |
|
| 53 | 49 | ##Setup using the Settings.aspx page |
| 54 | 50 | |
| 55 | 51 | To use the Settings.aspx page: |