Windchill RV&S 클라이언트 URL 링크

시작하기 > 작업 환경 선택 > Windchill RV&S 클라이언트 그래픽 사용자 인터페이스 > Windchill RV&S 클라이언트 URL 링크

Windchill RV&S 클라이언트 URL 링크를 클라이언트에서 생성한 이메일 알림으로 전송하여 수신자가 링크를 클릭하고 연결된 항목을 다양한 Windchill RV&S 클라이언트 GUI 보기에서 열 수 있도록 할 수 있습니다. 또한 URL 링크를 보고서에 포함하고 웹 페이지, Internet Explorer 및 Windows 시작 > 실행 메뉴와 같은 다른 URL 위치에서 해당 링크를 실행할 수 있습니다.

Windchill RV&S 클라이언트 URL 링크는 Windchill RV&S 클라이언트가 지원하는 모든 Windows 플랫폼에서 지원됩니다. 최신 제품 플랫폼 지원 정보는 Windchill RV&S 지원 플랫폼을 참조하십시오.

주요 고려 사항

• Windchill RV&S 클라이언트 URL에는 프로토콜 이름 integrity://가 포함되는데 이 이름을 각 클라이언트 컴퓨터의 Windows 운영 체제에 등록해야 합니다. 등록은 Windchill RV&S 클라이언트를 설치할 때 자동으로 수행됩니다.

단일 컴퓨터에 여러 Windchill RV&S 클라이언트가 설치된 경우 기본적으로 마지막으로 설치된 클라이언트에 프로토콜이 등록되고 Windchill RV&S 클라이언트 URL을 열 때 사용됩니다. 클라이언트의 기본 설정 구성 대화 상자의 일반 창에서 이 Windchill RV&S 클라이언트가 Windchill RV&S URL 링크에 응답합니다. 옵션을 전환하여 동일한 시스템의 다른 클라이언트에 프로토콜을 등록하거나 옵션을 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 "일반 기본 설정"을 참조하십시오.

기본적으로 Windchill RV&S 클라이언트 및 Windchill RV&S 서버에서 생성하는 이메일 알림에는 Windchill RV&S 클라이언트 URL이 포함되며 Windchill RV&S 관리 클라이언트에서 mksis.includeIntegrityGUILinks 속성을 통해 제어됩니다. 자세한 내용은 이메일 알림의 해당 항목을 참조하거나 관리자에게 문의하십시오.

• Windchill RV&S 클라이언트 URL은 Microsoft Outlook에서 인식하지 않는 사용자 정의 프로토콜을 사용합니다. 따라서 Windchill RV&S 클라이언트 URL 링크를 클릭할 때마다 계속할지를 묻는 표준 Microsoft Office Outlook 보안 알림이 표시됩니다. 대화 상자에서 예를 클릭하면 Windchill RV&S 클라이언트 URL이 호출됩니다. 또는 운영 체제에 레지스트리 엔트리를 생성하여 integrity:// 프로토콜에 대한 대화 상자를 완전히 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 PTC eSupport Portal에서 CS121955 문서를 참조하십시오.

• Windchill RV&S 클라이언트 URL을 서식 있는 텍스트 필드에 사용하려면 URL 접두사 integrity를 Windchill RV&S 서버의 mksis.im.validURLPrefixes 속성에 추가해야 합니다.

• 클라이언트 서비스 팩을 설치하는 경우 Windchill RV&S 프로토콜은 해당 클라이언트에 현재 등록되지 않은 경우에만 자동으로 설치됩니다. 따라서 클라이언트에 대해 프로토콜을 사용하지 않도록 설정하고 나중에 동일한 클라이언트에 서비스 팩을 적용하면 해당 클라이언트에서 프로토콜이 다시 사용하도록 설정됩니다.

• Windchill RV&S 클라이언트를 제거하면 Windchill RV&S 프로토콜이 자동으로 제거되고 해당 레지스트리 엔트리가 제거됩니다. 그러나 프로토콜을 다른 클라이언트에 등록한 경우(단일 시스템에 여러 클라이언트가 있는 경우) 레지스트리 엔트리가 제거되지 않습니다.

Windchill RV&S 클라이언트 URL 구문

Windchill RV&S 클라이언트 URL의 구문은 다음과 같습니다.

integrity://<server>:<port>/<app>/<command>?selection=<id>
&<option1>=<value1>&<option2>=<value2>

여기서

• integrity://는 Windows에 등록된 Windchill RV&S URL 프로토콜입니다.

• server는 Windchill RV&S 서버가 설치된 컴퓨터의 호스트 이름입니다.

호스트 이름은 관리자가 정의한 값에 따라 결정될 수 있습니다.

• port는 Windchill RV&S 서버가 설치된 컴퓨터의 포트 번호입니다.

• app은 도메인별 Windchill RV&S 응용 프로그램의 약어입니다(예: im=워크플로 및 문서 관리, si=구성 관리).

• command는 CLI 명령과 호출할 보기의 이름입니다(예: viewissue). 자세한 내용은 지원되는 보기, 명령 및 명령 옵션를 참조하십시오.

• selection=id는 명령에 필요한 Windchill RV&S 항목 ID입니다. 쉼표 또는 공백으로 구분된 값 목록일 수 있으며 여기서 공백은 %20으로 URL 인코딩됩니다(예: selection=12345%2023456%203456)

• option=value는 추가 설정을 나타내는 임의의 숫자로 CLI 명령 옵션에 해당합니다(다중 값 옵션을 쉼표로 구분된 목록으로 정의).

명령 옵션의 값에는 인코딩이 필요합니다. 자세한 내용은 "URL 인코딩 요구 사항 및 고려 사항"을 참조하십시오.

Windchill RV&S 클라이언트 URL 링크가 포함된 이메일 알림 전송 및 수신

GUI 또는 웹에서 필드에 강조 표시된 사용자 이름을 클릭하여 Windchill RV&S 클라이언트 URL이 포함된 이메일 알림을 생성할 수 있습니다. 사용자 이름을 클릭하면 기본 이메일 응용 프로그램이 열리고 선택한 사용자를 주소로 하는 새 메시지가 표시됩니다.

이메일 제목에는 항목에 대한 간략한 설명이 표시되며 본문에는 두 개의 하이퍼링크가 포함됩니다. 첫 번째는 Windchill RV&S 웹 인터페이스에서 해당하는 항목을 여는 하이퍼링크이고 두 번째는 동일한 항목을 Windchill RV&S 클라이언트 GUI에서 여는 하이퍼링크입니다. 예를 들어 항목 1234에 대한 항목 세부 정보 보기의 헤더에서 사용자 jriley를 클릭하여 다음 링크가 포함된 이메일을 생성합니다.

WEB: http://jriley.abcfinancial.com:7001/im/issues?selection=1234

GUI: url:integrity://jriley.abcfinancial.com:7001/im/viewissue?selection=1234

사용하는 이메일 응용 프로그램에 따라 받는 사람이 이메일 알림을 수신하기 전까지 Windchill RV&S 클라이언트 URL 링크가 활성화되지 않거나 클릭 가능한 상태로 표시되지 않을 수 있습니다.

기록 보기에서 이메일을 생성하는 경우 기록 보기에 해당하는 기준 날짜 및 시간이 이메일 제목 및 본문에 주석으로 달릴 수 있습니다. 예를 들어 항목 1234의 기록 탭에서 사용자 jriley를 July 9, 2012 4:15:25 PM EST에 클릭하여 다음 링크가 포함된 이메일 알림을 생성합니다.

WEB: http://jriley.abcfinancial.com:7001/im/issues?selection=1234&asOf=20120709T211525Z

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와 동일합니다.

또한 시간은 보낸 사람의 현지 시간을 기준으로 지정됩니다. 받는 사람의 표준 시간대가 보낸 사람의 표준 시간대와 다른 경우 링크를 클릭하고 항목을 열면 현지 표준 시간대로 표시됩니다.

Windchill RV&S 클라이언트 URL 링크가 포함된 이메일 알림을 수신할 때 다음 사항에 유의하십시오.

• Microsoft Outlook 이메일 클라이언트에서 Windchill RV&S 클라이언트 URL은 클릭 가능한 링크로 표시됩니다.

• Microsoft Outlook Web에서는 어떤 브라우저에서도 클릭 가능한 GUI 링크가 지원되지 않습니다.

• Lotus Notes 이메일 클라이언트에서 Windchill RV&S 클라이언트 URL은 클릭할 수 없는 일반 텍스트로 표시됩니다. 텍스트를 브라우저 또는 Windows 시작 > 실행 대화 상자에 복사하면 Microsoft Outlook 클라이언트에서 링크를 클릭했을 때와 동일한 보기가 열립니다.

Windchill RV&S 클라이언트에서 생성한 이메일의 항목 개정 정보

항목 개정을 사용하는 경우 Windchill RV&S는 Windchill RV&S 클라이언트에서 사용자 이름 링크를 클릭하여 생성한 이메일에 향상된 요약 정보도 제공합니다. 기록 항목에서 사용자 이름 링크를 클릭하면 클라이언트 생성 이메일의 제목 필드에 항목 개정 정보가 다음 형식으로 포함됩니다.

유형 <항목 ID>: 항목 요약 [개정 정보] 기준 날짜 기준 날짜

또한 항목 개정을 사용하는 경우 클라이언트 생성 이메일의 본문 텍스트에 다음이 포함됩니다.

기준 날짜: [개정 정보] 기준 날짜

Windchill RV&S 항목에 대한 기록 컨텍스트를 보려면 기록 탭으로 이동하고 필요한 날짜에 대한 타임스탬프 링크를 클릭하여 기록 항목을 엽니다. 그런 다음 기록 Windchill RV&S 항목에서 사용자 이름 링크(예: 지정된 사용자, 수정한 사람 사용자 또는 생성한 사람 사용자)를 클릭하여 이메일 메시지를 실행할 수 있습니다.

항목 기록에서 링크를 클릭하거나 첫 번째 개정이 설정되지 않은 항목에서 작업하는 경우 항목 개정 정보가 클라이언트 생성 이메일에 포함되지 않습니다.

항목 개정을 사용하지 않는 경우 Windchill RV&S는 생성된 이메일에 대한 표준 형식을 생성합니다.

지원되는 보기, 명령 및 명령 옵션

Windchill RV&S GUI 보기와 Windchill RV&S 클라이언트 URL에서 지원되는 해당하는 CLI 명령 및 명령 옵션이 다음 표에 설명되어 있습니다.

Windchill RV&S 클라이언트 GUI 보기

CLI 명령/지원 옵션

URL 예

항목 보기

im issues--query--queryDefinition--fields--sortField--sortAscending--nosortAscending

Windchill RV&S 클라이언트 GUI의 항목을 항목 보기에서 열기

integrity://localhost:9001/im/issues?query=MyQuery&fields=Summary%2cPriority&sortField=Priority&sortAscending

항목 세부 정보 보기

im viewissue--asof

Windchill RV&S 클라이언트 GUI의 항목을 항목 세부 정보 보기에서 열기

integrity://localhost:9001/im/viewissue? selection=1234

Windchill RV&S 클라이언트 GUI의 항목을 기록 항목 세부 정보 보기에서 열기

integrity://localhost:9001/im/viewissue?selection=1234&asOf=20120730T190323Z

문서 보기

im viewsegment--asof--fields--outlineColumns

Windchill RV&S 클라이언트 GUI의 문서를 문서 보기에서 열기

integrity://localhost:9001/im/viewsegment?selection=1234&fields=Category%2cText

관계 보기

im relationships--asof--fields

Windchill RV&S 클라이언트 GUI의 문서를 관계 보기에서 열기

integrity://localhost:9001/im/relationships?selection=1234&fields=ID%2cType%2cState%2cSummary

소스 추적 뷰어

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

Windchill RV&S 클라이언트 GUI를 빈 하위 프로젝트가 필터링된 소스 프로젝트 보기에서 열기

integrity://localhost:9001/si/viewproject?project=%2FTestProject%2Fproject.pj&filtersubs

소스 멤버 기록

si viewhistory--project--devpath--projectrevision

Windchill RV&S 클라이언트 GUI를 소스 멤버 기록 보기에서 열기

integrity://localhost:9001/si/viewhistory?selection=source.java&project=%2FTestProject%2Fproject.pj

변경 패키지

si viewcp

Windchill RV&S 클라이언트 GUI를 변경 패키지 보기에서 열기

integrity://localhost:9001/si/viewcp?selection=1234%3A1

대시보드

im rundashboard--fieldFilter

Windchill RV&S GUI 클라이언트를 열고 지정된 대시보드 실행

integrity://localhost:9001/im/rundashboard?selection=%22My%20Dashboard%22

공백이 포함된 대시보드 이름은 따옴표로 URL 인코딩되어야 합니다.

보고서

im runreport--fieldFilter--asOf--issues--query--param--[no]substituteParams

Windchill RV&S GUI 클라이언트를 열고 지정된 보고서 실행

integrity://localhost:9001/im/runreport?selection=%22My%20Report%22

공백이 포함된 보고서 이름은 따옴표로 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는 지원되는 모든 명령에서 사용할 수 있습니다. 이러한 옵션은 Windchill RV&S 클라이언트 URL이 지정된 명령을 보기 세트에서 완벽하게 지원되는 클라이언트 보기인 TVI(Tabbed View Interface)에서 실행할지 부동 보기에서 실행할지 여부를 제어합니다.

◦ -Tvigui를 지정하지 않은 경우 명령이 TVI GUI에서 실행됩니다. 다시 말해, Windchill RV&S 클라이언트 GUI가 사용자의 현재 보기 세트를 사용하여 열리고 해당 보기 세트의 구성에 따라 명령이 부동 보기 또는 고정 보기에서 열립니다.

◦ --notvigui를 지정한 경우 명령이 부동 보기에서 실행됩니다(TVI GUI가 실행되지 않음).

보기 세트에 대한 자세한 내용은 "보기 세트 이해(GUI)"를 참조하십시오.

시스템에서 생성된 모든 Windchill RV&S 클라이언트 URL은 --tvigui로 설정됩니다. 독립 실행형 URL(--notvigui)을 생성하도록 Integrity를 수정할 수 있지만 관리자가 이메일 알림을 생성하는 트리거 스크립트를 사용자 정의해야 합니다.

URL 인코딩 요구 사항 및 고려 사항

Windchill RV&S 클라이언트 URL을 구성할 때 인코딩은 명령 옵션의 값에 대해서만 필요합니다(전체 URL을 인코딩하지 않음).

Windchill RV&S는 모든 들어오는 Windchill RV&S 클라이언트 URL이 RFC 1738에 따라 인코딩되어 모든 URL 데이터를 UTF-8로 전환할 수 있다고 간주합니다. 모든 인코딩 및 디코딩은 WWW 컨소시엄의 권장 사항에 따라 UTF-8 인코딩 스키마를 사용하여 최대의 호환성을 제공합니다. 예를 들어 공백 문자는 %20으로 인코딩됩니다. 자세한 내용을 보려면 http://docs.oracle.com/javase/8/docs/api/java/net/URLEncoder.html로 이동하십시오.

모든 잘못된 문자는 백분율(%) 문자와 문자에 대한 ISO-Latin 코드 포인트를 나타내는 2자리 16진수로 인코딩됩니다.

다음은 인코딩 옵션이 포함된 Windchill RV&S 클라이언트 URL의 예입니다.

• integrity://localhost:9001/im/viewissue?selection=12345&asof=%222012-01-01%2014%3a01%3a00%20z%22

여기서 2012-01-01 12:01:00 z가 인코딩되었습니다.

• integrity://localhost:9001/si/viewproject?project=%2FTestProject%2Fproject.pj

여기서 /TestProject/project.pj가 인코딩되었습니다.

• integrity://localhost:9001/im/viewissue?selection=12345&asof=jwWiki%20%e3%82%a2%e3%83%bc%e3%83%86%e3%82%a3%e3

• %82%af%e3%83%ab

여기서 asof=jwWiki アーティクル가 인코딩되었습니다.

Windchill RV&S 클라이언트 URL을 생성하는 사용자 정의 트리거 스크립트 또는 사용자 정의 작업을 작성하는 경우 java.net.Encoder와 같은 표준 라이브러리를 사용하여 URL의 명령 옵션 값을 인코딩하는 것이 좋습니다. 예를 들어 Java 인코더 클래스를 호출하여 인코딩할 수 있습니다.

java.net.URLEncoder.encode(some_URL, "UTF-8")

이 인코더 클래스는 RFC 1738(URL 사양)을 준수하고 실행 시 Windchill RV&S 클라이언트 URL이 Windchill RV&S 클라이언트에 의해 올바르게 디코딩될 수 있도록 합니다. 자세한 내용을 보려면 http://www.rfc-editor.org/rfc/rfc1738.txt로 이동하십시오.

트리거 스크립트 파일 changePackageNotification.js는 이 java 클래스를 사용하여 다음 예에서와 같이 Windchill RV&S 클라이언트 URL의 명령 옵션을 인코딩합니다.

/**
* Return a URL-encoded string version of the argument passed in.
*/
function urlEncode(arg)
{
try {
return java.net.URLEncoder.encode(arg,"UTF-8");
} catch (err) {
// Fall-through
}
// If UTF-8 failed, just use the default encoding.
return java.net.URLEncoder.encode(arg);
}

다음 표에 Windchill RV&S 클라이언트 URL의 명령 옵션 값 인코딩에 대한 요구 사항 및 고려 사항이 설명되어 있습니다.

문자 유형	코딩 요구 사항/고려 사항
ASCII 제어 문자	범위 00-1F 및 7F 내의 모든 문자를 인코딩해야 합니다.
예약된 문자	다음 특수 문자는 예약된 문자입니다. • 달러 기호($) 인코딩 24% • 앰퍼샌드(\&) 인코딩 %26 • 더하기 기호(+) 인코딩 %2B • 쉼표(,) 인코딩 %2C • 슬래시(/) 인코딩 %2F • 콜론(:) 인코딩 %3A • 세미콜론(\;) 인코딩 %3B • 등호(=) 인코딩 %3D • 물음표(?) 인코딩 %3F • at 기호(@) 인코딩 40%
안전하지 않은 문자	일부 특수 문자는 URL 내에서 잘못 이해될 가능성이 있습니다. 예를 들어 호환되지 않거나 신뢰하지 못할 수 있습니다. PTC에서는 다음 문자를 인코딩할 것을 권장합니다. • 공백() 인코딩 20%(특히 여러 공백) • 따옴표("") 인코딩 %22 • 보다 작음 기호(\<) 인코딩 %3C • 보다 큼 기호(\>) 인코딩 %3E • 숫자 기호(#) 인코딩 23% • 백분율(%) 인코딩 25% • 왼쪽 중괄호({) 인코딩 %7B • 오른쪽 중괄호(}) 인코딩 %7D • 세로 막대/세로줄(\|) 인코딩 %7C • 백슬래시(\) 인코딩 %5C • 캐럿(^) 인코딩 %5E • 틸드(~) 인코딩 %7E • 왼쪽 대괄호([) 인코딩 %5B • 오른쪽 대괄호(]) 인코딩 %5D • 억음 악센트(') 인코딩 60%
ASCII가 아닌 문자	모든 비 ASCII 문자를 인코딩해야 합니다. 여기에는 ISO-Latin 세트 80-FF 16진수의 위쪽 반이 포함됩니다.
유니코드 문자	모든 유니코드 문자를 인코딩해야 합니다. FF 위의 모든 항목이 포함됩니다.