ListContent Utility Instructions

 Contents

Overview

Requirements

Using the Listcontent Utility

Authentication

Example

 Overview

This utility searches your local content mapping file (skillsoftcontent.xml, by default) to see what content you have available. When the utility finds a course, it puts the content into the content_available.xml file. This utility also scans the specified SkillBrief directory and creates an sb_available.xml file in it.

Run this utility:

• any time you add or remove courses on the content server and/or Skillbriefs in the skillbrief folder.
• if you edit your .xml file to add or remove a Custom Object.

The SkillSoft Installer automatically installs the ListContent Utility to the web/utility folder of your content site.

 Requirements

The ListContent utility ships with Sun JRE version 1.4.1_03. No other JVM is required to run the ListContent Utility.

 Using the ListContent Utility

To use the ListContent Utility, follow the procedure below:

1. Open a DOS windowand navigate to the web/utility/ListContent folder.
2. Type in the following command:

jre\bin\java -cp ListContent.jar;pp2.zip;xml4j.jar com.skillsoft.lms.util.ListContent [<key><value>] [<key> <value>] ...

Example: If you have your content installed in D:\CONTENT\WEB, which is mapped to http://contentserver/virtual you have to specify:

jre\bin\java -cp ListContent.jar;pp2.zip;xml4j.jar com.skillsoft.lms.util.ListContent -lp d:\content\web -vp http://contentserver/virtual

You can use the following keys at the end of the command for this utility.

• sb
  Specifies a directory containing SkillBrief files. The utility creates sb_available.xml in the directory. The file lists all SkillBriefs in the folder.

  Example:-sb c:\content\web\sb

• lp
  Specifies a local path to the web folder on the content server. The utility creates content_available.xml in the same folder where SkillSoftContent.xml resides.
  
  Example: -lp c:\content\web
  
  
• vp
  Specifies a base URL (virtual path) to the content server.
  
  Example: -vp https://qacontent1/contentUK
  
  

• map
  Specifies custom content mapping xml files. The utility uses SkillsoftContent.xml file by default. You don't have to specify it in the -map key. When a content site has a custom mapping xml, file you MUST specify the file with the -map key. If you don't specify it, the resulting content_available.xml file will not contain custom learning objects represented in the custom mapping file.

  Example: -map myCurriculuminfo.xml

• user
  Specifies a user name for web server basic authentication (Optional).

  Example: -user guest

• pass
  Specifies a user password for web server basic authentication (Optional).

  Example: -pass welcome

• proxyUser
  Specifies a user name for proxy a server authentication (Optional).
  
  Example: -proxyUser user1

• proxyPass
  Specifies a user password for a proxy server authentication (Optional).
  
  Example: -proxyPass pass1
  
  
• -trans
  Creates and specifies the location of the trans_available.xml file that lists all of the Transcript files.

  Example: -trans c:\content\web\trans
  

It is recommended that you cut and paste your command line for this utility into the RUN.BAT file that comes with the ListContent kit. Run the RUN.BAT file instead of typing the entire command every time you use this utility. Use the RUN.BAT each time you need to regenerate content_available.xml and sb_available.xml files.

To verify what courses are available, open the content_available.xml file in any editor.

NOTE: This procedure demonstrates how to use the ListContent utility on a single content server. You can also use this utility from a content server to other content locations on your network. Just ensure you have sharing rights for the folders that contain the remote content before you run this utility to the remote content.

 Authentication

If you are accessing web server(s) hosting SPCSF XML files, the -user, -pass, -proxyUser, and -proxyPass parameters might be required. The SPCSF attributes in the content mapping files could have the following format:

1. SPCSF="cbtlib/e9999/SPCSF/e9999.xml"
   Local folder under the same virtual directory. No authentication is needed.
2. SPCSF="/SpcsfContent/lib1/cbtlib/e9999/SPCSF/e9999.xml"
   Local folder under the different virtual directory. No authentication needed.
3. SPCSF="http://server1/SpcsfContent/lib1/cbtlib/e9999/SPCSF/e9999.xml"
   Different server. Authentication could be required.
   

 Example of Usage:

To create SB_AVAILABLE.XML only:
jre\bin\java -cp ListContent.jar;pp2.zip;xml4j.jar com.skillsoft.lms.util.ListContent -sb s:\library\sb

To create CONTENT_AVAILABLE.XML for standard mapping file SKILLSOFTCONTENT.XML:
jre\bin\java -cp ListContent.jar;pp2.zip;xml4j.jar com.skillsoft.lms.util.ListContent -lp s:\library\contentITS\web -vp http://qacontent/contentITS

To create CONTENT_AVAILABLE.XML assuming you have 2 custom content mapping files:
MYCURRICULA.XML and ZC.XML(SKILLSOFTCONTENT.XML will be used anyway)

Also, the proxy server authentication is required.
jre\bin\java -cp ListContent.jar;pp2.zip;xml4j.jar com.skillsoft.lms.util.ListContent -lp s:\library\contentITS\web -vp http://qacontent/contentITS -map zc.xml -map mycurricula.xml -proxyUser guest -proxyPass welcome