Você pode ajudar os usuários de celular e despachantes a iniciar com ArcGIS Workforce das seguintes maneiras:
- Forneça um link para usuários móveis que pode ser usado para instalar o aplicativo, definir a URL do portal, baixar o mapa, abrir uma atribuição ou definir o status de uma tarefa.
- Forneça um link para despachantes que pode ser usado para agilizar a criação de atribuições.
- Utilizar o software de gerenciamento de dispositivo móvel (MDM) para implantar e configurar o aplicativo móvel, incluindo a URL do portal.
Abra o aplicativo móvel Workforce de um link
Os usuários móveis podem especificar a URL do portal no Workforce, ou você pode fornecer uma URL diretamente para eles que especifica a URL correta do portal. Permita o acesso dos usuários móveis ao portal correto, compartilhando um link por e-mail, mensagem de texto, página da web, código QR ou outro aplicativo. Quando tocado, o Workforce abre a URL do portal que você deseja que o trabalhador móvel use.
Estrutura de link
Links para o aplicativo móvel Workforce têm o seguinte formato: https://workforce.arcgis.app?parameter=value. Os pares de parâmetro e valor são substituídos pelos valores que você deseja usar para implantar o aplicativo. Por exemplo, o link https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis utiliza o parâmetro portalURL para levar os usuários móveis diretamente para a tela de registro da sua organização e solicitar que eles registrem.
Parâmetros
Os parâmetros seguintes são suportados com links Workforce. Se nenhum parâmetro for passado, tocar no link abre o Workforce (ou solicita que você baixe o aplicativo).
| Parâmetro | Valores | Notas |
|---|---|---|
portalURL | A URL do portal da sua organização |
|
mapID | O ID de item do mapa para baixar e abrir no Workforce |
|
assignmentID | O valor GlobalID da tarefa a ser aberta no Workforce |
|
assignmentStatus | O status fornecido para uma tarefa quando aberta no Workforce |
|
Exemplos de uso desses parâmetros para obter um comportamento específico com um link do Workforce são fornecidos abaixo.
Conectar a um portal específico
Especifique a URL do portal na qual o trabalhador móvel deve estar conectado.
Abaixo está um exemplo:
https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgisBaixar e abrir um mapa
Baixe e abra um mapa utilizando o parâmetro mapID. Se o trabalhador móvel tiver o mapa baixado em seu dispositivo, não ocorrerá nenhum download e o mapa especificado será aberto no Workforce.
Os seguintes são exemplos:
- Abra o mapa como o trabalhador móvel atualmente registrado ou se não estiver registrado, forneça a oportunidade para eles registrarem:
https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d - Conecte a um portal em particular e então abra o mapa:
https://workforce.arcgis.app?portalURL=https://myportal.mycompany.com/arcgis&mapID=3ac4145c1ac44aea86e9ed42e00fbb0d
Abrir uma tarefa
Abra uma tarefa no mapa utilizando o parâmetro assignmentID.
Abaixo está um exemplo:https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d
Definir o status de uma tarefa
Defina o status de uma tarefa utilizando o parâmetro assignmentStatus.
Abaixo está um exemplo:https://workforce.arcgis.app?mapID=3ac4145c1ac44aea86e9ed42e00fbb0d&assignmentID=948b2bf3-f866-4516-97e7-00418d3b567d&assignmentStatus=2
Anotação:
É possível, mas não recomendado, utilizar este parâmetro para definir o status da tarefa de maneiras que não são possíveis no aplicativo móvel. Por exemplo, se uma tarefa tiver um status de Atribuída, um link do Workforce poderá ser utilizado para defini-la como Pausada, ignorando o status Em Progresso que seria definido pelo trabalhador móvel. Ignorar este status não é possível no aplicativo móvel.
Abra o aplicativo da web Workforce de um link
Você pode agilizar a implantação do aplicativo da web Workforce compartilhando um link por e-mail, mensagem de texto, página da web, código QR ou outro aplicativo. Os links podem ser personalizados com parâmetros de URL para abrir uma atribuição existente ou uma nova atribuição com informações da tarefa já preenchidas.
Fornecer um link para os despachantes permite que eles criem tarefas que possuam informações importantes preenchidas. Por exemplo, para criar tarefas a partir de um aplicativo de terceiros, poderá incluir um link que preencherá automaticamente o local, a descrição e a data de vencimento de uma nova tarefa.
Estrutura de link
Links para o aplicativo da web Workforce sempre começam com o seguinte formato: http://<portal-url>/apps/workforce/projects/<project-id>
Para abrir uma tarefa específica, anexe /dispatch/assignments/<assignment-id> ao link: http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/<assignment-id>
Para iniciar a criação de uma tarefa, anexe /dispatch/assignments/new? ao link e inclua um ou mais parâmetros separados por um e comercial (&):
http://<your portal url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair&lat=34.057170&lon=-117.194150&location=EsriAnotação:
O valor project-id poderá ser localizado na URL quando o projeto Workforce estiver aberto. Por exemplo, se a URL for http://arcgis.com/apps/workforce/projects/a0f297f949f549f0ade07eee562d9934, o valor project-id será a0f297f949f549f0ade07eee562d9934.
Codifique os parâmetros
Todos os parâmetros em links para o aplicativo da web Workforce devem ser codificados. A codificação substitui os caracteres inválidos pelo sinal de porcentagem (%) seguido por seu equivalente hexadecimal.
Por exemplo, o seguinte link tem parâmetros não codificados:http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=repair hydrant&lat=34.057170&lon=-117.194150&location=Esri Campus
O seguinte é o mesmo link com parâmetros codificados:http://<portal-url>/apps/workforce/<project-id>new?assignmentType=repair%20hydrant&lat=34.057170&lon=-117.194150&location=Esri%20Campus
Há muitos sites e ferramentas gratuitas para gerar URLs codificadas. Por exemplo, Albion Research Ltd. tem a página URLEncode e URLDecode.
Criar uma tarefa
Crie um link que inicie o aplicativo da web Workforce com informações da tarefa já preenchidas para uma nova tarefa. Por exemplo, se você tiver um aplicativo personalizado para criar inspeções de árvore, poderá criar um link que abrirá oWorkforce com o tipo de tarefa e as informações de localização preenchidas para uma nova tarefa de inspeção de árvore.
Parâmetros
Os parâmetros listados abaixo são suportados para a criação de atribuições com links do Workforce.
| Parâmetro | Valores | Notas |
|---|---|---|
assignmentType | O tipo de tarefa dada a uma atribuição |
|
lat | A coordenada y da tarefa em WGS84 (WKID: 4326) |
|
lon | A coordenada x da tarefa em WGS84 (WKID: 4326) |
|
location | O texto do local usado para a tarefa |
|
priority | A prioridade dada a uma tarefa |
|
dueDateTime | A data e hora de vencimento dadas a uma tarefa |
|
workOrderId | Uma chave que faz referência a uma ordem de serviço de um sistema externo ou de terceiros |
|
description | Informações sobre a tarefa |
|
assignee | O usuário atribuído à tarefa |
|
Anotação:
Todos os parâmetros são opcionais; entretanto, os parâmetros assignmentType, lat, lon e locationdevem ser preenchidos antes que a nova tarefa possa ser criada.
Se você estiver utilizando ArcGIS Enterprise, lat e lon são os únicos parâmetros com suporte ao criar uma tarefa a partir de um link. O aplicativo da web Workforce no ArcGIS Enterprise utiliza geocodificação reversa para preencher o parâmetro location.
Exemplos
A seguir estão exemplos de como os parâmetros podem ser usados em um link de aplicativo para preencher informações ao criar uma tarefa do Workforce :
- Crie uma tarefa usando coordenadas:
http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?lat=34.057170&lon=-117.194150 - Crie uma atribuição de inspeção de árvore com um nível de prioridade média e atribua-a a um trabalhador móvel:
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 - Crie uma tarefa de reparo de tubulação com vencimento em maio às 15h00:
http://<portal-url>/apps/workforce/projects/<project-id>/dispatch/assignments/new?assignmentType=pipe%20repair&lat=34.057170&lon=-117.194150&location=esri&dueDateTime=1621782000000 - Crie uma tarefa de reparo com uma descrição do problema:
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.
Gerenciamento do dispositivo móvel
O gerenciamento do dispositivo móvel faz referência ao software utilizado para administração de dispositivos móveis em uma organização. Um MDM é utilizado para realçar dados e segurança de rede como também configurar e aplicar as políticas do dispositivo móvel. Adicionalmente, a utilização de um MDM aumenta a eficiência de desenvolvimentos do aplicativo e gerenciamento dos dispositivos móveis, incluindo controlar como e quando um aplicativo será atualizado. Para saber mais sobre como a Esri aborda o MDM, consulte Padrões de Implementação do ArcGIS Secure Mobile no ArcGIS Trust Center.
Ao preparar para implantar o Workforce em dispositivos móveis da sua organização via MDM, há algumas configurações de perfil e aplicativo que você pode configurar. Isto inclui a URL do portal e configurações VPN por aplicativo.
Aviso:
Se você estiver usando um dispositivo Android, o Chrome ou outro navegador deverá estar instalado e habilitado para exibir a tela de registro do portal.
Configuração do aplicativo Workforce
A configuração de aplicativo (também denominada de AppConfig) faz referência a um formato para fornecer configurações de aplicativo, tais como, URL do portal. Em vez de definir estas configurações manualmente cada vez que um aplicativo móvel for instalado, você pode utilizar um MDM para especificar e aplicar as configurações do aplicativo automaticamente. Estas configurações são definidas como um dicionário de pares de valores-chaves em um arquivo .xml. A forma que o dicionário é criado depende do MDM que você está utilizando. Para saber mais sobre configuração de aplicativo, visite a página da web Comunidade do AppConfig.
O Workforce tem as seguintes configurações que podem ser implementadas com a configuração do aplicativo em um MDM:
| Chave | Valor | Notas |
|---|---|---|
portalURL | A URL do portal da sua organização |
|
Rede privada virtual por aplicativo
Configurar uma rede privada virtual por aplicativo (VPN por aplicativo) em um MDM permite restringir o acesso a recursos internos para aplicativos gerenciados específicos. O Workforce pode ser implantado com esta configuração. Para configurar o VPN por aplicativo para utilizar com o Workforce, veja a documentação do software do MDM que você está utilizando.
Aviso:
Se você estiver no iOS, o Safari é utilizado para exibir a tela de registro do portal no Workforce. Para isto funcionar corretamente com um VPN por aplicativo habilitado, seu domínio do portal (por exemplo, mycompany.com) deve ser especificado na configuração dos Domínios do Safari no perfil do VPN por aplicativo que você está utilizando. Se Domínios do Safari não estiver corretamente configurado, os dispositivos móveis atribuídos não poderão acessar a tela de registro do portal do Workforce .
Quando você define um valor de Domínio do Safari no perfil VPN por aplicativo conforme descrito acima, o navegador Safari também consegue acessar o domínio do portal que você especificou em Domínios do Safari. Para bloquear este acesso, configure uma Restrição de iOS (se disponível no MDM) para usar Bloquear Aplicativo do Navegador Safari nos dispositivos aplicáveis.
Após definir as configurações de VPN por aplicativo do Workforce no MDM, o aplicativo se conectará automaticamente ao VPN por aplicativo designado quando o aplicativo estiver aberto em um dispositivo móvel gerenciado. Quando o Workforce estiver executando no plano de fundo, o VPN do aplicativo estará conectado somente ao Workforce. Quando o Workforce é fechado, o dispositivo móvel desconecta automaticamente a partir do VPN por aplicativo.