PTC RV&S 클라이언트 URL 링크
PTC RV&S 클라이언트 URL 링크를 클라이언트에서 생성한 이메일 알림으로 전송하여 수신자가 링크를 클릭하고 연결된 항목을 다양한 PTC RV&S 클라이언트 GUI 보기에서 열 수 있도록 할 수 있습니다. 또한 URL 링크를 보고서에 포함하고 웹 페이지, Internet Explorer 및 Windows > 메뉴와 같은 다른 URL 위치에서 해당 링크를 실행할 수 있습니다.
 |
PTC RV&S 클라이언트 URL 링크는 PTC RV&S 클라이언트가 지원하는 모든 Windows 플랫폼에서 지원됩니다. 최신 제품 플랫폼 지원 정보는 PTC Release Advisor를 참조하십시오.
|
주요 고려 사항
• PTC RV&S 클라이언트 URL에는 프로토콜 이름 integrity://가 포함되는데 이 이름을 각 클라이언트 컴퓨터의 Windows 운영 체제에 등록해야 합니다. 등록은 PTC RV&S 클라이언트를 설치할 때 자동으로 수행됩니다.
단일 컴퓨터에 여러 PTC RV&S 클라이언트가 설치된 경우 기본적으로 마지막으로 설치된 클라이언트에 프로토콜이 등록되고 PTC RV&S 클라이언트 URL을 열 때 사용됩니다. 클라이언트의 기본 설정 구성 대화 상자의 일반 창에서 이 PTC RV&S Client가 PTC RV&S URL 링크에 응답합니다. 옵션을 전환하여 동일한 시스템의 다른 클라이언트에 프로토콜을 등록하거나 옵션을 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 일반 기본 설정 항목을 참조하십시오.
|
|
기본적으로 PTC RV&S 클라이언트 및 PTC RV&S 서버에서 생성하는 이메일 알림에는 PTC RV&S 클라이언트 URL이 포함되며 PTC RV&S 관리 클라이언트에서 mksis.includeIntegrityGUILinks 속성을 통해 제어됩니다. 자세한 내용은 이메일 알림의 해당 항목을 참조하거나 관리자에게 문의하십시오.
|
• PTC RV&S 클라이언트 URL은 Microsoft Outlook에서 인식하지 않는 사용자 정의 프로토콜을 사용합니다. 따라서 PTC RV&S 클라이언트 URL 링크를 클릭할 때마다 계속할지를 묻는 표준 Microsoft Office Outlook 보안 알림이 표시됩니다. 대화 상자에서 예를 클릭하면 PTC RV&S 클라이언트 URL이 호출됩니다. 또는 운영 체제에 레지스트리 엔트리를 생성하여 integrity:// 프로토콜에 대한 대화 상자를 완전히 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 PTC eSupport Portal에서 CS121955 문서를 참조하십시오.
• PTC RV&S 클라이언트 URL을 서식 있는 텍스트 필드에 사용하려면 URL 접두사 integrity를 PTC RV&S 서버의 mksis.im.validURLPrefixes 속성에 추가해야 합니다.
• 클라이언트 서비스 팩을 설치하는 경우 PTC RV&S 프로토콜은 해당 클라이언트에 현재 등록되지 않은 경우에만 자동으로 설치됩니다. 따라서 클라이언트에 대해 프로토콜을 사용하지 않도록 설정하고 나중에 동일한 클라이언트에 서비스 팩을 적용하면 해당 클라이언트에서 프로토콜이 다시 사용하도록 설정됩니다.
• PTC RV&S 클라이언트를 제거하면 PTC RV&S 프로토콜이 자동으로 제거되고 해당 레지스트리 엔트리가 제거됩니다. 그러나 프로토콜을 다른 클라이언트에 등록한 경우(단일 시스템에 여러 클라이언트가 있는 경우) 레지스트리 엔트리가 제거되지 않습니다.
PTC RV&S 클라이언트 URL 구문
PTC RV&S 클라이언트 URL의 구문은 다음과 같습니다.
integrity://<server>:<port>/<app>/<command>?selection=<id>
&<option1>=<value1>&<option2>=<value2>
여기서
• integrity://는 Windows에 등록된 PTC RV&S URL 프로토콜입니다.
• server는 PTC RV&S 서버가 설치된 컴퓨터의 호스트 이름입니다.
|
|
호스트 이름은 관리자가 정의한 값에 따라 결정될 수 있습니다.
|
• port는 PTC RV&S 서버가 설치된 컴퓨터의 포트 번호입니다.
• app은 도메인별 PTC RV&S 응용 프로그램의 약어입니다(예: im=워크플로 및 문서 관리, si=구성 관리, extended-web-ui=새로 고친 웹 인터페이스).
• selection=id는 명령에 필요한 PTC RV&S 항목 ID입니다. 쉼표 또는 공백으로 구분된 값 목록일 수 있으며 여기서 공백은 %20으로 URL 인코딩됩니다(예: selection=12345%2023456%203456)
• option=value는 추가 설정을 나타내는 임의의 숫자로 CLI 명령 옵션에 해당합니다(다중 값 옵션을 쉼표로 구분된 목록으로 정의).
|
|
명령 옵션의 값에는 인코딩이 필요합니다. 자세한 내용은 URL 인코딩 요구 사항 및 고려 사항을 참조하십시오.
|
PTC RV&S 클라이언트 URL 링크가 포함된 이메일 알림 전송 및 수신
GUI 또는 웹에서 필드에 강조 표시된 사용자 이름을 클릭하여 PTC RV&S 클라이언트 URL이 포함된 이메일 알림을 생성할 수 있습니다. 사용자 이름을 클릭하면 기본 이메일 응용 프로그램이 열리고 선택한 사용자를 주소로 하는 새 메시지가 표시됩니다.
이메일 제목에는 항목에 대한 간략한 설명이 표시되며 본문에는 두 개의 하이퍼링크가 포함됩니다. 첫 번째는 PTC RV&S 웹 인터페이스에서 해당하는 항목을 여는 하이퍼링크이고 두 번째는 동일한 항목을 PTC RV&S 클라이언트 GUI에서 여는 하이퍼링크입니다. 예를 들어 항목 1234에 대한 항목 세부 정보 보기의 헤더에서 사용자 jriley를 클릭하여 다음 링크가 포함된 이메일을 생성합니다.
WEB: https://jriley.abcfinancial.com:7001/im/issues?selection=1234
REFRESHED WEB: https://jriley.abcfinancial.com:7001/extended-web-ui/items/item/1234
GUI: url:integrity://jriley.abcfinancial.com:7001/im/viewissue?selection=1234
|
|
사용하는 이메일 응용 프로그램에 따라 수신자가 이메일 알림을 수신하기 전까지 PTC RV&S 클라이언트 URL 링크가 활성화되지 않거나 클릭 가능한 상태로 표시되지 않을 수 있습니다.
|
기록 보기에서 이메일을 생성하는 경우 기록 보기에 해당하는 기준 날짜 및 시간이 이메일 제목 및 본문에 주석으로 달릴 수 있습니다. 예를 들어 항목 1234의 기록 탭에서 사용자 jriley를 July 9, 2012 9:15:25 PM EST에 클릭하여 다음 링크가 포함된 이메일 알림을 생성합니다.
WEB: https://jriley.abcfinancial.com:7001/im/issues?selection=1234&asOf=20120709T211525Z
REFRESHED WEB: https://jriley.abcfinancial.com:7001/extended-web-ui/items/item/1234?asof=2012-07-09T21:15:25Z
GUI: url:integrity://jriley.abcfinancial.com:7001/im/viewissue?selection=1234&asOf=20120709T211525Z
기준 날짜 및 타임스탬프는 UTC(협정 세계시)의 기본 ISO 8601 형식이며 표준 시간대 지정자가 포함된 전체 날짜 및 시간으로 지정됩니다. 예를 들면 다음과 같습니다.
YYYYMMddThhmmssZ
여기서
• YYYYMMdd는 연도를 나타내는 4자리 숫자와 각각 월 및 일을 나타내는 2자리 숫자입니다(월 및 일이 한 자리 숫자인 경우 0이 선행해야 함).
• T는 날짜와 시간을 구분합니다.
• hhmmss는 각각 시, 분 및 초를 나타내는 2자리 숫자입니다(시, 분, 초가 한 자리 숫자인 경우 0이 선행해야 함).
• Z는 영(0) UTC 오프셋에 대한 표준 시간대 지정자입니다.
|
|
시간은 00:00:00부터 23:59:59까지 24시간 형식으로 지정됩니다. 예를 들어 13:56:45의 시간을 나타내는 URL은 오후 1:56:45와 동일합니다.
또한 시간은 발송자의 현지 시간을 기준으로 지정됩니다. 수신자의 표준 시간대가 발송자의 표준 시간대와 다른 경우 링크를 클릭하고 항목을 열면 현지 표준 시간대로 표시됩니다.
|
PTC RV&S 클라이언트 URL 링크가 포함된 이메일 알림을 수신할 때 다음 사항에 유의하십시오.
• Microsoft Outlook 이메일 클라이언트에서 PTC RV&S 클라이언트 URL은 클릭 가능한 링크로 표시됩니다.
• Microsoft Outlook Web에서는 어떤 브라우저에서도 클릭 가능한 GUI 링크가 지원되지 않습니다.
• Lotus Notes 이메일 클라이언트에서 PTC RV&S 클라이언트 URL은 클릭할 수 없는 일반 텍스트로 표시됩니다. 텍스트를 브라우저 또는 Windows > 대화 상자에 복사하면 Microsoft Outlook 클라이언트에서 링크를 클릭했을 때와 동일한 보기가 열립니다.
PTC RV&S 클라이언트에서 생성한 이메일의 항목 개정 정보
항목 개정을 사용하는 경우 PTC RV&S는 PTC RV&S 클라이언트에서 사용자 이름 링크를 클릭하여 생성한 이메일에 향상된 요약 정보도 제공합니다. 기록 항목에서 사용자 이름 링크를 클릭하면 클라이언트 생성 이메일의 제목 필드에 항목 개정 정보가 다음 형식으로 포함됩니다.
유형<항목 ID>: 항목 요약[개정 정보] 기준 날짜 기준 날짜
또한 항목 개정을 사용하는 경우 클라이언트 생성 이메일의 본문 텍스트에 다음이 포함됩니다.
기준 날짜: [개정 정보] 기준 날짜
PTC RV&S 항목에 대한 기록 컨텍스트를 보려면 기록 탭으로 이동하고 필요한 날짜에 대한 타임스탬프 링크를 클릭하여 기록 항목을 엽니다. 그런 다음 기록 PTC RV&S 항목에서 사용자 이름 링크(예: 지정된 사용자, 수정한 사람 사용자 또는 만든 사람 사용자)를 클릭하여 이메일 메시지를 실행할 수 있습니다.
|
|
항목 기록에서 링크를 클릭하거나 첫 번째 개정이 설정되지 않은 항목에서 작업하는 경우 항목 개정 정보가 클라이언트 생성 이메일에 포함되지 않습니다.
|
항목 개정을 사용하지 않는 경우 PTC RV&S는 생성된 이메일에 대한 표준 형식을 생성합니다.
지원되는 보기, 명령 및 명령 옵션
PTC RV&S GUI 보기와 PTC RV&S 클라이언트 URL에서 지원되는 해당하는 CLI 명령 및 명령 옵션이 다음 표에 설명되어 있습니다.
|
PTC RV&S 클라이언트 GUI 보기
|
CLI 명령/지원 옵션
|
1세대 웹 인터페이스 URL 예
|
새로 고친 웹 인터페이스 URL 예
|
||||
|---|---|---|---|---|---|---|---|
|
항목 보기
|
im issues--query--queryDefinition--fields--sortField--sortAscending--nosortAscending
|
PTC RV&S 클라이언트 GUI의 항목을 항목 보기에서 열기
integrity://localhost:9001/im/issues?query=MyQuery&fields=Summary%2cPriority&sortField=Priority&sortAscending
|
새로 고친 웹 인터페이스 항목 보기에서 항목 열기:
integrity://localhost:9001/extended-web-ui/items?query=MyQuery&fields=Summary%2cPriority&sortField=Priority&sortAscending
다음 특수 문자는 질의 정의에서 지원되지 않습니다.
• 더하기 기호(+)
• 등호(=)
• 콜론(:)
• 세미콜론(;)
• 골뱅이 기호(@)
• 앰퍼샌드(&)
• 물음표(?)
• 달러 기호($)
• 쉼표(,)
• 슬래시 표시(/)
• 별표(*)
• 느낌표(!)
• 작은따옴표(')
• 왼쪽 꺾쇠괄호([)
• 오른쪽 꺾쇠괄호(])
• 왼쪽 괄호 (
• 오른쪽 괄호 )
• 왼쪽 중괄호({)
• 오른쪽 중괄호(})
|
||||
|
항목 세부 정보 보기
|
im viewissue--asof
|
PTC RV&S 클라이언트 GUI의 항목을 항목 세부 정보 보기에서 열기
integrity://localhost:9001/im/viewissue? selection=1234
PTC RV&S 클라이언트 GUI의 항목을 기록 항목 세부 정보 보기에서 열기
integrity://localhost:9001/im/viewissue?selection=1234&asOf=20120730T190323Z
|
새로 고친 웹 인터페이스 항목 세부 정보 보기에서 항목 열기:
integrity://localhost:9001/extended-web-ui/items/item/1234
새로 고친 웹 인터페이스 기록 항목 세부 정보 보기에서 항목 열기:
integrity://localhost:9001/extended-web-ui/items/item/1234?asOf=20120730T190323Z
|
||||
|
문서 보기
|
im viewsegment--asof--fields--outlineColumns
|
PTC RV&S 클라이언트 GUI의 문서를 문서 보기에서 열기
integrity://localhost:9001/im/viewsegment?selection=1234&fields=Category%2cText
|
새로 고친 웹 인터페이스 DocStudio 보기에서 문서 열기:
integrity://localhost:9001/extended-web-ui/doc-workspace/doc/1234?fields=Category%2cText
|
||||
|
관계 보기
|
im relationships--asof--fields
|
PTC RV&S 클라이언트 GUI의 문서를 관계 보기에서 열기
integrity://localhost:9001/im/relationships?selection=1234&fields=ID%2cType%2cState%2cSummary
|
새로 고친 웹 인터페이스 관계 보기에서 문서 열기:
integrity://localhost:9001/extended-web-ui/relationships/item/1234?fields=ID,Type,State,Summary
|
||||
|
소스 추적 뷰어
|
im viewsourcetraces--project--asof--devpath--scmHost--scmPort--fields--projectrevision--revision--sortField--sortAscending--nosortAscending
|
일반 프로젝트/하위 프로젝트의 멤버에 대한 소스 추적 뷰어 열기
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3a%2fproject.pj& revision=1.0
파생 하위 프로젝트의 멤버에 대한 소스 추적 뷰어 열기
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3A%2Fproject.pj&devpath=TestDevPath&revision=1.0
또는
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=%23c%3A%2F%23d%3DTestDevPath&revision=1.0
빌드 프로젝트/하위 프로젝트의 멤버에 대한 소스 추적 뷰어 열기
integrity://localhost:9001/im/viewsourcetraces?selection=code.java&project=c%3A%2Fproject.pj&projectrevision=1.0&revision=1.0
또는
integrity://localhost:9001/si/viewsourcetraces?selection=code.java&project=%23c%3A%2F%23b%3D1.0&revision=1.0
|
새로 고친 웹 인터페이스에서는 구성 관리 기능이 지원되지 않습니다
|
||||
|
소스 프로젝트
|
si viewproject--project--devpath--projectrevision--filtersubs--nofiltersubs
|
PTC RV&S 클라이언트 GUI를 빈 하위 프로젝트가 필터링된 소스 프로젝트 보기에서 열기
integrity://localhost:9001/si/viewproject?project=%2FTestProject%2Fproject.pj&filtersubs
|
새로 고친 웹 인터페이스에서는 구성 관리 기능이 지원되지 않습니다
|
||||
|
소스 멤버 기록
|
si viewhistory--project--devpath--projectrevision
|
PTC RV&S 클라이언트 GUI를 소스 멤버 기록 보기에서 열기
integrity://localhost:9001/si/viewhistory?selection=source.java&project=%2FTestProject%2Fproject.pj
|
새로 고친 웹 인터페이스에서는 구성 관리 기능이 지원되지 않습니다
|
||||
|
변경 패키지
|
si viewcp
|
PTC RV&S 클라이언트 GUI를 변경 패키지 보기에서 열기
integrity://localhost:9001/si/viewcp?selection=1234%3A1
|
새로 고친 웹 인터페이스에서는 구성 관리 기능이 지원되지 않습니다
|
||||
|
대시보드
|
im rundashboard--fieldFilter
|
PTC RV&S GUI 클라이언트를 열고 지정된 대시보드 실행
integrity://localhost:9001/im/rundashboard?selection=%22My%20Dashboard%22
|
새로 고친 웹 인터페이스에서 지정된 대시보드 실행하기:
https://ppuwsv-alm18t.ptcnet.ptc.com:1340/extended-web-ui/dashboards/run?selection=__id121
|
||||
|
보고서
|
im runreport--fieldFilter--asOf--issues--query--param--[no]substituteParams
|
PTC RV&S GUI 클라이언트를 열고 지정된 보고서 실행
integrity://localhost:9001/im/runreport?selection=%22My%20Report%22
|
새로 고친 웹 인터페이스에서 지정된 보고서 실행하기:
https://ppuwsv-alm18t.ptcnet.ptc.com:1340/extended-web-ui/reports/run?selection=12345
|
||||
|
차트
|
im runchart--fieldFilter--query
|
PTC RV&S 클라이언트 GUI를 열고 지정된 차트 실행하기:
integrity://localhost:9001/im/runchart?selection=%22My%20Chart%22
|
새로 고친 웹 인터페이스에서 지정된 차트 실행하기:
https://ppuwsv-alm18t.ptcnet.ptc.com:1340/extended-web-ui/charts/run?selection=__id158
|
|
|
mksis.im.enableautomaticredirectiontoRWI 속성이 true로 설정되면 1세대 웹 인터페이스를 가리키는 모든 URL이 새로 고친 웹 인터페이스로 리디렉션됩니다.
|
또한 명령 옵션 --project, --tvigui 및 --notvigui에 대한 다음 사항에 유의하십시오.
• 옵션 --project는 소스 구성 경로 및 플랫 경로 구문을 지원합니다. 소스 구성 경로 구문을 --project 옵션과 함께 사용하면 --devpath 및 --projectrevision 옵션을 사용하지 않고 파생 프로젝트 및 빌드 프로젝트를 지정할 수 있습니다.
예를 들어 두 옵션을 지정하는 대신
project=c%3A%2Fproject.pj&devpath=TestDevPath
단일 옵션을 지정할 수 있습니다.
project=%23c%3A%2F%23d%3DTestDevPath
이러한 구문에 대한 자세한 내용은 CLI 매뉴얼 페이지의 options 매뉴얼 페이지에서 "구성 관리 프로젝트 지정"을 참조하십시오.
• 옵션 -tvigui 및 -notvigui는 지원되는 모든 명령에서 사용할 수 있습니다. 이러한 옵션은 PTC RV&S 클라이언트 URL이 지정된 명령을 보기 세트에서 완벽하게 지원되는 클라이언트 보기인 TVI(탭 보기 인터페이스)에서 실행할지 부동 보기에서 실행할지 여부를 제어합니다.
◦ -Tvigui를 지정하지 않은 경우 명령이 TVI GUI에서 실행됩니다. 다시 말해, PTC RV&S 클라이언트 GUI가 사용자의 현재 보기 세트를 사용하여 열리고 해당 보기 세트의 구성에 따라 명령이 부동 보기 또는 고정 보기에서 열립니다.
◦ --notvigui를 지정한 경우 명령이 부동 보기에서 실행됩니다(TVI GUI가 실행되지 않음).
|
|
보기 세트에 대한 자세한 내용은 보기 세트 이해(GUI)를 참조하십시오.
|
시스템에서 생성된 모든 PTC RV&S 클라이언트 URL은 --tvigui로 설정됩니다. 독립 실행형 URL(--notvigui)을 생성하도록 Integrity를 수정할 수 있지만 관리자가 이메일 알림을 생성하는 트리거 스크립트를 사용자 정의해야 합니다.