Monday, March 31, 2014

Known Issues

31 March, 2014 - Chrome on Android cannot download PDF Reports.

Have been unable to determine what is wrong. Can download sample report but not direct reports. This doesn't make sense. Trying to work it.

After making some changes it appears to work, but we should monitor.


31 March, 2014 - Pepper Flash Player hesitates (freezes for 4 - 30 seconds) after clicks.

Chrome comes with it's own Flash player "Pepper Flash" that is maintained by google and not by Adobe. This player has been observed to hesitate occasionally after a click for 4 - 30 seconds. It appears flash has frozen and then it works. In order to avoid this condition, a checkbox is now available in ClicFlic -> IMO -> Main Settings -> Deployment Settings to avoid using the Pepper Flash player if it is present and if HTML5 is available.




 





Monday, March 24, 2014

Direct Testing (Completely Bypassing a Portal)

Given the browser-driven nature of ClicFlic IMOs, it is sometimes preferable to completely bypass the testing portal when administering an assessment. This enables HR Avatar to administer tests directly on customer's websites, if they want to do it that way. The IMO will still report everything to the testing system and the results will be handled exactly as if a testing portal would be used. But all access is controlled by the customer and there is no pin code or anything.

Velocity Performance uses this approach.

Configuring a SIM for Direct Testing
  
The IMO is embedded in the customer webpage exactly as if it were a hosted IMO with ClicFlic, except:

  • There is a 'direct test code' parameter added to the IMO parameters. This code is Sim and Org specific, and can be obtained via the SimBuilder website.
  • The Sim IMO must collect name/email information and this must be included in the result XML using the name and email field identifiers. 
  • The customer must include a unique xref value for the test event in the parameters, otherwise there will be no restart capability if the person abandons in the middle and restarts. Without a unique xref value, the system will treat all starts as new starts and the restarting test taker will have to start over. 


Products and Product Groups

A Product is anything we deliver or sell on HR Avatar. All Products have a product record.

So, every Sim that is provided through HR Avatar as a test must have a Product record. A package of credits sold to a customer must have a product record.

A Product Group is a set of Products.

The catalog system on HR Avatar uses Product Groups.

For example, there are default Product Groups, whose products are made available to everyone regardless of their organization. There are also Product Groups that are only made available to individuals for specific Organizations.

So, if we create a Sim we want to sell to everyone, be create a Product and we add that product to the HR Avatar public Product Group. If we create a sim that is only to be made available to one customer, we create a Product and we create a new Product Group containing that Product. Then we associate the new Product Group with the Org of the customer who will use it. 

Organizations, Suborganizations, Users, and Roles

A User is ANY individual who either performs an activity on any site, such as take a test, log on to a corporate account, etc.

All Users must belong to one Org.

An Org can any (or none) number of Suborgs.

A User can be associated with zero or one Suborg.

Users can be either "Named" or "Anonymous" - though we don't know the name of an anonymous user, they can still exist on the system as a test-taker.

Users, Orgs, and Suborgs can all set various defaults that are only overridden by the object below it in specificity. So, User overrides Suborg and Suborg overrides Org. These defaults include such items as where to email or text test results.

All users are assigned a role that determines there access. These roles are:
  • No Logon
  • Personal Logon Only
  • Logon Portal User
  • Account User Level 1
  • Account User Level 2
  • Account User Level 3 
  • Overall System Administrator
A No Logon User has no account privileges. They are a test taker only, or they requested a white paper or performed some other action that caused them to register. These users are associated with the org they are testing with.

A Personal User - belongs to the default personal account org and has his/her own personal account on HR Avatar (this functionality is not currently used).

A Portal User is a test taker who accesses a logon testing portal and therefore needs a logon id and password, which will work only for the logon portal.

Account Level 1 Users can view results only. They cannot initiate tests.

Account Level 2 Users can view results only and initiate tests.

Account Level 3 Users can also manage the 'Role' of all account users and create new account users.

Duplicates

Note that the system tries to associate users by their email address WITHIN A SINGLE ORGANIZATION ONLY. So, if the same person takes a test with three different organizations, they will have three different User records on our system, one for each Org.




Testing Portal Basics

There are two different kinds of testing portals available on HR Avatar's testing system.

These are:
  1. PIN Portals, which require an Access Key with PIN that determines what test (sim) or tests (for a battery) to administer.
  2. LOGON Portals, which require a user to log on and which administer a single battery of tests to the logged on user. 
PIN Portals administer the test(s) associated with that PIN and never allow re-entry. Once a user has completed the tests, the PIN is no longer active.

LOGON Portals can be set to allow or disallow re-entry into completed tests.

All portals are configured in the administration section of SimBuilder, under portals. You can set various parameters and customize the look/feel of a portal to virtually any look you need. You can also customize the way the portal functions. For instance, you can control whether the portal collects name/email info, collects standard US demographic data, presents a customizable release to the test taker, and provides any other instructions. You can customize what happens after the test(s) are completed.

Each portal is associated with an organization, and can be made the default testing portal for that organization.

Understanding the HR Avatar Applications

Several web applications make up the HR Avatar Suite. These are:

ClicFlic Sites - these are web apps that have their own website login:
  • ClicFlic (http://www.clicflic.com) - this is the IMO authoring system. The complete purpose of ClicFlic is to create one IMO.
  • ClicFlic Utilities:  (http://www.clicflic.com/stutil) - performs various maintenance and troubleshooting activities for ClicFlic. 
ClicFlic Extra WebApps - these run on their own on the ClicFlic server:
  • STEJBALL - performs deployments, compiles IMOs, manages media conversion, emailing. Accessed exclusively through web services.
  • STWS - Performs file transfers and media conversions. Accessed exclusively through web services.
HR Avatar Sites
  • HR Avatar (https://www.hravatar.com) - Main HR Avatar marketing and selling, and customer accounts portal.
  • SimBuilder (http://www.simajob.com) - this is the main administration site for HR Avatar. The site is used to:
    - Define and build Sims and all their related objects.
    - Maintain the image libraries
    - Create administer testing portals
    - Manage all users
    - Create and administer test batteries
    - Create and manage organizations and sub-organizations
    - Create and manage product groups
    - Create and manage all products
    - Perform item and test analysis tasks
    - Auto-generate CT3 Sims
    - Perform various test cleanup tasks, such as archiving
  • Test Engine (http://test.hravatar.com) - Administers all tests
  • Scoring Engine (http://ts.hravatar.com) - Performs all scoring, report generation, and results distribution. Each of these functions is performed independently.
Databases

There are two databases - ClicFlic (called seenthat2) and HR Avatar (called TM2). The are totally independent. The only webapp that accesses both of them is SimBuilder. 

ClicFlic uses its own database and user management system, while the other sites all share a common database. So a user can have a logon to ClicFlic but that same logon will not work on the other sites unless a copy of the that user account is created on the HR Avatar database.

All applications have a special administrator page with various functions and information available via http://SITE DOMAIN/tools/admin/admintools.xhtml  To access these pages you need to have an overall system administrator logon.







Welcome! System Administrators, not customers

This blog is intended to provide a searchable repository of notes regarding how to accomplish various tasks within the HR Avatar suite of software applications.

Note that this is NOT for CUSTOMERS. This is for individuals with overall system administrator access only.   The blog hravatarcorpusers.blogspot.com will be used for updates and information for corporate users.