Professional Documents
Culture Documents
Knowledge Session - Connectors 2016 - 01 - 20
Knowledge Session - Connectors 2016 - 01 - 20
Knowledge Session - Connectors 2016 - 01 - 20
1. What are the Connectors in the LMS and for what we use it for?
2. Different connectors types inside LMS
2.1 Olsa Connector vs Skillsoft Connector
3. Connector Workbooks: Standard Connector, Olsa Connector, Skillsoft Connector and Competency Connector
4. Connectors Configuration LMS
5. SF User Connector – Bizx Integration
5.1 Provisioning
5.2 LMS Configuration
5.3 Adding Custom Columns to Extended Data
9. Known Issues
10. Known Issues: KBA created for connectors LMS
11. Database relations to Connectors
12. Connector Error Codes
13. A Reminder about Connectors : new features b1411
14. A Reminder about Connectors : new features b1502
15. A Reminder about Connectors : new features b1505
16. A Reminder about Connectors : new features b1508
17. A Reminder about Connectors : new features b1511
Description
Each connector has it’s own specific data structure, so each input data file must
match a predefined format.
Requires license – All are Free except OLSA Connector that it was substitute by
the standard Skillsoft connector in b1508.
Compentency Connector SF has his own connector workbook and it is not found
in the standard connector workbook.
Source
Extracts
Data
Process Input
Records SF LMS DB
Summary
Email Report
SF LMS DB
Position Method: This method requires that all of the fields in the input file are in a specific order. This
method is deprecated. Do not use this method it is deprecated.
Header Method: This method uses the header row to determine the positions of the input data. This is
the only supported method.
Record Rejections
The standard connector and imports will reject a record (not the entire input file) if any of the following
conditions occur:
The input file contains a null value for a field that cannot be null. Check the ‘Req’ column in the data
mapping tables which indicates whether a value for a field is required.
The input file contains a value that does not comply with the data type for that input file column.
The field input value is a reference but the value does not match the reference table.
© 2015 SAP SE or an SAP affiliate company. All rights reserved. Internal 7
Knowledge Session: Connectors
1. What are the Connectors in the LMS and for what we use it for?
Null Values
Null values in the input file are accepted by a standard connector unless the field is a required field.
The connectors do not update fields when the input file passes a null value.
Character Set: SuccessFactors supports only the UTF-8 Character Set in the input file.
Column Headers: Must be included as the first row of the input file.
Null values (empty fields): All columns indicated in the header row must be supplied in the input file
data. You can indicate null values by using two consecutive pipes.
User - SF Loads and updates users in an integrated environment from the BizX suite. This
connector is used solely for integrated environments.
User Loads new users and updates existing records. Capable of creating references,
such as domains.
Federal Contains all values as the standard user connector, but adds additional fields
User required for Federal agencies.
Domain Loads new domains, updates existing records, and manages the hierarchical
relationship of domains
Item Creates new items in SuccessFactors Learning and updates existing records. It
is most common for the item connector to be used for one-time data migrations,
rather than an ongoing feed.
Learning Records item-based completions for existing users’ completion of existing item
History records. Both the user and the item record must exist within the system for the
record to be accepted. The learning history connector is most commonly used for
one-time data migrations.
Scheduled Schedules instances of existing item records and is typically used for one-time data
Offering migrations.
Registration Updates user registrations in existing scheduled offerings. Both the user and
scheduled offering must already exist in the system. This connector is typically used
for one-time data migrations.
Job Code Formerly known as job position, the job code connector creates new and updates
existing job code values, such as domain, if curricula should be automatically
assigned, and more
© 2015 SAP SE or an SAP affiliate company. All rights reserved. Internal 11
Knowledge Session: Connectors
2. Different connectors types inside LMS
Connector Description
Position Similar to the job code connector in that positions are typically instances of job
codes. For example, job code 199 may represent an administrative assistant,
while the position, Phoenix – 199, may represent an administrative assistant in
the Phoenix office. The connector creates new records and updates existing.
User Manages compensation values in the system, such as compensation manager,
Compensation salary, etc. It is recommended that the user connector be run in advance of the
Connector user compensation connector so that the user connector maintains sole
responsibility for creating new users. Has his own connector workbook.
Curriculum Similar to Item Connector, this connector adds new curricula and updates to
existing curricula.
Competency Creates competencies and associated rating scales in in the LMS. Records
SF are created in the BizX environment and loaded to the LMS using the
connector. See section 3 for connector workbook.
These are the standard Connectors, then the customers could have their own custom connectors
made by Professional Services and there is also the OLSA Connectors
Olsa Connector was a Custom Connector that it was set up and deploy by Professional Services
and if they were an issue on this Connector must of the times Customer had to go to
Professional Services for a fix or revision.
From b1508 a standard skillsoft connector was created, where we troubleshot and give
customer support care without reaching Professional Services.
Olsa Connector customers that deploy this Custom connectors have two custom connectors:
The Skillsoft connector brings your Skillsoft courses into the Learning Management System
(LMS) as learning items.
If you use Skillsoft knowledge center, you can bring the courses into the LMS to track them as
Learning Items. You pull in the data through the Skillsoft Connector.
Please find bellow the last standard connector b1511, the Olsa connector b1210, Standard
Competency Connector Workbook b1210 and the new Skillsoft migration connector workbook.
Once you’re in the LMS Admin site, navigate to System Admin>Configuration>System Configuration>Connectors
LMS
Schedule Quartz Job Archives
Schedule LMS picks LMS
Data Export kicks off and input file;
Connector in up file from Processes
Job in places file detailed
LMS FTP File
Provisioning on FTP report made
available*
Notes:
1 - File will be remove from FTP drive once LMS picks it up.
2 - *Must be configured in connector properties in LMS System Configuration
In Provisioning:
Search for customer by selecting the first letter of their name:
For SF User Connector, LMS will only process files based on Headers.
Null values (empty fields): Indicate null values (empty fields) by using two consecutive commas. Do
not use blank space to indicate null values; as they will be interpreted by the connector as a non-null
data input.
1. BizX - Update the Customer Data Model with the Custom Fields
2. BizX - Add Extended User Information
3. LMS - Update the Connector Property file with the Custom File Mappings
4. LMS - Add the Custom User Columns to the LMS
5. LMS - Export the Extended User Information
6. LMS - Import the Extended User Data
Note: If you want the extra column to be available within the BizX UI, it will need to be added to the form and
permissions. This was not tested as part of this solution.
Add the user data in the custom field of the new field.
sfuser.extendeduser.field.customcolumn.160=ADDL_TEST
*The Custom Column from BizX must be entered in uppercase, even though the BizX ID may not be.
The column number must match the value in the property file
This is scheduled to run after the BizX User Export. Both files are sent to the same location on the
SFTP server. The User Connector-SF will process both files when it runs.
After the process runs, the data in the custom column displays in the user record:
sfuser.field.mapping.data.COL_NUM6_VAL=<customer’s DB value>, which would be in the first row of headers in the input file.
To add additional custom columns, you can use this mapping format:
<connector prefix>.field.customcolumn.<field>=<column_number>
where field is the header value that will appear in the input file and column_number is the user custom column where the value
will be stored.
A secondary file called “Extended User File” can be ran to specify custom columns to feed.
There are advanced configurations that are not covered in this guide (ie., Transform rules that allow the data that the customer
submits to be transformed to something that the LMS will accept/understand), this is covered on this document:
There are advanced configurations that are not covered in this guide (ie., Transform rules that allow
the data that the customer submits to be transformed to something that the LMS will
accept/understand), this is covered on this document. However, below is an example.
The LMS Connector has what we call “transformation properties” that essentially help address
mismatches. Locale is one example. The out-of-the-box configuration, transforms incoming “en” and
“en_US” (from BizX – Input file) values to English (corresponding locale value in the LMS):
sfuser.field.transform.data.LOCALE.English=en,en_US
Similarly, if you want to transform a BizX “EST” timezone value to “America/New_York” (corresponding
LMS value), you would specify a setting such as:
sfuser.field.transform.data.TIMEZONE.America/New_York=EST
You can get the advanced connector configuration by double clicking this icon:
The LMS connectors have the ability to process PGP encrypted input files. PGP stands for Pretty
Good Privacy which is a widely used encryption program to encrypt and decrypt files. PGP uses a
variation of the public key (PK) system where each user has a publicly known encryption key and a
private key known only to that user. The message is encrypted using the Public key shared between
the two users and the receiver uses the private key (known only to the user) to decrypt the message.
The PS Technical Services team is responsible for generating the (Public, Private) key pair and the
secret pass phrase. Once the keys are generated, the Public key is shared with the customer to
encrypt the connector files. The customer may choose to use a program/utility of their choice to
encrypt the file(s) using the key provided.
Once the input files are encrypted and ready for connector processing, the Successfactors PS
personnel will need to update the following properties in the LMS Connector configuration.
In this example, we see that the issue is pointing to the file ending “unexpectedly” and it gives you a line
number. If we look at the archive file, we see that the input file has long gaps of blank line spaces, starting at
line 11930. This caused the connector to fail. In this case, a DCOPS JIRA is in order since the Quartz job
failed to produce a correct input file.
“No Headers” error / File is 0 bytes 2 Provisioning Data Export jobs running at the same time
Inactivating users on BizX does not “Valid Users Only” is checked on Provisioning Scheduled Job
inactivate them on LMS
FTP connection failed Incorrect FTP credentials/Ops Issue
Accented Characters not showing up If Provisioning Quartz job has UTF-8 character encoding, this may be a
correctly on LMS UI Defect.
“File has no content” error PGP Encryption may be misconfigured. LMS processes file but cannot
understand it due to encryption.
Locale on input file is being rejected Locale may not be an actual BizX locale. Go to Provisioning>Company
Settings; confirm locale on input is listed AND checked.
Something to keep in mind: The BizX data validation is different than the LMS. It’s possible that the when importing
data to BizX, some records are not rejected because they are not required, so when these records are imported to
LMS, it will reject if not according to Workbook specifications.
Issues Workaround
Connector – Customer wants one Bizx field be mapped in two LMS fields
2160607 Exception: "Hire Date cannot be in the future" running User Connector or User Connector SF in SuccessFactors Learning
2148552 Item connector creates new items when the revision date is not provided for an update of an existing item
2163549 ERROR: "Same source field is configured for multiple fields. Please use copy field mapping for this purpose"
2165339 How to change the e-mail address that receives the Report Notifications for Connectors - Learning Management System
2166405 Message Inactive revisions are not supported when trying to Inactivate Item via Connector - Learning Management
System
2173658 How to map BizX Locale to LMS Locale via User SF Connector-LMS
2074129 Do inactive curricula stay linked to the items on the curricula items tab?
2169281 How to Associate More Than Three Alternate Supervisors to a User - SF LMS
2169282 User Connector Run Result Exception - Code 1102 - Entity Does Not Exist - CountryID - SF LMS
2168610 How to get the exact time stamp of Item Revision detailed into seconds so you can update the current revision of item
using Item Connector?
2167649 Staging Instance Not Connecting To FTP - SF LMS
2167463 Subject Area for Skillsoft courses showing subject area ID instead of description for certain user locales
2220447 Whether we can use Orgs Connectors to update Organization custom columns rather than the five listed in Connector
Workbooks-LMS
© 2015 SAP SE or an SAP affiliate company. All rights reserved. Internal 52
Knowledge Session: Connectors
10. Known Issues : KBA Created for connector LMS
2075199 Position based processing mode VS. Header based processing mode - Learning
2075355 Error - Connector upload is failing due to String or binary data would be truncated error - LMS
2101266 when a user is turned inactive through connectors , it removes all the items associated with it - Learning
2101872 Removing Alternate Supervisor on the LMS side through Connector - Learning
2250769 How to question - Learning history data upload with connector with delete mode
2251414 User connector sf failed with the following error : java.lang.UnsupportedOperationException: ElmsEncryption does not
support CipherOutputStreamProvider, please upgrade to com.plateausystems.elms.util.helper.ElmsJceEncryption
2247963 How to map Bizx custom column in LMS?
2208130 How to check the box for "Use AICC Wrapper" when the item connector file processes
2200538 New Item connector revision setting b1505 turns old items inactive
2197843 Connector gives Error while importing data.ORA-01400: cannot insert NULL into
2258754 SF User Connector input file missing from sftp folder after LMS clone
Connectors are jobs that run in the connector node, so the information related to the jobs can be found
in the following tables:
(If AP Synch is running, connectors won't be able to run. Both connectors and AP Sync may require to
update the very same tables and we don't want both of them updating records at the same time.)
PS_CONFIGURATION contains also connector configurations saved in the Admin>System
Admin>Configuration>System Configuration>CONNECTORS. You will only see the changes from the
original one, not the full configuration (the same as shown using 'view changes')
Connectors place the information in the tables related to the specific connector. For more detail, check
the connector's workbook, as it shows where in the database (field & table) will be
saved/modified each field of the input file, as well as how it will be updated
Other database tables specific for connectors, use the naming convection PA_CONN_...
PA_CONN_ACTIVITY lists the connectors and the last run and it is doing the counting of the entities
that need to be inserted, updated and removed. This is the info showed in the connector report>
activity summary
PA_CONN_ALT_JOB_POS, related to the alternate job code connector
PA_CONN_CBT_CPNT_MOD, related to the online components of the item connector
PA_CONN_CONFIG has the UPDATE_ON_NULL and NO_UPDATE_ON_NULL configurations, as
well as the fields applied to them.
PA_CONN_EXCEPTIONS: For each connector (INTERFACE_ID) shows the exceptions and type
found after the execution
PA_CONN_INPUT_DATA: shows the info of the archived connector input file
PA_CONN_JOB_POS, job code connector- info processed
PA_CONN_LOG: It shows a log of the connector executions
PA_CONN_ORG, organization connector
PA_CONN_ORG_DSHBRD, configuring dashboards for organizations
PA_CONN_ORG_INITIATIVES, Organization connector(organizations can have initiatives set by the
org owner)
PA_CONN_ORG_OWNER, Organization connector
PA_CONN_ORG_SUCES_PLNING, Organization connector, to set up the succession planning
PA_CONN_QUAL, Curriculum connector
PA_CONN_QUAL_CPNT, Curriculum connector- assigning items to the curriculum
PA_CONN_QUAL_JOB, Curriculum connector- matching the curricula with the job code and assigning
the curricula settings on the job code screen of the user
PA_CONN_QUAL_LOCALE_LABEL, curricula locale info
PA_CONN_QUAL_PARENT, parent curricula relations: curricula, subcurriculas...
PA_CONN_QUAL_REQ, Curricula connector, requirements
PA_CONN_SCHED, Scheduled Offering Connector
PA_CONN_SF_CPTY, Competency connector: BizX competencies
PA_CONN_SF_CPTY_RTNG_CRITERIA, Competency connector: BizX rating criteria (teasers)
PA_CONN_STUD_ALT_SUPER, User connector, alternate supervisors
PA_CONN_STUD_FEDERAL, User connector federal
PA_CONN_STUD_FEDERAL_ALT_SUPER, User Federal connector, alternate supervisors
- Download the latest connector template(s) for any connector (“all columns” option).
If custom columns beyond the standard 15 have been configured, they will be
included in the template as well.
- Download connector template(s) for any connector that contains just columns that
have been mapped (per the connector.properties file configurations). This option
(“only mapped columns”) applies only when header-based processing is enabled.
1.Enable usage of the feature in: System Admin > Configuration > Global Variables > Enable Inline Content Launch
Configuration
2.Then, in order to open the content in the same browser window, the value can be set in:
a)Content > Content Objects > Launch Method > Launch in a New Browser Window
b)Content > Tools > Import Content
c)Connector properties:
item.field.mapping.data.LAUNCH_IN_A_NEW_BWSR_WINDOW=LAUNCH_IN_A_NEW_BWSR_WINDOW
-OR-
item.contentmodule.field.mapping.data.LAUNCH_IN_A_NEW_BWSR_WINDOW=LAUNCH_IN_A_NEW_BWSR_WINDOW.
LRN-8154 Item connector: provide the ability to copy Admin Opt-in Item.connector.defaultValue.revision.copyS
substitutes when revising an item ubstitutes=Y