R/updateExperimentSampleData.R

In ajwtech/pfsrsdk: Functions for interacting with Platform for Science APIs

#' updateExperimentSampleData - Update experiment sample assay data.
#'
#' \code{updateExperimentSampleData} Update experiment sample assay data.
#'
#' @param coreApi coreApi object with valid jsessionid
#' @param experimentAssayType entity type to get as character string
#' @param experimentSampleBarcode User provided barcode as a character string
#' @param experimentAssayUpdateAttrList assay attributes as a list of key-values pairs
#' @param useVerbose Use verbose communication for debugging
#' @export
#' @return RETURN returns a list $entity contains entity information,
#'        $response contains the entire http response
#' @examples
#' \dontrun{
#' api <- coreAPI("PATH TO JSON FILE")
#' login <- authBasic(api)
#' response <- updateExperimentSampleData(login$coreApi,
#'   experimentAssayType = "BITTERNESS_ASSAY",
#'   experimentSampleBarcode = "BTES3", experimentAssayUpdateAttrList = list(CI_BITTERNESS_IBU = 9.7, CI_ACCEPT = FALSE)
#' )
#' updatedEntity <- response$entity
#' logOut(login$coreApi)
#' response <- authBasic(coreApi)
#' }
#' @author Craig Parman info@ngsanalytics.com
#' @author Natasha Mora natasha.mora@thermofisher.com
#' @description \code{updateExperimentSampleData} Update experiment sample assay data.

updateExperimentSampleData <-
  function(coreApi,
             experimentAssayType,
             experimentSampleBarcode,
             experimentAssayUpdateAttrList,
             useVerbose = FALSE) {
    # Clean Names of assay
    experimentAssayType <- odataCleanName(experimentAssayType)

    # Clean Names of attributes
    for (i in 1:length(names(experimentAssayUpdateAttrList)))
    {
      names(experimentAssayUpdateAttrList)[i] <-
        attributeCleanName(names(experimentAssayUpdateAttrList)[i])
    }
    body <- jsonlite::unbox(experimentAssayUpdateAttrList)

    resource <- paste0(experimentAssayType, "_DATA")
    query <- paste0("('", experimentSampleBarcode, "')")
    header <- c("Content-Type" = "application/json", "If-Match" = "*")

    response <-
      apiPUT(
        coreApi,
        resource = resource,
        query = query,
        body = body,
        encode = "raw",
        headers = header,
        useVerbose = useVerbose
      )

    list(entity = httr::content(response), response = response)
  }