Construct a cybed:Role node (workforce frameworks)

Convenience wrapper around build_organizing_unit_node() for workforce frameworks (NICE, DCWF, ENISA ECSF). Asserts cybed:Role in addition to cybed:OrganizingUnit and the per-framework subtype. For non-workforce frameworks (SFIA, Cyber.org K-12, CSTA, CSEC2017, DigComp 3.0), call build_organizing_unit_node() directly with is_role = FALSE.

Usage

build_role_node(
  role_id,
  role_name,
  framework_prefix,
  framework_role_type,
  description = NA_character_,
  element_ids = character(0),
  framework_id = NA_character_,
  opm_codes = character(0),
  metadata = list(),
  unit_iri_prefix = NULL
)

Arguments

role_id

Character, framework-local identifier (e.g., "OG-WRL-015").

role_name

Character, human-readable name.

framework_prefix

Character, Tier 2 prefix.

framework_role_type

Character, specific subclass name within the framework vocabulary (e.g., "WorkRole", "RoleProfile").

description

Character, role description text.

element_ids

Character vector of role-element identifiers to link.

framework_id

Character, framework identifier (e.g., "nice-v2") to populate cybed:partOf. Enables SPARQL queries that traverse role to framework. Recommended. Defaults to NA for backward compatibility.

opm_codes

Character vector of OPM occupational-series codes to attach as the multi-valued literal property cybed:opmCode. NICE v2.2.0 publishes Federal-use OPM cybersecurity data standard codes per work role; a role may carry zero, one, or several codes (e.g., NICE DD-WRL-004 carries two). The codes are modeled as literals, not nodes: the published opm_code elements have no descriptive payload (title/text are empty; the code is the identifier). Empty vector (the default) and NA entries omit the property. Merged via the same metadata-merge path used for cybed:ecfCrossReference, cybed:cybokCrossReference, and cybed:niceCrossReference (the framework's own cited NICE work-role ids, recorded as literals where the cited ids do not resolve to elements in this graph).

metadata

Named list, optional additional fields to include.

unit_iri_prefix

Character, optional discriminator for the minted role IRI, passed through to build_organizing_unit_node(). Supply it for a framework that numbers its roles and its statements out of one id space, such as DCWF, where a work-role code and a task/KSA number can be the same number. The role's printed code is then kept as a schema:identifier literal. Defaults to NULL, the bare IRI.

Value

Named list (JSON-LD node).

See also

Other JSON-LD construction: assemble_framework_document(), build_framework_node(), build_jsonld_context(), build_multi_framework_context(), build_organizing_unit_node(), build_related_unit_metadata(), build_role_element_node(), build_unit_relation_node()

Examples

role <- build_role_node(
  role_id              = "OG-WRL-015",
  role_name            = "Cybersecurity Architecture",
  framework_prefix     = "nice",
  framework_role_type  = "WorkRole",
  description          = "Designs enterprise security architectures.",
  element_ids          = c("T0001", "K0001"),
  framework_id         = "nice-v2"
)
role[["@type"]]
#> [1] "nice:WorkRole"        "cybed:Role"           "cybed:OrganizingUnit"
# c("nice:WorkRole", "cybed:Role", "cybed:OrganizingUnit")

# Multi-valued OPM codes (NICE v2.2.0 Federal-use annotation).
role_opm <- build_role_node(
  role_id              = "DD-WRL-004",
  role_name            = "Enterprise Architecture",
  framework_prefix     = "nice",
  framework_role_type  = "WorkRole",
  framework_id         = "nice-v2",
  opm_codes            = c("631", "632")
)
role_opm[["cybed:opmCode"]]
#> [1] "631" "632"

# DCWF numbers work roles and task/KSA statements from one range, so its
# role IRIs carry a discriminator and the printed code becomes a literal.
dcwf_role <- build_role_node(
  role_id             = "462",
  role_name           = "Systems Security Analyst",
  framework_prefix    = "dcwf",
  framework_role_type = "WorkRole",
  framework_id        = "dcwf-v5.1",
  unit_iri_prefix     = "role-"
)
dcwf_role[["@id"]]
#> dcwf:role-462
dcwf_role[["schema:identifier"]]
#> [1] "462"