How Pretty URL / Permalink ID WorksHow Pretty URL / Permalink ID Works

What

Permalink ID is a unique ID provided for all content in Pure, and it is used for generating Portal URLs. As default there will be one permalink ID with the UUID and one with the title of the content.

For Persons and Oganisations, Pure also creates a 'prettier' URL version, as URLs containing IDs or UUIDs are not very user friendly.  Both pretty URLs and permalink IDs are unique. Each Person/Organisation can have several pretty URLs, but they are all unique and cannot be re-used on other content. They are found on content e.g. a Person or Organisation editor > Display > System info and any of them will work. But the one at the top is the current primary one.

A job named "Pretty URL Update" can be used to create these URLs.

How

• The job can be configured to use username or email (from Pure 5.21) on a Person. Meaning a Pretty URL based on username or email can be added to the person.
• If somebody changes their name, or adds a name variant, this becomes a new primary URL, instead of the current one - even though the job has been configured in Pure to use username or email as a pretty URL.
  Note: Prior to 5-24-3: If the name changes to a shorter version of the existing name (e.g. from Jane Doe Pedersen to Jane Doe), then the pretty URL which is jane-doe-pedersen will not change to jane-doe as this is already part of the existing pretty URL.
  This has been changed/fixed in 5.24.3, in 5.24.3 and newer versions, adding shorter name versions will generate a new pretty URL (you can try run a republish on your persons on portal, and Pure will generate any shorter name versions that was not generated prior to 5.24.3 
• A pretty URL may include a dash and a number at the end (e.g. anette-pedersen-2 or anette-pedersen-3).
  • This happens when a pretty URL has already been used, for example if there are multiple Persons or Organisations with the same name.
  • Other scenarios could be if an organisation was wrongly created manually or through synchronisation, then it gets deleted, and afterwards a new Organisation (with new Pure ID) with the same name is created. This later Organisation will then get the -x version as the other has been used (and is still stored in the Pure database).
• From 5.21 the primary Pretty URL is labelled "primary" but it is possible for an Administrator or Editor of the content type to mark another Pretty URL as primary instead:
  
  
  • It should be possible to use this for all content types i.e. also Activities, Projects and Research outputs.
  • Before using the “Primary” button, none of the Pretty URLs will be labelled as Primary, but the top one will be the Primary by default. After clicking on the “Primary” button, however, the “Primary” label will appear.
  • It is only possible to change the primary URL to one that is already in the list of assigned permalinks.
  • Note: It is not possible to make the UUID the primary Pretty URL.
• If you have previously used one of the strategies in the job Person username strategy, Person email strategy or have some unused Organisation or Person Pretty URLs you would like to delete, then please reach out to Pure Support.

Note:

• The job only processes Person records that have been added since the job was last run going forward.
• We recommend running this job every two weeks.

More information

5.12.0 Release notes
5.21.0 Release notes