Ordens de serviço em lote
Pode ler a planilha de pedidos, recusar o que está fora da área ou sem coordenada e criar as tarefas na camada de tarefas do Field Maps (campos esritask_*), com responsável, prazo e prioridade.
Octo para campo e operações no ArcGIS
Do pedido em planilha ao laudo em PDF. Quem decide é a equipe.
Survey123, Field Maps, Workforce, QuickCapture e Notebooks já fazem a coleta em campo. Com a API Python do ArcGIS, o Octo pode transformar uma planilha de pedidos em tarefas no Field Maps, preparar o mapa offline, publicar o formulário a partir de um XLSForm versionado, gerar minutas de laudo em lote e conferir todo dia a qualidade das coletas. Tudo começa em homologação e termina numa decisão humana: laudo assinado, publicação em produção e aprovação da vistoria ficam com pessoas habilitadas.
API Python, PyPI2.4.4
arcgis, publicada em 20/10/2026Laudos no Online0,5crédito por registro impresso
Notebook agendado15 minintervalo mínimo; até 10 tarefas ativas por conta
Fontes14listadas no fim da página
01
O que o Octo faz na operação de campo.
Seis entregas possíveis, tiradas do levantamento. Todas usam a API Python do ArcGIS ou as exportações do Survey123, começam numa organização de homologação e vão para revisão de quem responde pela operação.
Mapa offline e link do aplicativo
Pode criar a área offline do mapa por script (offline_areas.create) e gerar o link fieldmaps.arcgis.app que abre o mapa certo no aparelho da equipe.
Formulário versionado como código
Pode manter o XLSForm em CSV no git, conferir a estrutura, montar o .xlsx e publicar em homologação com Survey.publish(..., schema_changes=False), que para e descreve qualquer mudança de esquema.
Minutas de laudo em lote
Pode numerar as vistorias aprovadas, estimar o custo com Survey.estimate e gerar os PDFs em lotes com generate_report, a partir do modelo .docx aprovado.
Qualidade das coletas, todo dia
Pode escrever e agendar um notebook que confere as vistorias do dia (fotos faltando, ponto fora da área, duplicatas) e separa as pendências por supervisor.
Entrega: pendências do dia, por supervisorIntegrações por webhook
Pode configurar webhooks do Survey123 ou de feature services (FeaturesCreated, com assinatura HMAC) para avisar outro sistema a cada envio, e preparar o receptor que confere a assinatura.
02
Oito braços, uma ordem de serviço.
O mesmo ciclo do Octo, aplicado à operação de campo. Cada braço tem um papel estreito; quem aprova a vistoria, assina o laudo e publica em produção são pessoas.
-
Descoberta
Mapeia a operação
ArcGIS Online ou Enterprise, que aplicativos a equipe usa (Survey123, Field Maps, Workforce, QuickCapture), que formulários, camadas e painéis existem, e onde os pedidos nascem hoje.
-
Dados
Fixa campos e domínios
Campos da camada de tarefas, códigos de tipo e prioridade, campos do formulário, numeração de laudo, sistema de coordenadas e fuso horário das datas.
-
Segurança
Protege pessoas e acessos
Perfis salvos, sem senha em arquivo; menor privilégio na conta de serviço; fotos e endereços de cidadãos tratados como dados pessoais (LGPD), com o mínimo necessário.
-
Arquitetura
Escolhe o caminho
Tarefas do Field Maps em vez de Workforce (obsoleto na API desde a 2.4.4), notebook agendado ou webhook, lote único ou em partes, Online com créditos ou Enterprise.
-
Desenvolvimento
Escreve o script
Scripts em Python com a API do ArcGIS e XLSForm em CSV, cada um com a fonte da sintaxe anotada no próprio arquivo e um modo de simulação que roda sem tocar no ArcGIS.
-
Revisão
Confere em homologação
Roda com dados de amostra, depois na organização de homologação, e confere pelo resultado: a tarefa no aparelho, o PDF aberto, a pendência no texto do supervisor.
-
Publicação
Leva a produção com ordem
Só com o seu ok nominal, publica o formulário, cria as tarefas ou agenda o notebook em produção, com estimativa de créditos aprovada antes.
-
Documentação
Registra o que vale no seu projeto
Versão do formulário, do modelo de laudo e da API usada em cada lote, tag git de cada publicação e regras de qualidade em vigor. O próximo trabalho parte desse registro.
O Octo não assina laudo, não aprova vistoria e não publica em produção por conta própria. Isso cabe ao responsável técnico, ao supervisor e a quem responde pela operação.
03
Cada tarefa, o seu caminho.
O critério que o Octo usa para escolher. Os aplicativos da Esri continuam sendo a referência; os scripts preparam, conferem e consolidam.
| Tarefa | Caminho | Observação |
|---|---|---|
| Criar ordens de serviço em lote | Camada de tarefas do Field Maps + edit_features(adds=...) | Workforce só para projeto antigo: módulo obsoleto desde a 2.4.4, remoção prevista para 2027 |
| Mandar a equipe ao mapa certo | Link fieldmaps.arcgis.app ou build_field_maps_url | Testar o link no aparelho antes de mandar |
| Mapa offline de uma região | Map(item=...).offline_areas.create(...) | Conferir com check_compatibility(); armazenamento cobrado no Online |
| Mudar o formulário com segurança | XLSForm em CSV no git + Survey.publish(..., schema_changes=False) | Homologação antes, aprovação nominal para produção |
| Laudos em lote | Survey.estimate + generate_report(..., output_format="pdf") | 0,5 crédito por registro no Online; minuta, não laudo assinado |
| Conferir a qualidade das coletas | Survey.download("CSV") + script; agendamento com tasks.create | Regras definidas pelo supervisor |
| Reagir a cada envio | Webhook do Survey123 ou de feature service | Receptor confere a assinatura HMAC |
| Copiar painel ou formulário para outra organização | gis.content.clone_items(...) | Serviços de mapa e de imagem não são copiados |
04
Da conferência à rotina.
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua operação.
Proposta, não promessa
Conferências sob demanda
Com as exportações do Survey123 e a planilha de pedidos, você pede em linguagem de operação e o Octo propõe o script e a lista.
- “Confira as coletas de ontem” vira pendências por supervisor
- Planilha de pedidos conferida antes de virar tarefa
- Formulário conferido antes de publicar
Lotes em homologação
Tarefas, áreas offline e minutas de laudo passam a sair em lote, primeiro na organização de homologação.
- Ordens de serviço criadas a partir da planilha
- Formulário versionado, com tag a cada publicação
- Laudos numerados com estimativa de créditos aprovada
Rotina agendada
A conferência diária roda sozinha num notebook agendado, e os sistemas vizinhos recebem cada envio por webhook.
- Notebook agendado com regras aprovadas pelo supervisor
- Webhook com assinatura conferida para o sistema de OS
- Registro de versão de formulário, modelo e API por lote
05
Confirmado em fonte.
Cada ponto abaixo tem fonte publicada pelo fabricante, pelo projeto ou pelo órgão responsável. As fontes estão na seção seguinte.
4
pontos com fonte publicada, cada um com a referência indicada ao lado.
- ConfirmadoWorkforce obsoleto na API
- A referência do módulo
arcgis.apps.workforcediz que ele está obsoleto desde a 2.4.4 e será removido no outono de 2027 (o aviso de cada classe e método diz "Removed in: 2.4.6"), e manda migrar para as tarefas do Field Maps.Fonte: referência da API Python, arcgis.apps.workforce - ConfirmadoFormulário publicado a partir do XLSForm
Survey.publish(xlsform=..., schema_changes=False)publica o formulário a partir do XLSForm; comschema_changes=False, qualquer diferença de esquema vira erro que descreve as diferenças.Fonte: referência da API Python, arcgis.apps.survey123- ConfirmadoCusto dos laudos
- No ArcGIS Online, imprimir relatórios custa 0,5 crédito por registro, com mínimo de 0,5; a prévia gera PDF com marca d'água para até 20 registros sem custo; no Enterprise não consome crédito.Fonte: Survey123, Print survey results
- ConfirmadoNotebooks agendados
- No ArcGIS Online, uma tarefa de notebook roda no máximo a cada 15 minutos; cada conta tem até 10 tarefas ativas e a organização até 50; o runtime Standard custa 1,5 crédito por hora, cobrado por minuto.Fonte: ArcGIS Online, Schedule a notebook task; Understand credits
06
O que o Octo faz e o que fica com vocês.
O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.
O Octo prepara
Levanta, calcula, organiza e gera os documentos: planilhas, relatórios, mapas e minutas.
Entrega: material pronto para conferirA sua equipe confere
O profissional habilitado confere o que o Octo entregou antes de assinar. Se algo não fecha, volta para o Octo com a correção.
Etapa: conferência por quem assinaQuem assina
O Octo não assina. Projeto, laudo, ART/RRT, prestação de contas e qualquer documento oficial continuam assinados pelo profissional habilitado da empresa ou do órgão: aqui, o responsável técnico pelo mapa ou pelo levantamento.
Assinatura: responsável técnico pelo mapa ou levantamento
07
Fontes.
Documentação da Esri e do PyPI usada no levantamento, consultada em 29/10/2026.
- API Python: arcgis.apps.survey123publish, download, generate_report, webhooks
- API Python: arcgis.apps.workforceAviso de obsolescência desde a 2.4.4
- API Python: arcgis.mapÁreas offline (offline_areas.create)
- API Python: arcgis.gis.tasksTarefas agendadas de notebook
- API Python: arcgis.appsLinks de aplicativo (build_field_maps_url)
- API Python: clonagem de conteúdoItens que clone_items copia
- PyPI: arcgis2.4.4, publicada em 20/10/2026
- Survey123: XLSForm essentialsPlanilhas e colunas do XLSForm
- Survey123: Print survey resultsCréditos e formatos dos relatórios
- Field Maps: Configure tasksCampos esritask_* e situações
- Field Maps: Deploy your mapLinks de aplicativo
- ArcGIS Online: Schedule a notebook taskIntervalo mínimo e limite de tarefas
- ArcGIS Online: Understand creditsNotebooks e armazenamento offline
- Webhooks para feature servicesFeaturesCreated, assinatura e limites
Sua operação de campo, conferida antes de virar retrabalho.
O diagnóstico começa por uma planilha de pedidos ou uma exportação do Survey123 que você já tem, sem mexer na sua organização de produção. Você recebe uma proposta do que dá para preparar e conferir na sua operação e decide com ela na mão.