Add content

Create a content catalog

Administrators can create one or more content catalogs. Catalogs are groupings of content that the administrator manages from the Content Registry.

1. Navigate to the Admin portal.

2. From the Catalog Registry, select Create catalog.

3. Complete the Catalog details and Additional details form to describe the preferred grouping type for your catalog.

4. Click Save.

Your saved content record will be assigned a Product ID that is used during the content ingestion process of uploading via CSV or API.

Create content

Add content to a catalog through the Library Admin portal. Log into your Library Admin app, and then select the Catalog tab in the navigation bar. You can create content within ContentNav, or upload content via CSV or API.

Generate a partner access token

A partner is created within ContentNav as part of the tenant onboarding process. Administrators can generate partner authentication tokens.

1. Log into the Library Admin portal.

2. Select Partner Registry from the navigation menu.

3. Select the appropriate Partner.

4. From the Technical tenant details section, click Generate Details to generate a Client ID and Secret code.

5. Enter the API documentation URL in a new tab.

6. Enter the Client ID and Secret code.

7. Click Execute to generate the access token.

CSV content ingestion

Download a sample CSV

You can download a sample CSV file from the Bulk Upload page. To access the sample file:

1. From the catalog, select My Content from the ContentNav Catalog menu.

2. Click the Create menu and select Bulk Upload.

3. From the Upload List, click Download sample CSV file.

Upload files via CSV

You can add content to the Library through a CSV upload. You can upload one file or upload several in a bulk upload. To upload content via CSV files, from the catalog:

1. Click the Create menu, and select Bulk Upload.

2. Click Browse, and then select the file you want to upload.

3. Click Upload.

There is no size limitation for CSV files.

Required fields

The following fields are required for ingesting content via CSV upload:

• UniqueId

• ResourceFormat

• Title

• Description

• Url

• Operation

• isCurated

• ProductId

• ResourceFormat values can be video_resource, webpage_resource, interactive_resource, image_resource, text_resource, or audio_resource.

You can also access a list of previous uploads from the Bulk Upload page. Each previous upload will display the:

• File Name

• Uploaded Date

• Resource Counts

• Processed Counts

• Error Counts

• Status

Click on the Error Counts cell to access a list of reasons why an upload failed.

Monitor the status of a CSV ingestion

After you upload a CSV file, or multiple files, you can monitor the status of the job from the Bulk Upload page. To access this list:

1. From the catalog, select My Content from the ContentNav Catalog menu.

2. Click the Create menu, and then select Bulk Upload.

   1. The Status field of the Upload List will tell you the status of your CSV upload.

   2. Use the Search bar to search for a specific file.

Upload status changes are reflected in real-time, although the exact duration may vary. If multiple concurrent requests are sent, upload times may take several minutes to complete.

API content ingestion

Contact your PowerSchool representative to establish your API connection and begin uploading content via API. To access a list of API request uploads; from the Catalog tab, click the Create menu and select API.

There is no limit on the number of API calls that can be made in one day.

Required API fields

The following fields are required when making a content ingestion API call:

• The Id must be a unique UUID for that tenant.

• contentFormat values can be video_resource, webpage_resource, interactive_resource, image_resource, text_resource, audio_resource, html_resource, file_download, lesson_plan, instructional_strategy, or presentation.

• webpage_resource can be used for Microsoft Word, PDF, PowerPoint, XLS, etc. files if they are hosted as a URL.

• isCurated should be marked as 'false.’

The ProductId applies content to the appropriate catalog. You can find the ProductId in the Admin Portal. Navigate to the Learning Registry tab and select Catalog Registry. The Product Id is displayed in the first column.

Monitor the status of an API ingestion

After you upload an API file, or multiple files, you can monitor the status of the job from the Request API List page. To access this list:

1. From the catalog, select My Content from the ContentNav Catalog menu.

2. Click the Create menu, and then select API.

   1. The Status field of the API List will tell you the status of your API ingestion.

   2. Use the Search bar to search for a specific file.

   3. Click Processed Counts or Error Counts for details of uploaded records and details for each record’s id.