UiPath Documentation
maestro
2.2510
true

Guía del usuario de Maestro

Última actualización 6 de may. de 2026

ID de instancia personalizado

Información general

De forma predeterminada, Maestro identifica cada instancia de proceso por un ID generado por el sistema. Un ID de instancia personalizado te permite reemplazar esa etiqueta por un valor dinámico y legible por humanos, como un número de orden o un nombre de cliente, derivado de los datos que recibe el proceso en runtime.

El ID de instancia personalizado se muestra directamente en la ListaDeInstancias, para que puedas identificar por qué se ejecutó una instancia y para qué valor, sin abrir la instancia.

Requisitos previos

  • Un proceso agéntico abierto en el lienzo de Maestro.
  • El proceso tiene un evento de inicio.

Configurar un ID de instancia personalizado

  1. Selecciona el evento de inicio en el lienzo.

  2. En el panel de Propiedades, ve a la sección General.

  3. En el campo ID de instancia personalizado, establece el valor utilizando una de las siguientes opciones:

    • Variable: selecciona una variable de iniciar evento o un argumento de entrada.
    • Expresión: crea una expresión que combine variables o formatos de salida, por ejemplo: string.Format("Order: {0}", vars.OrderId).
    • Literal: introduce un valor de texto fijo.
  4. Publica el proceso.

Resultado

Cuando se ejecuta una instancia, Maestro evalúa la expresión ID de instancia personalizado después de que se complete el evento de inicio y muestra el resultado como el NombreDeInstancia en la ListaDeInstancias.

Si la expresión hace referencia a variables que aún no se han resuelto en tiempo de evaluación, el ID de instancia personalizado se muestra en blanco hasta que el valor esté disponible.

Limitaciones

  • Puedes configurar ID de instancia personalizados solo en eventos de inicio. Los ID de instancia personalizados se evalúan una vez, inmediatamente después de la ejecución del evento de inicio. No se aplican los valores establecidos en actividades o eventos de fin.
  • Searching and filtering instances by custom instance ID in instance management and Insights is not yet supported.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado