Tekst źródłowy strony ELIS Reports and roles

ELIS provides program administrators a method to manage who can view and schedule reports by the context in which a role is assigned. <br />ELIS enables ELIS Administrators to setup roles that give the user the ability to view or view/schedule report data filtered by the context of where the role is assigned. For example, the capability to view reports can be added to a &quot;user set supervisor-type&quot; role that is assigned at the user set context. The supervisor can then filter reports by his/her user sets only.<br /><br />To create a new role go to the Administration block &gt; Site Administration &gt; Users &gt; Permissions &gt; Define roles. Scroll to the bottom of the page and select the &quot;Add a new role&quot; button and follow the steps below:<br />
<ul>
  <li>Enter a name: View Reports</li>
  <li>Enter a shortname: viewreports</li>
  <li>Enter the context types where the role may be assigned: User Set</li>
  <li>In the Capabilities section, scroll to the ELIS Report capabilities and allow &quot;View ELIS reports - block/php_report:view&quot;.</li>
  <li>Scroll to the bottom of the page a select the &quot;Create this role&quot; button.</li>
</ul><br />In the image below, we are assigning the role called &quot;View Reports&quot; in the ACME Corporation user set. The user who is assigned this role will be able to view reports for users in his/her user set. This process can be followed in any ELIS context (program, course, class, track, user set).<br /><br />Go to the Program Management block &gt; Users &gt; Manage User Sets. Choose the name of the user set where the role should be assigned. Select the (1) Roles tab. Select the (2) role (e.g., View Reports) that should be assigned. Select a user and assign the role.<br />
<div style="margin-left: 40px;"><br /></div>[[Image:elis_rolesandreports.png|frame|center|]]<br />The following is a table that provides details on a role capability and what that capability will allow in each context.<br /><br />
<table border="1" cellspacing="2" cellpadding="5" style="background-image: none; border-width: 2px; float: none; text-align: left; vertical-align: top; border-style: solid;" frame="void" rules="all"> 
  <tr>
    <td>
      <p><strong>Role Capability</strong></p>
    </td>
    <td>
      <p><strong>Context Assigned<br /></strong></p>
    </td>
    <td>
      <p><strong> Result -- </strong> User can view and/or schedule the following reports</p>
    </td>
  </tr>
  <tr>
    <td>
      <p> block/php_report:view </p>
    </td>
    <td>
      <p>program</p>
    </td>
    <td>
      <p> 1. <strong>Course Completion Gas Gauge</strong> - user can filter report by courses in assigned program only. </p>
      <p> 2. <strong>Individual Course Progress Report</strong> - user can generate report for self only<i></i></p>
      <p> 3. <strong>Sitewide Course Completion Report</strong> - user can filter for courses in the assigned program only. </p>
      <p> 4. <strong>Class Completion Gas Gauge</strong> - user can filter by courses/classes in the assigned program only. </p>
      <p> 5. <strong>Class Roster Report</strong> – user can filter for course/class within assigned program only. </p>
      <p> 6. <strong>Individual User Report </strong>— user can generate report for self-only.<br /></p>
      <p> 7. <strong>Course progress Summary Report</strong> — user can filter for assigned program only. Choosing &quot;All programs or no filter&quot; generates a report for assigned program data only.<br /></p>
      <p>8. <strong>New Registrants by Course - </strong>user can filter for assigned program only. Choosing &quot;All program&quot; generates a report for assigned program data only.</p>
    </td>
  </tr>
  <tr>
    <td style="vertical-align: top;">block/php_report:schedule<br />
    </td>
    <td style="vertical-align: top;">program<br />
    </td>
    <td style="vertical-align: top;">User can schedule all reports with filters as outlined above, except for the Individual Course Progress Report and Individual User Report. To schedule the &quot;Individual&quot; reports you must be assigned schedule permission in a user, user set, or site context. The Report Usage Report can not be scheduled.<br />
    </td>
  </tr>
  <tr>
    <td>
      <p> block/php_report:view </p>
    </td>
    <td>
      <p>course</p>
    </td>
    <td>
      <p> 1. <strong>Course Completion Gas Gauge -</strong> user can filter for only assigned course. If “any value” is selected, report is generated for assigned course only.</p>
      <p> 2. <strong>Individual course Progress Report</strong> — user can generate report for self only.</p>
      <p> 3. <strong>Sitewide Course Completion Report</strong> — user can filter for assigned courses or all courses. When choosing “all” report generates data for for assigned course only.</p>
      <p> 4. <strong>Class Completion report</strong>— user can filter for assigned course/class only.<br /></p>
      <p> 5. <span style="font-weight: bold;">Class Roster Report </span>— user can filter for assigned course/class only.<br /></p>
      <p> 6. <strong>Individual User Report </strong>- user can generate report for self only.<br /></p>
      <p> 7. <strong>Course Progress Summary Report </strong>- user can filter for assigned course only. If &quot;no filtering&quot; or &quot;All programs&quot; is selected the reported is generated for assigned course(s) only. <br /></p>
      <p> 8. <strong>New Registrant by Course Report</strong> - user can generate this report for assigned course(s) only.<br /></p>
    </td>
  </tr>
  <tr>
    <td style="vertical-align: top;">block/php_report:schedule<br />
    </td>
    <td style="vertical-align: top;">course<br />
    </td>
    <td style="vertical-align: top;">User can schedule all reports with filters as outlined above, except for the Individual Course Progress Report and Individual User Report. To schedule the &quot;Individual&quot; reports you must be assigned schedule permission in a user, user set, or site context.
    </td>
  </tr>
  <tr>
    <td>
      <p> block/php_report:view </p>
    </td>
    <td>
      <p>track</p>
    </td>
    <td>
      <p> 1. <strong>Individual Course Progress Report</strong> - user can generate report for self only. <i></i></p>
      <p> 2. <strong>Class Completion Gas Gauge</strong> — user can filter report for class within assigned track only.<br /></p>
      <p><i> 3. </i><strong>Class Roster Report</strong> — user can filter report for class within assigned track only.<i></i></p>
      <p> 4. <strong>Individual User Report </strong>— user can generate report for self only. <i></i></p>
    </td>
  </tr>
  <tr>
    <td style="vertical-align: top;">block/php_report:schedule
    </td>
    <td style="vertical-align: top;">track<br />
    </td>
    <td style="vertical-align: top;">User can schedule all reports with filters as outlined above, except for the Individual Course Progress Report and Individual User Report. To schedule the &quot;Individual&quot; reports you must be assigned schedule permission in a user, user set, or site context.
    </td>
  </tr>
  <tr>
    <td>
      <p> block/php_report:view </p>
    </td>
    <td>
      <p>class</p>
    </td>
    <td>
      <p> 1. <strong>Class Completion Gas Gauge </strong>— user can filter for assigned class only.<br /></p>
      <p> 2. <strong>Class Roster Report </strong>— user can filter for assigned class only.<br /></p>
    </td>
  </tr>
  <tr>
    <td style="vertical-align: top;">block/php_report:schedule
    </td>
    <td style="vertical-align: top;">class<br />
    </td>
    <td style="vertical-align: top;">User can schedule all reports with filters as outlined above.
    </td>
  </tr>
  <tr>
    <td>
      <p> block/php_report:view </p>
    </td>
    <td>
      <p>user set<br /></p>
    </td>
    <td>
      <p><i> </i>1. <strong>Programs Report</strong> — user can filter by assigned user set or users within assigned user set. If no filter is used, report generates data for user set members of assigned user set only.</p>
      <p>2.<span style="font-weight: bold;"> Course Completion by Cluster Report </span>-- user can filter by assigned user set only.</p>
      <p><i> 3. </i><strong>Individual Course Progress Report</strong> — user can filter the report for users in assigned program only. </p>
      <p><i> 4. </i><strong>Individual User Report</strong> – user can filter the report for users in the assigned program only. </p>
      <p><i> 5. </i><strong>New Registrants by Student Report</strong> — user can filter by assigned user set. If no user set is chosen, the report generates data for users in the assigned user set only. </p>
      <p> <span style="font-style: italic;">6</span>. <strong>Sitewide Time Summary </strong>— user can filter by name of user or by assigned user set. If no user set is chosen, data is generated for assigned user set members only. If a name is entered, only user set members with that name will appear in report. </p>
      <p><i> 7. </i><strong>Sitewide Transcript Report</strong> -- user can filter by name of user or by assigned user set. If no user set is chosen, data is generated for assigned user set members only. If a name is entered, only user set members with that name will appear in report. </p>
    </td>
  </tr>
  <tr>
    <td style="vertical-align: top;">block/php_report:schedule
    </td>
    <td style="vertical-align: top;">user set<br />
    </td>
    <td style="vertical-align: top;">User can schedule all reports with filters as outlined above.
    </td>
  </tr>
  <tr>
    <td>
      <p> block/php_report:view </p>
    </td>
    <td>
      <p>site</p>
    </td>
    <td>
      <p> 1. <strong>Programs Report</strong> — user can generate report for any or all programs.</p>
      <p>2.<span style="font-weight: bold;"> Course Completion by User Set Report </span>-- user can filter by assigned user set only.<br /></p>
      <p> 3. <strong>Course Completion by User Set Report </strong>- user may select any user set or no user sets for this report. If no user set is selected, a report is generated for Course completion data for all user sets, by user set.</p>
      <p> 4. <strong>Individual Course Progress Report</strong> — user can filter for any user on the site.</p>
      <p><strong> 5. </strong><strong>Sitewide Course Completion Report — </strong>user can filter for all courses or any one course on the site. All enrolled users on <strong style="font-weight: normal;">the site are included in the reports.</strong></p>
      <p> 6. <strong>Class Completion Gas Gauge </strong>— user can select any course/class on the site.</p>
      <p> 7. <strong>Class Roster Report </strong>- user can select any course/class on the site.</p>
      <p> 8. <strong>Individual User Report</strong> - user may select any user on the site for this report.</p>
      <p>9. <strong>User Class Completion Report</strong> - .</p>
      <p>10. <strong>Absence Report</strong> - .</p>
      <p> 11. <strong>Course Progress Summary Report </strong>— user can filter by any or all programs and any or all user sets on site.</p>
      <p> 12. <strong>New Registrants by Course Report</strong> — user can filter by any or all programs on the site.</p>
      <p> 13. <strong>New Registrants by Student Report</strong> — user can filter for all or one user set on the site.</p>
      <p> 14.<span style="font-weight: bold;"> Site Usage Summary Report</span><strong></strong> - .</p>
      <p> 15. <strong>Sitewide Time Summary Report - </strong>user can filter by name or by any user set on the site.</p>
      <p> 16. <strong>Sitewide Transcript Report</strong> - user can filter by name or run the report for all users on the site.</p>
    </td>
  </tr>
  <tr>
    <td style="vertical-align: top;">block/php_report:schedule
    </td>
    <td style="vertical-align: top;">site<br />
    </td>
    <td style="vertical-align: top;">User can schedule all reports with filters as outlined above, except for the Site Usage. The Report Usage Report can not be scheduled.
    </td>
  </tr>
</table><br />To give a user permission to view reports only, is only necessary to set the &quot;block/php_report:view&quot; capability to allow. However, if a user should be able to schedule reports both the &quot;block/php_report:view&quot; and &quot;block/php_report:schedule&quot; capabilities should be set to allow. The &quot;block/php_report: schedule&quot; capability does not function when set to allow without the &quot;view&quot; capability as well.<br /><br />In the table above the word &quot;assigned&quot; refers to the specific program, course, class, track, or user set in which the user has been assigned the role which includes the &quot;view&quot; and/or &quot;schedule&quot; capability. The role is assigned via the Roles tab of that program, course, etc.<br /> 

[[Category: ELIS]] [[Category: ELIS Reports|EAAab]]