안녕하세요 Chris, JMP 임상에서 현재 연구로 연구를 만들기 위한 연구 관리 API가 있는지 궁금합니다. 블로그의 표에서 찾을 수 없습니다.감사합니다. 리 바오위에
JMP Clinical은 표준화되고 구조화된 데이터를 중심으로 현재 진행 중인 임상 시험을 분석하고 검토하기 위해 특별히 11년 전에 출시되었습니다. 그 의도는 검토자가 사전 프로그래밍된 보고서를 사용하여 안전성 및/또는 효능 신호를 찾기 위해 정기적인 간격(매주 또는 매월)으로 검토용 데이터를 수신함으로써 검토자가 스스로 서비스를 제공하고 관련 데이터를 더 깊이 파고들 수 있도록 하는 것이었습니다. -수요. 검토 프로세스를 가속화하고 정적 표, 목록 및 그림을 볼 때 놓칠 수 있는 예외 사항을 찾아내기를 희망했습니다.
또한, 소프트웨어의 목표는 요청된 데이터와 검토자를 위한 표준화된 보고서를 생성하는 프로그래밍 팀의 부담을 완화하는 것이었습니다. 이로 인해 리뷰어의 요구를 수용하고 자주 프로그램을 실행하거나 프로그램/스크립트/매크로를 편집하는 데 많은 시간이 필요했습니다. 프로그래밍 및 생물통계학 그룹은 일반적으로 연구마다 일관성이 있는 일반적인 표나 그래프 대신 연구에 고유한 데이터 및 보고서에 집중하기를 원합니다. 더 많은 통계적 또는 알고리즘적 지식이 필요합니다.
모니터링해야 할 연구가 많거나 데이터를 자주 업데이트하는 조직을 제외하고 JMP Clinical은 대부분 이러한 목표를 달성했습니다. 이는 데이터 관리 및 생물통계학 팀에 JMP Clinical 내에서 연구를 업데이트해야 하는 새로운 부담을 주거나 프로세스에 능숙하지 않거나 시간이 없는 검토자에게 부담을 줍니다. 또한 JMP Clinical 내에서 일부 보고서를 수정하거나 일정에 따라 동일한 검토 템플릿을 실행할 수 있는 기능도 흥미로웠습니다. 자동화와 JMP Clinical 기능 확장에 대한 요구가 자주 제기되었습니다.
JMP Clinical의 API를 입력하세요. JMP Clinical 6에서는 프로그래밍 방식으로 일반적인 기능/프로세스에 대한 API 기반 액세스를 가능하게 하는 프레임워크와 인프라를 도입했습니다. JMP Clinical 7에서는 JSL(JMP 스크립팅 언어)을 사용하여 API가 출시되고 제공되었습니다. 버전 8(최신 버전)에서는 더 많은 기능이 출시되었습니다. 이 게시물에서는 API 개발에 대한 세부 사항을 다루지 않습니다. 대신, 이를 활용할 수 있도록 실제 사용에 중점을 둡니다.
API를 호출하고 사용하는 방법에 대한 일련의 게시물을 공유하겠습니다. 기본 구문과 사용법을 소개하는 것으로 간단하게 시작합니다. 그런 다음 JSL을 사용하면서 더욱 정교한 용도로 진행합니다. 마지막으로 일부 JSL 내에서 호출되는 두 가지 API 범주를 결합합니다.
JMP Clinical의 맥락에서 연구, 검토, 보고 및 검토 템플릿이라는 용어에 익숙하지 않은 분들은 이 링크를 참조하여 숙지하시기 바랍니다. 또한 JSL에 익숙하지 않은 분들도 이 링크 에서 자세한 내용을 읽고 배우시기 바랍니다. API 사용을 이해하려면 두 가지에 대한 지식이 필요합니다.
이 게시물에서는 두 가지 주요 범주와 가능한 것부터 시작하겠습니다. 두 가지 주요 범주는 연구 관리 관련 기능(JMPClinicalStudyManagerAPI)과 검토 관련 기능(JMPClinicalReviewAPI)입니다. 아이디어는 사용자 결정이 필요하지 않은 사용자 인터페이스 내에서 수행할 수 있는 작업(주로 버튼 클릭)을 복제하는 것입니다(예: 새 데이터로 연구에 대한 메타데이터를 새로 고치거나 특정 연구에 대해 검토 템플릿을 열고 실행). 다음은 연구 관리 섹션 및 검토 섹션과 관련된 버튼을 강조하는 두 개의 이미지입니다.
Study Management Functions that Relate to JMPClinicalStudyMangerAPIStudy Management Functions that Relate to JMPClinicalStudyMangerAPIStudy Management Functions that Relate to JMPClinicalStudyMangerAPIStudy Management Functions that Relate to JMPClinicalStudyMangerAPIJMPClinicalStudyMangerAPI 관련 연구 관리 기능
Review/Review Builder Functions that Related to JMPClinicalReviewAPIReview/Review Builder Functions that Related to JMPClinicalReviewAPIReview/Review Builder Functions that Related to JMPClinicalReviewAPIReview/Review Builder Functions that Related to JMPClinicalReviewAPIJMPClinicalReviewAPI 관련 리뷰/리뷰 빌더 기능
API는 새로운 메타데이터로 연구를 새로 고치거나 리뷰 템플릿 내의 보고서에서 콘텐츠를 추가/제거하는 등 일상적인 작업을 수행하고 자동화하기 위한 것입니다. 다음은 참조용 JMPClinicalStudyManagerAPI 함수에 대한 링크와 JMPClinicalReviewAPI 함수에 대한 또 다른 링크입니다.
그렇다면 이 JMPClinicalStudyMangerAPI API는 우리에게 무엇을 할 수 있을까요? 이는 두 가지 기능 세트, 즉 get 함수(연구에 대한 정보를 얻는 함수)와 조작 함수(연구를 추가, 제거 또는 업데이트하는 함수)를 제공합니다. 다음은 해당 함수를 호출하기 위한 기본 구문으로 가능한 작업에 대한 표입니다. 콜론(:)은 API 호출과 함수 호출을 구분합니다. 일부 함수에는 입력 및/또는 반환이 있습니다. 입력 및 반환으로 예상되는 내용에 대한 자세한 내용은 위 링크를 참조하세요.
|
연구 관리 API
|
|
정보 가져오기 기능
|
학습 기능 조작
|
|
연구 이름 목록 가져오기:
JMPClinicalStudyManagerAPI:getStudyList
|
연구 추가:
JMPClinicalStudyManagerAPI:addStudy
|
|
SDTM 폴더 경로 가져오기:
JMPClinicalStudyManagerAPI:getSDTMFolder
|
연구 메타데이터 새로 고침:
JMPClinicalStudyManagerAPI:refreshStudies
|
|
ADaM 폴더 경로 가져오기:
JMPClinicalStudyManagerAPI:getADaMFolder
|
연구 삭제:
JMPClinicalStudyManagerAPI:deleteStudies
|
|
날짜 연구 가져오기가 추가되었습니다:
JMPClinicalStudyManagerAPI:getInitialDate
|
새로운 스냅샷으로 연구 업데이트:
JMPClinicalStudyManagerAPI:updateSnapshot
|
|
마지막 연구가 업데이트된 날짜 가져오기:
JMPClinicalStudyManagerAPI:getLastUpdatedDate
|
연구 데이터 폴더 변경:
JMPClinicalStudyManagerAPI:changeFolders
|
|
스냅샷 활성화 상태 가져오기:
JMPClinicalStudyManagerAPI:getEnableSnapshot
|
환자 프로필 데이터 사전 계산:
JMPClinicalStudyManagerAPI:precomputeProfileData
|
|
스냅샷 번호 가져오기:
JMPClinicalStudyManagerAPI:getSnapshotNumber
|
|
|
인식된 도메인 목록 가져오기:
JMPClinicalStudyManagerAPI:getDomainList
|
|
|
디스크의 파일 크기를 가져옵니다.
JMPClinicalStudyManagerAPI:getSizeOnDisk
|
|
|
연구를 생성/추가한 Windows OS 사용자 ID 가져오기:
JMPClinicalStudyManagerAPI:getCreatedBy
|
|
|
마지막으로 업데이트한 Windows OS 사용자 ID를 가져옵니다. 연구:
JMPClinicalStudyManagerAPI:getLastUpdatedBy
|
|
이제 두 번째 범주인 검토 기능을 살펴보겠습니다. 여기에도 일련의 가져오기 및 조작 기능이 있지만 검토 및 보고서용입니다.
|
API 검토
|
|
정보 가져오기 기능
|
보고/검토 기능 조작
|
|
Review Builder에 대한 참조를 얻으십시오.
JMPClinicalReviewAPI:getReviewBuilder
|
리뷰 작성기 닫기:
JMPClinicalReviewAPI:closeReviewBuilder
|
|
리뷰 뷰어/빌더 ID 및 제목 가져오기:
JMPClinicalReviewAPI:getReviewViewerIDsAndTitles
|
검토 템플릿 열기:
JMPClinicalReviewAPI:openReviewTemplate
|
|
리뷰 뷰어에 대한 참조를 얻으세요:
JMPClinicalReviewAPI:getReviewViewer
|
리뷰 빌더에 보고서 추가:
JMPClinicalReviewAPI:추가보고서
|
|
리뷰 뷰어/빌더의 목차 가져오기:
JMPClinicalReviewAPI:getReviewTableOfContents
|
제목별로 보고서 양식 검토 작성기 제거:
JMPClinicalReviewAPI:removeReportByReportTitle
|
|
보고서 ID 목록을 가져옵니다.
JMPClinicalReviewAPI:getReportIDList
|
리뷰 빌더에서 제목별로 보고서 실행:
JMPClinicalReviewAPI:runReportByReportTitle
|
|
보고서 제목 목록을 가져옵니다.
JMPClinicalReviewAPI:getReportTitleList
|
Review Builder에서 모든 보고서를 실행합니다.
JMPClinicalReviewAPI:manAllReports
|
|
ID별로 보고서에 대한 참조를 얻으세요.
JMPClinicalReviewAPI:getReportByID
|
리뷰 빌더 콘텐츠를 리뷰로 저장:
JMPClinicalReviewAPI:saveReview
|
|
제목별 보고서에 대한 참조를 얻으세요.
JMPClinicalReviewAPI:getReportByTitle
|
리뷰 뷰어에서 리뷰를 엽니다.
JMPClinicalReviewAPI:오픈리뷰
|
|
제목별로 보고서 세부정보 가져오기:
JMPClinicalReviewAPI:getReportDetailsByTitle
|
보고서에 섹션 삽입:
JMPClinicalReviewAPI:insertSectionIntoReportByTitleAndSectionName
|
|
보고서 결과에 대한 참조를 얻으십시오.
JMPClinicalReviewAPI:getReportResultsByTitle
|
보고서에서 섹션 제거:
JMPClinicalReviewAPI:removeSectionFromReportByTitleAndSectionName
|
|
보고서 섹션에 대한 참조를 얻으십시오.
JMPClinicalReviewAPI:getReportSectionByTitleAndSectionName
|
보고서 섹션 끝에 추가:
JMPClinicalReviewAPI:appendDisplayObjectToReportSectionByTitleAndSectionName
|
|
보고서에 사용된 데이터 테이블 목록을 가져옵니다.
JMPClinicalReviewAPI:getDataTablesForSectionByTitleAndSectionName
|
보고서 섹션 시작 부분에 추가:
JMPClinicalReviewAPI:prependDisplayObjectToReportSectionByTitleAndSectionName
|
이제 다양한 기능과 해당 기능이 수행할 수 있는 작업이 나열되었습니다. 이제 사용의 기본 구문을 보여줄 차례입니다. 기본 형태는 다음과 같습니다.
JMPClinical<CATEGORY>API:<FUNCTION> ({인수(들)}, {네임스페이스}, CompleteListenerFunction());</FUNCTION></CATEGORY>
위에서 JMPClinicalStudyManagerAPI를 참조할 때 Study Management 관련 API 함수에 대한 기본 호출을 이미 소개했습니다. 따라서 등록된 연구의 메타데이터를 새로 고치려면 다음과 같이 표시됩니다.
JMPClinicalStudyManager:refreshStudies ({studyList},{},{});
우리는 이것을 더 자세히 분석하고 다음 게시물에서 일반적인 용도에 대해 이야기할 것입니다. 지금은 사용 가능한 항목과 이를 JSL 스크립트 내에서 일반적으로 호출하는 방법을 소개하고 싶었습니다. 다음 게시물에서는 Study Management API의 예에 대해 설명하겠습니다. API 호출의 네임스페이스 및 CompleteListener 부분에 대해 자세히 설명하고 이를 JSL로 래핑하고 그 안에서 JSL을 사용하는 방법을 시작합니다.
다음 포스팅까지 몸조심하세요!
@BaoyueLi,
늦은 답변 죄송합니다. 이번 포스팅에는 이런 댓글이 안보이네요. JMP Clinical 18(및 17)에서는 현재 연구를 설정할 수 있습니다. 다음은 사용자 가이드의 API 페이지 링크입니다.
https://www.jmp.com/support/downloads/JMPC180_documentation/Content/JMPCUserGuide/AP_C_0013.htm
일반적인 용도는 다음과 같습니다.
JMPClinicalStudyManagerAPI:setCurrentStudy("연구 이름")
현재 연구를 지정된 연구로 설정합니다.
인수:
연구 - 현재 연구로 설정할 연구의 이름이 포함된 문자열 또는 현재 연구를 다음으로 설정하기 위한 비어 있음()
보고:
현재 연구가 성공적으로 설정되면 1; 그렇지 않으면 0.
고마워요 크리스. JMP 임상 버전 15에서는 "setCurrentStudy" 명령을 사용할 수 없는 것 같나요?