El fichero de especificaciones de Promoción de Business Administrative Change es un mecanismo que permite definir criterios para la selección de objetos administrativos en un nivel macro que se exportarán a un fichero XML. Por ejemplo, se puede especificar un criterio de filtro para exportar solo los perfiles provenientes de una organización o contexto concretos, o bien exportar reglas de control de acceso de directiva solo para un participante concreto, etcétera. En el fichero BACSpec.xsd se incluyen las reglas y restricciones que se aplican al crear un fichero de especificaciones. El fichero BACSpec.xsd se encuentra en <WT_HOME>\prog_examples\BAC\schema. El filtrado de objetos usando un fichero de especificaciones se soporta en los modos sincronizado y selectivo. En las secciones subsiguientes de este tema se describen la estructura de elementos y la información relacionada que se utilizarán en un fichero de especificaciones para cada objeto junto con una muestra de código XML de especificaciones. Además, se proporcionan como referencia algunos ficheros de especificaciones de muestra para cada tipo de objeto en <WT_HOME>\prog_examples\BAC.

Utilice la opción -s o --objectType en el comando de exportación para cargar y procesar el fichero XML de especificaciones. La opción -s o --objectType solo está disponible si se ha definido la propiedad com.ptc.windchill.bac.features.enabled de wt.properties en 2666518. Sin esta configuración, todo intento de cargar un fichero de especificaciones se rechazará con un error. Esta opción está disponible para los modos selectivo y sincronizado.

Además de utilizar los atributos de identidad de un objeto como criterios de filtro, se puede utilizar la etiqueta GlobalContainerCriteria en el fichero de especificaciones para filtrar objetos en un nivel de contenedor. Consulte la sección Criterios de contenedor global de este tema para obtener más detalles.

Cada tipo de objeto del sistema soporta solo un conjunto de criterios de filtro determinado. Durante la creación del fichero de especificaciones, asegúrese de que los criterios que se hayan proporcionado sean válidos para ese tipo de objeto. Por ejemplo, para las reglas de control de acceso de directiva, el nombre no es un criterio soportado del filtro. Por lo tanto, no se pueden exportar las reglas de acceso de directivas basándose en el nombre. De manera similar, el estado de ciclo de vida o el ID de tipo no son criterios de filtro soportados para los perfiles. En las siguientes secciones se proporcionan detalles sobre los distintos elementos que se pueden utilizar para cada tipo de objeto al crear un fichero de especificaciones de Business Administrative Change Promotion.

Los valores de cadena especificados para un elemento, subelemento o atributo del fichero de especificaciones distinguen entre mayúsculas y minúsculas.

El fichero de especificaciones permite filtrar perfiles según el nombre de los perfiles en un contenedor de organización específico o el contenedor de intercambio. En esta sección se describen los elementos XML que se pueden utilizar para filtrar objetos por perfiles en sistemas en modo selectivo. En el esquema de perfil se incluyen los siguientes elementos:

Se puede crear un fichero XML de especificaciones para seleccionar todos los perfiles denominados Profile1 en la organización ExchangeContainer o PTC, como se muestra a continuación:

En esta sección se describen los elementos XML que se utilizan para filtrar y exportar los registros de regla de inicialización de objetos (OIR) en sistemas en modo selectivo. Para OIR solo se soportan los elementos TypeBasedRule. Las OIR se pueden filtrar según el nombre de una OIR de un contenedor de organización específico, contenedor de aplicación, contenedor de intercambio o tipo de objeto. En el esquema de OIR se incluyen los siguientes elementos:

A continuación, se presenta un fichero de especificaciones de muestra para filtrar y exportar registros de OIR con los nombres OIR-part-org, OIR-doc-org y OIR-doc-prod1 desde la organización PTC y según el elemento WTDocument como el tipo de objeto:

En esta sección se describen los elementos XML que se utilizan para filtrar y exportar las preferencias en sistemas en modo selectivo. En el esquema de preferencias se incluyen los siguientes elementos:

Es posible filtrar las preferencias según el tipo de contenedor, el usuario de Windchill, la categoría de preferencia, la definición de preferencia y el cliente de preferencia.

La información de contenedor, la información de usuario y excludeInstances son opciones mutuamente excluyentes para las preferencias de filtrado.

Fichero de especificaciones de muestra para filtrar y exportar una definición de preferencia denominada Intro del contenedor de aplicación GOLF_CART de Test Organization. En el fichero de especificaciones también se especifican los criterios de filtrado para exportar los registros de una preferencia denominados AAA de un cliente de preferencia denominado Windchill y un cliente de preferencia denominado DEMO, así como para excluir el filtrado de preferencias con visibilidad oculta en las instancias User y Container:

Para obtener nombres internos: la especificación de los criterios de filtrado según la categoría de preferencia, definición de preferencia y cliente de preferencia requiere proporcionar el nombre interno de las preferencias. Utilice el siguiente comando para obtener los nombres internos de las preferencias de una configuración regional específica:

Al ejecutar este comando, se genera un informe CSV que guarda en la ubicación especificada. En el informe CSV se proporciona información sobre el tipo de objeto, el nombre interno y el nombre que se muestra en la configuración regional que se ha especificada en el comando.

Los siguientes elementos se incluyen en el esquema de la regla de control de acceso de directiva para los sistemas en modo selectivo:

Las reglas de control de acceso de directiva se pueden filtrar en función de los atributos de participantes solo para los sistemas en modo selectivo. El filtro se puede definir como una combinación de elementos de participantes con contenedores, dominios o solo atributos.

Al crear un fichero de especificaciones para las reglas de control de acceso de directiva de los sistemas en modo sincronizado, se debe especificar solo el tipo de objeto. No se soporta ningún otro criterio de filtro.

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva que tienen WTPart como tipo de ID, cuyo estado de ciclo de vida se ha definido en APPROVED y donde allExceptPrincipal se ha definido en verdadero.

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva desde el dominio del contenedor de intercambio System, dominio de organización Test Organization y dominios del contenedor de la aplicación, como GOLF_CART, Test_Lib y Test_Project.

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todos los perfiles del contenedor de intercambio y Test Organization, así como todas las reglas de control de acceso de directiva desde el contenedor de intercambio y los contenedores de aplicación, tales como producto, proyecto y biblioteca.

A continuación se incluye un fichero de especificaciones de muestra para exportar todos los perfiles, reglas de inicialización de objetos y reglas de control de acceso de directiva desde un sistema en modo sincronizado:

En esta sección se describen los elementos XML que se utilizan para filtrar y exportar registros de plantillas de ciclo de vida en sistemas en modo selectivo. Las plantillas de ciclo de vida se pueden filtrar según el nombre de una plantilla de ciclo de vida de un contenedor de organización, contenedor de aplicación o contenedor de intercambio específico.

Al desarrollar el fichero de especificaciones de plantillas de ciclo de vida, se deben tener en cuenta las siguientes directrices:

Los siguientes elementos se incluyen en el esquema de plantilla de ciclo de vida para sistemas en modo selectivo:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las plantillas de ciclo de vida desde el contenedor Exchange y el producto GOLF_CART en Demo Organization:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las plantillas de ciclo de vida denominadas Default en Demo Organization:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las plantillas de ciclo de vida denominadas Basic y Default:

En esta sección se describen los elementos XML que se utilizan para filtrar y exportar registros de plantillas de proceso de trabajo en sistemas en modo selectivo. Las plantillas de proceso de trabajo se pueden filtrar según el nombre de una plantilla de ciclo de vida de un contenedor de organización, contenedor de aplicación o contenedor de intercambio específico.

Al desarrollar el fichero de especificaciones de plantillas de proceso de flujo de trabajo, se deben tener en cuenta las siguientes directrices:

Los siguientes elementos se incluyen en el esquema de plantilla de proceso de trabajo para sistemas en modo selectivo:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las plantillas de proceso de trabajo desde el contenedor Exchange y el producto GOLF_CART en Demo Organization:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las plantillas de proceso de trabajo denominadas Submit en Demo Organization:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las plantillas de proceso de trabajo denominadas Review en Submit:

El fichero de especificaciones permite filtrar y exportar la plantilla de atributos en función del nombre interno de la definición de tipo. En el esquema de la plantilla de atributos se incluyen los siguientes elementos:

A continuación se proporciona un ejemplo en el que se utiliza el fichero de especificaciones para filtrar y exportar la plantilla de atributos:

El fichero de especificaciones permite filtrar y exportar el sistema de medidas en función del nombre interno del sistema de medidas. En el esquema se incluyen los siguientes elementos:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar el sistema de medidas:

El fichero de especificaciones permite filtrar y exportar cantidades de medida en función del nombre de las cantidades de medida. En el esquema se incluyen los siguientes elementos:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar las cantidades de medida:

El fichero de especificaciones permite filtrar y exportar enumeraciones globales, enumeraciones modeladas y texto personalizado de la interfaz de usuario en función del nombre de las enumeraciones o del texto personalizado de la interfaz de usuario, el nombre del organizador y la organización propietaria. En el esquema se incluyen los siguientes elementos:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global, la enumeración modelada y el texto personalizado de la interfaz de usuario que se denominan basic y default:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global, la enumeración modelada y el texto personalizado de la interfaz de usuario según el organizador de enumeraciones o el organizador de texto:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global, la enumeración modelada y el texto personalizado de la interfaz de usuario según el organizador de enumeraciones o el organizador de texto y la organización propietaria:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global, la enumeración modelada y el texto personalizado de la interfaz de usuario según la organización propietaria:

El fichero de especificaciones permite filtrar y exportar atributos reutilizables según el nombre del atributo y el organizador de atributos. En el esquema se incluyen los siguientes elementos:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar atributos reutilizables según el nombre interno del atributo:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar atributos reutilizables según el organizador de atributos.

Un fichero de especificaciones se puede crear mediante un elemento o una combinación de los elementos de participantes. Si se utilizan todos los elementos del esquema de participante en un fichero de especificaciones, la secuencia de elementos en el esquema debe tener el orden que se muestra en la siguiente figura.

Los siguientes elementos se incluyen en el esquema de participante:

A continuación se incluye un fichero de especificaciones de muestra que hace referencia a todos los elementos de participante en la secuencia asignada por mandato:

El fichero de especificaciones permite filtrar según el nombre de las vistas en tabla, tableID o un propietario específico. En esta sección se describen los elementos XML que se pueden utilizar para filtrar objetos por perfiles en sistemas en modo selectivo.

La estructura es la siguiente:

donde se pueden especificar filtros con todos o con cualquiera de los elementos. Cada elemento puede tener también varios valores. No se puede cambiar la secuencia de los elementos.

A continuación se muestra un ejemplo de fichero de especificaciones file.xml para seleccionar vistas en tabla:

En el ejemplo anterior, el filtro permite generar la salida de cualquiera de los nombres, WSView o Por defecto, y de cualquiera de los ID de tabla para el propietario especificado.

Solo se puede definir el filtro para el nombre de una vista en tabla, o solo para los ID de tabla o el propietario. En el siguiente ejemplo, el filtro se basa solo en el nombre. Por lo tanto, el resultado son vistas en tabla en las que el elemento de nombre es WSView O Por defecto.

Utilice GlobalContainerCriteria para especificar un contenedor común como criterio de filtro global para todos los tipos de objeto especificados en el fichero de especificaciones. Los contenedores especificados en GlobalContainerCriteria se aplican de manera adicional a todos los tipos de objeto del fichero de especificaciones. El uso de GlobalContainerCriteria en un fichero de especificaciones para importar o exportar registros solo se soporta con los sistemas en modo selectivo.

Por ejemplo, para filtrar y exportar todos los perfiles de la organización PTC en GlobalContainerCriteria y un contenedor de intercambio, se obtienen todos los registros de perfil de PTC y ExchangeContainer. A continuación se ofrece una muestra de código XML para este ejemplo:

Al crear un fichero de especificaciones mediante GlobalContainerCriteria, se debe tener en cuenta los siguientes puntos:

A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todos los perfiles de un contenedor de intercambio y las reglas de control de acceso de directiva desde el contenedor de aplicación del sistema conductor de la organización PTC: