Iniciar la aplicación de campo

Puede crear vínculos de aplicaciones para abrir la aplicación de campo Survey123 desde otra aplicación, un elemento emergente de mapa web o un hipervínculo de un correo electrónico o sitio web. Utilice un esquema URL personalizado para iniciar la aplicación desde un navegador web o un vínculo de la aplicación Survey123 para iniciarla desde una aplicación de Android o iOS. Utilice los parámetros de la URL para personalizar la forma en que se abre la aplicación de campo, como para cargar una encuesta concreta, establecer las coordenadas de la ubicación de mapa predeterminada y rellenar las respuestas a las preguntas con valores predeterminados o pasando atributos de datos de un elemento emergente de mapa web.

Vincular desde un navegador web en Windows

Puede crear un vínculo para abrir la aplicación de campo e integrarla en otra aplicación. El mismo vínculo se puede introducir también en un navegador web para realizar pruebas.

Nota:

Una vez creado el vínculo, puede reemplazar arcgis-survey123:// por https://survey123.arcgis.app como vínculo de Survey123 para utilizarlo en iOS o Android.

En los siguientes pasos se describe cómo crear un esquema de URL personalizado y utilizarlo en un navegador web de escritorio:

  1. Escriba arcgis-survey123:// en el navegador.

    Se abre la aplicación de campo Survey123 (o se le pide que la abra).

    Nota:

    Para iniciar y descargar una encuesta de un portal específico, incluya el parámetro de URL del portal, por ejemplo, arcgis-survey123://?portalUrl=host.domain.com/webadaptor (donde host, domain y webadaptor se reemplazan por su información del portal).

  2. Agregue una referencia única a una encuesta y agréguela a la URL:
    1. Identifique el Id. de elemento de la encuesta que desea abrir.
      Nota:

      Es la cadena de caracteres que ArcGIS Online utiliza para identificar exclusivamente la encuesta y se puede encontrar en la URL del elemento de formulario en ArcGIS Online. Por ejemplo, si la dirección URL de la encuesta es https://exampleurl.maps.arcgis.com/home/item.html?id=36ff9e8c13e042a58cfce4ad87f55d19, el Id. de elemento del formulario es 36ff9e8c13e042a58cfce4ad87f55d19.

    2. Incluya la encuesta en la dirección URL agregando ?itemId= y el Id. de elemento del formulario al final de la URL.
    La dirección URL debería tener un aspecto similar al siguiente:
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Si prueba la dirección URL, ahora debería abrir la aplicación de campo Survey123 y abrir inmediatamente la encuesta.

    Nota:

    Si todavía no está en su dispositivo, la encuesta se descarga en él.

  3. Incluya respuestas a preguntas predeterminadas agregando una referencia en la URL a un campo mediante el uso del nombre que se le ha asignado en XLSForm (no su etiqueta). Por ejemplo, para rellenar el campo Surname, escriba &field:surname= y el valor.

    & actúa como separador de parámetro y field: hace referencia al nombre de la pregunta que se va a rellenar.

    La dirección URL debería tener un aspecto similar al siguiente:
    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    Ya puede utilizar la URL para abrir la aplicación de campo Survey123 y la encuesta, así como rellenar la pregunta indicada con la respuesta que defina. Puede rellenar varias preguntas en la dirección URL de una encuesta. En los nombres de campo se distingue entre mayúsculas y minúsculas.

  4. Defina una ubicación para una pregunta de geopunto en la encuesta agregando coordeandas a la URL:
    • Escriba &center= e introduzca las coordenadas.
    • Escriba las coordenadas de latitud y longitud en grados decimales, separadas por una única coma.
    • Si lo desea, agregue la altitud en metros decimales como tercer valor, también separado por una sola coma.

    La dirección URL final tendrá un aspecto similar al siguiente:

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

    Esta dirección URL abrirá ahora la aplicación de campo Survey123 y la encuesta elegida, rellenará una pregunta de texto y proporcionará una nueva ubicación predeterminada para la pregunta geopoint.

    Los atributos de campo también se pueden entregar a Survey123 desde un elemento emergente de un mapa web de ArcGIS, lo que permite la integración con las demás aplicaciones de Esri que utilicen elementos emergentes en un mapa web. Esta funcionalidad puede usarse para rellenar un campo en Survey123 con el valor de un atributo de entidad, en lugar de un valor establecido, indicando para ello el nombre del atributo entre llaves.

  5. Abra el mapa web y seleccione Elementos emergentes para una de las capas. Elegir Agregue contenido y seleccione Texto. Proporcione el texto que se va a mostrar correspondiente al vínculo y haga clic en el botón Vínculo para introducir el valor de URL de vínculo.

    Defina el vínculo del esquema de direcciones URL en el elemento emergente.

    Esta URL rellena el campo surname con el contenido del atributo name de la entidad seleccionada, en lugar de con un valor establecido:

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname={name}

    Esta URL rellena el campo hydrantGlobalID con el Id. global del hidrante seleccionado:

    arcgis-survey123://?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:hydrantGlobalID={globalid}

    Nota:

    De forma predeterminada, los valores solo se pueden pasar para seleccionar preguntas de selección única o selección múltiple de un elemento emergente en un mapa web si el nombre y la etiqueta de la opción correspondiente son idénticos. Si los nombres y las etiquetas de la lista de opciones son diferentes, puede utilizar las funciones DomainCode o UrlEncode en una expresión ArcGIS Arcade en el elemento emergente para pasar el valor deseado.

    No es posible rellenar las preguntas de repeticiones.

Vincular desde otra aplicación en iOS o Android

Puede crear un vínculo para utilizarlo en aplicaciones de ArcGIS para abrir Survey123 y capturar datos en una encuesta. En los siguientes pasos se describe cómo crear un vínculo de aplicación Survey123 y utilizarlo en un elemento emergente de un mapa web. Este vínculo se introduce en la ventana emergente de un mapa web de su organización de ArcGIS. Puede probar este vínculo con un navegador web (usando pasos similares a los de la sección anterior) en un dispositivo iOS o Android.

  1. Abra el mapa web que se verá en el dispositivo y seleccione Elementos emergentes para una de las capas.
  2. Elija Agregar contenido y seleccione Texto.
  3. Escriba Iniciar Survey123, resalte este texto y haga clic en el botón Vínculo para introducir la URL del vínculo. Introduzca https://survey123.arcgis.app, y haga clic en Aceptar.
    1. Abra el mapa web en un dispositivo móvil desde un navegador o una aplicación de ArcGIS.
    2. Seleccione una entidad y haga clic en el vínculo Iniciar Survey123 de la ventana emergente para abrir Survey123.
  4. Para incluir la encuesta en la URL, agregue ?itemId= y el Id. de elemento del formulario al final de la URL.
    La dirección URL debería tener un aspecto similar al siguiente:
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19

    Si prueba la dirección URL, ahora debería abrir la aplicación de campo Survey123 y abrir inmediatamente la encuesta.

    Nota:

    Si todavía no está en su dispositivo, la encuesta se descarga en él.

  5. Incluya respuestas a preguntas predeterminadas agregando una referencia en la URL a un campo mediante el uso del nombre que se le ha asignado en XLSForm (no su etiqueta). Por ejemplo, para rellenar el campo Surname, escriba &field:surname= y el valor.

    & actúa como separador de parámetro y field: hace referencia al nombre de la pregunta que se va a rellenar.

    La dirección URL debería tener un aspecto similar al siguiente:
    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser

    Ya puede utilizar la URL para abrir la aplicación de campo Survey123 y la encuesta, y puede rellenar la pregunta indicada con la respuesta que defina. Puede rellenar varias preguntas en la dirección URL de una encuesta. En los nombres de campo se distingue entre mayúsculas y minúsculas.

  6. Defina una ubicación para una pregunta de geopunto en la encuesta agregando coordeandas a la URL:
    • Escriba &center= e introduzca las coordenadas.
    • Escriba las coordenadas de latitud y longitud en grados decimales, separadas por una única coma.
    • Si lo desea, agregue la altitud en metros decimales como tercer valor, también separado por una sola coma.

    La dirección URL final tendrá un aspecto similar al siguiente:

    https://survey123.arcgis.app?itemID=36ff9e8c13e042a58cfce4ad87f55d19&field:surname=Klauser&center=37.8199,-122.4783,20

    Esta dirección URL completa ahora abre la aplicación de campo Survey123 y la encuesta elegida, rellena una pregunta de texto y proporciona una nueva ubicación predeterminada para la pregunta geopoint.

Parámetros de la URL para iniciar la aplicación de campo

Los siguientes parámetros se pueden usar para personalizar cómo se abre la aplicación de campo:

ParámetroDescripciónTipo

center

Centra el mapa en una latitud, longitud y altitud opcional conocidas.

Ejemplo:

center=37.8199,-122.4783,20

Cadena de caracteres

field:fieldname

Rellena las preguntas de la encuesta con valores de campo.

Ejemplo:

field:surname=Klauser

Cadena de caracteres

portalUrl

Dirección URL del portal donde está alojado el elemento de la encuesta.

Ejemplo:

portalUrl=https://myorg.arcgis.com

Cadena de caracteres

itemID

Formulario que se debe abrir.

Ejemplo:

itemID=36ff9e8c13e042a58cfce4ad87f55d19

UUID

download

Descarga automáticamente la encuesta cuando el dispositivo está en línea. El valor predeterminado es true.

Ejemplo:

download=false

Booleano

action

Especifica cómo se abre la encuesta. Los valores admitidos son: collect (el predeterminado), edit, view y copy.

Ejemplo:

action=edit

Cadena de caracteres

folder

Especifica la carpeta que se mostrará cuando se abra la encuesta. Los valores admitidos son: inbox, drafts, outbox, sent y * (carpeta de información general).

Agregue el parámetro filter a la URL para filtrar las encuestas en la carpeta especificada. Especifique folder=* y el parámetro filter para filtrar las encuestas de todas las carpetas y mostrarlas en la carpeta de información general.

Ejemplos:

folder=inbox
folder=*&filter=lake

Cadena de caracteres

callback

Dirección URL a la que volver cuando se completa una acción de formulario (por ejemplo, enviar, mover a borradores, cancelar o salir).

Ejemplo:

callback=https://quickcapture.arcgis.app

URL

callback:status

Especifica el estado de la encuesta cuando se activa la devolución de llamada. Los valores admitidos para el estado son cancel, draft, submit y close. El estado close solo se puede usar al action=view.

Ejemplo:

callback:draft=https://quickcapture.arcgis.app

Cadena de caracteres

filter

Filtra las encuestas existentes en el dispositivo que coinciden con una cadena de caracteres encontrada en el nombre de la instancia o en un campo específico. Filtra la bandeja de entrada de forma predeterminada. Agregue el parámetro folder a la URL para filtrar encuestas en una carpeta específica.

Si se ha definido un nombre de instancia, proporcione una cadena que represente el nombre de instancia completo o una subcadena del nombre de instancia. Los siguientes ejemplos muestran cómo filtrar todos los registros con el nombre de instancia completo Klauser o todos los registros presentes en Borradores que contengan la palabra lake en su nombre de instancia.

Ejemplos:

filter=Klauser
filter=lake&folder=drafts

Cuando no se haya definido ningún nombre de instancia o para filtrar por un campo que no forme parte del nombre de instancia, incluya tanto el nombre como el valor del campo, con el formato filter=field:fieldname:fieldvalue. Solo se pueden filtrar valores de campo completos utilizando el campo. Los siguientes ejemplos muestran cómo filtrar los registros cuyo tipo de masa de agua es Río o cuyo número de estación es 5171.

Ejemplos:

filter=field:waterbodytype:River
filter=field:ws_stationnumber:5171

Cadena de caracteres

update

Actualiza el contenido de la Bandeja de entrada e intenta enviar encuestas a la opción Bandeja de salida. Si en una URL se incluyen tanto update como filter, la actualización actualizará el contenido de la carpeta antes de que se aplique el filtro (que se realiza sobre las encuestas existentes en el dispositivo). El valor predeterminado es false.

Ejemplo:

update=false

Booleano

q:queryparameter

Consulta la capa de entidades para buscar un registro existente. Esto se utiliza para recuperar contenido que no está en el dispositivo.

Ejemplos:

q:where=ws_stationnumber=5171
q:where=waterbodytype='Lake'
q:globalId=1d392670-33e2-456d-8435-7fad3abd8bb9

Cadena de caracteres