Referencia de comando > Referencia de comando pmrep > ApplyLabel
  

ApplyLabel

Aplica una etiqueta a un objeto o a un conjunto de objetos de una carpeta. Si especifica el nombre de una carpeta, todos los objetos de esa carpeta recibirán la etiqueta. Puede aplicar la etiqueta a objetos dependientes. Si utiliza la opción dependency_object_types, pmrep etiqueta todos los objetos dependientes. Para aplicar una etiqueta a los objetos dependientes seleccionados, separe cada nombre de tipo de objeto por una coma, sin espacios entre uno y otro en la línea de comandos.
Emplee ApplyLabel para etiquetar objetos de entrada reutilizables. Si desea etiquetar objetos de entrada no reutilizables, debe usar un archivo de entrada persistente que contenga ID de objeto codificados.
Si ApplyLabel se ejecuta correctamente, pmrep puede no mostrar ninguna información de estado o bien puede mostrar una lista de los objetos que ya tienen la etiqueta. Si el comando falla, pmrep muestra la razón por la que se produjo el error.
El comando ApplyLabel utiliza la sintaxis siguiente:
applylabel

-a <label_name>

{{-n <object_name>

  -o <object_type>

  [-t <object_subtype>]

  [-v <version_number>]

  [-f <folder_name>] } |

  -i <persistent_input_file>}

[-d <dependency_object_types>]

[-p <dependency_direction (children, parents, or both)>]

[-s (include pk-fk dependency)]

[-g (across repositories)]

[-m (move label)]

[-c <comments>]

[-e dbd_separator]
La tabla siguiente describe las opciones y los argumentos de pmrep ApplyLabel:
Opción
Argumento
Descripción
-a
label_name
Obligatorio. Nombre de la etiqueta que se desea aplicar al objeto.
-n
object_name
Obligatorio cuando se está actualizando un objeto específico. Nombre del objeto que recibirá la etiqueta. No se pueden especificar nombres de objetos si se emplea la opción -i.
-o
object_type
Tipo de objeto al que se le aplicará la etiqueta. Se puede especificar origen, destino, transformación, asignación, sesión, worklet, flujo de trabajo, programador, configuración de sesión, tarea, cubo o dimensión. Obligatorio si se aplicará una etiqueta a un objeto específico.
-t
object_subtype
Obligatorio. Tipo de tarea o transformación que se está etiquetando. pmrep omite otros tipos de objeto. Para obtener más información sobre los subtipos válidos, consulte Listado de tipos de objeto.
-v
version_number
Opcional. Versión del objeto al que se le aplicará la etiqueta. El comando falla si la versión está desprotegida. De manera predeterminada, aplica la etiqueta a la última versión del objeto.
-f
folder_name
Opcional. Carpeta que contiene los objetos. Si especifica un nombre de carpeta, pero no un nombre de objeto, pmrep aplica la etiqueta a todos los objetos de la carpeta. Si especifica un nombre de carpeta con un nombre de objeto, pmrep busca el objeto dentro de esa carpeta. No se puede usar la opción -f si se emplea la opción -i.
-i
persistent_input_file
Opcional. Nombre de un archivo de texto generado con ExecuteQuery, ListObjectDependency o Validate. Contiene una lista de los objetos que recibirán la etiqueta. Si utiliza esta opción, no use el nombre de objeto, el tipo de objeto o el nombre de carpeta para especificar objetos.
-d
dependency_object_types
Opcional. Tipos de objetos dependientes para etiquetar. Los tipos de objetos dependientes válidos incluyen accesos directos, asignaciones, mapplets, sesiones, flujos de trabajo, worklets, definiciones de destino, definiciones de origen y dependencias de claves externas
Utilice esta opción con la opción -p. Si especifica un tipo de objeto, la etiqueta se aplica a los objetos dependientes de ese tipo de objeto.
-p
dependency_direction
Opcional. Objetos primarios o secundarios dependientes a los que se les aplicará la etiqueta. Puede especificar primarios, secundarios o ambos. Si no especifica la opción -d, todos los objetos dependientes reciben la etiqueta.
Si no especifica esta opción, la etiqueta se aplica al objeto especificado.
-s
-
Opcional. Incluya los objetos de dependencia de clave externa/clave principal independientemente de la dirección de la dependencia.
-g
-
Opcional. Busca dependencias de objetos entre los repositorios.
-m
-
Opcional. Mueve una etiqueta de la versión actual a la última versión de un objeto. Utilice este argumento cuando el tipo de etiqueta sea one_per_object.
-c
comments
Opcional. Comentarios sobre la etiqueta.
-e
dbd_separator
Opcional. Si un origen ODBC incluye un punto (.) en el nombre, establezca un carácter de separador diferente al definir el objeto de origen. Por ejemplo, en lugar de database_name.source_name, defina el objeto de origen como database_name\source_name y defina dbd_separator con una barra invertida (\).