Skip to content

@pnp/sp-taxonomy/termsets

Term sets contain terms within the taxonomy heirarchy.

Load a term set

You load a term set directly from a term store.

import { taxonomy, ITermStore, ITermSet } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

Or you can load a term set from a collection - though if you know the id it is more efficient to get the term set directly.

import { taxonomy, ITermStore, ITermSet } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set = store.getTermSetsByName("my set", 1031).getById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

const setWithData = await store.getTermSetsByName("my set", 1031).getByName("my set").get();

Term set methods and properties

addStakeholder

Adds a stakeholder to the TermSet

import { taxonomy, ITermStore, ITermSet } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

await set.addStakeholder("i:0#.f|membership|person@tenant.com");

deleteStakeholder

Deletes a stakeholder to the TermSet

import { taxonomy, ITermStore, ITermSet } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

await set.deleteStakeholder("i:0#.f|membership|person@tenant.com");

get

Gets the data for this TermSet

import { taxonomy, ITermStore, ITermSet, ITermSetData } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

const setWithData: ITermSet & ITermSetData = await set.get();

terms

Provides access to the terms collection for this termset

import { taxonomy, ITermStore, ITermSet, ITerms, ITermData, ITerm } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

const terms: ITerms = set.terms;

// load the data into the terms instances
const termsWithData: (ITermData & ITerm)[] = set.terms.get();

getTermById

Gets a term by id from this set

import { taxonomy, ITermStore, ITermSet, ITermData, ITerm } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

const term: ITerm = set.getTermById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

// load the data into the term instances
const termWithData: ITermData & ITerm = term.get();

addTerm

Adds a term to a term set

import { taxonomy, ITermStore, ITermSet, ITermData, ITerm } from "@pnp/sp-taxonomy";

const store: ITermStore = taxonomy.termStores.getByName("Taxonomy_v5o/SbcTE2cegwO2dtAN9l==");

const set: ITermSet = store.getTermSetById("0ba6845c-1468-4ec5-a5a8-718f1fb05431");

const term: ITerm & ITermData = await set.addTerm("name", 1031, true);

// you can optionally set the id when you create the term
const term2: ITerm & ITermData = await set.addTerm("name", 1031, true, "0ba6845c-1468-4ec5-a5a8-718f1fb05431");
spacer