set_rights_and_access: Set rights holder with access policy for an object

View source: R/access.R

set_rights_and_accessR Documentation

Set rights holder with access policy for an object

Description

Set the given subject as the rights holder and with given permissions for the given objects. This function only updates the existing System Metadata when a change is needed.

Usage

set_rights_and_access(
  mn,
  pids,
  subject,
  permissions = c("read", "write", "changePermission")
)

Arguments

mn

(MNode) The Member Node.

pids

(character) The PIDs of the objects to set the rights holder and access policy for.

subject

(character) The identifier of the new rights holder, typically an ORCID or DN.

permissions

(character) Optional. The permissions to set. Defaults to read, write, and changePermission.

Value

(logical) Whether an update was needed.

Examples

## Not run: 
cn <- CNode("STAGING2")
mn <- getMNode(cn,"urn:node:mnTestKNB")
pids <- c("urn:uuid:3e5307c4-0bf3-4fd3-939c-112d4d11e8a1",
    "urn:uuid:23c7cae4-0fc8-4241-96bb-aa8ed94d71fe")
set_rights_and_access(mn, pids, "http://orcid.org/0000-000X-XXXX-XXXX",
    permissions = c("read", "write", "changePermission"))

## End(Not run)

NCEAS/arcticdatautils documentation built on Aug. 28, 2023, 12:10 p.m.