FM_MarksUserImporter

Overview

FM_MarksUserImporter is a custom user importer built for Mark's.

Installation & Configuration

Installation

Install this module non-globally (i.e. organization must be specified during installation).

Before installing this module, make sure that both FM_LearningPath and FM_AutoEnroll modules are installed.

Configuration

The following application settings are created during installation:

Application Setting

FM_MarksUserImporter Directory to Monitor

FM_MarksUserImporter Unique Identifier Override

Description

The full path to the directory the FM_MarksUserImporter module should monitor for updates.

The ID of the Detail Field that should be considered the unique identifier for a user.

Sample User List CSV Format

The list must included the following fields:

Usage

Mark's HR System (Canadian Tire's PeopleSoft) generated the user list in csv format and dropped it on the FiLMS Server around 21:00 MT. The file will be processed by FiLMS CRON job daily between 0:00 and 8:00 MT.

The list is authoritative. Mark's only includes active users in that list (i.e. if a user is included (s)he is either reactivated or created). Those users not included are automatically inactivated. The users with the following FiLMS user roles are exempt from inactivation:

  • #1 System Administrator
  • #2 Limited System Administrator
  • #23 Demo User

Organization / Group / Learning Path / Role Assignment

New organizations are generated using "[user_region_name] - [user_district_name] - [user_store_name] - [user_store_id]" format.

If the user is in the corporate organization (org id #2), (s)he will be assigned to the jobtitles group based on his / her job class. If his/her job class is not found in the list, (s)he will be assigned to "Non-operators" group.

If the user is not in the corporate organization, (s)he will be assigned to the following jobtitles groups and learning paths based on his/her job class.

If a FiLMS user role based on user's job title exists, the user will be assigned to that role. Otherwise his / her role is set to Learner by default.

FAQ / Troubleshooting

!Warning!

If the job fails it can be re-run by clicking the following link. Running it without a failure first may lead to unintended consequences.

https://mymarkslearning.com/includes/modules/FM_MarksUserImporter/test.php

Documentations

TBA