Identificador ordinal en QTP/UFTEjemplo de identificación de objetos

⚡ Resumen inteligente

Identificador ordinal en QTP/UFT es el desempate UFT Se aplica cuando las propiedades obligatorias y de asistencia aún coinciden con más de un objeto, utilizando los valores de Índice, Ubicación o Tiempo de Creación para seleccionar un único objeto.

  • 🎯 Último recurso: UFT Agrega un identificador ordinal solo después de que las propiedades obligatorias y de asistencia no logren que una descripción sea única.
  • 🔢 Índice: Numbers objetos de la misma clase por orden de código fuente, comenzando en 0, por lo que index:=3 apunta a la cuarta coincidencia.
  • 📍 Ubicación: Numbers objetos por posición en la pantalla dentro de la ventana, marco o cuadro de diálogo, de arriba abajo y de izquierda a derecha.
  • 🕒 Tiempo de creación: Se aplica únicamente a los objetos Browser y registra el orden en que se abrió cada instancia del navegador.
  • 🗂️ Identificación de objeto: El tipo ordinal predeterminado para cada clase de objeto de prueba se puede editar en Herramientas > Identificación de objetos.
  • ⌨️ Descriptprogramación ive: Pase el índice, la ubicación o la hora de creación como una propiedad ordinaria dentro de la cadena de descripción del objeto.
  • ⚠️ Fragilidad: Los valores ordinales cambian cada vez que se modifica el diseño de la página, por lo que deben tratarse como una solución temporal, nunca como una decisión de diseño.

Identificador ordinal en QTP/UFT Explicado con Índice, Ubicación y Tiempo de Creación

¿Qué es un identificador ordinal en QTP/UFT?

An Identificador ordinal es una propiedad numérica que UFT (antes QTP) agrega a la descripción de un objeto cuando las propiedades obligatorias y auxiliares capturadas durante una sesión de grabación no son suficientes para identificar el objeto de forma única. En lugar de fallar, la herramienta recurre a un contador que, en efecto, dice: "Tome el tercer objeto de esta clase".

Por defecto, existe un identificador ordinal para cada clase de objeto de prueba. Un WebEdit se numera de forma diferente a un WinButton, y un Browser también se numera de forma diferente. Puede ver o modificar el identificador ordinal predeterminado de una clase en la ventana Identificación de objetos.

Configuración del identificador ordinal en el QTP/UFT Ventana de identificación de objetos

Como muestra la captura de pantalla anterior, el menú desplegable Identificador ordinal se encuentra en la parte inferior del cuadro de diálogo Identificación de objetos, debajo de las listas de propiedades obligatorias y auxiliares. Esa posición no es casual: refleja el orden en el que UFT En realidad consulta a los tres grupos.

Hay tres tipos de identificadores ordinales en UFT:

  1. Basado en índice
  2. Basado en la ubicación
  3. Tiempo de creación

Por qué UFT Utiliza identificadores ordinales solo como último recurso.

Identificación de objetos en UFT funciona en cascada. Primero se aprenden las propiedades obligatorias. Si no producen ninguna coincidencia, se añaden propiedades auxiliares una por una hasta que la descripción sea única. Solo cuando ambos grupos se agotan UFT Se adjunta un identificador ordinal y, en tiempo de ejecución, se consulta el mecanismo de identificación inteligente antes de que se considere fiable el valor ordinal.

La razón de esa clasificación es la estabilidad. Las propiedades obligatorias y de asistencia se describen Lo que Un objeto es: su nombre, su etiqueta HTML, su tipo, su etiqueta. Un identificador ordinal solo describe dónde El objeto se encontraba allí en el momento de la grabación. Cualquier cambio en la página modifica el número:

  • Un desarrollador inserta un campo oculto encima del que usted automatiza.
  • Un banner promocional añade dos enlaces adicionales al encabezado.
  • Un diseño adaptable reorganiza el formulario de dos columnas a una sola.
  • Se abre una ventana emergente del navegador antes de lo que lo hizo durante la grabación.

Ninguno de estos cambios rompe una descripción basada en un nombre o un ID, pero cada uno desplaza silenciosamente todos los valores de índice y ubicación en la página. Por eso, los ingenieros experimentados tratan un identificador ordinal como una señal de que la descripción del objeto necesita trabajo, no como una solución terminada. El mismo principio se aplica a todos pruebas de automatización marcos en general, incluyendo la estrategia de localización en Selenium.

💡 Consejo: Antes de aceptar un identificador ordinal, abra el objeto en el Explorador de objetos y busque un atributo personalizado estable. Agregar ese atributo a la lista de propiedades auxiliares de la clase suele eliminar la necesidad de un identificador ordinal en todos los objetos futuros de ese tipo.

Tipos de identificadores ordinales en UFT/QTP

Basado en índice

  • Cuando se utiliza un identificador ordinal basado en índice, UFT asigna un valor al índice propiedad del objeto durante la grabación.
  • El valor se basa en el orden en que aparece el objeto dentro del código fuente, no en la pantalla.
  • La primera aparición tiene el valor 0.
  • Los valores de las propiedades de índice son específicos de cada objeto, por lo que cada clase de objeto de prueba se cuenta por separado.
  • Por lo tanto, si utiliza index:=3 para describir un objeto de prueba WebEdit, UFT Busca el cuarto objeto WebEdit en la página.
  • Del mismo modo, si utiliza index:=1 para describir un objeto de prueba WebButton, UFT Busca el segundo objeto WebButton en la página.

Basado en la ubicación

  • Cuando se utiliza un identificador ordinal basado en la ubicación, UFT asigna un valor al localización propiedad del objeto para identificarlo de forma única.
  • El valor se basa en el orden en que aparece el objeto dentro de la ventana, marco o cuadro de diálogo, en relación con otros objetos con propiedades idénticas.
  • La primera aparición del objeto es 0.
  • Los valores se asignan en columnas, de arriba abajo y luego de izquierda a derecha.
  • La ubicación es el identificador ordinal predeterminado para la mayoría de los estándares. Windows Clases de objetos de prueba, donde la disposición visual es más estable que el orden del marcado.

Tiempo de creación

  • Cuando se utiliza el identificador ordinal de tiempo de creación, UFT asigna un valor al tiempo de creación propiedad de un objeto del navegador.
  • Este identificador solo está disponible para el entorno web y solo para objetos de prueba del navegador.
  • El valor indica el orden en que se abrió el navegador en relación con otros navegadores abiertos.
  • El primer navegador que se abre durante la ejecución recibe creationtime:=0, y los navegadores posteriores reciben 1, 2, 3, y así sucesivamente.
  • Si se cierra un navegador, los navegadores restantes conservan sus valores originales en lugar de ser renumerados.

Tabla comparativa: Índice vs. Ubicación vs. Tiempo de creación

Los tres identificadores responden a tres preguntas diferentes, y elegir el incorrecto es una causa frecuente de fallos intermitentes.

Aspecto Home Ubicacion Tiempo de creación
Nombre de la propiedad índice localización tiempo de creación
Base de pedido Orden en la jerarquía del código fuente/objeto Posición de la pantalla dentro de la ventana, marco o cuadro de diálogo. Orden en que se abrieron las instancias del navegador
Regla de conteo Secuencial, por clase de objeto de prueba Columnas, de arriba abajo y luego de izquierda a derecha. Secuencial, por instancia de navegador
primer valor 0 0 0
Se aplica a Web y Windows privadas Principalmente estándar Windows privadas Solo objetos del navegador
Descansos cuando Cambios en el orden de marcado El diseño se reposiciona o cambia de tamaño. Windows abrir en una secuencia diferente
Mejores usados ​​para Controles de cuadrícula o tabla repetitivos Formularios de escritorio heredados con diseño fijo Flujos web multiventana, como ventanas emergentes de pago.

Cómo configurar el identificador ordinal en el repositorio de objetos

El identificador ordinal se configura por clase de objeto de prueba y se aplica automáticamente a cada objeto de esa clase que UFT Aprende posteriormente. Los objetos que ya existen en el repositorio no se actualizan retroactivamente.

  1. Abra UFT y seleccione Herramientas > Identificación de objetos.
  2. Seleccione el entorno, por ejemplo Web o Estándar. Windows, desde el menú desplegable Entorno.
  3. Seleccione la clase de objeto de prueba que desea modificar, como WebEdit o WinButton.
  4. En la sección Identificador ordinal En esta sección, seleccione Índice, Ubicación, Fecha de creación o Ninguno.
  5. Haga clic en OK y volver a aprender el objeto para que se capture el nuevo valor ordinal.
  6. Abra el Repositorio de objetos, seleccione el objeto y confirme que la propiedad ordinal ahora aparece en la lista de descripción.

Seleccionar Ninguna Deshabilita por completo la alternativa para esa clase. UFT Entonces se producirá un error de identificación en lugar de una suposición, que suele ser el comportamiento deseado en una suite donde una identificación errónea silenciosa es más perjudicial que un fallo limpio. Registre sus expectativas en un documento bien escrito. caso de prueba Esto hace que esa disyuntiva sea explícita para todo el equipo.

⚠️ Advertencia: Cambiar el identificador ordinal de una clase es una configuración a nivel de máquina, no a nivel de prueba. Si no se exporta y comparte, los scripts que funcionan correctamente en tu máquina pueden fallar en la máquina de un compañero o en el agente de compilación.

Cómo usar identificadores ordinales en DescriptProgramación ive

En la programación descriptiva no existe un cuadro de diálogo de identificación de objetos. El ordinal se escribe directamente en la cadena de descripción, al igual que cualquier otro nombre de propiedad, y siempre comienza en cero.

' Ordinals are zero based: index:=3 is the FOURTH WebEdit on the page
Set objPage = Browser("Guru99 Bank").Page("Guru99 Bank")

objPage.WebEdit("index:=3").Set "9999999999"
Print "Filled WebEdit occurrence #" & (3 + 1)

' Location is counted top to bottom, then left to right
objPage.WebButton("location:=1").Click
Print "Clicked WebButton occurrence #" & (1 + 1)

' CreationTime works only on Browser objects
Print "Switching to browser opened at position #" & (1 + 1)
Browser("creationtime:=1").Sync

Salida:

Filled WebEdit occurrence #4
Clicked WebButton occurrence #2
Switching to browser opened at position #2

Un patrón más seguro es combinar propiedades reales con ChildObjects Por lo tanto, el ordinal se valida antes de su uso. El siguiente ejemplo supone una página que contiene cinco objetos WebEdit coincidentes y un índice de 9.

Dim oDesc, oChildren, intIndex

Set oDesc = Description.Create()
oDesc("micclass").Value = "WebEdit"
oDesc("html tag").Value = "INPUT"

Set oChildren = objPage.ChildObjects(oDesc)
intIndex = 9

If intIndex < oChildren.Count Then
    oChildren(intIndex).Set "Guru99"
Else
    Print "Index " & intIndex & " is out of range; only " & oChildren.Count & " objects match"
End If

Salida:

Index 9 is out of range; only 5 objects match

Este mecanismo convierte un error de tiempo de ejecución poco útil de "No se puede identificar el objeto" en un mensaje legible, lo cual es importante cuando se publican los resultados de un defecto. tracker o a HP ALM integrado con UFT.

Errores comunes al usar identificadores ordinales

La mayoría de los defectos relacionados con el orden tracVolvemos a un pequeño conjunto de errores recurrentes.

  • Contando desde 1. Cada identificador ordinal comienza en 0. Escribir index:=1 para el primer campo es el error más común y produce un fallo con un desfase de uno que parece un problema de sincronización.
  • Confundir índice con ubicación. El índice sigue al código fuente; la ubicación sigue a la pantalla. En una página donde CSS reordena los elementos, los dos valores difieren y se intercambian.ping Ellos, en silencio, apuntan al control equivocado.
  • Utilizar CreationTime fuera del entorno web. Esta propiedad solo existe en objetos Browser. Aplicarla a un objeto Page, Frame o Window genera un error de propiedad no compatible.
  • Incluir un valor ordinal directamente en el código de una función compartida. Una función reutilizable que asume que el índice es igual a 2 deja de ser utilizable en el momento en que una segunda pantalla con un diseño diferente la llama.
  • Dejar los ordinales en el repositorio una vez que la aplicación se estabilice. Una vez que los desarrolladores agreguen identificadores estables, revisen los objetos y reemplacen el ordinal con la nueva propiedad.
  • Basándose en ordinales dentro de bucles sobre cuadrículas. Utilice ChildObjects, que devuelve una colección en vivo, por lo que el recuento refleja la página actual en lugar de la registrada.

Recursos

Descarga las páginas web utilizadas en el tutorial anterior para practicar por tu cuenta.

Los identificadores ordinales son una pequeña parte del modelo de identificación de objetos. Para ver cómo encajan en el flujo de trabajo más amplio, continúe con el ejemplo completo. QTP/UFT serie de entrenamiento, repase los fundamentos en pruebas de software, aprenda cómo se gestionan los resultados en el Tutorial de HP ALMy comparar las estrategias de localización con las Selenium tutoriales.

Preguntas Frecuentes

El valor predeterminado varía según la clase. La mayoría de los objetos de prueba web, como WebEdit y WebButton, tienen por defecto Index, los objetos Browser tienen por defecto CreationTime y Standard Windows Las clases se establecen por defecto en Ubicación. Cada valor predeterminado es visible y editable en la ventana de Identificación de objetos.

La identificación inteligente se ejecuta primero. UFT Intenta con la descripción aprendida, luego con la Identificación Inteligente si está habilitada para la clase, y solo recurre al identificador ordinal cuando ambos fallan al producir un único objeto coincidente.

Sí. Establezca el menú desplegable Identificador ordinal en Ninguno para la clase en la ventana Identificación de objeto. UFT En lugar de adivinar, informa de un error de identificación, lo cual es más seguro para conjuntos de pruebas donde un clic en un objeto incorrecto podría corromper los datos de prueba.

Ligeramente. UFT Es necesario enumerar todos los objetos de la clase antes de poder contar hasta la posición solicitada, por lo que las páginas con cientos de controles similares tardan más en resolverse que una descripción basada en un nombre o ID único.

Sí. La identificación basada en IA en la actualidad UFT Una versión compara los controles según su apariencia visual y el texto de la etiqueta, en lugar de la posición del marcado, de modo que un campo se puede localizar por su aspecto incluso cuando cambian los valores de índice circundantes.

Un asistente de IA puede analizar una exportación de repositorio, identificar cada descripción que contenga índice, ubicación o fecha de creación, y proponer reemplazos a partir de los atributos HTML capturados. Aun así, un humano debe verificar cada sugerencia con la aplicación en producción antes de confirmarla.

Haga clic en aquí si el video no es accesible

Resumir este post con: