SAP Knowledge Base Article - Public

2416189 - How to setup and use iContent with Learning

Symptom

This KB article explains how to set up a Deployment Location in Learning with iContent.

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

Environment

    SAP Successfactors Learning

    Resolution

    • Deployment Locations are used in conjunction with the Import Content tool. It's a wizard that you can use to import one or more content packages, deploy them to a content server, and create and configure items to be associated with those content packages.
    • When importing a course, an admin can add new content and upload the selected content.

    Configuration Files

    There are two major configuration files that need to be considered when setting up Deployment Location:

    1. Content Import:
      • This configuration contains the maximum allowed file size for Content Import (maximumFileSizeKB).
      • It can be accessed by going to:
        1.  System Administration >
        2. Configuration >
        3. System Configuration >
        4. CONTENT IMPORT.
    2. File Upload Max Size:
      • This property is in bytes, and should be set to the corresponding value of the maximumFileSizeKB property in the Content Import configuration.
      • It can be accessed under:
        1.  System Administration >
        2. Configuration >
        3. System Configuration >
        4. LMS_ADMIN >
        5. fileUploadMaxSize.

    Setup

    1. Go to Learning Administration >
    2. Navigate to System Administration >
    3. Configuration >
    4. Content Deployment Locations >
    5. Click Add New.

    ContentDeploy.png

    1. A popup window appears. Fill in the details:

    DeployFields.png

    1. Explanation of the available fields (* indicates a required field):

      1. Deployment Location ID*: ID as per your requirement.
      2. Description: Short description regarding this particular deployment location.
      3. Domain*: Domain ID in which you want particular set of group to use it.
      4. Host Name*: SFTP URL of your iContent server without HTTPS. Reference 2250792 for the URLs.
      5. Port*: is always 22 for iContent services.
      6. Username*: username of your iContent SFTP server (not the same as the standard BizX or LMS SFTP accounts for reports, connectors, etc...).
        <tenantuser>_content for self-managed iContent account.
        <tenantuser>_managed for Premium Content Managed (PCM) service.
      7. Password*: password of your iContent server.
      8. URL Prefix: refer KBA 2396085
      9. Directory: Directory in which you want to store your content in your iContent server. Make sure that this directory has already been created in the SFTP site. It is a good practice to create a main/root folder for each LMS environment, especially when multiple LMS environments share the same iContent account. It is also a good practice to have a folder for each LMS environment. (Please note the "My Folders" can be excluded from this path as it is a place-holder only) Note: It is imperative that the directory folder that is added to this field is appended to the URL prefix as shown in the screenshot above.
        • It is best practice to not utilize special characters in both files that are being uploaded or in the Directory section as per the guide. This can lead to courses not working in either desktop or mobile application.
      10. Test User: Test User ID you want to assign course once you import content to this server.
      11. Location Type: Will always be SFTP.
      12. iContent Deployment: Customers with iContent 25 Free GB self-managed LMS bundle Storage Service should not enable this feature. The setting needs to be used only for Premium iContent customers (managed iContent), however selecting it if you use the self-managed iContent will not have any negative impact for the customers.
        • Note: Notifications are sent to the e-mail address configured under System Administration > Configuration > System Configuration > CONTENT IMPORT > IContentNotificationEmailAddress.
      13. Display Order: When configuring multiple deployment locations, this controls the display order in the selection dropdown of the Import Content assistant.

    Setup Example:

    The email with the initial provisioning for iContent has been received. The following was provided from the email:

    • Username: SAPTest_content
    • iContent Tenant URL (SFTP URL/Host Name): sftp50.sapsf.com
    • Password: FakePassword

    With this information, configuration can begin.

    1. Go to Learning Administration >
    2. Navigate to System Administration >
    3. Configuration >
    4. Content Deployment Locations >
    5. Click Add New
    6. The fields in the Add New Deployment Location screen will be the following (This is an example)
      1. Deployment Location ID: iContent Deployment Location
      2. Description: Deployment location for importing content
      3. Domain: PUBLIC
        • If specific admins will be importing to certain deployment locations, modify it to the appropriate domain that Security Domain restrictions are set on.
      4. Host Name: sftp50.sapsf.com
      5. Port: 22
      6. Username: SAPTest_content
      7. Password: FakePassword
      8. URL Prefix: /learning/user/onlineaccess/icontent.do?Course=CUSTOM_dc50&url=/self-managed/Production
      9. Directory: /Production
      10. Test User: ContentTestUser
      11. Location Type: SFTP
      12. iContent Deployment: Unchecked
      13. Contact's Email: N/A
      14. Display Order: 1
      15. Comments: iContent Deployment Location

    Keywords

    lms, sf, SuccessFactors, Learning, iContent, setup, configure, Deployment, Location, assign, course, upload, content, configuration, setting, using, use , KBA , LOD-SF-LMS-PCM , iContent , LOD-SF-LMS , Learning Management System , LOD-SF-LMS-CNT , Content , How To

    Product

    SAP SuccessFactors Learning all versions