Workforce 배포

다음과 같이 모바일 사용자 및 디스패처가 ArcGIS Workforce를 시작하도록 지원할 수 있습니다.

링크에서 Workforce 모바일 앱 열기

모바일 사용자는 Workforce에서 포털 URL을 지정하거나 올바른 포털 URL을 지정하는 URL을 직접 입력할 수 있습니다. 이메일, 문자 메시지, 웹페이지, QR 코드, 다른 앱을 통해 링크를 공유하여 모바일 사용자가 올바른 포털에 접속할 수 있도록 합니다. 누르면 모바일 작업자가 사용할 포털 URL이 Workforce에서 열립니다.

링크 구조

Workforce 모바일 앱에 대한 링크의 형식은 https://workforce.arcgis.app?parameter=value입니다. 매개변수 및 값 쌍은 앱을 배포할 때 사용할 값으로 대체됩니다. 예를 들어 https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis 링크는 portalURL 매개변수를 사용하여 모바일 사용자를 기관의 로그인 화면으로 바로 안내하고 로그인하라는 메시지를 표시합니다.

매개변수

다음 매개변수는 Workforce 링크에서 지원됩니다. 만약 매개변수가 전달되지 않은 경우, 링크를 누르면 Workforce가 열립니다(또는 앱을 다운로드하라는 메시지가 표시됨).

매개변수참고

portalURL

기관의 포털 URL

  • 값이 지정된 경우 모바일 사용자가 로그아웃하거나 다른 포털(ArcGIS Online 포함)에 연결하면 로그아웃하라는 메시지가 표시되고, 기관의 로그인 화면으로 바로 이동하며 로그인하라는 메시지가 표시됩니다.
  • 포털에 접근할 때 브라우저에 입력하는 것과 동일한 URL을 제공합니다(예시: https://myportal.mycompany.com/arcgis).

mapID

Workforce에서 다운로드하고 열 맵의 항목 ID

  • 이 항목 ID는 작업자 맵의 항목 페이지 URL에 포함되어 있습니다. 예를 들어 작업자 맵의 항목 페이지 URL이 https://www.arcgis.com/home/item.html?id=fc60dfd46b234fbeaa74e76e6b17fb7b인 경우, 맵의 항목 ID는 fc60dfd46b234fbeaa74e76e6b17fb7b입니다.

assignmentID

Workforce에서 열리는 업무의 GlobalID

  • mapID 값이 필요합니다.
  • 업무의 GlobalID 값은 업무 레이어의 항목 페이지에 있는 데이터 탭에 있습니다. 테이블에서 옵션 메뉴를 클릭하고 열 보기/숨기기를 클릭합니다. GlobalID를 선택하여 각 업무에 이 값을 표시합니다.

assignmentStatus

Workforce에서 열 때 업무에 지정된 상태

  • mapIDassignmentID 값이 필요합니다.
  • 지원되는 정수 값은 다음과 같습니다.
    • 1(할당됨)
    • 2(진행 중)
    • 3(완료됨)
    • 4(거절됨)
    • 5(정지됨)

Workforce 링크에서 특정 동작을 구현하기 위해 이러한 매개변수를 사용하는 예시가 아래에 나와 있습니다.

특정 포털에 연결

모바일 작업자가 연결되어야 하는 포털의 URL을 지정합니다.

예를 들면 다음과 같습니다.

https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis

맵 다운로드와 열기

mapID 매개변수를 사용하여 맵을 다운로드하고 엽니다. 모바일 작업자가 맵을 기기에 이미 다운로드한 경우에는 다운로드가 수행되지 않고 해당 맵이 Workforce에 열립니다.

예를 들면 다음과 같습니다.

  • 현재 로그인한 모바일 작업자로 맵을 엽니다. 로그인하지 않은 경우에는 작업자에게 로그인할 기회를 제공합니다.
    https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
  • 특정 포털에 연결한 후 맵을 엽니다.
    https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&mapID=3ac4145c1ac44aea86e9ed42e00fbb0d

업무 열기

assignmentID 매개변수를 사용하여 맵에서 업무를 엽니다.

예를 들면 다음과 같습니다.

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d

업무 상태 설정

assignmentStatus 매개변수를 사용하여 업무 상태를 설정합니다.

예를 들면 다음과 같습니다.

https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d&assignmentStatus=2
비고:

이 매개변수를 사용하여 모바일 앱에서 불가능한 방식으로 업무 상태를 설정하는 것은 가능하지만 권장하지 않습니다. 예를 들어, 업무 상태가 할당됨인 경우 모바일 작업자가 설정한 진행 중 상태를 건너뛰고 Workforce 링크를 사용하여 이 상태를 정지됨으로 설정할 수 있습니다. 모바일 앱에서는 이 상태를 건너뛸 수 없습니다.

링크에서 Workforce 웹 앱 열기

이메일, 문자 메시지, 웹페이지, QR 코드 또는 다른 앱을 통해 링크를 공유하여 Workforce 웹 앱 배포를 간소화할 수 있습니다. URL 매개변수로 링크를 사용자 정의하여 기존 업무를 열거나 업무 정보가 이미 입력된 새 업무를 열 수 있습니다.

디스패처에 대한 링크를 제공하면 이미 주요 정보가 입력된 업무를 생성할 수 있습니다. 예를 들어 서드 파티 앱에서 업무를 생성하려면 새 업무의 위치, 설명, 기한을 자동으로 채우는 링크를 포함하면 됩니다.

링크 구조

Workforce 웹 앱에 대한 링크는 항상 http://<portal-url>/apps/workforce/projects/<project-id> 형식으로 시작됩니다.

특정 업무를 열려면 /dispatch/assignments/<assignment-id>를 링크에 추가합니다(http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>).

업무 생성을 시작하려면 /dispatch/assignments/new?을(를) 링크에 추가하고 앰퍼샌드(&)로 구분된 하나 이상의 매개변수를 포함합니다.

http://<your portal url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&lat=34.057170&lon=-117.194150&location=Esri
비고:

project-id 값은 Workforce 프로젝트가 열리면 해당 URL에서 확인할 수 있습니다. 예를 들어 URL이 http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934라면, project-id 값은 a0f297f949f549f0ade07eee562d9934입니다.

매개변수 인코딩

Workforce 웹 앱에 대한 링크의 모든 매개변수는 인코딩되어 있어야 합니다. 인코딩은 잘못된 문자를 퍼센트 기호(%)로 대체하여 해당 16진수 값이 뒤에 나타납니다.

예를 들어 다음 링크에는 인코딩되지 않은 매개변수가 있습니다.

http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair hydrant&lat=34.057170&lon=-117.194150&location=Esri Campus

다음은 인코딩된 매개변수가 사용된 동일한 링크입니다.

http://<portal-url>/apps/workforce/<project-id>new?assignmentType=repair%20hydrant&lat=34.057170&lon=-117.194150&location=Esri%20Campus

인코딩된 URL을 생성할 수 있는 무료 웹사이트 및 도구가 많이 있습니다. 예를 들어 Albion Research Ltd에는 URLEncode and URLDecode 페이지가 있습니다.

업무 생성

새 업무에 대해 이미 입력된 업무 정보로 Workforce 웹 앱을 시작하는 링크를 생성합니다. 예를 들어 나무 검사를 생성하기 위한 사용자 설정 앱이 있는 경우 새 나무 검사 업무에 대해 업무 유형 및 위치 정보가 이미 입력된 상태로 Workforce를 여는 링크를 생성할 수 있습니다.

매개변수

아래 나열된 매개변수는 Workforce 링크가 있는 업무 생성에 지원됩니다.

매개변수참고

assignmentType

업무에 지정된 업무 유형

  • GlobalID 값이나 업무 유형의 이름을 사용할 수 있습니다.
    비고:

    클래식 프로젝트에 대한 링크를 생성하는 경우 코드 값 도메인 또는 업무 유형 이름을 사용할 수 있습니다.

  • 값은 대/소문자를 구분하지 않습니다.

lat

업무의 WGS84(WKID: 4326) 기준 y 좌표

  • lon 값이 필요합니다.

lon

업무의 WGS84(WKID: 4326) 기준 x 좌표

  • lat 값이 필요합니다.

location

업무에 사용된 위치 텍스트

  • 이 매개변수는 latlon이(가) 입력되지 않은 경우 무시됩니다.

priority

업무에 지정된 우선순위

  • 지원되는 정수 값은 다음과 같습니다.
    • 0(없음)
    • 1(낮음)
    • 2(보통)
    • 3(높음)
    • 4(매우 높음)

dueDateTime

업무에 지정된 기한 및 시간

  • Unix 에포크 이후의 숫자(밀리초)입니다.

workOrderId

외부 또는 서드 파티 시스템의 작업 지시를 참조하는 키

  • 외부 시스템의 값입니다.

description

업무에 대한 정보

  • 설명 텍스트입니다.

assignee

업무에 배정된 사용자

  • 작업자의 GlobalID 값 또는 사용자 이름을 사용할 수 있습니다.
    비고:

    클래식 프로젝트에 대한 링크를 생성하는 경우 objectid 값 또는 사용자 이름을 사용할 수 있습니다.

  • 값은 대/소문자를 구분하지 않습니다.
비고:

모든 매개변수는 선택 사항입니다. 그러나 assignmentType, lat, lon, location 매개변수는 새 업무를 생성하기 전에 채워야 합니다.

ArcGIS Enterprise를 사용하는 경우 latlon은(는) 링크에서 업무를 생성할 때 지원되는 유일한 매개변수입니다. ArcGIS EnterpriseWorkforce 웹 앱은 역 지오코딩을 사용하여 location 매개변수를 채웁니다.

예시

다음은 Workforce 업무를 생성할 때 앱 링크에서 매개변수를 사용하여 정보를 채우는 방법의 예시입니다.

  • 좌표를 사용한 업무 생성:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150
  • 보통 우선순위인 나무 검사 업무를 생성하고 모바일 작업자에게 배정:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=inspect%20tree&lat=34.057170&lon=-117.194150&location=esri&priority=2&assignee=mobile_worker
  • 5월 23일 오후 3시에 마감되는 파이프 수리 업무 생성:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000
  • 문제에 대한 설명과 함께 수리 업무 생성:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&&lat=34.057170&lon=-117.194150&location=esri&description=Repair%20the%20valve.

모바일 기기 관리

모바일 기기 관리는 기관 내의 모바일 기기를 운영하는 데 사용되는 소프트웨어입니다. MDM을 사용하여 데이터 및 네트워크 보안을 강화하고 모바일 기기 정책을 설정하고 시행할 수 있습니다. 또한 MDM을 사용하면 앱 갱신 방법 및 시기를 제어하는 등 모바일 기기의 앱 배포 및 관리 효율성이 향상됩니다. Esri의 MDM 처리 방법에 대해 더 알아보려면 ArcGIS 보안센터ArcGIS 보안 모바일 구현 패턴을 참고하세요.

MDM을 통해 기관의 모바일 기기에 Workforce를 배포하려는 경우 일부 응용프로그램 및 프로필 설정을 구성할 수 있습니다. 포털 URL, 앱별 VPN 설정 등이 해당됩니다.

주의:

Android 기기를 사용하는 경우, Chrome 또는 기타 브라우저가 설치되고 포털 로그인 화면을 표시하도록 활성화되어 있어야 합니다.

Workforce 앱 구성

앱 구성(AppConfig라고도 함)은 포털 URL 등의 응용프로그램 설정을 제공하기 위한 형식입니다. 모바일 앱이 설치될 때마다 이러한 설정을 수동으로 구성하는 대신 MDM을 사용하여 앱 구성 설정을 자동으로 지정하고 적용할 수 있습니다. 이러한 설정은 .xml 파일의 키-값 쌍 사전으로 정의됩니다. 사전을 생성하는 방법은 사용하는 MDM에 따라 다릅니다. 앱 구성 설정에 대한 자세한 내용은 AppConfig 커뮤니티 웹 페이지를 참고하세요.

MDM의 앱 구성으로 다음과 같은 Workforce 설정을 구현할 수 있습니다.

참고

portalURL

기관의 포털 URL

  • Workforce를 실행하면 기관 포털의 로그인 화면으로 바로 건너뜁니다.
  • 예시: https://myportal.mycompany.com/gis.
  • 값 유형은 문자열입니다.

앱별 가상 사설망

MDM에서 앱별 가상 사설망(앱별 VPN)을 구성하면 내부 리소스의 특정 관리 앱 접속을 제한할 수 있습니다. Workforce는 이 구성으로 배포될 수 있습니다. Workforce에 사용할 앱별 VPN을 설정하려면 사용 중인 MDM의 소프트웨어 문서를 참고하세요.

주의:

iOS에서는 Workforce에서 포털 로그인 화면을 표시하는 데 Safari가 사용됩니다. 따라서 앱별 VPN이 활성화된 상태로 올바르게 작동되도록 하려면 사용 중인 앱별 VPN 프로파일의 Safari 도메인 설정에 포털 도메인(예시: mycompany.com)이 지정되어 있어야 합니다. Safari 도메인이 올바르게 설정되어 있지 않으면 할당된 모바일 기기에서 Workforce 포털 로그인 화면에 접속할 수 없습니다.

위에서 설명한 대로 앱별 VPN 프로파일에서 Safari 도메인을 설정하면 Safari 브라우저에서 Safari 도메인에 지정한 포털 도메인에도 접속할 수 있습니다. 이 접속을 차단하려면 해당 기기에서 Safari 브라우저 앱 차단을 사용하도록 iOS 제한(MDM에서 사용 가능한 경우)을 구성합니다.

MDM에서 Workforce에 대한 앱별 VPN 설정을 구성한 후 관리되는 모바일 기기에서 앱을 열면 지정된 앱별 VPN에 자동으로 연결됩니다. Workforce가 백그라운드에서 실행 중인 경우에도 앱별 VPN은 Workforce에만 연결됩니다. Workforce를 종료하면 모바일 기기와 앱별 VPN의 연결이 자동으로 해제됩니다.