Administración de la empresa > Business Administrative Change Promotion > Ejecución de la utilidad de línea de comandos Business Administrative Change Promotion > Creación de un fichero XML de especificaciones
  
Creación de un fichero XML de especificaciones
El fichero de especificaciones de Business Administrative Change Promotion 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 <Windchill_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 <Windchill_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.
Perfil
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:
Elemento
Descripción
ExchangeContainer
Este elemento se utiliza para filtrar los perfiles que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
Organization
Permite especificar el nombre de la organización. Por ejemplo, PTC.
name
Permite especificar el nombre del perfil. Por ejemplo, Profile1.
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<Profile>
</ExchangeContainer>
<Organization>PTC</Organization>
<name>Profile1</name>
</Profile>
</BACSpec>
Regla de inicialización de objetos
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:
Elemento
Subelemento
Atributo
Descripción
ExchangeContainer
Este elemento se utiliza para filtrar las OIR que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
AppContainer
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
Este es un atributo obligatorio para AppContainer.
name
Permite especificar el nombre del contenedor de aplicación.
Este es un atributo obligatorio para AppContainer.
orgName
Permite especificar el nombre la organización dentro del contenedor de aplicación. Por ejemplo, PTC.
Este es un atributo obligatorio para AppContainer.
Organization
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
name
Permite especificar el nombre de la OIR. Por ejemplo, TestUser.
objectType
Permite especificar el nombre interno de un objeto. Por ejemplo, wt.doc.WTDocument. El nombre interno de un objeto está disponible en la utilidad Gestión de tipos y atributos.
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<OIR>
<name>OIR-part-org</name>
<name>OIR-BACdocument-org</name>
<name>OIR-document-org</name>
<Organization name=”PTC”/>
<objectType>WCTYPE|wt.doc.WTDocument</objectType>
<objectType>WCTYPE|wt.doc.WTDocument|com.ptc.ptcnet.BACDocument</objectType>
</OIR>
</BACSpec>
Preferencia
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.
Elemento
Subelemento
Atributo
Descripción
ExchangeContainer
Este elemento se utiliza para filtrar las instancias de preferencia que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
AppContainer
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
name
Permite especificar el nombre del contenedor de aplicación.
orgName
Permite especificar el nombre de la organización. Por ejemplo, PTC.
Organization
name
Permite especificar el nombre del contenedor de organización. Por ejemplo, PTC.
User
Permite especificar el nombre, UFID o ID de correo electrónico de un usuario de Windchill o WTUser para filtrar y exportar la instancia de preferencia de un usuario. En el fichero de especificaciones se debe especificar al menos uno de estos valores como criterio de filtro para WTUser.
excludeInstances
Permite utilizar excludeInstances para especificar si desea excluir alguna instancia de preferencia durante el filtrado de preferencias.
Si solo se utiliza excludeInstances, durante el proceso de filtrado se excluirán todas las instancias de preferencia. Para obtener un filtrado más específico, utilice los subelementos instanceType y visibility como criterios de filtro.
instanceType
Permite especificar el tipo de instancia que se excluirá del filtrado de preferencias. Los valores válidos son los siguientes:
USER
CONTAINER
ORGANIZATION
SITE
visibility
Permite especificar los valores de configuración de visibilidad para los que se deben excluir las instancias de preferencia. Los valores válidos son los siguientes:
USER
CONTAINER
ORGANIZATION
SITE
HIDDEN
PRODUCT
PROJECT
LIBRARY
USERONLY
PRODUCT,PROJECT
PRODUCT,LIBRARY
PROJECT,LIBRARY
PRODUCT,PROJECT,LIBRARY
Name
Permite especificar el nombre interno de una definición de preferencia.
Utilice el comando getInternalNames para obtener los nombres internos. Consulte getInternalNames para obtener más información.
CategoryName
Permite especificar el nombre interno de una categoría de preferencia.
Utilice el comando getInternalNames para obtener los nombres internos. Consulte getInternalNames para obtener más información.
ClientName
Permite especificar el nombre interno de un cliente de preferencia.
Utilice el comando getInternalNames para obtener los nombres internos. Consulte getInternalNames para obtener más información.
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<Preference>
<AppContainer name="GOLF_CART" type="Product" orgName="Test Organization"/>
<Name>Intro<Name/>
<excludeInstances>
<instanceType>USER<instanceType/>
<instanceType>CONTAINER<instanceType/>
<visibility>HIDDEN</visibility>
</excludeInstances>
<Name>AAA<Name/>
<ClientName>WINDCHILL</ClientName>
<CategoryName>DEMO</CategoryName>
<Preference>
</BACSpec>
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:
java wt.scm.client.SCMCMD getInternalNames getInternalNames [--user <user>] [--password <password>] [--outputdir <outputdir] [--locale <locale>] [--objectType <objectType] [--help]
Opción
Obligatorio
Descripción
-p
--password
No
La contraseña del usuario de Windchill que ejecuta el comando.
-t
--objectType
El tipo de objeto cuyos nombres internos se deben obtener. Se debe especificar Preferences para esta opción. Esta opción se mejorará para soportar tipos de objeto nuevos en una versión futura.
-u
--user
No
El nombre del usuario de Windchill que ejecuta el comando. El usuario que ejecuta el comando debe ser un usuario válido de Windchill y un administrador del sitio.
-h
--help
No
Utilice esta opción para mostrar el texto de ayuda de la utilidad. El texto de ayuda enumera descripciones completas de cada opción, así como la sintaxis para ejecutar la utilidad.
-l
--locale
No
La configuración regional en la que se debe generar el fichero de salida. Si no se especifica una configuración regional, el fichero de salida se genera en la configuración regional por defecto.
-o
--outputdir
Ruta del fichero a la ubicación en la que se genera y guarda el fichero CSV. Si no se especifica esta opción, los ficheros se guardan en la ubicación por defecto del directorio temporal ${wt.temp}/bac de Windchill.
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.
Regla de control de acceso de directiva
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.
Elemento
Subelemento
Atributo
Descripción
Organization
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
ExchangeContainer
Este elemento se utiliza para filtrar las reglas de control de acceso de directiva que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
AppContainer
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
Este es un atributo obligatorio para AppContainer.
name
Permite especificar el nombre del contenedor de aplicación.
Este es un atributo obligatorio para AppContainer.
orgName
Permite especificar el nombre de la organización. Por ejemplo, PTC.
Este es un atributo obligatorio para AppContainer.
OrganizationDomains
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
Este es un atributo obligatorio para OrganizationDomains.
path
Permite especificar la ruta al fichero o la ubicación de la carpeta del dominio administrativo del objeto definido.
Este es un atributo obligatorio para OrganizationDomains.
ExchangeContainerDomains
domain
path
Permite especificar el dominio administrativo del objeto definido.
AppContainerDomains
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
Este es un atributo obligatorio para AppContainerDomains.
name
Permite especificar el nombre del contenedor de aplicación.
Este es un atributo obligatorio para AppContainerDomains.
orgName
Permite especificar el nombre de la organización. Por ejemplo, PTC.
Este es un atributo obligatorio para AppContainerDomains.
domain
path
Permite especificar el dominio administrativo del objeto definido.
Este es un atributo obligatorio para AppContainerDomains.
Principal
Permite especificar los participantes. Consulte la sección Participante de este tema para obtener detalles sobre los distintos subelementos y sus atributos correspondientes.
typeid
Permite especificar el identificador de tipo de un objeto, tal como WTPart, WTDocument. Por ejemplo:WCTYPE|com.ptc.windchill.bac.delivery.BACReceivedDelivery
state
Permite especificar un estado de ciclo de vida para el tipo de objeto en mayúscula.
allExceptPrincipal
Permite especificar si desea recopilar objetos de participante. Los valores válidos son true y false.
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.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<typeid>WCTYPE|wt.part.WTPart</typeid>
<state>APPROVED</state>
<allExceptPrincipal>true</allExceptPrincipal>
</PolicyAccessControlRule>
</BACSpec>
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.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<ExchangeContainerDomains>
<domain path=”/System”/>
<OrganizationDomains name=”Test Organization”/>
<domain path=”/Test Organization”/>
</OrganizationDomains>
<AppContainerDomains type=”Product” name=”GOLF_CART” orgName=”Test Organization”>
<domain path=”/Default”/>
</AppContainerDomains>
<AppContainerDomains type=”Library” name=”Test_Lib” orgName=”Test Organization”>
<domain path=”/Default”/>
</AppContainerDomains>
<AppContainerDomains type=”Project” name=”Test_Project” orgName=”Test Organization”>
<domain path=”/Default”/>
</AppContainerDomains>
</PolicyAccessControlRule>
</BACSpec>
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.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<Profile>
<ExchangeContainer/>
<Organization name=”Test Organization”/>
</Profile>
<PolicyAccessControlRule>
<ExchangeContainer/>
<Organization name=”Test Organization”/>
<AppContainer type=”Product” name=”GOLF_CART” orgName=”Test Organization”/>
<AppContainer type=”Library” name=”Test_Lib” orgName=”Test Organization”/>
<AppContainer type=”Project” name=”Test_Project” orgName=”Test Organization”/>
</PolicyAccessControlRule>
</BACSpec>
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<Profile/>
<PolicyAccessControlRule/>
<OIR/>
<Preference/>
</BACSpec>
Plantilla de ciclo de vida
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:
Se pueden propagar las plantillas de ciclo de vida que solo se encuentran en el dominio del sistema.
Solo se puede propagar la iteración más reciente de una plantilla de ciclo de vida. Esto es el caso incluso si el número de iteraciones de una plantilla de ciclo de vida varía en el sistema de origen y el sistema de destino.
Cuando una acción de borrado se propaga en la última iteración de una plantilla de ciclo de vida en el sistema de destino, esta acción también borra automáticamente la iteración maestra. Esto es el caso incluso si la iteración más reciente de la plantilla de ciclo de vida del sistema de origen que se ha exportado es la única iteración presente en el sistema de destino.
La acción de borrado se puede propagar para las plantillas de ciclo de vida solo si la asignación de base de datos y la información de ID local coincidentes se encuentran en los sistemas en modo sincronizado. En sistemas en modo selectivo, se debe encontrar una asignación de base de datos coincidente.
No se soporta el borrado de iteraciones intermedias de plantillas de ciclo de vida. Solo las iteraciones más recientes que coincidan con la información de asignación de base de datos o de ID local se borran con respecto al modo de intercambio.
Cuando una iteración de una plantilla de ciclo de vida se borra en el sistema de origen, durante el proceso de exportación, la información borrada de la iteración, junto con la iteración más reciente disponible del sistema de origen, se propagan al sistema de destino. Esta acción ayuda a sincronizar la iteración más reciente en uso en el sistema de destino.
No se soporta el filtrado de plantillas de ciclo de vida en función de la identidad empresarial para la propagación de la acción de borrado.
No se soporta el borrado de plantillas de ciclo de vida que están en uso por otros objetos.
Los siguientes elementos se incluyen en el esquema de plantilla de ciclo de vida para sistemas en modo selectivo:
Elemento
Subelemento
Atributo
Descripción
Name
Permite especificar el nombre de la plantilla de ciclo de vida.
ExchangeContainer
Este elemento se utiliza para filtrar plantillas de ciclo de vida que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
AppContainer
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
Este es un atributo obligatorio para AppContainer.
name
Permite especificar el nombre del contenedor de aplicación.
Este es un atributo obligatorio para AppContainer.
orgName
Permite especificar el nombre la organización dentro del contenedor de aplicación. Por ejemplo, PTC.
Este es un atributo obligatorio para AppContainer.
Organization
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<LifeCycleTemplate>
<ExchangeContainer/>
<AppContainer type=”Product” name=”GOLF_CART” orgName=”Demo Organization”/>
</LifeCycleTemplate>
</BACSpec>
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<LifeCycleTemplate>
<Organization name="Demo Organization"/>
<Name>Default</Name>
</LifeCycleTemplate>
</BACSpec>
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<LifeCycleTemplate>
<Name>Basic</Name>
<Name>Default</Name>
</LifeCycleTemplate>
</BACSpec>
Plantilla de proceso de trabajo
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:
Se pueden propagar las plantillas de proceso de trabajo que solo se encuentran en el dominio del sistema.
Solo se puede propagar la iteración más reciente de una plantilla de proceso de trabajo. Esto es el caso incluso si el número de iteraciones de una plantilla de proceso de trabajo varía en el sistema de origen y el sistema de destino.
Cuando una acción de borrado se propaga en la última iteración de una plantilla de proceso de trabajo en el sistema de destino, esta acción también borra automáticamente la iteración maestra. Esto es el caso incluso si la iteración más reciente de la plantilla de proceso de trabajo del sistema de origen que se ha exportado es la única iteración presente en el sistema de destino.
La acción de borrado se puede propagar para las plantillas de proceso de trabajo solo si la asignación de base de datos y la información de ID local coincidentes se encuentran en los sistemas en modo sincronizado. En sistemas en modo selectivo, se debe encontrar una asignación de base de datos coincidente.
No se soporta el borrado de iteraciones intermedias de plantillas de proceso de trabajo. Solo las iteraciones más recientes que coincidan con la información de asignación de base de datos o de ID local se borran con respecto al modo de intercambio.
Cuando una iteración de una plantilla de proceso de trabajo se borra en el sistema de origen, durante el proceso de exportación, la información borrada de la iteración, junto con la iteración más reciente disponible del sistema de origen, se propagan al sistema de destino. Esta acción ayuda a sincronizar la iteración más reciente en uso en el sistema de destino.
No se soporta el filtrado de plantillas de proceso de flujo de trabajo en función de la identidad empresarial para la propagación de la acción de borrado.
No se soporta el borrado de plantillas de proceso de trabajo utilizadas por otros objetos.
No se soporta el intercambio de plantillas de proceso de trabajo externalizadas.
Los siguientes elementos se incluyen en el esquema de plantilla de proceso de trabajo para sistemas en modo selectivo:
Elemento
Subelemento
Atributo
Descripción
Name
Permite especificar el nombre de la plantilla de proceso de trabajo.
ExchangeContainer
Este elemento se utiliza para filtrar plantillas de proceso de trabajo que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
AppContainer
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
Este es un atributo obligatorio para AppContainer.
name
Permite especificar el nombre del contenedor de aplicación.
Este es un atributo obligatorio para AppContainer.
orgName
Permite especificar el nombre la organización dentro del contenedor de aplicación. Por ejemplo, PTC.
Este es un atributo obligatorio para AppContainer.
Organization
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<WorkflowProcessTemplate>
<ExchangeContainer/>
<AppContainer type=”Product” name=”GOLF_CART” orgName=”Demo Organization”/>
</WorkflowProcessTemplate>
</BACSpec>
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<WorkflowProcessTemplate>
<Organization name="Demo Organization"/>
<Name>Submit</Name>
</WorkflowProcessTemplate>
</BACSpec>
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<WorkflowProcessTemplate>
<Name>Review</Name>
<Name>Submit</Name>
</WorkflowProcessTemplate>
</BACSpec>
Definición de tipo
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:
Elemento
Descripción
Name
Se especifica el nombre interno de la definición de tipo. Por ejemplo, Name1.
Namespace
Se especifica el espacio de nombres de la definición de tipo. Por ejemplo, Namespace1.
* 
Si no hay información para el espacio de nombres, no se debe incluir en el fichero de especificaciones.
Flavor
Se especifica el carácter de la plantilla de atributos de la definición de tipo. Por ejemplo, LWCTYPE.
A continuación se proporciona un ejemplo en el que se utiliza el fichero de especificaciones para filtrar y exportar la plantilla de atributos:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<TypeDefinitions>
<TypeDefinition>
<Name>name</Name>
<Namespace>namespace</Namespace>
<Flavor>LWCTYPE</Flavor>
</TypeDefinition>
<TypeDefinition>
<Name>Name1</Name>
<Namespace>Namespace1</Namespace>
<Flavor>LWCTYPE</Flavor>
</TypeDefinition>
</TypeDefinitions>
</BACSpec>
Sistema de medidas
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:
Elemento
Descripción
Name
Especifique el nombre del sistema de medidas. Por ejemplo, MS1.
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar el sistema de medidas:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<MeasurementSystem>
<Name>MS1</Name>
<Name>MS2</Name>
</MeasurementSystem>
</BACSpec>
Cantidades de medida
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:
Elemento
Descripción
Name
Especifique el nombre de las cantidades de medida. Por ejemplo, QOM1.
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar las cantidades de medida:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<QOM>
<Name>QOM1</Name>
<Name>QOM2</Name>
</QOM>
</BACSpec>
Enumeraciones globales
El fichero de especificaciones permite filtrar y exportar enumeraciones globales en función del nombre de las enumeraciones, el nombre del organizador y la organización propietaria. En el esquema se incluyen los siguientes elementos:
Elemento
Descripción
internalName
Especifique el nombre de la enumeración global. Por ejemplo, ENU1.
OrganizerName
Especifique el nombre del organizador de enumeraciones.
owningOrg
Especifique la organización en la que se va a crear la enumeración.
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global que se denomina basic y default:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<GlobalEnumeration>
<Name>basic</Name>
<Name>default</Name>
</GlobalEnumeration>
</BACSpec>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global según el organizador de enumeraciones:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<GlobalEnumeration>
<OrganizerName>ORGNAME1</OrganizerName>
<OrganizerName>ORGNAME2</OrganizerName>
</GlobalEnumeration>
</BACSpec>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global según el organizador de enumeraciones y la organización propietaria:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<GlobalEnumeration>
<OrganizerName>ORGNAME1</OrganizerName>
<owningOrg>Demo Org</owningOrg>
</GlobalEnumeration>
</BACSpec>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar la enumeración global según la organización propietaria:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<GlobalEnumeration>
<owningOrg>site</owningOrg>
</GlobalEnumeration>
</BACSpec>
Atributos reutilizables
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:
Elemento
Descripción
name
Especifique el nombre interno del atributo con o sin nombre de dominio. Por ejemplo, org.rnd.SampleAttr1 o SampleAttr1
OrganizerName
Especifique los nombres internos para los organizadores de atributos en la jerarquía.
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar atributos reutilizables según el nombre interno del atributo:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<ResuableAttr>
<name>org.rnd.SampleAttr1</name>
<name>SampleAttr1</name>
</ResuableAttr>
</BACSpec>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar atributos reutilizables según el organizador de atributos.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <BACSpec xmlns="http://www.ptc.com/bac">
<ResuableAttr>
<OrganizerName>RootOrganizer</OrganizerName>
<OrganizerName>RootOrganizer/Organizer1</OrganizerName>
</ResuableAttr>
</BACSpec>
Participante
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:
Participante Rol
Representa a los grupos del sistema creados para los roles asignados a los miembros del equipo en equipos de contexto y equipos compartidos, y a los grupos del sistema creados en un contexto de aplicación que representa a las organizaciones que tienen miembros en el equipo de contexto.
Este elemento soporta el nombre de grupo, tipo de grupo y contenedor, ya sea un contenedor de intercambio o un contenedor de organización, de un rol Windchill o WTRoleprincipal. Se debe especificar el contenedor de intercambio o de organización para WTRolePrincipal.
En el esquema de WTRoleprincipal se incluyen los siguientes elementos:
Elemento
Subelemento
Atributo
Descripción
groupname
Permite especificar APPROVER como el nombre del grupo interno.
grouptype
Permite especificar DynamicRole como el tipo de grupo al que pertenece el grupo interno.
ExchangeContainer
Este elemento se utiliza para filtrar los grupos del sistema que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
Organization
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva basadas en RolePrincipal desde una organización PTC:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<RolePrincipal>
<groupname>112211_ORG</groupname>
<grouptype>DynamicRole</grouptype>
<Organization name=”PTC”/>
</RolePrincipal>
</PolicyAccessControlRule>
</BACSpec>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva basadas en RolePrincipal desde un contenedor de intercambio:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<RolePrincipal>
<ExchangeContainer/>
</RolePrincipal>
</PolicyAccessControlRule>
</BACSpec>
Grupo
Permite especificar el UFID o una combinación de nombre y contenedor de intercambio o contenedor de organización de un grupo Windchill o WTGroup.
En el esquema de WTGroup se incluyen los siguientes elementos:
Elemento
Subelemento
Atributo
Descripción
name
Permite especificar el nombre del grupo. Por ejemplo, Administrator.
Organization
Permite especificar el nombre de la organización. Por ejemplo, PTC.
ExchangeContainer
domain
path
Este elemento se utiliza para filtrar los grupos que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
ufid
name
Permite especificar el identificador federado único (UFID) del objeto. El formato válido de este parámetro es: <cadena_ufid>|<almacén ldap>|<almacén ldap>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva del grupo Administrator desde la organización PTC, desde el contenedor de intercambio y un UFID específico:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<Group>
<name>Administrator</name>
<grouptype>DynamicRole</grouptype>
<Organization name=”PTC”/>
</Group>
<Group>
<ufid>uid=test,ou=people,cn=adminsitrativeldap,cn=ajohn.111.01.01,o=ptc|Ldap.ptcnet.ptc.com|Ldap.ptcnet.ptc.com</ufid>
</Group>
</PolicyAccessControlRule>
</BACSpec>
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 todos los grupos del contenedor de intercambio:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<Group>
<ExchangeContainer/>
</Group>
</PolicyAccessControlRule>
</BACSpec>
Grupo interno
Estos son grupos que no se representan en el LDAP, pero cuyo mantenimiento lo realiza internamente Windchill. Por ejemplo, Creador de bibliotecas
En el esquema de InternalGroup se incluyen los siguientes elementos:
Elemento
Subelemento
Atributo
Descripción
groupname
Permite especificar el nombre de un grupo interno.
grouptype
Permite especificar DynamicRole como el tipo de grupo al que pertenece el grupo interno.
ExchangeContainer
Este elemento se utiliza para filtrar los grupos internos que se han creado en el nivel del sitio.
En el fichero XML de especificaciones solo se permite una instancia de esta etiqueta.
Organization
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
AppContainer
type
Permite especificar el tipo de contenedor de aplicación. Los valores válidos son Project, Product o Library.
Este es un atributo obligatorio para AppContainer.
name
Permite especificar el nombre del contenedor de aplicación.
Este es un atributo obligatorio para AppContainer.
orgName
Permite especificar el nombre de la organización. Por ejemplo, PTC.
Este es un atributo obligatorio para AppContainer.
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva del grupo LIBRARY CREATOR desde una organización PTC:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<InternalGroup>
<groupname>LIBRARY CREATOR</groupname>
<grouptype>DynamicRole</grouptype>
<Organization name=”PTC”/>
</InternalGroup>
</PolicyAccessControlRule>
</BACSpec>
WTUser
Permite especificar el nombre, UFID o ID de correo electrónico de un usuario Windchill o WTUser. En el fichero de especificaciones se debe especificar al menos uno de estos elementos como criterio de filtro de WTUser.
En el esquema de WTUser se incluyen los siguientes elementos:
Elemento
Descripción
name
Permite especificar el nombre del usuario. Por ejemplo, TestUser.
emailid
Permite especificar el ID de correo electrónico del usuario. Por ejemplo, testuser@ptc.com.
ufid
Permite especificar el identificador federado único (UFID) del objeto. El formato válido de este parámetro es: <cadena_ufid>|<almacén ldap>|<almacén ldap>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva basadas en el UFID:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<User>
<ufid>uid=test,ou=people,cn=adminsitrativeldap,cn=ajohn.111.01.01,o=ptc|Ldap ptcnet.ptc.com|Ldap.ptcnet.ptc.com</ufid>
</User>
</PolicyAccessControlRule>
</BACSpec>
A continuación se incluye un fichero de especificaciones de muestra para filtrar y exportar todas las reglas de control de acceso de directiva basadas en el ID de correo electrónico de un usuario llamado TestUser:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<User>
<emailid>testuser@ptc.com</emailid>
</User>
</PolicyAccessControlRule>
</BACSpec>
WTOrganization
Permite especificar el nombre o el UFID de una organización Windchill o WTOrganization. En el fichero de especificaciones al menos uno de los elementos es obligatorio. En el fichero de especificaciones se debe especificar al menos uno de los elementos como criterio de filtro de WTOrganization.
En el esquema de WTOrganization se incluyen los siguientes elementos:
Elemento
Descripción
name
Permite especificar el nombre de la organización. Por ejemplo, PTC.
ufid
Permite especificar el identificador federado único (UFID) del objeto. El formato válido de este parámetro es: <cadena_ufid>|<almacén ldap>|<almacén ldap>
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 una organización PTC y UFID:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<Org>
<ufid>uid=test,ou=people,cn=adminsitrativeldap,cn=ajohn.111.01.01,o=ptc|Ldap ptcnet.ptc.com|Ldap.ptcnet.ptc.com</ufid>
</Org>
<Org>
<name>PTC</name>
</Org>
</PolicyAccessControlRule>
</BACSpec>
Pseudo-rol
Permite especificar el filtro para la recopilación de objetos según pseudo-roles.
En el esquema de pseudo-rol se incluyen los siguientes elementos:
Elemento
Descripción
name
Permite especificar ALL o OWNER para este atributo, donde:
ALL es un pseudo-rol que Windchill utiliza para representar a todos los participantes.
OWNER es un pseudo-rol que Windchill utiliza para representar al propietario del objeto.
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 un pseudo-rol definido en ALL u OWNER:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<PseudoRole>
<name>ALL</name>
</PseudoRole>
<PseudoRole>
<name>OWNER</name>
</PseudoRole>
</PolicyAccessControlRule>
</BACSpec>
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<PolicyAccessControlRule>
<RolePrincipal>
<groupname>112211_ORG</groupname>
<grouptype>DynamicRole</grouptype>
<Organization name=”PTC”/>
</RolePrincipal>
<Group>
<name>Administrator</name>
<grouptype>DynamicRole</grouptype>
<Organization name=”PTC”/>
</Group>
<User>
<emailid>testuser@ptc.com</emailid>
</User>
<User>
<name>Test User</name>
</User>
<Org>
<ufid>uid=test,ou=people,cn=adminsitrativeldap,cn=ajohn.111.01.01,o=ptc|Ldap ptcnet.ptc.com|Ldap.ptcnet.ptc.com</ufid>
</Org>
<Org>
<name>PTC</name>
</Org>
<InternalGroup>
<groupname>LIBRARY CREATOR</groupname>
<grouptype>LIBRARY CREATOR</grouptype>
<Organization name=”PTC”/>
</InternalGroup>
<PseudoRole>
<name>ALL</name>
</PseudoRole>
<PseudoRole>
<name>OWNER</name>
</PseudoRole>
</PolicyAccessControlRule>
</BACSpec>
Criterios de contenedor global
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<GlobalContainerCriteria>
<Organization name=”PTC”/>
</GlobalContainerCriteria>
<Profile>
<ExchangeContainer/>
</Profile>
</BACSpec>
Al crear un fichero de especificaciones mediante GlobalContainerCriteria, se debe tener en cuenta los siguientes puntos:
Este elemento se encuentra en el primer nivel inmediatamente después de la etiqueta raíz de BACSpec.
Este elemento se encuentra en el mismo nivel que las etiquetas de objeto en el fichero de especificaciones.
Este elemento soporta los siguientes contenedores:
Contenedor de intercambio
Contenedor de organización
Contenedor de aplicación
Verifique que el contenedor especificado en GlobalContainerCriteria es válido para un tipo de objeto concreto.
Para realizar una búsqueda granular, especifique un contenedor válido dentro de un objeto administrativo. Por ejemplo, contenedores de aplicación para las reglas de control de acceso de directiva.
* 
No se puede especificar el contenedor de aplicación o el dominio con GlobalContainerCriteria para los perfiles.
No se soporta el uso de un dominio como elemento hijo dentro de un elemento objeto. Por ejemplo, no se puede especificar un dominio bajo el contenedor de aplicación para las reglas de control de acceso de directiva.
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:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BACSpec xmlns="http://www.ptc.com/bac">
<GlobalContainerCriteria>
<Organization name=”PTC”/>
</GlobalContainerCriteria>
<Profile>
<ExchangeContainer/>
</Profile>
<PolicyAccessControlRule>
<AppContainer name=”Drive System” orgName=”Demo Organization” type=”Product”/>
</PolicyAccessControlRule>
</BACSpec>