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 2.2), 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_,
  metadata = list()
)

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.

metadata

Named list, optional additional fields to include.

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_role_element_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")