UUIDs/GUIDs

Many requests will need to reference data in Promana by a universally unique identifier (the term globally unique identifier (GUID) is a synonym more typically used in software associate with Microsoft).

Promana exclusively uses UUIDs to identify the following entities:

  • Users
  • Groups
  • Assignments (an assignment is a collection of one or many assigned surveys)
  • Assigned Surveys (an assigned survey is a survey that has been assigned to a user to complete, and as such, is not available in your inventory of assignable empty surveys)

UUIDs take the form of 36 characters (32 alphanumeric characters and 4 hyphens).

Format: xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

Example: 123e4567-e89b-12d3-a456-426655440000

The user UUID is returned on creation of a user and on generating a listing of users.

Assignment UUIDs are returned when requesting a user (as a collection in the user object) or when requesting using the assigned request, which takes a user UUID parameter.

UUID Standards

UUIDs are standardized by the Open Software Foundation (OSF) as part of the Distributed Computing Environment (DCE).

UUIDs are documented as part of ISO/IEC 11578:1996 “Information technology – Open Systems Interconnection – Remote Procedure Call (RPC)” and more recently in ITU-T Rec. X.667 | ISO/IEC 9834-8:2005.

The Internet Engineering Task Force (IETF) published the Standards-Track RFC 4122, technically equivalent to ITU-T Rec. X.667 | ISO/IEC 9834-8.