What would you like to know more about?

Create Permanent URLs to Topics

Create a permanent URL that references the resource ID instead of the topic title.

Before creating resource id's, read standards.
Note: This task applies to non-versioned content. For versioned content, see Resource ID URLs for Versioned Content.
Sometimes, you need to link to page in a portal from a disconnected content system, such as the corporate website, LMS, or other. You can copy/paste the URL in your browser, which includes the article title, but if the article title changes, or the article moves to a new location, your URL may break.
  1. Add your unique resource id to the prologue of your article.
  2. For non-versioned content, construct your URL as shown. Note the uppercase "I", lowercase "d" in "Id".
    https://help.acst.com/en/?resourceId=Legal.Home
                    
  3. For versioned content, there are two methods.
    1. Preferred: The option to include both version and resource_id could reduce the need to tag each version's resource_id uniquely. It requires adding id attributes to your <version> elements, which you could then reference in this format:
      Production: 
      https://help.acst.com/en?resource_id=Classic_Missionimpact.Guide&version=versionid
      
      Staging: 
      https://acstech-staging.portal.heretto.com/en?resource_id=missionimpact.guide&version=2N
      https://acstech-staging.portal.heretto.com/en?resource_id=missionimpact.guide&version=1C
    2. Non-preferred, but use if you have issues with the former: Rename resource id's in one version to include the version name. Construct your URL as shown: Note that "id" is all lowercase.
    Production: 
    https://help.acst.com/en?resource_id=legacy_MI.Missionimpact.Guide
    vs 
    https://help.acst.com/en?resource_id=early_adopter_MI.Missionimpact.Guide
    Staging: 
    https://acstech-staging.portal.heretto.com/en?resource_id=legacy_MI.Missionimpact.Guide
    Testing: 
    https://acsttesting.portal.heretto.com/en?resource_id=legacy_MI.Missionimpact.Guide
    
    
  4. Please add the application name to indicate what internal system or group is using this resource id. For example, if the URL is for a MinistrySmart eLearning course, type "MinistrySmart Training".
  5. Record the resource ID in the spreadsheets we share with other departments.