Basis group#

A basis group (basisgruppe) represents a group of students who are taught together. This typically represents a class (e.g. 10A). The basis group also contains one or more contact teachers (“kontaktlærere”) for the students.

Availability#

Attribute group

To retrieve these groups, the application needs access to the groups-edu attribute group / scope.

Organization type

This group type is available for primary, lower secondary and upper secondary schools.

Member list

Example#

{
  "id": "fc:gogroup:eksempel.kommune.no:b:NO987654321:3a:2000-07-01:2100-06-30",
  "type": "fc:gogroup",
  "displayName": "3A",
  "membership": {
    "basic": "member",
    "displayName": "Elev",
    "affiliation": "student"
  },
  "notBefore": "2000-06-30T22:00:00Z",
  "notAfter": "2100-06-30T22:00:00Z",
  "go_type": "b",
  "parent": "fc:gogroup:eksempel.kommune.no:unit:NO987654321",
  "go_type_displayName": "basisgruppe"
}

Group object#

The group objects has the following fields:

id (required, string)

Unique identifier of the group. Has the format fc:gogroup:<realm>:b:<organization-number>:<local-group-id>:<start-date>:<end-date>. <realm> is the domain name of the school owner. <organization-number> is the organization number of the school or the organization number of the school owner. In both cases it is prefixed with NO. <local-group-id> is the local identifier of the group at the school owner. <start-date> and <end-date> contain the first and last date the group the group is active.

type (required, string)

The group type. Always fc:gogroup for basis groups.

Note

There are multiple groups with the type fc:gogroup. To recognize a basis group, check for both "type": "fc:gogroup" and "go_type": "b".

displayName (required, string)

A human readable name for the group. E.g. 3A, Klasse 3A, 3. klasse, etc.

membership (optional, object)

The role of the current user in the group. This field is only present when requesting groups for a specific user.

notBefore (required, string)

The timestamp when the group became active / valid. This is typically before the school year.

notAfter (required, string)

The timestamp when the group is no longer active / valid. This is typically after the end of the school year.

go_type (required, string)

The group type code. Always b for basis groups.

parent (required, string)

The group identifier of the school or school owner this group belongs to. This is usually a school, but it is possible to have basis groups that are not part of a specific school. In that case the parent is the school owner.

go_type_displayName: (required, string)

A human readable name for the group type. Always basisgruppe for basis groups.

Membership object#

The membership object contains information about the user’s role in the basis group.

{
  "basic": "member",
  "displayName": "Elev",
  "affiliation": "student"
}

It has the following fields:

basic (required, string)

The basic membership role of the user. This field is a string with one of the following values:

  • admin: For teachers in the group.

  • member: For students in the group.

affiliation (required, string)

The user’s affiliation to this group. Common values are:

  • student: For students in the group.

  • faculty: For teachers in the group.

displayName (required, string/object)

A human-readable version of the affiliation field.

This field is either a plain string or a JSON object with different translations. The JSON object contains the language code as key and the translation as value.

It will be returned as a plain string in most cases, but will be returned as a JSON object when retrieving group member lists.