Uso de BuildGlobalAddress

La construcción de una dirección es un proceso interactivo que requiere seleccionar elementos de dirección en cada paso del proceso de construcción. Esto significa que la construcción de una dirección requiere de una secuencia de llamadas de invocación a BuildGlobalAddress, y no una sola llamada. Para comenzar, debe hacer una llamada de inicialización a BuildGlobalAddress. Esta invocación devuelve una ID de sesión. Usted utilizará esta ID de sesión en las siguientes invocaciones. En cada una de estas invocaciones, BuildGlobalAddress presenta una lista de valores alternativos para un elemento de dirección. Usted selecciona el valor deseado, y luego avanza al siguiente elemento de dirección hasta construir la dirección completa. Salvo algunas excepciones, es necesario hacer una llamada por separado para cada elemento de dirección.

El proceso general funciona de este modo:

  • En primer lugar, usted realiza una llamada de inicialización para abrir una sesión y recibir una ID de sesión asignada por el sistema.
  • Realice una búsqueda para encontrar posibles valores para un elemento de dirección dado.
  • Después de seleccionar un valor, realice una confirmación para indicar el valor que desea para el elemento de dirección dado.
  • Siga realizando invocaciones de búsqueda y confirmación hasta establecer valores para todos los elementos de dirección.
  • Por último, debe realizar una invocación de cierre para finalizar la sesión.

Para familiarizarse con la forma en que funciona el proceso, utilice la ficha de vista previa de Management Console a fin de avanzar a través del procedimiento.

  1. Abra Management Console.
  2. En la ficha Servicios, seleccione Address Now.
  3. Desde la lista de servicios a la izquierda del panel, seleccione Build Global Address.
  4. En la ficha Options, especifique las opciones deseadas. Para obtener más información sobre las opciones, consulte Parámetros d.
  5. Haga clic en la ficha Preview.
  6. En el campo Action, escriba init.
  7. En el campo Country, ingrese el país correspondiente a la dirección que desea construir
  8. Haga clic en Run Preview.
  9. En Vista previa de salida, localice el campo SessionId, resalte y haga clic con el botón derecho del mouse en el valor, y seleccione Copiar en el menú desplegable.
  10. En Vista previa de entrada, resalte y haga clic con el botón derecho del mouse en el campo SessionId y seleccione Pegar.
  11. Ingrese los siguientes valores en los campos de entrada:
    • Action: escriba "search" (búsqueda).
    • Country: mantenga igual este campo.
    • FieldIndex: escriba el valor de índice del primer campo que desea buscar. Por ejemplo, si desea buscar una dirección de Chicago, debe escribir "1" porque en el caso de las direcciones de Estados Unidos el índice de campo 1 corresponde al campo de ciudad.
    • SearchValue: escriba el valor que desea buscar. Por ejemplo, si desea construir una dirección de Chicago, debe escribir "chicago".
    • SessionId: mantenga el mismo valor.
    Nota: Los valores de los demás campos de entrada no se tienen en cuenta.
  12. Haga clic en Run Preview nuevamente.
  13. Los resultados de la búsqueda aparecerán en dos campos de salida como máximo: Alternatives.InContext y AlternativesOutContext. Para obtener una explicación sobre las diferencias entre los resultados en contexto o fuera de contexto, consulte ¿Qué es el contexto?.
  14. Una vez que encuentre el valor que busca, ingrese los siguientes valores en los campos de entrada:
    • Action: escriba commit.
    • AlternativeIndex: escriba el número de índice de la alternativa elegida. Los valores de índice comienzan con 0, no con 1. Por ejemplo, si realiza una búsqueda para Chicago, las alternativas devueltas por BuildGlobalAddress se indexan tal como se muestra a continuación. Si desea confirmar el valor "CHICAGO", debe escribir "0" en el campo AlternativeIndex.
      • 0—CHICAGO
      • 1—CHICAGO HTS
      • 2—CHICAGO PARK
      • 3—CHICAGO RIDGE
      • 4—EAST CHICAGO
      • 5—NORTH CHICAGO
      • 6—WEST CHICAGO
    • AlternativeContext: escriba in o bien out para indicar si el valor de índice especificado en el campo AlternativeIndex corresponde a la lista de alternativas del campo Alternatives.InContext o del campo Alternatives.OutContext.
    • SessionId: mantenga igual este valor.
    Nota: Los valores de los demás campos de entrada no se tienen en cuenta.
  15. Haga clic en Run Preview nuevamente. El valor especificado aparecerá en el campo Field.n.Value del elemento de dirección correspondiente.
  16. Repita la búsqueda y confirme y guarde los pasos siempre que sea necesario hasta construir la dirección.
  17. Para cerrar la sesión, ingrese los siguientes valores en los campos de entrada:
    • Action: escriba close.
    • SessionId: mantenga igual este valor.
    Nota: Los valores de los demás campos de entrada no se tienen en cuenta.