Português do Brasil

Articles in this section

Sub-portals: add linked resources from the top-level portal

Elizabeth
  • Updated

Summary

Use the LearnUpon API to link resources from a top-level portal to sub-portals.

Resources are available to all customers.
Sub-portals and the LearnUpon API are available depending on your LearnUpon plan.

Note: creating linked resources in sub-portals is an API-only feature. You can’t create linked resources between portals through the user interface.

Prerequisites

Before creating linked resources:

Linked resources: overview

After uploading resources to your top-level portal, you can make them available to sub-portals without uploading them over and over.

The LearnUpon API lets you create links to top-level resources in the sub-portals. So the same resource is available in as many sub-portals as required.

Any changes to the top-level resource, like a new file name, description and keywords appear immediately in sub-portal linked resources. If you update the file with a new one, the new file is available immediately.

Note: The sub-portal resource copies the Show on resource tab setting from the top-level portal, when you first share the resource.
If you change the top-level setting later, the sub-portal does not show any subsequent changes to this setting.

In the sub-portal, admins can change Show on resource tab to show or hide the resource, as required for their business needs.

To change the Show on resource tab setting in the top-level portal and share this change in the sub-portal, you need to delete and re-create the resource link using the API.

Removing a resource link from a sub-portal - for example, to re-create it - resets the counter that tracks the number of downloads in that sub-portal.

Sub-portal view of resources

For learners, the linked resources in the sub-portal look and feel the same as they do in a top-level portal.

Sub-portal admins can’t edit the linked resource. They can:

  • select Shareable URL, to share the resource directly as a URL
  • change Show on resource tab setting for the sub-portal
  • limit access with Resource Categories
  • use Further restrict access by Group? to limit access to selected groups on the sub-portal

Creating linked resources: process

See the LearnUpon API guide for full details of API calls and syntax.

  1. In the top-level portal, upload the resource file, and set Show on resource tab as required.
  2. In your API editor:
    • use GET /portals to find the sub-portal id
    • use GET /resources to list the resources and their ids on the top-level portal
    • use POST /resources to share a resource from top-level to sub-portal
  3. In the sub-portal, refresh Resources to view the resource now available.

Change Show on resource tab setting for all portals: process

See the LearnUpon API guide for full details of API calls and syntax.

Any changes to the top-level resource, like a new file name, description and keywords appear immediately in sub-portal linked resources. If you update the file with a new one at the top level, the new file is available immediately in the sub-portals.

To change the Show on resource tab setting for a resource, and apply the change on all portals, you delete the existing link, and re-create it.

For example: to make sure all linked resources have Show on resource tab turned off for a specific document, you delete and re-create a link.

  1. In the top-level portal, upload the resource file, and set Show on resource tab as required.
  2. In your API editor:
    • use GET /portals to find the sub-portal id
    • use GET /resources to list the resources and their ids on the top-level portal
    • use DELETE /resources to remove the resource link from the sub-portal
    • use POST /resources to create a new link to the sub-portal
  3. In the sub-portal, refresh Resources and confirm the resource is available as expected.

See: 

Related articles