Migrar um formulário Survey123 e dados associados para uma nova organização manualmente (sem Python)

Descrição

Este fluxo de trabalho é um dos muitos fluxos de trabalho possíveis para migrar pesquisas de uma organização para outra. Este artigo discute como fazer isto manualmente substituindo formulários de pesquisa baixados via Survey123 Connect, modificando-os para implementá-los na nova organização e republicando a camada de feição na nova organização.

Solução ou Solução Provisória

Para replicar uma pesquisa em outra organização, certifique-se de que a mesma camada de feição esteja disponível na outra organização, isto pode ser feito por meio de uma Colaboração Distribuída ou publicando os dados diretamente na nova organização. Para fazer isto, exporte a camada hospedada como um arquivo geodatabase e publique-a como uma camada de feição hospedada na organização de destino. Alternativamente, você pode publicar o serviço da feição a partir da fonte de dados original do ArcGIS Pro.

Ao publicar os dados na segunda organização, certifique-se de que os nomes da camada e da tabela (se relacionados e incluídos no serviço) correspondam aos originais na primeira organização, pois o formulário ainda faz referência à camada anterior, descrita nas etapas abaixo:

Cenário: Replicar o formulário Survey123 e o serviço da feição associado da Organização A para a Organização B

Após republicar os dados e tabelas relacionadas, se aplicável, como um serviço da feição para a Organização B, prossiga com as seguintes etapas:

1. Entre na Organização A via Survey123 Connect.
   • Se a pesquisa foi publicada na mesma máquina, o formulário XLS poderá ser encontrado no seguinte local:

C:\User\<UserName>\ArcGIS\My Survey Designs\<Survey Name>\<Survey Name.xlsx.

Caso contrário, você poderá baixar a pesquisa no Connect. O formulário XLS está localizado no mesmo caminho, mas a pasta da pesquisa tem uma ID aleatória em vez do nome da pesquisa.

2. Saia da Organização A e Entre na Organização B via Survey123 Connect.

Há duas opções para publicar o serviço da feição, utilizando um serviço da feição existente ou publicando a pesquisa a partir de um arquivo.

Publicando uma Pesquisa usando um serviço da feição existente

1. Crie uma nova pesquisa utilizando um método de serviço da feição existente e selecione o serviço da feição publicado recentemente.
2. Navegue até o caminho da pasta relevante mencionado na Etapa 1, acima, e copie o formulário xlsx original e cole na nova pasta de pesquisa a ser publicada na Organização B.
3. Se estiver usando o mesmo nome para a nova pesquisa que a pesquisa original, você será solicitado a substituir o formulário XLS. Se a nova pesquisa tiver um nome diferente, exclua o formulário XLS atual e renomeie o formulário XLS que você copiou para ter o mesmo nome da sua nova pesquisa.
4. Publique a pesquisa do Connect para a nova organização.

Publicação de uma Pesquisa a partir do Arquivo

1. Se você não puder criar uma pesquisa utilizando o método de serviço da feição existente, crie uma nova pesquisa utilizando a opção Arquivo e selecione o formulário XLS da Etapa 1, acima.
2. Abra o XLS para, vá até a guia Configurações > modifique a URL de Envio. A URL deve ser a URL REST de Compartilhamento associada ao item do Portal/ArcGIS Online. Por exemplo, "https://<host>:<porta>/arcgis/sharing/rest/content/items/<item_id>". Você deve fornecer a URL do item de item da camada de feição, conforme mostrado no exemplo. Ao contrário, um erro comum é utilizar a URL da camada de feição, que não é suportada.
3. Entre na Organização B a partir de um navegador da web e navegue até a camada de feição a ser utilizada com o formulário de pesquisa > página Detalhes do Item > anote o ID do item e o nome da camada primária em sua camada de feição.
4. Substitua o <item_id> na URL pela id do item e digite o nome da camada na coluna form_id. Tenha em mente que este não é o nome do item ou do serviço da feição, ao invés disso, é o nome da subcamada primária na camada de feição.
5. Publique sua pesquisa do Connect para a nova organização.

Para criar esta URL, você deve concatenar o ID do Item com o Conteúdo Raiz do portal. Conforme descrito no artigo Utilizar o Survey123 com camadas de feição existentes,

https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a

Esse fluxo de trabalho é um substituto para o método Clonar usando Python, conforme mencionado no artigo na seção Informações Relacionadas, nos casos onde o método Python não é aplicável devido às seguintes limitações:

• Falha ao clonar com caracteres diferentes de ASCII no nome do serviço
• A clonagem é limitada a 1000 registros
• BUG-000136846 - O método clone_items() falha ao tentar clonar uma visualização da camada de feição hospedada publicamente hospedada hospedada por outra organização com a mensagem de erro "O usuário não tem permissões para acessar este serviço".
• BUG-000141004 - O método clone_items() do ArcGIS API for Python não está recriando as URLs de informações do item para pesquisas publicadas a partir do web designer
  • A solução alternativa é baixar a pesquisa do ambiente de destino e atualizá-la imediatamente usando o arquivo baixado.