---
sourceDocument: Yokohama Mobile 구성 및 탐색
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/yokohama/mobile

 Release :

    - yokohama

ft:locale :

    - ko-KR

ft:publication_title :

    - Yokohama Mobile 구성 및 탐색

ft:clusterId :

    - mobile

bundleId :

    - mobile

workflow :

    - evelopment, Data and Analytics


---

# 모바일 딥 링크 구조

# 모바일 딥 링크 구조 {#ariaid-title1}

* 릴리스 버전: Yokohama
* 
* 업데이트 날짜 2025년 01월 30일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

모바일 앱 내의 모든 화면 유형에서 모바일 딥 링크를 구성하고 사용하는 방법을 숙지합니다.
모바일 딥 링크는 기본적으로 세 가지 구성 요소로 구성됩니다. 변수의 이름, 모바일 앱에 대한 참조 및 모바일 딥링크를 끌어오는 데 사용되는 공개 메서드입니다. 다음 모바일 딥 링크에는 지정된 화면이 열리는 `deepLinkGen`이라는 이름의 변수가 있습니다.모바일 에이전트  

    var deepLinkGen= new global.MobileDeepLinkGenerator('Agent');
     return deepLinkGen.getScreenLink('73f3d135532033002d96ddeeff7b1212');

변수 이름
:   모바일 딥 링크에 변수 이름을 지정할 수 있지만 나중에 참조할 수 있도록 식별할 수 있어야 합니다.

모바일 앱 호출
:   모바일 딥 링크가 가리키는 모바일 앱 중 하나를 입력합니다. 앱에 대한 Now Mobile`요청` 또는 앱에 대한 `에이전트를` 입력할 수 있습니다.모바일 에이전트 예를 들어 Now Mobile 앱을 가리키는 모바일 딥 링크 생성기를 사용하여 링크를 생성하려면 다음 코드를 사용합니다. 새 `전역. MobileDeepLinkGenerator('요청');`

공개 방법
:   모바일 딥 링크를 만드는 데 사용할 수 있는 공개 방법 중 하나를 사용합니다. 각 메서드에 대한 설명과 사용 이유를 보려면 표를 참조합니다.  
    {#deep-link-mobile-structure__table_nm2_jwd_ypb__entry__3}

    | 방법 | 사용 이유 | 메서드 매개변수 |
    |-|-|-|
    | `getButtonLink(buttonId, tableName, recordSysId)` | getButtonLink 는 입력 양식 화면에 연결하는 데 사용됩니다. | buttonId (필수): 입력 양식 화면을 시작할 버튼의 sys_id입니다. tableName (선택 사항): 현재 컨텍스트의 테이블 이름 recordSysId (선택 사항): 현재 컨텍스트 기록의 sys_id |
    | `getFormScreenLink(formScreenId, tableName, recordSysId)` | getFormScreenLink 는 매개변수가 지정되지 않은 양식 화면에 연결하는 데 사용됩니다. | formScreenId (필수): 필수 양식 화면 sys_id tableName (필수): 필수 양식 화면의 테이블 이름 recordSysId (필수): 의 기록 sys_id tableName |
    | `getLauncherScreenLink(launcherScreenId)` | getLauncherScreenLink 는 모든 런처 화면에 연결하는 데 사용됩니다. | launcherScreenId (필수): 필요한 시작 관리자 화면의 sys_id입니다. |
    | `getPrefillLink(forceLocalLogin)` | getPrefillLink 는 ServiceNow 모바일 앱을 처음 사용하는 사용자에게 유용합니다. 이 링크 형식은 모바일 앱에 인스턴스를 아직 추가하지 않은 사용자의 인스턴스 링크를 미리 채웁니다. 이 방법은 기본 인증 환경입니다. 이 메서드는 특정 화면에 대한 링크를 생성하지 않습니다. | forceLocalLogin (필수): 시스템에서 사용자의 인스턴스 로그인 상세 정보를 미리 채우려면 <kbd class="ph userinput">예를</kbd> 입력합니다. 사용자가 로그인 상세 정보를 수동으로 입력하려면 <kbd class="ph userinput">false</kbd>를 입력합니다. |
    | `getScreenLink(documentId, uiParams)` | getScreenLink 는 매개변수화된 유형과 매개변수화되지 않은 유형을 모두 포함하여 모든 목록 화면에 연결하는 데 사용됩니다. 매개변수가 없는 모든 화면 유형에도 사용할 수 있습니다. 선택적 UI 매개변수를 이 메서드에 전달할 수 있습니다. | documentId (필수): 원하는 화면 sys_id uiParams (선택 사항): 데이터 항목의 매개변수 |
    | `getSSOPrefillLink(sys_id)` | getSSOPrefillLink 는 `sys_id` 매개변수로 식별되는 IdP(신원 확인 제공자)를 사용하는 링크를 생성합니다. 이 링크는 다른 IdP를 사용하는 최종 사용자를 인증하는 데 사용할 수 있습니다. 예를 들어 사전 채용자는 IdP로 사용할 Microsoft Azure 수 있으며 온보딩된 직원은 IdP로 사용할 Okta 수 있습니다. 이러한 SSO(Single Sign-On) 미리 채워진 링크는 직원에게 전송되는 이메일에 포함하는 데 일반적으로 사용됩니다. 이러한 이메일에는 모바일 앱을 사용하여 인스턴스에 ServiceNow 안전하게 로그인하는 데 사용할 수 있는 링크가 포함되어 있습니다. 중요사항: 이 방법을 사용하려면 복수 제공자 SSO 플러그인을 활성화하고 활성 IdP가 있어야 합니다. 자세한 내용은 [복수 제공자 SSO 플러그인 활성화](https://www.servicenow.com/docs/access?context=t_ActivateMultipleProviderSSO&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)를 참조하십시오 | sys_id (필수): ID 제공자 \[sso_properties\] 테이블에서 사용할 IdP의 sys_id 입력합니다. IdP sys_id 가져오려면 다음을 수행합니다. 1. 다음으로 이동 모두복수 제공자 SSO계정 제공자. 2. ID 제공자 기록을 마우스 오른쪽 버튼으로 클릭하고 sys_id 복사를 선택합니다. {#deep-link-mobile-structure__ol_srz_cr3_wrb} |
    | `getUniversalLink(url)` | getUniversalLink 는 목록, 양식 또는 브라우저에 대한 링크를 생성합니다. 이 URL의 컨텐츠를 기반으로 화면이 생성됩니다. [모바일용 범용 링크](https://servicenow-prod.fluidtopics.net/lyYt79msBpLe465khlrsYw "모바일 범용 링크를 사용하면 플랫폼 웹 경험을 통해 액세스할 수 없는 모바일 앱 내의 특정 화면으로 사용자를 유도할 수 있습니다.ServiceNow") 문서를 참조하십시오. | url (필수): 인스턴스의 자원에 대한 링크 |
    [ ]

    {#deep-link-mobile-structure__table_nm2_jwd_ypb}