Obtener entidades por consulta
Utilice la acción Obtener entidades por consulta para recuperar detalles de metadatos de entidades en función de una consulta. Se puede proporcionar el nombre o número del objeto Windchill para recuperar sus metadatos.
Realice los siguientes pasos para utilizar la acción Obtener entidades por consulta en el flujo de trabajo:
1. Arrastre la acción Obtener entidades por consulta de Windchill al lienzo, coloque el puntero sobre la acción y, a continuación, pulse en 
o pulse dos veces en la acción. Se abre la ventana Obtener entidades por consulta.
o pulse dos veces en la acción. Se abre la ventana Obtener entidades por consulta.2. Si fuera necesario, modifique el valor de Rótulo. Por defecto, el nombre de rótulo es igual que el nombre de acción.
3. Para añadir un tipo de conector de Windchill, consulte Tipos de conector de Windchill soportados.
Si se ha añadido previamente un tipo de conector, seleccione el valor de Tipo de conector apropiado y, en Nombre de conector, seleccione el conector.
4. Pulse en Probar para validar el conector.
5. Pulse en Asignar conector para ejecutar la acción mediante un conector que sea diferente del que se utiliza para rellenar los campos de entrada. En el campo Conector de tiempo de ejecución, proporcione un nombre de conector de Windchill válido. Para obtener más información sobre la opción Asignar conector, consulte el tema sobre el uso de la asignación del conector.
6. En la lista Tipo de entidad, seleccione el tipo de entidad adecuado.
7. Utilice las opciones de la lista Tipo de consulta para filtrar la salida en función de las propiedades del objeto que desee incluir en la salida.
Según el tipo de devolución de entidad, una consulta tiene los siguientes parámetros:
◦ Objeto único: Seleccionar propiedades, Añadir elementos relacionados
◦ Recopilación de objetos: Filtros, Seleccionar propiedades, Añadir elementos relacionados, Limitar, Omitir
En la lista Tipo de consulta, seleccione Consulta basada en formulario, Consulta discreta o Consulta sin formato para proporcionar parámetros de consulta.
Consulta basada en formulario a. (Disponible solo para la recopilación de objetos) En el grupo Filtro, realice lo siguiente: a. En la lista Unir por, seleccione un operador lógico para unir las cláusulas de filtro. El valor por defecto es y. b. En Cláusulas de filtro, pulse en Añadir para añadir un filtro: ▪ Propiedad: permite seleccionar una propiedad. ▪ Condición coincidente: permite seleccionar una condición. La condición depende del tipo de la propiedad seleccionada, como cadena, booleano, etcétera. ▪ Valor: permite introducir un valor de propiedad. Pulse en Añadir para añadir varios filtros. Pulse en  para borrar cualquier filtro que se haya añadido.Si se añaden las mismas propiedades y se selecciona Y en la lista Unir por, los atributos se unen mediante el operador O. b. En Seleccionar propiedades, pulse en Añadir y, en la lista Propiedad, seleccione la propiedad para la que desee recuperar los valores. Pulse en Añadir para añadir varias propiedades. Pulse en para borrar cualquier propiedad que se haya añadido.Por defecto, los valores de las propiedades "clave" se recuperan en la salida. c. En Añadir elementos relacionados, pulse en Añadir y, en la lista Elemento relacionado, seleccione el elemento relacionado para el que desee recuperar valores. Pulse en Añadir para añadir varios elementos relacionados. Pulse en para borrar cualquier elemento relacionado que se haya añadido.Cualquier propiedad marcada como NavigationProperty se incluye en la categoría Elemento relacionado. d. (Disponible solo para la recopilación de objetos) En el campo Límite, introduzca un valor para limitar la salida a un número especificado de entidades. e. (Disponible solo para la recopilación de objetos) En el campo Omitir, introduzca el número de recursos que desea omitir. f. En el grupo Ordenar por, realice lo siguiente: ▪ En la lista Seleccionar atributo, seleccione el atributo. ▪ En la lista Orden, seleccione Ascendente o Descendente.
|
Consulta discreta a. (Disponible solo para la recopilación de objetos) En el campo Filtros, especifique los criterios de filtro de OData en el formato propertyName operator 'value' [and | or | not].... Por ejemplo, number eq '0000222341' o name eq 'PTC' o startswith(name, 'PTC') b. En el campo Seleccionar propiedades, especifique una expresión de selección OData para proporcionar una lista de nombres de propiedad separados por comas. Por defecto, los valores de las propiedades "clave" se recuperan en la salida. c. En el campo Añadir elementos relacionados, especifique una expresión de selección OData para proporcionar una lista de elementos relacionados separados por comas. Cualquier propiedad marcada como NavigationProperty se incluye en la categoría Elemento relacionado. d. (Disponible solo para la recopilación de objetos) En el campo Limitar, introduzca el número de resultados de la búsqueda que desea recuperar. e. (Disponible solo para la recopilación de objetos) En el campo Omitir, introduzca el número de resultados principales de la búsqueda que desea omitir de los resultados. f. En el campo Ordenar por, introduzca una expresión orderBy de OData en el formato propertyName [asc | desc]. |
Consulta sin formato En el campo Consulta, especifique una expresión de consulta OData. Por ejemplo:$select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' Por defecto, los valores de las propiedades "clave" se recuperan en la salida. Cualquier propiedad marcada como NavigationProperty se incluye en la categoría Elemento relacionado. Según el tipo de devolución de la entidad, se pueden proporcionar parámetros de filtro, límite y omisión en la expresión de consulta. |
8. Pulse en Mostrar campos adicionales para ver campos adicionales.
◦ En Obtener anotaciones de OData, seleccione verdadero para incluir las anotaciones de OData en la salida. El valor por defecto es falso.
9. Pulse en Terminado.
Esquema de salida
El esquema de salida para la acción Obtener entidades por consulta es un esquema dinámico. Cambia según los valores seleccionados para los campos Tipo de entidad, Propiedad y Elementos relacionados.
Si se ha seleccionado Consulta basada en formulario para especificar los parámetros de consulta, en el esquema de salida se proporcionan detalles solo de las propiedades seleccionadas.
Para Consulta discreta o Consulta sin formato, en el esquema de salida se incluyen todas las propiedades del objeto devuelto. Sin embargo, solo se proporcionan los valores de las propiedades seleccionadas.
El esquema de salida tiene una matriz de objetos del tipo de entidad seleccionado y una lista de identificadores que es una lista de los OID de Windchill separados por comas. En la siguiente imagen se muestra el esquema de salida de ejemplo:
Si se selecciona el valor de Tipo de entidad como Partes, el esquema de salida es como se muestra en la siguiente figura:
Si se selecciona el valor de Tipo de entidad como Partes y el valor de Propiedad se define en AssemblyMode, el esquema de salida es como se muestra en la siguiente figura:
 | Para AssemblyMode, la acción devuelve un valor como { "Value": "separable", "Display": "Separable" }. Si el usuario desea asignar el campo Valor solo, se debe actualizar la asignación de la siguiente manera: {{$a0.Results[0].AssemblyMode.Value}} |
Si se selecciona el valor de Tipo de entidad como Partes y el valor de Propiedad se define en AssemblyMode y el valor de Elementos relacionados en Carpeta, el esquema de salida es como se muestra en la siguiente figura:
