SUPPORT / SAMPLES & SAS NOTES
 

Support

Usage Note 67124: SAS® Life Science Analytics Framework Macro API 2.4 - Release Notes

DetailsDownloadsAboutRate It

The SAS® Life Science Analytics Framework Macro API 2.4 is available for use with SAS® Life Science Analytics Framework Java API 2.4.

The table below summarizes the enhancements for this release.

For a detailed list of added and modified macros, see the SAS® Life Science Analytics Framework Macros 2.4 Changes Spreadsheet on the Downloads tab of this SAS Note.

 

Functional Area

Description

General

  • Work was done to remove redundant validation of parameters pertaining to creating and updating files written to the SAS Life Science Analytics Framework by the macros. This change affected all macros that create or update files in the repository and might cause changes in default behavior when optional parameters are omitted.
  • Documentation concerning the allowable date formats has been updated to accurately reflect SAS format DATETIME20.

 

AclService

Updated macro:

  • lsaf_getacls: Updated recursion strategy to allow any valid integer between 0 and 99, inclusively.

BatchRepository

    Service

Updated macros:

  • lsaf_uploadandexpand: Added handling of custom version.

JobService

Updated macros:

  • lsaf_createworkspacejob
    • Renamed data set input parameters.
    • Added optional parameter useRelativePaths.
    • Updated to accommodate changes to data sets used as input parameters.
  • lsaf_getjobinfo and lsaf_getworkspacejobinfo: Renamed properties in resulting data set:
    • logPath => logsLocation
    • lstPath => resultsLocation
    • manifestPath => manifestLocation
  • lsaf_updateworkspacejob:
    • Renamed data set input parameters.
    • Updated to accommodate changes to data sets used as input parameters.

 

Renamed macros:

  • lsaf_getjoboutputs => lsaf_getjobcheckinlocations
  • lsaf_getjobinputs => lsaf_getjobsetup
  • lsaf_getworkspacejobinputs => lsaf_getworkspacejobsetup
  • lsaf_getworkspacejoboutputs => lsaf_getworkspacejobcheckinlocs

JobManifest

   Service

New service to retrieve information from a repository job manifest file.

 

Macros moved from JobSubmissionService:

  • lsaf_getjobmanifestinfo
    • Renamed values in resulting data set:
         manifestPath => manifestLocation.
    • Removed values from resulting data set: logPath and lstPath.
  • lsaf_getjobmanifestinputs: Added external inputs.
  • lsaf_getjobmanifestmetrics
  • lsaf_getjobmanifestoutputs: Added external outputs.
  • lsaf_getjobmanifestparameters
  • lsaf_getjobmanifestprograms

 

Added macros:

  • lsaf_getjobmanifestloglocs
  • lsaf_getjobmanifestresultlocs

JobSubmission

   Service

Updated macros:

  • lsaf_getjobpublishhistory: Added variables to resulting data set variables: jobId and jobOwner.
  • lsaf_getsubmissionstatus: Documentation update to report new status values.

 

Added macro:

  • lsaf_getjobsubmissionbysessionid

ProcessFlow

   Service

Added macro:

  • lsaf_copyprocessflow

ProcessFlowSetup

   Service

Updated macro:

  • lsaf_getpfsetupsignallocs: Variable signalName added to resulting data set.

ProcessFlowTask

   Service

Added macro:

  • lsaf_getpfcompleteddetails

QueryService

Return code -200 was introduced to indicate that the validation of the input data set failed.

Updated to handle new -200 return code:

  • lsaf_queryauditdetails
  • lsaf_queryauditentries

 

Updated to accommodate new query types:

  • lsaf_getquerycolumns

 

Added macros:

  • lsaf_queryContainer
  • lsaf_queryContextMembership
  • lsaf_queryDistContextMembership
  • lsaf_queryFile
  • lsaf_queryFileVersion
  • lsaf_queryItem
  • lsaf_queryRecycleBinContainer
  • lsaf_queryRecycleBinFile
  • lsaf_queryRecycleBinFileVersion
  • lsaf_queryRecycleBinItem

RepositoryService

Updated macros:

  • lsaf_getchildren
    • Updated recursion strategy to allow any valid integer between 0 and 99, inclusively.
    • Added variables to resulting data set: fileSize and formattedFileSize.
    • Suppressed folder size.
  • lsaf_getproperties: Added values to returned data set.
    • For files: MD5 digest, major and minor version limits.
    • For containers: major and minor default version limits.

 

Added macros:

  • lsaf_getsyncinfo
  • lsaf_updateversionlimits

SessionService

Deprecated for removal in future release:

  • lsaf_getmysessions
  • lsaf_getsessions
  • lsaf_getusersessions

 

Added macro:

  • lsaf_getsessionsbyquery

StudyService

Added macros:

  • lsaf_importstudycodelists
  • lsaf_importstudydetails
  • lsaf_importstudydocs
  • lsaf_importstudyfromdefinexml
  • lsaf_importstudytables
  • lsaf_importstudytlfs
  • lsaf_importstudyvlm

UserService

Updated macro:

  • lsaf_getuserproperties: Added single sign-on ID to values in returned data set.

WorkspaceService

Updated macro:

  • lsaf_getworkspacechildren
    • Updated recursion strategy to allow any valid integer between 0 and 99, inclusively.
    • Added variables to resulting data set: fileSize and formattedFileSize.
    • Suppressed folder size.

 

 

In addition to new features and enhancements, SAS Life Science Analytics Framework Macro API 2.4 addresses the following software issues:

 

SAS Note Number Title

67375

Audit detail query from API Macros or Java API does not return results

 

Note: The LSAF Macro API 2.4 was originally delivered with a small typo in a few areas of the documentation, reflecting version number 2.3 instead of 2.4. These typos were corrected as of July 6, 2021. No changes to the Macro code were made.

If you downloaded the macros prior to July 9, 2021, you can download the new LSAF API Macros API 2.4 ZIP file and simply replace these three files to get the corrected documentation:

  • .\lsaf-sas-macro-2.4\docs\macrodocs\product.html
  • .\lsaf-sas-macro-2.4\docs\macrodocs\module-list.html
  • .\lsaf-sas-macro-2.4\docs\macrodocs\index.html


Operating System and Release Information

Product FamilyProductSystemProduct ReleaseSAS Release
ReportedFixed*ReportedFixed*
SAS SystemSAS Life Science Analytics FrameworkLinux for x645.39.4 TS1M7
* For software releases that are not yet generally available, the Fixed Release is the software release in which the problem is planned to be fixed.