GlideURI - 전역

GlideURI API는 전역 애플리케이션에서 URI 매개변수를 처리하는 메서드를 제공합니다.

주:

익스포트 또는 백그라운드 작업에서 실행되는 스크립트에 GlideURI API를 사용하지 마십시오.

URI 사용에 대한 자세한 내용은 다음을 참조하십시오.

• URL로 탐색
• 탐색 스택

Action - getGlideURI()도 참조하십시오.

GlideURI - deleteMatchingParameter(문자열 일치)

제공된 문자열의 시작과 일치하는 하나 이상의 매개변수를 URI에서 삭제합니다.

표 1. 매개변수

이름	유형	설명
일치	문자열	URI의 쿼리 부분에서 제거할 하나 이상의 매개변수 부분 이름입니다.

표 2. 반환

유형	설명
없음

다음 예제에서는 제공된 이름과 부분적으로 일치하는 URI 매개 변수를 삭제하는 방법을 보여 줍니다.

// create the GlideURI object
var uri = action.getGlideURI();

uri.deleteMatchingParameter('sysparm_list_');
uri.deleteMatchingParameter('sysparm_record_');

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

GlideURI - deleteParameter(문자열 이름)

URI의 쿼리 부분에서 지정된 매개변수를 제거합니다.

표 3. 매개변수

이름	유형	설명
이름	문자열	URI의 쿼리 부분에서 제거할 매개변수의 이름입니다.

표 4. 반환

유형	설명
없음

다음 예제에서는 URI 매개 변수를 삭제하는 방법을 보여 줍니다.

// create the GlideURI object
var uri = action.getGlideURI(); 

uri.deleteParameter('sysparm_referring_url');

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

GlideURI - get(문자열 이름)

지정된 매개변수의 값을 반환합니다.

표 5. 매개변수

이름	유형	설명
이름	문자열	매개변수 이름입니다.

표 6. 반환

유형	설명
문자열	지정된 매개변수의 값입니다.

// create the GlideURI object
var uri = action.getGlideURI();
uri.set('sysparm_query', 'priority=2^active=true' );
var fileString = uri.get('sysparm_query');
gs.info(fileString);

출력:

priority=2^active=true

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 get() 메서드를 사용하려면 해당 범위가 지정된 메서드인 GlideURI - get(String name) 을 사용합니다.

GlideURI - getFileFromPath()

URI의 파일 이름 부분을 반환합니다.

표 7. 매개변수

이름	유형	설명
없음

표 8. 반환

유형	설명
문자열	URI의 파일 이름 부분입니다.

var gURI = action.getGlideURI();
        
var fileString = gURI.getFileFromPath();
gs.info(fileString);

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 getFileFromPath() 메서드를 사용하려면 해당 범위가 지정된 메서드인 GlideURI - getFileFromPath() 를 사용합니다.

GlideURI - getMap()

쿼리의 각 매개변수와 관련 값을 포함하는 맵(키 값 쌍)을 반환합니다.

표 9. 매개변수

이름	유형	설명
없음

표 10. 반환

유형	설명
객체

다음 예제에서는 sysparm_query 매개 변수를 가져오는 방법을 보여 줍니다. Action - getGlideURI() 도 참조하십시오.

gs.action.getGlideURI().getMap().get('sysparm_query');

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

GlideURI - set(문자열 이름, 문자열 값)

지정된 매개변수를 지정된 값으로 설정합니다.

표 11. 매개변수

이름	유형	설명
이름	문자열	매개변수 이름입니다.
값	문자열	값입니다.

표 12. 반환

유형	설명
없음

다음 예제에서는 sysparm_query 필드의 값을 설정하는 방법을 보여 줍니다. Action - getGlideURI() 도 참조하십시오.

var gURI = action.getGlideURI();
gURI.set('sysparm_query', 'priority=2^active=true' );
var fileString = gURI.get('sysparm_query');
gs.info(fileString);

출력:

priority=2^active=true

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 set() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 GlideURI - set(String name, String value) 를 사용합니다.

GlideURI - setView(문자열 뷰)

명명된 뷰를 사용하여 쿼리에 매개변수를 추가합니다 sysparm_view .

뷰는 사용자가 양식 또는 목록을 열 때 나타나는 요소를 정의합니다. 매개변수는 sysparm_view 목록이나 양식에 사용할 뷰를 지정합니다. 보기에 대한 자세한 내용은 보기 관리를 참조하세요.

참조:

• 작업 - getGlideURI()
• GlideModalV3 - switchView()

표 13. 매개변수

이름	유형	설명
뷰	문자열	URI 쿼리에서 설정할 매개변수의 sysparm_view 이름입니다.

표 14. 반환

유형	설명
없음

다음 예에서는 인시던트 [incident] 테이블의 URI 쿼리에 중요 인시던트 뷰를 추가하는 방법을 보여줍니다. 예: sysparm_view=Major%20Incidents. Action - getGlideURI() 도 참조하십시오.

// create the GlideURI object
var uri = action.getGlideURI(); 

// Adds the Major incidents to the query
uri.setView('Major Incidents');

// https://instance.service-now.com/incident.do?sys_id=0&sysparm_view=Major%20Incidents ...

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

GlideURI - toString(문자열 경로)

URI 문자열을 재구성하고 유효하지 않은 문자를 URL 코드로 변환하여 적절한 URL 인코딩을 수행합니다. 예를 들어 \\를 '%26'(으)로 변환합니다.

set() 메서드로 설정된 매개 변수도 URI로 인코딩됩니다.

표 15. 매개변수

이름	유형	설명
path	문자열	URI가 추가되는 시스템 URL의 기본 부분입니다.

표 16. 반환

유형	설명
문자열	URL입니다.

다음 예제는 인스턴스 URL에서 잘못된 문자를 URL 코드로 변환하는 방법을 보여줍니다. Action - getGlideURI() 도 참조하십시오.

var gURI = action.getGlideURI();
fileString = gURI.toString('https://<your instance>.service-now.com/navpage.do');

범위가 지정된 해당 항목

범위가 지정된 애플리케이션에서 toString() 메서드를 사용하려면 해당 범위가 지정된 메서드인 GlideURI - toString(String path) 를 사용합니다.