Wdrażanie aplikacji Workforce

Aby ułatwić użytkownikom mobilnym i dyspozytorom rozpoczęcie pracy z aplikacją ArcGIS Workforce, można zastosować następujące sposoby:

Otwieranie aplikacji mobilnej Workforce przy użyciu łącza

Użytkownicy mobilni mogą podać adres URL portalu w aplikacji Workforce lub można przesłać prawidłowy adres URL portalu bezpośrednio do nich. Umożliw użytkownikom mobilnym uzyskiwanie dostępu do właściwego portalu, udostępniając im łącze za pośrednictwem wiadomości e-mail, wiadomości tekstowej, strony internetowej, kodu QR lub innej aplikacji. Po naciśnięciu łącza aplikacja Workforce otworzy adres URL portalu, który ma być używany przez pracownika mobilnego.

Struktura łącza

Łącza do aplikacji mobilnej Workforce mają następujący format: https://workforce.arcgis.app?parameter=value Pary parametr-wartość są zastępowane wartościami, które mają zostać użyte do wdrożenia aplikacji. Na przykład w łączu https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis parametr portalURL jest używany do bezpośredniego wyświetlania ekranu logowania instytucji wraz z prośbą o zalogowanie się.

Parametry

W łączach aplikacji Workforce obsługiwane są poniższe parametry. Jeśli nie zostaną przekazane żadne parametry, naciśnięcie łącza spowoduje otwarcie aplikacji Workforce (lub wyświetlenie prośby o pobranie aplikacji).

ParametrWartościUwagi

portalURL

Adres URL portalu instytucji

  • Jeśli jest podana wartość, a użytkownik mobilny jest wylogowany lub połączony z innym portalem (w tym usługą ArcGIS Online), zostanie poproszony o wylogowanie się i przeniesiony bezpośrednio na ekran logowania instytucji. Tam zostanie wyświetlona prośba o zalogowanie się.
  • Należy podać ten sam adres URL, który jest wprowadzany w przeglądarce, aby uzyskać dostęp do portalu, na przykład: https://myportal.mycompany.com/arcgis.

mapID

Identyfikator elementu mapy do pobrania i otwarcia w aplikacji Workforce

  • Identyfikator elementu znajduje się w adresie URL strony elementu mapy Pracownik. Jeśli na przykład adresem strony elementu mapy Pracownik jest https://www.arcgis.com/home/item.html?id=fc60dfd46b234fbeaa74e76e6b17fb7b, identyfikatorem elementu tej mapy jest fc60dfd46b234fbeaa74e76e6b17fb7b.

assignmentID

Wartość GlobalID zlecenia do otwarcia w aplikacji Workforce

  • Wymaga wartości mapID.
  • Wartość GlobalID zlecenia można znaleźć na karcie Dane na stronie elementu warstwy zleceń. W tabeli kliknij menu Opcje, a następnie kliknij przycisk Pokaż/ukryj kolumny. Wybierz identyfikator GlobalID, aby wyświetlić tę wartość dla każdego zlecenia.

assignmentStatus

Status przypisany do zlecenia w chwili, gdy zostało ono otwarte w aplikacji Workforce

  • Wymaga wartości mapID i assignmentID.
  • Obsługiwane są następujące wartości całkowite:
    • 1 (Zlecone)
    • 2 (W toku)
    • 3 (Ukończone)
    • 4 (Odrzucone)
    • 5 (Wstrzymane)

Przykłady użycia tych parametrów w celu osiągnięcia konkretnego zachowania za pomocą łącza Workforce znajdują się poniżej.

Łączenie się z określonym portalem

Podaj adres URL portalu, z którym powinien łączyć się pracownik mobilny.

Poniżej znajduje się przykład:

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

Pobieranie i otwieranie mapy

Mapę można pobrać i otworzyć przy użyciu parametru mapID. Jeśli pracownik mobilny pobrał plik mapę na urządzenie, nie są pobierane żadne dodatkowe elementy, a podana mapa jest otwierana w aplikacji Workforce.

Przykłady:

  • Otwórz mapę jako aktualnie zalogowany pracownik mobilny lub, jeśli pracownik nie jest zalogowany, zapewnij mu możliwość logowania:
    https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
  • Połącz się z określonym portalem i otwórz mapę:
    https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&mapID=3ac4145c1ac44aea86e9ed42e00fbb0d

Otwieranie zlecenia

Zlecenie można otworzyć na mapie przy użyciu parametru assignmentID.

Poniżej znajduje się przykład:

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

Ustawianie statusu zlecenia

Status zlecenia można ustawić przy użyciu parametru assignmentStatus.

Poniżej znajduje się przykład:

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

Tego parametru można używać do konfigurowania statusu zlecenia w sposób, który nie jest możliwy w aplikacji mobilnej. Nie jest to jednak zalecane. Jeśli na przykład zlecenie ma status Przypisane, można użyć łącza do aplikacji Workforce, aby ustawić dla tego zlecenia status Wstrzymane, pomijając status W toku, który normalnie zostałby ustawiony przez pracownika mobilnego. Pominięcie tego statusu nie jest możliwe w aplikacji mobilnej.

Otwieranie aplikacji internetowej Workforce przy użyciu łącza

Aby usprawnić wdrażanie aplikacji internetowej Workforce, możesz udostępnić łącze w wiadomości e-mail, wiadomości tekstowej, na stronie internetowej, przy użyciu kodu QR lub w innej aplikacji. Łącza można dostosowywać przy użyciu parametrów adresu URL w taki sposób, aby za ich pomocą były otwierane istniejące zlecenia lub nowe zlecenie z wypełnionymi już informacjami.

Dzięki łączom dyspozytorzy mogą tworzyć wstępnie wypełnione zlecenia, które zawierają kluczowe informacje. Aby na przykład utworzyć zlecenia w aplikacji innej firmy, możesz dodać łącze, które automatycznie wypełnia pola informacji o lokalizacji, opisu i terminu realizacji nowego zlecenia.

Struktura łącza

Łącza do aplikacji internetowej Workforce zawsze rozpoczynają się w następujący sposób: http://<portal-url>/apps/workforce/projects/<project-id>

Aby otworzyć określone zlecenie, dodaj do łącza fragment /dispatch/assignments/<assignment-id>: http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>

Aby rozpocząć proces tworzenia zlecenia, dodaj do łącza fragment /dispatch/assignments/new? i co najmniej jeden parametr, rozdzielając poszczególne parametry znakiem ampersand (&):

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

Wartość project-id można znaleźć w adresie URL, gdy otwarty jest projekt aplikacji Workforce. Na przykład, jeśli adres URL to http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, wartością project-id jest a0f297f949f549f0ade07eee562d9934.

Kodowanie parametrów

Wszystkie parametry używane w łączach do aplikacji internetowej Workforce muszą być kodowane. Kodowanie zastępuje nieprawidłowe znaki ich odpowiednikami szesnastkowymi poprzedzonymi znakiem procentu (%).

Na przykład następujące łącze zawiera niezakodowane parametry:

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

Poniżej znajduje się to samo łącze z zakodowanymi parametrami:

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

Istnieje wiele bezpłatnych witryn internetowych i narzędzi służących do generowania zakodowanych adresów URL. Na przykład, firma Albion Research Ltd. oferuje witryny URLEncode i URLDecode.

Utwórz zlecenie

Utwórz łącze uruchamiające aplikację internetową Workforce z nowym zleceniem, w którym wypełniono już pola informacji o zleceniu. Jeśli na przykład dysponujesz aplikacją niestandardową służącą do przeprowadzania inspekcji drzew, możesz utworzyć łącze uruchamiające tę aplikację Workforce z otwartym nowym zleceniem inspekcji drzew, w którym są podane informacje o typie i lokalizacji zlecenia.

Parametry

Podczas tworzenia zleceń przy użyciu łączy do aplikacji Workforce można używać wymienionych poniżej parametrów:

ParametrWartościUwagi

assignmentType

Typ przypisany do zlecenia

  • Można użyć wartości GlobalID lub nazwy typu zlecenia.
    Notatka:

    Jeśli tworzysz łącze do projektu klasycznego, możesz użyć domeny wartości kodowanych lub nazwy typu zlecenia.

  • W wartościach nie jest rozróżniana wielkość liter.

lat

Współrzędna y zlecenia w układzie odniesienia WGS84 (WKID: 4326)

  • Wymaga wartości lon.

lon

Współrzędna x zlecenia w układzie odniesienia WGS84 (WKID: 4326)

  • Wymaga wartości lat.

location

Używany w zleceniu tekst lokalizacji

  • Ten parametr jest ignorowany, jeśli nie ma wartości w polach lat i lon.

priority

Priorytet nadany zleceniu

  • Obsługiwane są następujące wartości całkowite:
    • 0 (Brak)
    • 1 (Niski)
    • 2 (Średni)
    • 3 (Wysoki)
    • 4 (Krytyczny)

dueDateTime

Data i czas realizacji zlecenia

  • Jest to liczba milisekund od początku epoki Unix.

workOrderId

Klucz odwołujący się do zamówienia na pracę z systemu zewnętrznego lub systemu innej firmy

  • Wartość z systemu zewnętrznego.

description

Informacje o zleceniu

  • Tekst objaśniający.

assignee

Użytkownik przypisany do zlecenia

  • Można użyć wartości GlobalID pracownika lub jego nazwy użytkownika.
    Notatka:

    Jeśli tworzysz łącze do projektu klasycznego, możesz użyć wartości objectid lub nazwy użytkownika.

  • W wartościach nie jest rozróżniana wielkość liter.
Notatka:

Wszystkie parametry są opcjonalne, jednak parametry assignmentType, lat, lon i location muszą zostać wypełnione przed utworzeniem nowego zlecenia.

Jeśli używane jest oprogramowanie ArcGIS Enterprise, lat i lon to jedyne parametry obsługiwane podczas tworzenia zleceń przy użyciu łącza. Aplikacja internetowa Workforce w oprogramowaniu ArcGIS Enterprise wypełnia parametr location przy użyciu geokodowania odwrotnego.

Przykłady

Poniżej przedstawiono przykłady używania w łączach do aplikacji parametrów służących do wypełniania informacji podczas tworzenia zlecenia Workforce:

  • Tworzenie zlecenia przy użyciu współrzędnych:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150
  • Tworzenie zlecenia inspekcji drzew o średnim priorytecie i przypisywanie go do pracownika mobilnego:
    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
  • Tworzenie zlecenia naprawy rurociągu o terminie realizacji przypadającym 23 maja o godzinie 15:00:
    http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000
  • Tworzenie zlecenia naprawy z opisem problemu:
    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.

Zarządzanie urządzeniami przenośnymi

Termin „zarządzanie urządzeniami przenośnymi” odnosi się do oprogramowania służącego do administrowania urządzeniami przenośnymi w instytucji. Oprogramowanie MDM zwiększa bezpieczeństwo danych i sieci. Jest ono także używane do konfigurowania i wymuszania zasad dotyczących urządzeń przenośnych. Dodatkowo korzystanie z oprogramowania MDM zwiększa efektywność procesu wdrażania aplikacji i zarządzania urządzeniami przenośnymi, w tym harmonogramem i sposobem aktualizowania aplikacji. Aby dowiedzieć się więcej o tym, jak firma Esri wykorzystuje oprogramowanie MDM, zapoznaj się z publikacją ArcGIS Secure Mobile Implementation Patterns (Wzorce bezpiecznej implementacji mobilnej ArcGIS) w Centrum zaufania ArcGIS.

Przygotowując się do wdrożenia aplikacji Workforce na urządzeniach przenośnych w instytucji za pośrednictwem oprogramowania MDM, można skonfigurować pewne ustawienia aplikacji i profili. Ustawienia te to między innymi adres URL portalu i ustawienia VPN poszczególnych aplikacji.

Uwaga:

Jeśli używasz urządzenia z systemem Android, musisz zainstalować i włączyć przeglądarkę Chrome lub inną, aby wyświetlić ekran logowania do portalu.

Konfiguracja aplikacji Workforce

Termin „konfiguracja aplikacji” (używana jest także nazwa „obiekt AppConfig”) odnosi się do formatu podawania ustawień aplikacji, takich jak adres URL portalu. Zamiast konfigurować te ustawienia ręcznie przy każdej instalacji aplikacji mobilnej, można użyć oprogramowania MDM, które automatycznie zdefiniuje i zastosuje konfiguracje aplikacji. Te ustawienia są definiowane w formie słownika zawierającego pary klucz-wartość, który ma format pliku .xml. To, w jaki sposób tworzony jest ten słownik, zależy od używanego oprogramowania MDM. Aby dowiedzieć się więcej o konfiguracji aplikacji, odwiedź stronę internetową AppConfig Community.

Następujące ustawienia aplikacji Workforce można zaimplementować, tworząc konfigurację aplikacji w oprogramowaniu MDM:

KluczWartośćUwagi

portalURL

Adres URL portalu instytucji

  • Gdy aplikacja Workforce jest uruchamiana, natychmiast wyświetlany jest ekran logowania w portalu instytucji.
  • Na przykład: https://myportal.mycompany.com/gis.
  • Typem wartości jest ciąg znakowy.

Wirtualna sieć prywatna dla poszczególnych aplikacji

Skonfigurowanie wirtualnej sieci prywatnej dla poszczególnych aplikacji (VPN aplikacji) w oprogramowaniu MDM umożliwia przyznawanie dostępu do zasobów wewnętrznych tylko wybranym aplikacjom zarządzanym. Aplikacja Workforce może być wdrażana przy użyciu tej konfiguracji. Aby skonfigurować sieć VPN aplikacji do użytku z aplikacją Workforce, należy zapoznać się z dokumentacją używanego oprogramowania MDM.

Uwaga:

Jeśli korzystasz z systemu iOS, ekran logowania do portalu jest wyświetlany w aplikacji Workforce przy użyciu przeglądarki Safari. Aby ta konfiguracja działała poprawnie przy włączonej sieci VPN aplikacji, należy podać domenę portalu (na przykład mycompany.com) w ustawieniu Domeny przeglądarki Safari używanego profilu sieci VPN aplikacji. Jeśli ustawienie Domeny przeglądarki Safari nie jest prawidłowo skonfigurowane, urządzenia przenośne nie będą mogły uzyskiwać w aplikacji Workforce dostępu do ekranu logowania w portalu.

Jeśli skonfigurujesz wartość Domeny Safari w profilu VPN aplikacji zgodnie z powyższym opisem, przeglądarka Safari będzie także mogła uzyskiwać dostęp do domeny portalu podanej w polu Domeny Safari. Aby zablokować ten dostęp, skonfiguruj Ograniczenia iOS (jeśli są dostępne w MDM), aby używać aplikacji Blokuj przeglądarkę Safari na odpowiednich urządzeniach.

Po skonfigurowaniu ustawień VPN dla poszczególnych aplikacji dla aplikacji Workforce w MDM, aplikacja automatycznie łączy się z wyznaczoną siecią VPN dla poszczególnych aplikacji, gdy aplikacja jest otwierana na zarządzanym urządzeniu mobilnym. Gdy aplikacja Workforce działa w tle, VPN dla aplikacji jest połączony tylko z aplikacją Workforce. Po zamknięciu aplikacji Workforce urządzenie przenośne automatycznie rozłącza się z siecią VPN aplikacji.