Changes between Version 1 and Version 2 of Software/Manual/WizardWalkthrough


Ignore:
Timestamp:
04/18/13 14:58:13 (6 years ago)
Author:
smith@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Software/Manual/WizardWalkthrough

    v1 v2  
    11= Walkthroughs - Using the Raptor Wizard = 
    22 
     3== Walkthrough 1 - JUSP and Shibboleth IdP data broken down by department for a particular month == 
     4 
     5In this walkthrough, we have the following scenario. We've looked at the JUSP data and found that Science Direct is the most used resource in terms of downloads. So, we want to take that data and alongside it show authentications to Science Direct via SAML (the Shibboleth IdP) broken down by departments. This will allow you to get a rough idea of which departments might be the biggest users of this particular resource. 
     6 
     7So we'll be using the Wizard to graph JUSP data for a given time period (the previous month), and for the same time period, Shibboleth IdP authentications broken down by department. 
     8 
     9=== Step 1 - Loading the wizard === 
     10 
     11Click on the wizard tab of Raptor Web. 
     12 
     13[image 1] 
     14 
     15=== Step 2 - Creating a new report === 
     16 
     17Click on the "Create a new report" icon. 
     18 
     19[Image 2] 
     20 
     21=== Step 3 - Choosing the reporting period === 
     22 
     23For this example, we want to look at the last calendar month's data. So in the dropdown, choose "Last Month". 
     24 
     25[Image 3] 
     26 
     27Click next. 
     28 
     29=== Step 4 - Choosing the event types === 
     30 
     31We want to look at JUSP data and Shibboleth IdP data. So in the dropdown, choose "JUSP Monthly" and click on add, then "ShibbolethIdP" and click on add again. 
     32 
     33[Image 4] 
     34 
     35Click next. 
     36 
     37=== Step 5 - Choosing which functions to use === 
     38 
     39For the JUSP data, we'd like to view all JUSP data for Cardiff for the chosen time period. So make sure the institution parameter for the JUSP data shows "car". 
     40 
     41For the Shibboleth IdP data, we would like to group the data according to department. In Raptor this Group By field is "principalInformation.school", so choose that in the dropdown. 
     42 
     43[Image 5] 
     44 
     45Click next. 
     46 
     47=== Step 6 - Graph Options === 
     48 
     49The first set of options you can modify are which series are to be displayed, and appropriate filters. For the Jusp data, we want to show all JUSP data unfiltered, so simply leave these alone. For the Shibboleth IdP data we want to show only logins to Science Direct, so we need to apply a filter. Click on the add filter button, and set up a filter for "resourceId" "EQUALS" "https://sdauth.sciencedirect.com/" (the entityId for the Science Direct SAML Service Provider). 
     50 
     51[Image 6.1] 
     52 
     53[Image 6.2] 
     54 
     55Click on Save, then next. 
     56 
     57The second set of options you can modify are transformations to the data (for example sorting, cutting rows, etc). In this walkthrough, we don't need to use any of these, so click Next. 
     58 
     59The third set of options are graph display options - type of graph, size, etc. For now the defaults are fine, but you might want to give the Graph a meaningful title - note that if you save this Report for reuse later, its name is derived from the Graph Title. So enter a title, e.g. "Science Direct usage in JUSP and Shib IdP broken down by school, last month". 
     60 
     61[Image 6.3] 
     62 
     63Click next. 
     64 
     65Finally, if you have multiple graphs (i.e. multiple data types), you are prompted whether you want the graphs to appear side-by-side or on top of each other. Make your choice and click next. 
     66 
     67 
     68=== Understanding the Results === 
     69 
     70You should now be presented with the data you requested. That is, JUSP usage for the last month in the top graph, of which Science Direct JR1 downloads dominate, then underneath, Shibboleth IdP authentications to the Science Direct SAML SP broken down by school. You can see that in this case, there are three departments which dominate the downloads. 
     71 
     72=== Limitations === 
     73 
     74Using Raptor with data of differing types, such as JUSP and Shibboleth IdP, has certain limitations. For example, in this walkthrough, we used authentications to the Science Direct SAML SP to get an indication of which departments might be responsible for all of those JR1 JUSP downloads in Science Direct. However, the Science Direct SAML SP is actually a single SAML SP run by Elsevier that is responsible for authentications to both Science Direct and to Scopus. So, when using the Raptor wizard, all such conclusions must be considered purely indicative and not absolute.