Maze / Library /PackageCache /com.unity.collab-proxy@2.0.4 /Lib /Editor /PlasticSCM /Localization /cm-help.es.txt
| == CMD_DESCRIPTION_ACL == | |
| Configura permisos para un objeto. | |
| == CMD_USAGE_ACL == | |
| Sintaxis: | |
| cm acl (--user=<usr_name> | --group=<group_name>) | |
| (-allowed|-denied|-overrideallowed|-overridedenied=+|-<permission>[,...])[,...] | |
| <objectspec> | |
| --user Nombre de usuario. | |
| --group Nombre de grupo. | |
| -allowed Habilita los permisos indicados. Use una coma para | |
| separar permisos. (Use 'cm showpermissions' para mostrar | |
| los permisos disponibles.) | |
| -denied Deniega los permisos indicados. Use una coma para | |
| separar permisos. (Use 'cm showpermissions' para mostrar | |
| los permisos disponibles.) | |
| -overrideallowed Anula los permisos habilitados. Use una coma para separar | |
| permisos. (Use 'cm showpermissions' para mostrar | |
| los permisos disponibles.) | |
| -overridedenied Anula los permisos denegados. Use una coma para separar | |
| permisos. (Use 'cm showpermissions' para mostrar | |
| los permisos disponibles.) | |
| objectspec Objeto sobre el que configurar los permisos. | |
| Este objeto puede ser uno de los siguientes: | |
| servidor de repositorios, repositorio, rama, etiqueta | |
| o atributo. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de objetos.) | |
| Uso especial para rutas seguras: | |
| cm acl [(--user=<usr_name> | --group=<group_name>) | |
| (-allowed|-denied|-overrideallowed|-overridedenied=+|-<permission>[,...])[,...]] | |
| [--delete] [--branches=[+ | -]<branch>[,...]] | |
| <spec> | |
| --delete Elimina una ruta segura. | |
| Consulte las Notas para más información. | |
| --branches Configura los permisos de una ruta segura a un grupo de | |
| ramas. Use una coma para separar las ramas. | |
| Opcionalmente, cada rama puede ir precedida de un signo | |
| + o - para especificar si la rama debe añadirse o | |
| eliminarse de la lista cuando se está editando. | |
| Consulte las Notas para más información. | |
| spec La ruta segura donde configurar los permisos. | |
| == CMD_HELP_ACL == | |
| La configuración de permisos requiere entender cómo funciona la seguridad en | |
| Unity VCS. Lea la Guía de Seguridad para aprender cómo funcionan estos | |
| permisos: | |
| https://www.plasticscm.com/download/help/securityguide | |
| Notas: | |
| Este comando configura permisos para un usuario o un grupo en los objetos, | |
| repositorios, ramas, etiquetas o rutas de servidor especificados. | |
| Especificaciones de objeto: | |
| (Use 'cm help objectspec' para más información sobre las especificaciones | |
| de objetos.) | |
| El comando acl usa un tipo especial de especificación: rutas seguras. | |
| - Especificación de rutas seguras: | |
| path:server_path[#tag] | |
| Ejemplos: path:/src/foo.c | |
| path:/doc/pdf | |
| path:/doc/pdf#documents | |
| Acciones de permisos: | |
| Use -allowed y -denied para especificar qué permisos aplicar. | |
| Use los argumentos -overrideallowed y -overridedenied para especificar | |
| qué permisos se anulan. | |
| Cada acción requiere una lista de permisos separados por comas. | |
| Nombres de permisos: | |
| Cada nombre de permiso debe ir precedido del símbolo + o -. | |
| El símbolo + aplica el permiso y el símbolo - lo elimina. | |
| Para ver los permisos de un objeto use el comando 'cm showacl'. | |
| Permisos anulados: | |
| Anular un permiso usando --overrideallowed y --overridedenied permite | |
| evitar la herencia de permisos. | |
| Esto es útil para evitar los permisos aplicados a nivel de repositorio o | |
| de servidor. | |
| Por ejemplo: | |
| cm acl --user=vio -allowed=+ci -overrideallowed=+ci br:qa@test | |
| (Permite a la usuaria 'vio' hacer checkin en la rama 'qa' del | |
| repositorio 'test' incluso si ella tiene los permisos denegados a | |
| nivel de repositorio.) | |
| Permisos de rutas de servidor (rutas seguras): | |
| - Se pueden especificar permisos para una ruta de servidor dada. | |
| - Estos permisos se comprueban durante la operación de checkin. | |
| - Estos permisos también se pueden comprobar durante la operación de | |
| update y se pueden usar para evitar que ciertos directorios y ficheros | |
| se descarguen al espacio de trabajo. | |
| - Por cada ítem que se proteja (checkin), el servidor intenta concordar | |
| la ruta del ítem con una ruta segura. Si se encuentra, entonces la | |
| operación de checkin comprueba si el ítem tiene permisos para ser | |
| protegido (checked in). | |
| Los permisos que se pueden definir para una ruta segura son: | |
| ci, change, add, move, rm, read | |
| Si la comprobación de permisos no es satisfactoria para ninguno de los | |
| ítems involucrados, entonces la operación de checkin se revierte. | |
| Para aplicar permisos de rutas seguras a un grupo de ramas, use la | |
| opción --branches. | |
| Por ejemplo: | |
| cm acl --user=jo -denied=+ci path:/src#rule0 --branches=main,main/rel0 | |
| Para editar el ACL asociado a una ruta segura, use el símbolo "#". | |
| Por ejemplo: | |
| cm acl --user=jo -denied=+rm path:/src#rule0 | |
| (Sin "#", la lista de ramas tendría que especificarse de nuevo). | |
| La lista de ramas de una ruta segura se puede editar. | |
| Por ejemplo: | |
| cm acl path:/src#rule0 --branches=-main,+main/rel1 | |
| (Elimina 'main' de la lista y añade 'main/rel1'.) | |
| Para eliminar una ruta segura, use el argumento --delete. | |
| Por ejemplo: | |
| cm acl --user=jo --delete path:/src#rule0 | |
| Herencia: | |
| Herencia es una opción que proviene de los inicios de Plastic SCM 3.0. | |
| Es una opción avanzada pero también obsoleta. | |
| Permite a un objeto heredar los permisos de otro objeto anulando las | |
| relaciones de herencia por defecto. | |
| Use la opción -cut para cortar la cadena de herencia. | |
| Usd la opción -cutncpy para cortar y copiar los permisos heredados. | |
| (Esto está inspirado en los permisos de sistema de Windows donde se | |
| puede cortar herencia pero mantener los permisos actuales.) | |
| La opción -inherit permiter heredar de una especificación de objeto. | |
| Por ejemplo: '-inherit=object_spec' | |
| Ejemplos: | |
| cm acl --user=danipen -denied=+ci rep:core | |
| (Deniega el permiso de checkin al usuario 'danipen' en el repositorio 'core'.) | |
| cm acl --group=developers -allowed=+view,-read -denied=+chgperm br:main | |
| (Otorga el permiso 'view', elimina el permiso 'read' y deniega el permiso | |
| 'chgperm' al grupo 'developers' en la rama 'main'.) | |
| Ejemplos con rutas de servidor: | |
| cm acl --group=devs -denied=+ci path:/server#rel --branches=main,main/2.0 | |
| (Deniega el permiso de checkin al grupo 'devs' para cualquier ruta que | |
| concuerde con '/server' en las ramas 'main' y 'main/2.0'. La etiqueta '#rel' | |
| se crea para poder referirse a ella más adelante.) | |
| cm acl path:/server#rel --branches=-/main,+/main/Rel2.1 | |
| (Actualiza la ruta segura '/server' cuya etiqueta es 'rel', borrando la | |
| rama 'main' y añadiendo la rama 'main/Rel2.1' al grupo de ramas al que la | |
| ruta segura aplica. Teniendo en cuenta el ejemplo anterior, ahora la lista | |
| de ramas contendrá 'main/Rel2.1' y 'main/2.0'.) | |
| cm acl --user=vsanchezm -allowed=-read -overrideallowed=+read path:/doc | |
| (Eliminar el permiso de lectura 'read' a 'vsanchezm' anulándolo en la ruta | |
| '/doc'.) | |
| == CMD_DESCRIPTION_ACTIVATEUSER == | |
| Activa un usuario con licencia. | |
| == CMD_USAGE_ACTIVATEUSER == | |
| Sintaxis: | |
| cm activateuser | au <user-name>[ ...] [--server=<rep-server-spec>] | |
| user-name Nombre o nombres de usuario a activar. Use comillas dobles (" ") | |
| para especificar nombres de usuario que contengan espacios. Use | |
| un espacio en blanco para separar nombres de usuarios. | |
| Opciones: | |
| --server=<rep-server-spec> Activa al usuario en el servidor indicado. | |
| Si no se especifica ningún servidor, el comando | |
| se ejecuta en el servidor por defecto indicado | |
| en el fichero client.conf. | |
| (Use 'cm help objectspec' para más información | |
| sobre las especificaciones de servidores de | |
| repositorios.) | |
| == CMD_HELP_ACTIVATEUSER == | |
| Notas: | |
| Para activar un usuario debe haber sido desactivado previamente. | |
| Por defecto, un usuario se activa por primera vez cuando lleva a cabo una | |
| operación de escritura en Unity VCS. El usuario se activa automáticamente | |
| si no se ha excedido el número máximo de usuarios. | |
| (Use 'cm help deactivateuser' para más información sobre desactivar usuarios | |
| en Unity VCS.) | |
| Examples: | |
| cm activateuser john | |
| cm activateuser david "mary collins" | |
| cm au peter --server=localhost:8087 | |
| == CMD_DESCRIPTION_ADD == | |
| Añade un ítem al control de versiones. | |
| == CMD_USAGE_ADD == | |
| Sintaxis: | |
| cm add [-R | -r | --recursive] [--silent] [--ignorefailed] | |
| [--skipcontentcheck] [--coparent] [--filetypes=<file>] [--noinfo] | |
| [--format=<str-format>] [--errorformat=<str-format>] | |
| <item-path>[ ...] | |
| item-path Ítem o ítems a añadir. Use comillas dobles (" ") para especificar | |
| rutas que contengan espacios. Use un espacio en blanco para | |
| separar rutas de ítems. | |
| Use * para añadir todo el contenido del directorio actual. | |
| Opciones: | |
| -R|-r|--recursive Añade los ítems recursivamente. | |
| --silent No muestra ninguna salida. | |
| --ignorefailed Si un ítem no se puede añadir, la operación de add | |
| continuará sin él. Importante: si un directorio no se | |
| puede añadir, su contenido tampoco se añadirá. | |
| --skipcontentcheck Cuando la extensión no es suficiente para determinar si | |
| el fichero es de texto o binario, se asumirá que es | |
| binario en lugar de usar el contenido para detectar el | |
| tipo. Este funcionamiento se asume para aumentar el | |
| rendimiento en grandes operaciones de checkin. | |
| --coparent Hace checkout al padre del ítem que se va a añadir. | |
| --filetypes Fichero con los tipos de ficheros a usar. Consulte el | |
| siguiente enlace para más información: | |
| http://blog.plasticscm.com/2008/03/custom-file-types.html | |
| --noinfo No muestra información de progreso. | |
| --format Muestra el mensaje de salida con el formato indicado. | |
| Consulte los ejemplos para más información. | |
| --errorformat Muestra el mensaje de error (si existe) con el formato | |
| indicado. Consulte los ejemplos para más información. | |
| == CMD_HELP_ADD == | |
| Notas: | |
| Requisitos para añadir ítems: | |
| - El directorio padre del ítem a añadir debe haber sido añadido previamente. | |
| Lectura desde stdin: | |
| El comando 'add' puede leer rutas desde stdin. Para ello, pase como | |
| argumento un guión "-". | |
| Por ejemplo: cm add - | |
| Las rutas se leerán hasta que se introduzca una línea en blanco. | |
| Este tipo de lectura permite usar una tubería (pipe) para especificar qué | |
| ficheros se van a añadir. | |
| Por ejemplo: | |
| dir /S /B *.c | cm add - | |
| (En Windows, añade todos los ficheros del workspace con extensión .c.) | |
| Ejemplos: | |
| cm add file1.txt file2.txt | |
| (Añade los ítems file1.txt y file2.txt.) | |
| cm add c:\workspace\file.txt | |
| (Añade el ítem file.txt en la ruta c:\workspace.) | |
| cm add -R c:\workspace\src | |
| (Añade recursivamente el contenido de la ruta src.) | |
| cm add -R * | |
| (Añade recursivamente todo el contenido del directorio actual.) | |
| cm add -R * --filetypes=filetypes.conf | |
| (Añade recursivamente todo el contenido del directorio actual usando el | |
| fichero 'filetypes.conf' para asignar un tipo a cada fichero basándose en su | |
| extensión en lugar de en el contenido.) | |
| cm add --coparent c:\workspace\dir\file.txt | |
| (Añade el fichero 'file.txt' y hace checkout a 'dir'.) | |
| cm add -R * --format="ADD {0}" --errorformat="ERR {0}" | |
| (Añade recursivamente todo el contenido del directorio actual y muestra por | |
| pantalla 'ADD <item>' para cada archivo añadido y 'ERR <item>' para cada | |
| archivo que no se pudo añadir.) | |
| == CMD_USAGE_ADDIGNOREPATTERN == | |
| Uso: | |
| cm addignorepattern <pattern>[ ...] | |
| [--workspace=<wkpath> | --allworkspaces] [--remove] | |
| == CMD_DESCRIPTION_ADMIN == | |
| Ejecuta comandos de administración en el servidor. | |
| == CMD_USAGE_ADMIN == | |
| Sintaxis: | |
| cm admin <command> [options] | |
| Comandos: | |
| readonly | |
| Para obtener más información de cada uno de los comandos use lo siguiente: | |
| cm admin <command> --usage | |
| cm admin <command> --help | |
| == CMD_HELP_ADMIN == | |
| Notas: | |
| Sólo el administrador del servidor puede ejecutar comandos de administración. | |
| Ejemplos: | |
| cm admin readonly enter | |
| cm admin readonly status | |
| == CMD_DESCRIPTION_ADMIN_READONLY == | |
| Habilita/deshabilita el modo solo lectura del servidor. | |
| == CMD_USAGE_ADMIN_READONLY == | |
| Sintaxis: | |
| cm admin readonly (enter | leave | status) [<server>] | |
| Acciones: | |
| enter Habilita el modo solo lectura en el servidor. Las operaciones de | |
| escritura se rechazan. | |
| leave Deshabilita el modo solo lectura en el servidor. | |
| status Muestra el estado del modo solo lectura en el servidor. | |
| Opciones: | |
| server Ejecuta el comando en el servidor indicado (servidor:puerto). (Use | |
| 'cm help objectspec' para más información sobre las especificaciones | |
| de servidor.) | |
| Si no se especifica ningún servidor, el comando actúa en el servidor | |
| del espacio de trabajo actual. | |
| Si la ruta actual no corresponde a un espacio de trabajo, el comando | |
| actúa sobre el servidor por defecto indicado en el fichero client.conf. | |
| == CMD_HELP_ADMIN_READONLY == | |
| Notas: | |
| Solo el administrador del servidor puede configurarlo como solo lectura. | |
| Ejemplos: | |
| cm admin readonly enter diana:8086 | |
| cm admin readonly leave | |
| == CMD_DESCRIPTION_ANNOTATE == | |
| Muestra el changeset donde se modificó por última vez y por quién cada línea de | |
| un fichero. | |
| == CMD_USAGE_ANNOTATE == | |
| Sintaxis: | |
| cm annotate | blame <spec>[ ...] | |
| [--format=<str_format>] | |
| [--comparisonmethod=(ignoreeol | ignorewhitespaces | |
| | ignoreeolandwhitespaces | recognizeall)] | |
| [--dateformat=<str_date_format>] | |
| [--encoding=<name>] | |
| [--stats] | |
| [--repository=<repspec>] | |
| spec Especificación del fichero que se va a anotar. | |
| (Use 'cm help objectspec' para obtener más información sobre | |
| especificaciones.) | |
| Use comillas dobles (" ") para especificar rutas que contengan | |
| espacios. | |
| Opciones: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --comparisonmethod Configura el método de comparación indicado. | |
| Consulte las Notas para más información. | |
| --dateformat Configura el formato de salida para la impresión de fechas. | |
| --encoding Especifica el encoding que se usará en la salida, por | |
| ejemplo, utf-8. Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y su | |
| formato (al final de la página en la columna "Name"). | |
| --stats Muestra estadísticas. | |
| --repository Especifica el repositorio a usar para calcular las | |
| anotaciones. Por defecto, se usa el repositorio del | |
| workspace cuya revisión está cargada. (Use | |
| 'cm help objectspec' para más información sobre las | |
| especificaciones de repositorio.) | |
| == CMD_HELP_ANNOTATE == | |
| Notas: | |
| Los ítems de tipo binario no pueden ser anotados. | |
| Métodos de comparación (opción --comparisonmethod): | |
| ignoreeol Ignora diferencias en final de línea. | |
| ignorewhitespaces Ignora diferencias en espacios. | |
| ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios. | |
| recognizeall Detecta diferencias en final de línea y espacios. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {owner} Usuario que hizo el último cambió en la línea. | |
| {rev} Especificación de la revisión de la línea. | |
| {content} Contenido de la línea. | |
| {date} Fecha de checkin de la línea. | |
| {comment} Comentario de la revisión de la línea. | |
| {changeset} Changeset de la revisión de la línea. | |
| {line} Número de línea del fichero. | |
| {id} Identificador del ítem. | |
| {parentid} Identificador del padre del ítem. | |
| {rep} Repositorio del ítem. | |
| {branch} Rama de la revisión de la línea. | |
| {ismergerev} Si la revisión de la línea se creó en un merge. | |
| --dateformat: | |
| Para especificar el formato en el que se escribirán las fechas en pantalla. | |
| Consulte los formatos soportados: | |
| https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings | |
| --repository: | |
| Para devolver los datos de un repositorio remoto. Esto es útil cuando se | |
| trabaja con escenarios distribuidos. | |
| Ejemplos: | |
| cm blame c:\workspace\src --comparisonmethod=ignoreeolandwhitespaces --encoding=utf-8 | |
| cm annotate c:\workspace\file.txt --comparisonmethod=ignoreeol | |
| cm annotate c:\workspace\file.txt --format="{owner} {date, 10} {content}" | |
| (Muestra el usuario que hizo el último cambio, un espacio, la fecha alineada | |
| a la derecha, un espacio y el contenido de la línea.) | |
| cm blame c:\workspace\file.txt --format="{owner, -7} {comment} {date}" \ | |
| --dateformat=yyyyMMdd | |
| (Muestra en 7 espacios (y alineado a la izquierda) el usuario que hizo el | |
| último cambio, un espacio, el comentario seguido de otro espacio y la fecha | |
| formateada (por ejemplo, 20170329).) | |
| cm annotate c:\workspace\file.txt --repository=centralRep@myserver:8084 | |
| cm blame serverpath:/src/client/checkin/Checkin.cs#cs:73666 | |
| (Muestra las anotaciones del fichero (usando una especificacion de ruta de | |
| servidor) comenzando por el changeset 73666.) | |
| == CMD_DESCRIPTION_APPLY_LOCAL == | |
| Busca cambios locales (movidos localmente, borrados localmente y modificados | |
| localmente) y los aplica para que Unity VCS pueda monitorizarlos. | |
| == CMD_USAGE_APPLY_LOCAL == | |
| Sintaxis: | |
| cm applylocal | al [--dependencies] [<item_path>[ ...]] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| Opciones: | |
| --dependencies Añade las dependencias de cambios locales a los ítems | |
| a aplicar. | |
| item_path Ítems a aplicar. Use comillas dobles (" ") | |
| para especificar rutas que contengan espacios. Use un | |
| espacio en blanco para separar rutas de ítems. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_APPLY_LOCAL == | |
| Notas: | |
| - Si no se especifican las opciones --dependencies y <item_path>, la operación | |
| involucra a todos los cambios locales en el espacio de trabajo. | |
| - Siempre se aplican recursivamente desde la ruta indicada. | |
| Ejemplos: | |
| cm applylocal foo.c bar.c | |
| cm applylocal . | |
| (Aplica todos los cambios locales del directorio actual.) | |
| cm applylocal | |
| (Aplica todos los cambios locales del espacio de trabajo.) | |
| cm applylocal --machinereadable | |
| (Aplica todos los cambios locales del espacio de trabajo y muestra por | |
| pantalla el resultado en un formato simple y fácil de parsear.) | |
| cm applylocal --machinereadable --startlineseparator=">" \ | |
| --endlineseparator="<" --fieldseparator="," | |
| (Aplica todos los cambios locales del espacio de trabajo y muestra por | |
| pantalla el resultado en un formato simple y fácil de parsear, comenzando y | |
| terminando cada línea con los separadores indicados y separando los campos | |
| de cada línea con el separador también indicado.) | |
| == CMD_DESCRIPTION_ARCHIVE == | |
| Almacena datos en almacenamiento externo. | |
| == CMD_USAGE_ARCHIVE == | |
| Sintaxis: | |
| cm archive | arch <revspec>[ ...] [-c=<str_comment>] | |
| [--file=<base_file>] | |
| (Extrae datos del repositorio y los almacena en un almacenamiento externo.) | |
| cm archive | arch <revspec>[ ...] --restore | |
| (Restaura al repositorio datos previamente almacenados.) | |
| revspec Una o más especificaciones de revisión.(Use 'cm help objectspec' | |
| para más información sobre especificaciones de revisiones.) | |
| --restore Restaura desde los ficheros generados durante el almacenamiento | |
| los datos previamente almacenados. El almacenamiento externo y | |
| el fichero externaldata.conf tienen que estar disponibles en el | |
| momento de la restauración de la revisión. Consulte las Notas | |
| para más información. | |
| Opciones: | |
| -c Aplica un comentario en los ficheros de almacenamiento que | |
| se van a crear. | |
| --file Prefijo y ruta (opcional) de los nuevos ficheros de | |
| almacenamiento de datos. | |
| == CMD_HELP_ARCHIVE == | |
| Notas: | |
| Este comando extrae datos del repositorio y los almacena en un almacenamiento | |
| externo, ahorrando así espacio en la base de datos. | |
| El comando también restaura (--restore) las revisiones que previamente | |
| fueron archivadas para volverlas a introducir en el repositorio. | |
| Use 'cm help objectspec' para saber más sobre especificaciones de revisiones. | |
| El usuario que ejecute este comando debe ser administrador del servidor | |
| de Unity VCS (propietario del servidor de repositorios) para que se le | |
| permita completar la operación. | |
| Cada segmento de datos de las revisiones especificadas se almacenará en | |
| un fichero diferente cuyo nombre comenzará por el texto definido en el | |
| argumento --file. Este argumento puede ser un path completo incluyendo un | |
| prefijo o únicamente el prefijo. | |
| Una vez archivados los datos de las revisiones, se podrá acceder a ellos | |
| de dos maneras: | |
| 1. Desde el cliente: El cliente de Unity VCS detectará si los datos fueron | |
| fueron archivados y pedirá al usuario que indique la ubicación de los | |
| ficheros. | |
| El usuario configurará las ubicaciones de almacenamiento externo en un | |
| fichero llamado externaldata.conf. El fichero se creará en las ubicaciones | |
| estándar donde se encuentran los ficheros de configuración y siguiendo las | |
| mismas reglas que se aplican para el fichero client.conf. El fichero | |
| externaldata.conf contendrá las rutas en los que se encuentren los datos | |
| archivados. | |
| 2. Desde el servidor: Con este método, los usuarios no tienen que saber si | |
| los datos han sido archivados o no ya que las peticiones se resuelven de | |
| forma transparente por el servidor. Para ello, el administrador creará un | |
| fichero llamado externaldata.conf en el directorio del servidor e | |
| introducirá las rutas donde se archivaron los datos. | |
| Para restaurar (restore) los datos de una revisión (o conjunto de | |
| revisiones), el cliente tiene que poder acceder a los ficheros donde los | |
| datos se almacenaron. Por tanto, no es posible restaurar datos que estén | |
| siendo resueltos por el servidor (método 2) porque el cliente no podrá | |
| identificarlos como archivados. | |
| Para restaurar usando el método 2, el administrador tiene que editar el | |
| fichero externaldata.conf en el servidor para eliminar el acceso a los | |
| ficheros archivados para que puedan ser restaurados. | |
| Ejemplo para archivar: | |
| 1) Archivar una revisión: | |
| cm archive Assets/RoofTextures/Textures/Wooden_Roof_05.png --file=/Users/ruben/archive/battle | |
| 2) Es posible comprobar la revisión archivada en la ruta especificada: | |
| ls -al /Users/ruben/archive/battle* | |
| -rw-r--r-- 1 ruben staff 2220039 Nov 9 10:52 /Users/ruben/archive/battle-100280-167 | |
| Ejemplo para restaurar: | |
| 1) Añadir la ruta de almacenamiento al fichero externaldata.conf: | |
| vi /Users/ruben/.plastic4/externaldata.conf | |
| /Users/ruben/archive | |
| 2) Restaurar la revisión: | |
| cm archive Assets/RoofTextures/Textures/Wooden_Roof_05.png --restore | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Lectura desde stdin: | |
| El comando 'archive' puede leer rutas desde stdin. Para ello, pase como | |
| argumento un guión "-". | |
| Por ejemplo: cm archive - | |
| Las rutas se leerán hasta que se introduzca una línea en blanco. | |
| Este tipo de lectura permite usar una tubería (pipe) para especificar qué | |
| ficheros se van a almacenar (archive). | |
| Por ejemplo: | |
| dir /S /B *.c | cm archive --all - | |
| (En Windows, almacena (archive) todos los ficheros del workspace con | |
| extensión .c.) | |
| Ejemplos: | |
| cm archive bigfile.zip#br:/main | |
| (Almacena la última revisión de 'bigfile.zip' en la rama 'main'.) | |
| cm archive bigfile.zip#br:/main --restore | |
| (Restaura la revisión almacenada.) | |
| cm archive rev:myfile.pdf#cs:2 -c="big pdf file" --file=c:\arch_files\arch | |
| (Archiva la revisión del changeset 2 de myfile.pdf en la carpeta | |
| 'c:\archived_files'. El nombre del fichero de almacenamiento comenzará con | |
| 'arch' (por ejemplo, arch_11_56).) | |
| cm find "revs where size > 26214400" --format="{item}#{branch}" \ | |
| --nototal | cm archive -c="volume00" --file="volume00" - | |
| (Archiva todos los ficheros de tamaño mayor de 25Mb en ficheros de | |
| almacenamiento cuyo nombre empiece por 'volume00'.) | |
| == CMD_DESCRIPTION_ATTRIBUTE == | |
| Permite al usuario administrar atributos. | |
| == CMD_USAGE_ATTRIBUTE == | |
| Sintaxis: | |
| cm attribute | att <command> [options] | |
| Comandos: | |
| create | mk | |
| delete | rm | |
| set | |
| unset | |
| rename | |
| edit | |
| Para obtener más información de cada uno de los comandos use lo siguiente: | |
| cm attribute <command> --usage | |
| cm attribute <command> --help | |
| == CMD_HELP_ATTRIBUTE == | |
| Ejemplos: | |
| cm attribute create status | |
| cm attribute set att:status br:/main/SCM105 open | |
| cm attribute unset att:status br:/main/SCM105 | |
| cm attribute delete att:status | |
| cm attribute rename att:status "buildStatus" | |
| cm attribute edit att:status "Status of the task in the CI pipeline" | |
| == CMD_DESCRIPTION_CHANGELIST == | |
| Agrupa los cambios pendientes en listas de cambios (changelists). | |
| == CMD_USAGE_CHANGELIST == | |
| Sintaxis: | |
| a) Manejo de los objetos 'changelist': | |
| cm changelist | clist [--symlink] | |
| (Muestra todas las listas de cambios.) | |
| cm changelist | clist create <clist_name> | |
| [<clist_desc>] [--persistent | --notpersistent] [--symlink] | |
| (Crea una lista de cambios.) | |
| cm changelist | clist delete <clist_name> [--symlink] | |
| (Borra la lista de cambios indicada. Si dicha lista contiene cambios | |
| pendientes, estos se moverán a lista de cambios 'default'.) | |
| cm changelist | clist edit <clist_name> [<action_name> <action_value>] | |
| [--persistent | --notpersistent] [--symlink] | |
| (Edita la lista de cambios indicada.) | |
| b) Manejo del contenido de un 'changelist': | |
| cm changelist | clist <clist_name> (add | rm) <path_name>[ ...] | |
| [--symlink] | |
| (Edita la lista de cambios indicada y añade (add) o quita (rm) los cambios | |
| que concuerden con la ruta especificada. Use un espacio en blanco para | |
| separar rutas. Use comillas dobles (" ") para especificar rutas que | |
| contengan espacios. El estado de las rutas debe ser 'Added' o | |
| 'Checked-out'.) | |
| Opciones: | |
| clist_name El nombre de la lista de cambios (changelist). Se puede | |
| usar la ruta a un archivo que contenga el nombre en su | |
| lugar. Más información en --namefile. | |
| clist_desc La descripción de la lista de cambios. Se puede usar la | |
| ruta a un archivo que contenga el nombre en su lugar. | |
| Más información en --descriptionfile. | |
| action_name Seleccione 'rename' o 'description' para modificar un | |
| changelist. | |
| action_value Aplica el nuevo cambio o la nueva descripción al editar | |
| la lista de cambios. | |
| --persistent La lista de cambios permanecerá en el espacio de trabajo | |
| aun cuando los cambios en ella se hayan protegido | |
| (checked-in) o deshecho. | |
| --notpersistent (Por defecto.) La lista de cambios no permanecerá en el | |
| espacio de trabajo cuando los cambios en ella se protejan | |
| (checked-in) o se deshagan. | |
| --symlink Aplica la operación al symlink pero no al destino | |
| (target). | |
| --namefile Una ruta válida al archivo que contiene el nombre de la | |
| lista de cambios. El archivo debe existir en esa ruta, debe | |
| contener algo de texto y no puede contener saltos de línea. | |
| --newnamefile Una ruta válida al archivo que contiene el nuevo nombre de | |
| la lista de cambios cuando se edita para renombrar. El | |
| archivo debe existir en esa ruta, debe de contener algo de | |
| texto y no puede contener saltos de línea. | |
| --descriptionfile Una ruta válida al archivo que contiene la descripción deseada | |
| para la lista de cambios. El archivo debe existir en esa ruta. | |
| == CMD_HELP_CHANGELIST == | |
| Notas: | |
| El comando 'changelist' gestiona tanto las listas de cambios pendientes del | |
| espacio de trabajo como los cambios dentro de la lista. | |
| Ejemplos: | |
| cm changelist | |
| (Muestra las listas de cambios del espacio de trabajo actual.) | |
| cm changelist create config_changes "dotConf files" --persistent | |
| (Crea una nueva lista de cambios llamada 'config_changes' con descripción | |
| 'dotConf files' que permanecerá en el espacio de trabajo después de que sus | |
| cambios se hayan protegido (checked-in) o deshecho.) | |
| cm changelist create --namefile="name.txt" --descriptionfile="desc.txt" | |
| (Crea una nueva lista de cambios cuyo nombre y descripción son tomados de | |
| archivos.) | |
| cm changelist edit config_changes rename config_files --notpersistent | |
| (Edita la lista de cambios 'config_changes' renombrándola a 'config_files' | |
| y haciéndola no persistente.) | |
| cm changelist edit config_changes --notpersistent | |
| (Edita la lista de cambios 'config_changes' haciéndola no persistente.) | |
| cm changelist delete config_files | |
| (Elimina la lista de cambios 'config_files' del espacio de trabajo actual.) | |
| cm changelist delete --namefile="name.txt" | |
| (Elimina la lista de cambios identificada por el nombre contenido en 'name.txt' | |
| del espacio de trabajo actual.) | |
| cm changelist config_files add foo.conf | |
| (Añade el fichero 'foo.conf' a la lista de cambios 'config_files'.) | |
| cm changelist config_files rm foo.conf readme.txt | |
| (Elimina los ficheros 'foo.conf' y 'readme.txt' de la lista de cambios | |
| 'config_files' y los mueve la lista de cambios por defecto del sistema.) | |
| cm changelist edit --namefile="name.txt" description --descriptionfile="desc.txt" | |
| (Edita la lista de cambios identificada por el nombre contenido en 'name.txt', cambiando | |
| su descripción por el contenido del archivo 'desc.txt'.) | |
| cm changelist edit --namefile="name.txt" rename --newnamefile="newname.txt" | |
| (Edita la lista de cambios identificada por el nombre contenido en 'name.txt' file, | |
| renombrándola por el contenido del archivo 'newname.txt'.) | |
| == CMD_DESCRIPTION_CHANGESET == | |
| Ejecuta operaciones avanzadas sobre changesets. | |
| == CMD_USAGE_CHANGESET == | |
| Sintaxis: | |
| cm changeset <command> [options] | |
| Comandos: | |
| move | mv | |
| delete | rm | |
| editcomment | edit | |
| Para obtener más información de cada uno de los comandos use lo siguiente: | |
| cm changeset <command> --usage | |
| cm changeset <command> --help | |
| == CMD_HELP_CHANGESET == | |
| Ejemplos: | |
| cm changeset move cs:15@myrepo br:/main/scm005@myrepo | |
| cm changeset delete cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData | |
| == CMD_DESCRIPTION_CHANGESET_EDIT_COMMENT == | |
| Modifica el comentario de un changeset. | |
| == CMD_USAGE_CHANGESET_EDIT_COMMENT == | |
| Sintaxis: | |
| cm changeset editcomment | edit <csetspec> <new_comment> | |
| Opciones: | |
| csetspec El changeset cuyo comentario se va a editar. (Use | |
| 'cm help objectspec' para más información sobre | |
| especificaciones de changesets.) | |
| new_comment El nuevo comentario que se aplicará al changeset indicado. | |
| == CMD_HELP_CHANGESET_EDIT_COMMENT == | |
| Notas: | |
| - La especificación del changeset debe ser válida. | |
| Ejemplos: | |
| cm changeset editcomment cs:15@myrepo "I forgot to add the checkin details" | |
| cm changeset edit cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \ | |
| "This comment text will replace the previous one." | |
| cm changeset edit "89095131-895d-4173-9440-ff9ef9b2538d@project@cloud" \ | |
| "Changing my comment" | |
| == CMD_DESCRIPTION_CHANGESET_MOVE == | |
| Mueve un changeset y todos sus descendientes a otra rama. | |
| == CMD_USAGE_CHANGESET_MOVE == | |
| Sintaxis: | |
| cm changeset move | mv <csetspec> <branchspec> | |
| Opciones: | |
| csetspec El primer changeset que debe moverse a una rama | |
| diferente. Todos los changeset descendientes en la | |
| misma rama se moverán también. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de changesets.) | |
| branchspec La rama destino a la que mover los changesets | |
| seleccionados. Debe estar vacía o no existir. En caso | |
| de no existir, el comando la creará. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de ramas.) | |
| == CMD_HELP_CHANGESET_MOVE == | |
| Notas: | |
| - La especificación del changeset debe ser válida. | |
| - La rama de destino debe estar vacía o no existir. | |
| - Si la rama de destino no existe, el comando la creará. | |
| - Los enlaces de merge no se verán afectados dado que las ramas no están | |
| involucradas en ellos. | |
| Ejemplos: | |
| cm changeset move cs:15@myrepo br:/main/scm005@myrepo | |
| cm changeset move cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a br:/hotfix/TL-352 | |
| == CMD_DESCRIPTION_CHANGESET_DELETE == | |
| Elimina un changeset del repositorio. | |
| == CMD_USAGE_CHANGESET_DELETE == | |
| Sintaxis: | |
| cm changeset delete | rm <csetspec> | |
| Opciones: | |
| csetspec El changeset a eliminar. Debe cumplir con una serie de | |
| condiciones. Consulte las Notas para más información. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de changesets.) | |
| == CMD_HELP_CHANGESET_DELETE == | |
| Notas: | |
| - El changeset debe ser el último en su rama. | |
| - El changeset no puede ser el padre de otro changeset. | |
| - El changeset no debe ser origen de un merge ni formar parte de un intervalo | |
| de merge. | |
| - El changeset no tiene que tener ninguna etiqueta. | |
| - El changeset no puede ser el changeset raíz (cs:0). | |
| Ejemplos: | |
| cm changeset rm cs:4525@myrepo@myserver | |
| cm changeset delete cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a | |
| == CMD_DESCRIPTION_CHANGEUSERPASSWORD == | |
| Cambia el password del usuario (UP). | |
| == CMD_USAGE_CHANGEUSERPASSWORD == | |
| Sintaxis: | |
| cm changepassword | passwd | |
| == CMD_HELP_CHANGEUSERPASSWORD == | |
| Notas: | |
| Este comando está disponible solo si la configuración de seguridad es UP | |
| (user/password). | |
| Lea la Guía del Administrador para más información: | |
| https://www.plasticscm.com/download/help/adminguide | |
| Las contraseñas antigua y nueva son obligatorias. | |
| Ejemplo: | |
| cm passwd | |
| == CMD_DESCRIPTION_CHECKCONNECTION == | |
| Comprueba la conexión con el servidor. | |
| == CMD_USAGE_CHECKCONNECTION == | |
| Sintaxis: | |
| cm checkconnection | cc | |
| == CMD_HELP_CHECKCONNECTION == | |
| Notas: | |
| - Este comando devuelve un mensaje indicando si existe una conexión válida | |
| con el servidor de Unity VCS configurado. | |
| - El comando comprueba la compatibilidad de versiones con el servidor. | |
| - El comando también comprueba si el usuario configurado es válido o no. | |
| == CMD_DESCRIPTION_CHECKDB == | |
| Comprueba la integridad de los repositorios. | |
| == CMD_USAGE_CHECKDB == | |
| Sintaxis: | |
| cm checkdatabase | chkdb [<repserverspec> | <repspec>] | |
| Options: | |
| repserverspec Servidor de repositorios. | |
| repspec Repositorio. | |
| (Use 'cm help objectspec' para más información sobre especificaciones de | |
| servidor de repositorios y repositorio..) | |
| == CMD_HELP_CHECKDB == | |
| Notas: | |
| - Si no se indica ninguna especificación (de servidor de repositorios o de | |
| repositorio), la comprobación se hará sobre el servidor indicado en el | |
| fichero client.conf. | |
| Ejemplos: | |
| cm checkdatabase repserver:localhost:8084 | |
| cm chkdb rep:default@localhost:8084 | |
| == CMD_DESCRIPTION_CHECKIN == | |
| Guarda (protege) los cambios en el repositorio. | |
| == CMD_USAGE_CHECKIN == | |
| Sintaxis: | |
| cm checkin | ci [<item_path>[ ...]] | |
| [-c=<comentario> | -commentsfile=<fichero_comentario>] | |
| [--all|-a] [--applychanged] [--private] [--update] [--symlink] | |
| [--noshowchangeset] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| Opciones: | |
| item_path Ítems a guardar (checkin). Use comillas dobles (" ") | |
| para especificar rutas que contengan espacios. Use un | |
| espacio en blanco para separar rutas de ítems. | |
| Use . para hacer checkin al directorio actual. | |
| -c Asigna el comentario indicado al changeset que se crea | |
| en el checkin. | |
| -commentsfile Asigna el comentario especificado en el fichero al | |
| changeset que se crea en el checkin. | |
| --all | -a Incluye en el checkin los ítems de las rutas indicadas | |
| que han sido cambiados, movidos y borrados localmente. | |
| --applychanged Incluye en el checkin los ítems cambiados y los | |
| desprotegidos (checked-out). | |
| --private Incluye en el checkin los ítems privados. | |
| --update Procesa automáticamente un update-merge si fuera | |
| necesario. | |
| --symlink Incluye en el checkin al symlink pero no al destino | |
| (target). | |
| --noshowchangeset No muestra el changeset resultante. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_CHECKIN == | |
| Notas: | |
| - Si no se especifica ningún <item_path>, el checkin afecta a todos los | |
| cambios pendientes en el workspace. | |
| - El checkin siempre se aplica recursivamente desde la ruta especificada. | |
| - Para proteger (checkin) un ítem: | |
| - El ítem tiene que estar controlado (checked-in). | |
| - Si el ítem es privado (no está controlado), es necesario indicar el | |
| argumento --private para poder protegerlo (checkin). | |
| - El ítem tiene que estar desprotegido (checked-out). | |
| - Si el ítem ha cambiado pero no está desprotegido (no checked-out), no es | |
| necesario indicar el argumento --applychanged a no ser que <item_path> | |
| sea un directorio o contenga wildcards ('*'). | |
| El contenido de la revisión a proteger (checkin) debería ser diferente de la | |
| revisión anterior. | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Lectura desde stdin: | |
| El comando 'checkin' puede leer rutas desde stdin. Para ello, pase como | |
| argumento un guión "-". | |
| Por ejemplo: cm checkin - | |
| Las rutas se leerán hasta que se introduzca una línea en blanco. | |
| Este tipo de lectura permite usar una tubería (pipe) para especificar qué | |
| ficheros se van a proteger (checkin). | |
| Por ejemplo: | |
| dir /S /B *.c | cm checkin --all - | |
| (En Windows, protege (checkin) todos los ficheros del workspace con | |
| extensión .c.) | |
| Ejemplos: | |
| cm checkin file1.txt file2.txt | |
| (Protege (checkin) los ficheros desprotegidos (checked-out) 'file1.txt' y | |
| 'file2.txt'.) | |
| cm checkin . -commentsfile=micomentario.txt | |
| (Protege (checkin) el directorio actual y aplica el comentario incluido en | |
| el fichero 'mycomment.txt'.) | |
| cm checkin link --symlink | |
| (Protege (checkin) el fichero symlink y no el destino (target).) | |
| cm ci file1.txt -c="my comment" | |
| (Protege (checkin) el fichero 'file1.txt' y aplica el comentario.) | |
| cm status --short --compact --changelist=pending_to_review | cm checkin - | |
| (Obtiene los ítems de la lista de cambios (changelist) 'pending_to_review' y | |
| las redirecciona como entrada al comando checkin para protegerlos.) | |
| cm ci . --machinereadable | |
| (Protege (checkin) el directorio actual y muestra por pantalla el resultado | |
| en un formato simple y fácil de parsear.) | |
| cm ci . --machinereadable --startlineseparator=">" --endlineseparator="<" --fieldseparator="," | |
| (Protege (checkin) el directorio actual y muestra por pantalla el resultado | |
| en un formato simple y fácil de parsear, comenzando y terminando cada línea | |
| con los separadores indicados y separando los campos de cada línea con el | |
| separador también indicado.) | |
| == CMD_DESCRIPTION_CHECKOUT == | |
| Marca los ficheros para ser modificados (desprotege). | |
| == CMD_USAGE_CHECKOUT == | |
| Sintaxis: | |
| cm checkout | co [<item_path>[ ...]] [-R | -r | --recursive] | |
| [--format=<str_format>] | |
| [--errorformat=<str_format>] [--resultformat=<str_format>] | |
| [--silent] [--symlink] [--ignorefailed] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| Opciones: | |
| item_path Ítems a desproteger (checkout). Use comillas dobles (" ") | |
| para especificar rutas que contengan espacios. Use un | |
| espacio en blanco para separar rutas de ítems. | |
| Use . para hacer checkout al directorio actual. | |
| -R Desprotege (checkout) los ficheros recursivamente. | |
| --format Muestra el progreso en la salida con el formato | |
| indicado. Consulte los ejemplos para más información. | |
| --resultformat Muestra el resultado en la salida con el formato | |
| indicado. Consulte los ejemplos para más información. | |
| --silent No muestra nada en la salida. | |
| --symlink Incluye en el checkout al symlink pero no al destino | |
| (target). | |
| --ignorefailed Si no se puede hacer un checkout exclusivo (bloqueo) | |
| de un ítem, el checkout continuará sin él. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_CHECKOUT == | |
| Notas: | |
| Para desproteger (checkout) un ítem: | |
| - El ítem tiene que estar controlado (bajo control de versiones) | |
| - El ítem debe estar protegido (checked-in). | |
| Si los bloqueos están configurados en el servidor (existe el fichero | |
| lock.conf), cada vez que se produza un checkout en un ítem, Unity VCS | |
| comprueba si se cumple alguna de las reglas de bloqueo. Si se cumple, el | |
| ítem se bloqueará (checkout exclusivo) y nadie podrá hacer otro checkout. | |
| Para conocer los bloqueos que existen en cualquier momento en el servidor | |
| usa el comando 'cm lock list'. | |
| Lea la Guía del Administrador para más información: | |
| https://www.plasticscm.com/download/help/adminguide | |
| El texto en el argumento --format reemplaza a la variable '{0}' del ítem que | |
| se va a desproteger (checkout). Consulte los ejemplos para más información. | |
| Lectura desde stdin: | |
| El comando 'checkout' puede leer rutas desde stdin. Para ello, pase como | |
| argumento un guión "-". | |
| Por ejemplo: cm checkout - | |
| Las rutas se leerán hasta que se introduzca una línea en blanco. | |
| Este tipo de lectura permite usar una tubería (pipe) para especificar qué | |
| ficheros se van a desproteger (checkout). | |
| Por ejemplo: | |
| dir /S /B *.c | cm checkout --all - | |
| (En Windows, desprotege (checkout) todos los ficheros del workspace con | |
| extensión .c.) | |
| Ejemplos: | |
| cm checkout file1.txt file2.txt | |
| (Desprotege (checkout) los ficheros 'file1.txt' y 'file2.txt'.) | |
| cm co *.txt | |
| (Desprotege (checkout) todos los ficheros con extensión .txt.) | |
| cm checkout . | |
| (Desprotege (checkout) el directorio actual.) | |
| cm checkout -R c:\workspace\src | |
| (Desprotege (checkout) recursivamente el contenido de la carpte 'src'.) | |
| cm co file.txt --format="Checking out item {0}" | |
| --resultformat="Item {0} checked out" | |
| (Desprotege (checkout) el fichero 'file.txt' y usa un formato determinado | |
| para mostrar el progreso de la operación y el resultado.) | |
| cm checkout link --symlink | |
| (Desprotege (checkout) el fichero symlink y no el destino (target).) | |
| cm checkout . -R --ignorefailed | |
| (Desprotege (checkou) recursivamente el directorio actual ignorando aquellos | |
| ficheros que no se pueden desproteger.) | |
| cm co . --machinereadable --startlineseparator=">" | |
| (Desprotege (checkout) el directorio actual y muestra por pantalla el | |
| resultado en un formato simple y fácil de parsear, comenzando cada línea con | |
| el separador indicado.) | |
| == CMD_DESCRIPTION_CHECKSELECTORSYNTAX == | |
| Comprueba la sintaxis de un selector. | |
| == CMD_USAGE_CHECKSELECTORSYNTAX == | |
| Sintaxis: | |
| cm checkselectorsyntax | css --file=<selector_file> | |
| (Comprueba la sintaxis del fichero del selector.) | |
| cat <selector_file> | cm checkselectorsyntax | css - | |
| (Unix. Comprueba el fichero del selector desde la entrada estándar.) | |
| type <selector_file> | cm checkselectorsyntax | css - | |
| (Windows. Comprueba el fichero del selector desde la entrada estándar.) | |
| --file Fichero desde el que leer el selector. | |
| == CMD_HELP_CHECKSELECTORSYNTAX == | |
| Notas: | |
| Este comando lee el selector tanto de un fichero o de la entrada estándar, y | |
| comprueba su sintaxis. Si esta comprobación falla, los motivos de este fallo | |
| se mostrarán por la salida estándar. | |
| Ejemplos: | |
| cm checkselectorsyntax --file=myselector.txt | |
| (Comprueba la sintaxis del fichero 'myselector.txt'.) | |
| cat myselector.txt | cm checkselectorsyntax | |
| (Comprueba la sintaxis del fichero 'myselector.txt' desde la entrada estándar.) | |
| == CMD_DESCRIPTION_CHGREVTYPE == | |
| Cambia el tipo de revisión (binario o texto) de un ítem. | |
| == CMD_USAGE_CHGREVTYPE == | |
| Sintaxis: | |
| cm changerevisiontype | chgrevtype | crt <item_path>[ ...] --type=(bin | txt) | |
| item_path Ítems a los que cambiar el tipo de revisión. Use comillas | |
| dobles (" ") para especificar rutas que contengan | |
| espacios. Use un espacio en blanco para separar rutas de | |
| ítems. | |
| --type Tipo de revisión: 'bin' (binario) o 'txt' (texto). | |
| == CMD_HELP_CHGREVTYPE == | |
| Notas: | |
| Este comando solo se puede aplicar a ficheros y no a directorios. | |
| El tipo especificado debe ser uno de los soportados por el sistema: 'bin' | |
| (binario) o 'txt' (texto). | |
| Ejemplos: | |
| cm changerevisiontype c:\workspace\file.txt --type=txt | |
| (Cambia el tipo de revisión del fichero 'file.txt' a texto.) | |
| cm chgrevtype comp.zip "image file.jpg" --type=bin | |
| (Cambia el tipo de revisión de los ficheros 'comp.zip' e 'image file.jpg' a | |
| binario.) | |
| cm crt *.* --type=txt | |
| (Cambia el tipo de revisión de todos los ficheros a texto.) | |
| == CMD_DESCRIPTION_TRIGGER_EDIT == | |
| Edita un trigger. | |
| == CMD_USAGE_TRIGGER_EDIT == | |
| Sintaxis: | |
| cm trigger | tr edit <subtype_type> <position_number> | |
| [--position=<new_position>] | |
| [--name=<new_name>] [--script=<script_path>] | |
| [--filter=<str_filter>] [--server=<repserverspec>] | |
| subtype_type Ejecución y operación del trigger. | |
| (Use 'cm showtriggertypes' para ver la lista de tipos de | |
| triggers.) | |
| position_number Posición que ocupa el trigger que se va a modificar. | |
| Opciones: | |
| --position Nueva posición del trigger a modificar. | |
| Esta posición no debe estar en uso por otro trigger del | |
| mismo tipo. | |
| --name Nuevo nombre del trigger a modificar. | |
| --script Nueva ruta de ejecución del script del trigger a modificar. | |
| Si el script comienza con "webtrigger ", el trigger se | |
| considerará como trigger de tipo web. Consulte las Notas | |
| para más información. | |
| --filter Comprueba solo los ítems que cumplen con el filtro | |
| indicado. | |
| --server Modifica el trigger del servidor indicado. | |
| Si no se especifica ningún trigger, entonces el comando | |
| se ejecuta en el servidor configurado en el cliente. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de servidor.) | |
| == CMD_HELP_TRIGGER_EDIT == | |
| Notas: | |
| Web triggers: Un trigger web se crea escribiendo "webtrigger <target-uri>" | |
| como comando del trigger. En este caso, el trigger ejecutará una consulta | |
| POST contra el URI especificado en la que el cuerpo de la petición | |
| contiene un diccionario JSON con las variables de entorno del trigger y una | |
| clave INPUT apuntando a un vector de cadenas de texto . | |
| Ejemplos: | |
| cm trigger edit after-setselector 6 --name="Backup2 manager" --script="/new/path/al/script" | |
| cm tr edit before-mklabel 7 --position=4 --server=myserver:8084 | |
| cm trigger edit after-add 2 --script="webtrigger http://myserver.org/api" | |
| == CMD_DESCRIPTION_CODEREVIEW == | |
| Crea, edita o elimina revisiones de código. | |
| == CMD_USAGE_CODEREVIEW == | |
| Sintaxis: | |
| cm codereview <spec> <title> [--status=<status_name>] | |
| [--assignee=<user_name>] [--format=<str_format>] | |
| [--repository=<rep_spec>] | |
| (Crea una revisión de código.) | |
| cm codereview -e <id> [--status=<status_name>] [--assignee=<user_name>] | |
| [--repository=<rep_spec>] | |
| (Edita una revisión de código.) | |
| cm codereview -d <id> [ ...] [--repository=<rep_spec>] | |
| (Borra una o más revisiones de código.) | |
| spec Puede ser una especificación de changeset, una especificación de | |
| shelve o una especificación de rama. Creará la nueva revisión de | |
| código de dicha especificación. (Use 'cm help objectspec' para más | |
| información sobre especificaciones de changeset o rama.) | |
| title Cadena de texto que se usará como título de la revisión de | |
| código. | |
| id Número de identificación de la revisión de código. También se | |
| puede usar un GUID. | |
| Opciones: | |
| -e Edita los parámetros de una revisión de código. | |
| -d Elimina una o más revisiones de código. Use un espacio en | |
| blanco para separar los identificadores de las revisiones de | |
| código. | |
| --status Aplica el nuevo estado a la revisión de código. Consulte las | |
| Notas para más información. | |
| --assignee Aplica el nuevo usuario asignado a la revisión de código. | |
| --format Muestra el mensaje de salida con el formato indicado. | |
| Consulte las Notas para más información. | |
| --repository Indica el repositorio que se utilizará por defecto. (Use | |
| 'cm help objectspec' para más información sobre | |
| especificaciones de repositorio.) | |
| == CMD_HELP_CODEREVIEW == | |
| Notas: | |
| Este comando permite a los usuarios gestionar revisiones de código: crear, | |
| editar y eliminar revisiones de código de changesets o ramas. | |
| Para crear una nueva revisión de código se requiere una especificación de | |
| changeset o rama además de un título. También se puede indicar el estado | |
| inicial y el usuario asignado como revisor de los cambios. | |
| Como resultado se devolverá el identificador ID (o GUID). | |
| Para editar o eliminar una revisión de código existente debe indicar el ID | |
| (o GUID) de la misma. No se mostrarán mensajes si no ha habido errores. | |
| El parámetro 'status' debe tener uno de los siguientes valores: | |
| 'Under review' (valor por defecto), 'Reviewed' o 'Rework required'. | |
| El parámetro 'repository' sirve para especificar el repositorio por defecto. | |
| Esto es útil cuando el usuario quiere gestionar revisiones de código de un | |
| servidor diferente del asociado al espacio de trabajo actual o cuando no | |
| existe un espacio de trabajo. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} id | |
| {1} guid | |
| Tenga en cuenta que el parámetro --format solo tiene efecto al crear una | |
| nueva revisión de código. | |
| Ejemplos: | |
| cm codereview cs:1856@myrepo@myserver:8084 "My code review" --assignee=dummy | |
| cm codereview br:/main/task001@myrepo@myserver:8084 "My code review" \ | |
| --status="Rework required" --assignee=newbie --format="{id} -> {guid}" | |
| cm codereview 1367 -e --assignee=new_assignee | |
| cm codereview -e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --status=Reviewed | |
| cm codereview -d 1367 --repository=myremoterepo@myremoteserver:18084 | |
| cm codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -d | |
| == CMD_DESCRIPTION_CRYPT == | |
| Encripta una contraseña. | |
| == CMD_USAGE_CRYPT == | |
| Sintaxis: | |
| cm crypt <mypassword> | |
| mypassword Contraseña que se va a encriptar. | |
| == CMD_HELP_CRYPT == | |
| Notas: | |
| Este comando encripta la contraseña que se pasa como argumento. | |
| Está diseñado para encriptar las contraseñas de los ficheros de | |
| configuración y aumentar así su seguridad. | |
| Ejemplos: | |
| cm crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword | |
| (Encripta la contraseña en el fichero de configuración de la base de datos: | |
| 'db.conf'.) | |
| == CMD_DESCRIPTION_DEACTIVATEUSER == | |
| Desactiva un usuario con licencia. | |
| == CMD_USAGE_DEACTIVATEUSER == | |
| Sintaxis: | |
| cm deactivateuser | du <usr_name>[ ...] [--server=<name:port>] | |
| [--nosolveuser] | |
| usr_name Nombre del usuario a desactivar. Use un espacio en | |
| blanco para separar nombres de usuario. | |
| Si SID, entonces debe incluir el argumento '--nosolveuser'. | |
| Options: | |
| --server Desactiva el usuario en el servidor indicado. Si no se | |
| indica ningún servidor, el comando se ejecuta en el | |
| servidor configurado en el cliente. | |
| --nosolveuser Si se indica esta opción, el comando no comprobará si el | |
| nombre de usuario existe en el sistema de autentificación. | |
| El nombre de usuario debe ser un usuario SID. | |
| == CMD_HELP_DEACTIVATEUSER == | |
| Notas: | |
| Este comando desactiva a un usuario. De este modo no podrá usar Unity VCS. | |
| (Use 'cm activateuser' para más información sobre cómo activar usuarios de | |
| Unity VCS.) | |
| Este comando comprueba si el usuario existe en el sistema de autentificación | |
| (por ejemplo, ActiveDirectory, LDAP, User/Password...). | |
| Para forzar la desactivación de un usuario que ya no existe en el sistema de | |
| autentificación, use la opción '--nosolveuser' option. | |
| Ejemplos: | |
| cm deactivateuser john | |
| cm du peter "mary collins" | |
| cm deactivateuser john --server=myserver:8084 | |
| cm deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --nosolveuser | |
| == CMD_DESCRIPTION_DIFF == | |
| Muestra las diferencias entre ficheros, changesets o ramas. | |
| == CMD_USAGE_DIFF == | |
| Sintaxis: | |
| cm diff <csetspec> | <lbspec> | <shspec> [<csetspec> | <lbspec> | <shspec>] | |
| [<path>] | |
| [--added] [--changed] [--moved] [--deleted] | |
| [--repositorypaths] [--download=<download_path>] | |
| [--encoding=<name>] | |
| [--comparisonmethod=(ignoreeol | ignorewhitespaces | | |
| ignoreeolandwhitespaces | recognizeall)] | |
| [--clean] | |
| [--integration] | |
| [--format=<str_format>] [--dateformat=<str_format>] | |
| Muestra las diferencias entre un changeset o un shelveset 'origen' y un | |
| changeset o un shelveset 'destino'. Los changesets se pueden especificar | |
| usando una especificación de changeset o de etiqueta. | |
| Si se indican dos especificaciones, la primera será el 'origen' del diff | |
| y la segunda será el 'destino'. | |
| Si se indica solo una especificación, el 'origen' será el changeset | |
| padre del 'destino' indicado. | |
| Si se especifica una ruta, la ventana de Diff se abrirá para mostrar las | |
| diferencias entre las dos revisiones del fichero indicado. | |
| cm diff <revspec1> <revspec2> | |
| Muestra las diferencias entre un par de revisiones. Las diferencias se | |
| muestran en la ventana de Diff. La primera revisión indicada aparecerá | |
| a la izquierda. | |
| cm diff <brspec> [--added] [--changed] [--moved] [--deleted] | |
| [--repositorypaths] [--download=<download_path>] | |
| [--encoding=<name>] | |
| [--comparisonmethod=(ignoreeol | ignorewhitespaces | | |
| ignoreeolandwhitespaces | recognizeall)] | |
| [--clean] | |
| [--integration] | |
| [--format=<str_format>] [--dateformat=<str_format>] | |
| [--fullpaths | --fp] | |
| Muestra las diferencias de rama. | |
| (Use 'cm help objectspec' para más información sobre especificaciones.) | |
| Opciones: | |
| --added Imprime las diferencias de ítems añadidos al repositorio. | |
| --changed Imprime las diferencias de ítems que han cambiado. | |
| --moved Imprime las diferencias de ítems movidos o renombrados. | |
| --deleted Imprime las diferencias de ítems borrados. | |
| Si no se indica ni '--added' ni '--changed' ni '--moved' | |
| ni '--deleted', se imprimen todas las diferencias. | |
| 'A' significa ítems añadidos ('added'.)' | |
| 'C' significa ítems cambiados ('changed'.) | |
| 'D' significa ítems borrados ('deleted'.) | |
| 'M' significa ítems movidos ('moved'). El ítem a la | |
| izquierda es el original, y el de la derecha es el | |
| destino. | |
| --repositorypaths Imprime rutas de repositorio en lugar de rutas de | |
| workspace. (Esta opción anula la opción '--fullpaths'.) | |
| --download Guarda el contenido de las diferencias en la ruta de | |
| salida indicada. | |
| --encoding Especifica el encoding que se usará en la salida, por | |
| ejemplo, utf-8. Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| --comparisonmethod Configura el método de comparación indicado. | |
| Consulte las Notas para más información. | |
| --clean Omite las diferencias que provienen de un merge mostrando | |
| solo las diferencias creadas en los checkins. | |
| --integration Muestra los cambios de la rama que están pendientes de | |
| integrar en su rama padre. Tiene en cuenta los rebases | |
| y los merges a la rama padre ya realizados. | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --dateformat Configura el formato de salida para la impresión de fechas. | |
| --fullpaths, --fp Fuerza la impresión de rutas de workspaces absolutas para | |
| ficheros y directorios siempre que sea posible. | |
| == CMD_HELP_DIFF == | |
| Notas: | |
| Métodos de comparación (opción --comparisonmethod): | |
| ignoreeol Ignora diferencias en final de línea. | |
| ignorewhitespaces Ignora diferencias en espacios. | |
| ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios. | |
| recognizeall Detecta diferencias en final de línea y espacios. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {path} Ruta del ítem. | |
| {date} Fecha/hora del cambio. | |
| {owner} Autor del cambio. | |
| {revid} Identificador de la revisión considerada como | |
| destino en las diferencias. | |
| {parentrevid} Identificador del padre de la revisión considerada | |
| como destino en las diferencias. | |
| {baserevid} Identificador de la revisión considerada como origen | |
| en las diferencias. | |
| {srccmpath} Ruta de servidor antes de mover un ítem (para la | |
| operación de movido). | |
| {dstcmpath} Ruta de servidor después de mover un ítem (para la | |
| operación de movido). | |
| {type} Tipo de ítem: | |
| D directorio, | |
| B fichero binario, | |
| F fichero de texto, | |
| S symlink, | |
| X Xlink. | |
| {repository} Repositorio del ítem. | |
| {status} Estado del ítem: | |
| A añadido, | |
| D borrado, | |
| M movido, | |
| C cambiado. | |
| {fsprotection} Muestra los permisos del ítem (Linux/Mac chmod). | |
| {srcfsprotection} Muestra los permisos de la revisión padre del ítem. | |
| {newline} Inserta una nueva línea. | |
| Notas sobre 'revid': | |
| Para ítems añadidos, 'baserevid' y 'parentrevid' es -1 puesto que no existe | |
| revisión previa en estos casos. | |
| Para ítems borrados, 'revid' es el identificador de la revisión origen, y | |
| 'baserevid' es -1 puesto que no existe revisión destino. | |
| Para Xlinks, 'baserevid' y 'parentrevid' son siempre -1. | |
| Ejemplos: | |
| Comparar ramas: | |
| cm diff br:/main/task001 | |
| cm diff br:/main/task001 \doc\readme.txt | |
| cm diff br:/main/task001 --integration | |
| Comparar changesets: | |
| cm diff 19 | |
| cm diff 19 25 | |
| cm diff cs:19 cs:25 --format="{path} {parentrevid}" | |
| cm diff cs:19 cs:23 --format="{date} {path}" --dateformat="yy/dd/MM HH:mm:ss" | |
| cm diff cs:19 cs:23 --changed | |
| cm diff cs:19 cs:23 --repositorypaths | |
| cm diff cs:19 cs:23 --download="D:\temp" | |
| cm diff cs:19 cs:23 --clean | |
| cm diff cs:19 cs:23 \doc\readme.txt | |
| Comparar etiquetas: | |
| cm diff lb:EtiquetaPrimeraRelease lb:EtiquetaSegundaRelease | |
| cm diff lb:tag_193.2 cs:34214 | |
| cm diff cs:31492 lb:tag_193.2 | |
| Comparar shelves: | |
| cm diff sh:2 | |
| cm diff sh:2 sh:4 | |
| Comparar revisiones: | |
| cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20 | |
| cm diff serverpath:/doc/readme.txt#cs:19@myrepo \ | |
| serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084 | |
| cm diff rev:foo.c#cs:1 rev:foo.c#cs:2 --comparisonmethod=ignoreeol | |
| == CMD_DESCRIPTION_DIFFMETRICS == | |
| Muestra métricas de diferencias entre dos revisiones. | |
| == CMD_USAGE_DIFFMETRICS == | |
| Sintaxis: | |
| cm diffmetrics | dm <revspec1> <revspec2> [--format=<str_format>] | |
| [--encoding=<name>] | |
| [--comparisonmethod=(ignoreeol | ignorewhitespaces | | |
| ignoreeolandwhitespaces | recognizeall)] | |
| revspec Revisiones a comparar. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de revisiones.) | |
| Options: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --encoding Especifica el encoding que se usará en la salida, por | |
| ejemplo, utf-8. Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| --comparisonmethod Configura el método de comparación indicado. | |
| Consulte las Notas para más información. | |
| == CMD_HELP_DIFFMETRICS == | |
| Notas: | |
| Las métricas que se obtienen son: número de líneas cambiadas, añadidas y | |
| borradas. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} Número de líneas cambiadas. | |
| {1} Número de líneas añadidas. | |
| {2} Número de líneas borradas. | |
| Métodos de comparación (opción --comparisonmethod): | |
| ignoreeol Ignora diferencias en final de línea. | |
| ignorewhitespaces Ignora diferencias en espacios. | |
| ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios. | |
| recognizeall Detecta diferencias en final de línea y espacios. | |
| Ejemplos: | |
| cm diffmetrics file.txt#cs:2 file.txt#br:/main/scm0211 \ | |
| --format="There are {0} changed, {1} added and {2} deleted lines." | |
| (Muestra las métricas de diferencias en el formato indicado.) | |
| cm dm file.txt#cs:2 file.txt#cs:3 --encoding=utf-8 --comparisonmethod=ignorewhitespaces | |
| == CMD_DESCRIPTION_FASTEXPORT == | |
| Exporta los datos de un repositorio de Unity VCS a un formato fast-export. | |
| == CMD_USAGE_FASTEXPORT == | |
| Sintaxis: | |
| cm fast-export | fe <repspec> <fast-export-file> | |
| [--import-marks=<marks_file>] | |
| [--export-marks=<marks_file>] | |
| [--branchseparator=<chr_separator>] | |
| [--nodata] [--from=<changesetid>] [--to=<changesetid>] | |
| Opciones: | |
| repspec Repositorio cuyos datos serán exportados. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de repositorio.) | |
| fast-export-file Fichero con los datos del repositorio en formato | |
| fast-export de Git. | |
| --import-marks Fichero de marcas usado para la importación incremental. | |
| Este fichero ha sido previamente exportado con el | |
| comando --export-marks. Los changesets descritos en este | |
| fichero no se importarán porque ya lo fueron en una | |
| importación previa. | |
| --export-marks Fichero donde se guardan los changesets importados. | |
| Este fichero se usará en una operación fast-import para | |
| indicar los changesets que han sido importados. | |
| --branchseparator Unity VCS usa "/" como separador por defecto en la | |
| jerarquía de ramas. Esta opción permite usar un carácter | |
| como separador de jerarquía. Por ejemplo, la rama | |
| main-task-sub será mapeada en Unity VCS como | |
| /main/task/sub. | |
| --nodata Exporta el repositorio pero sin incluir los datos. Esta | |
| opción es útil para comprobar que la exportación se | |
| llevará a cabo sin problemas. | |
| --from Exporta desde el changeset especificado. | |
| --to Exporta hasta el changeset especificado. | |
| == CMD_HELP_FASTEXPORT == | |
| Notas: | |
| - Para importar un repositorio de Unity VCS a Git, use un comando como el siguiente: | |
| cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git | |
| - La exportación incremental se realiza usando un fichero de marcas que | |
| contenga los changesets previamente importados (ficheros --import-marks y | |
| --export-marks). | |
| Esto significa que solamente se exportarán los changesets que no fueron | |
| exportados con un fast-export previamente. | |
| Ejemplos: | |
| cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm | |
| (Exporta el repositorio 'repo' en el servidor local al fichero 'repo.fe.00' | |
| en formato fast-export de Git y crea el fichero de marcas para poder | |
| realizar una futura exportación incremental.) | |
| cm fast-export repo@localhost:8087 repo.fe.00 --from=20 | |
| (Exporta el repositorio 'repo' en el servidor local al fichero 'repo.fe.00' | |
| en formato Git fast-export desde el changeset '20'.) | |
| == CMD_DESCRIPTION_FASTIMPORT == | |
| Importa datos de fast-export de Git a un repositorio. | |
| == CMD_USAGE_FASTIMPORT == | |
| Sintaxis: | |
| cm fast-import | fi <repspec> <fast-export-file> | |
| [--import-marks=<marks_file>] | |
| [--export-marks=<marks_file>] | |
| [--stats] [--branchseparator=<chr_separator>] | |
| [--nodata] [--ignoremissingchangesets] [--mastertomain] | |
| Opciones: | |
| repspec Repositorio en el cual se importarán los datos. | |
| Si no existe en el momento de la operación, se | |
| crea automáticamente. (Use 'cm help objectspec' | |
| para más información sobre especificaciones de | |
| repositorio.) | |
| fast-export-file Fichero con los datos en formato Git | |
| fast-export. | |
| --import-marks El fichero de marcas utilizado para | |
| importaciones incrementales. Dicho fichero se | |
| ha exportado previamente con --export-marks. | |
| Los changesets descritos en este fichero no se | |
| importarán porque ya existían de una importación | |
| previa. | |
| --export-marks El fichero en el cual se guardarán los changesets | |
| importados. Dicho fichero se utilizará en una | |
| operación posterior de fast-import para indicar | |
| los changesets que ya han sido importados. | |
| --stats Muestra estadísticas del proceso de importación. | |
| --branchseparator Unity VCS usa "/" como separador por defecto | |
| en la jerarquía de ramas. Esta opción permite | |
| usar un carácter como separador en esa | |
| jerarquía. Por ejemplo, la rama main-task-sub | |
| será mapeada en Unity VCS como /main/task/sub. | |
| --nodata Importa Git fast-export pero sin incluir datos. | |
| Esta opción es útil para comprobar que la | |
| importación exportación se llevará a cabo sin | |
| problemas. | |
| --ignoremissingchangesets Los changesets que no pueden ser importados se | |
| descartan y la operación de fast-import continúa | |
| sin ellos. | |
| --mastertomain Realiza la importación usando "main" en lugar | |
| de "master". | |
| == CMD_HELP_FASTIMPORT == | |
| Notas: | |
| - Para exportar un repositorio de Git, use un comando como el siguiente: | |
| git fast-export --all -M --signed-tags=strip --tag-of-filtered-object=drop> ..\git-fast-export.dat | |
| La opción -M es importante para detectar ítems movidos. | |
| - El repositorio indicado se crea en caso de que no exista. | |
| - La importación incremental se realiza usando los ficheros de marcas que | |
| contengan los changesets previamente importados (ficheros --import-marks y | |
| --export-marks). | |
| Esto significa que solamente se importarán los changesets que no fueron | |
| importados con un fast-import previamente. | |
| Ejemplos: | |
| cm fast-import mynewrepo@atenea:8084 repo.fast-export | |
| (Importa el contenido exportado en el fichero 'repo.fast-export' al | |
| repositorio 'mynewrepo' del servidor 'atenea:8084'.) | |
| cm fast-import repo@server:8084 repo.fast-export --export-marks=rep.marks | |
| (Importa el contenido exportado en el fichero 'repo.fast-export' al | |
| repositorio 'repo' del servidor 'atenea:8084' y crea un archivo de | |
| marcas para importaciones incrementales posteriores.) | |
| cm fast-import repo@server:8084 repo.fast-export --importmarks=repo.marks \ | |
| --export-marks=repo.marks | |
| (Importa el contenido del fichero 'repo.fast-export'. Solamente se importarán | |
| los changesets que no están en el fichero de marcas. Se utiliza el mismo | |
| fichero de marcas para guardar la lista de changesets de nuevo para la | |
| siguiente importación incremental.) | |
| == CMD_DESCRIPTION_FILEINFO == | |
| Obtiene información detallada de ítems del espacio de trabajo. | |
| == CMD_USAGE_FILEINFO == | |
| Sintaxis: | |
| cm fileinfo <item_path>[ ...] [--fields=<field_value>[,...]] | |
| [[--xml | -x [=<output_file>]] | [--format=<str_format>]] | |
| [--symlink] [--encoding=<name>] | |
| item_path Ítems a mostrar. Use comillas dobles (" ") para especificar | |
| rutas que contengan espacios. Use un espacio en blanco para | |
| separar rutas de ítems. | |
| Opciones: | |
| --fields Cadena de valores separados por coma. Indica qué campos Se | |
| mostrarán por cada ítem. Consulte las Notas para más | |
| información. | |
| --xml | -x Imprime el resultado en formato XML a la salida estándar. | |
| También es posible especificar un fichero de salida. | |
| Esta opción no puede combinarse con --format. | |
| --format Muestra el mensaje de salida en un formato específico. | |
| Consulte las Notas para más información. No puede | |
| combinarse con --xml. | |
| --symlink Aplica la operación al symlink pero no al destino. | |
| --encoding Especifica el encoding que se usará en la salida, por | |
| ejemplo, utf-8. Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| == CMD_HELP_FILEINFO == | |
| Notas: | |
| Este comando muestra una lista detallada de atributos para cada ítem | |
| indicado. Cada atributo se muestra en una nueva línea. | |
| Se puede modificar la lista de atributos para mostrar únicamente los | |
| atributos que el usuario necesite. Para ello, utilice el argumento | |
| --fields=<field_list> que acepta una cadena de nombres de atributo | |
| separados por comas. De este modo, solo se mostrarán aquellos argumentos | |
| cuyo nombre esté presente en la lista. | |
| Revision head changeset: | |
| Esta opción está desactivada por defecto. Tenga en cuenta que la | |
| recuperación de este atributo es notablemente más lenta que la del resto de | |
| atributos, por lo que recomendamos agrupar tantos ficheros por ejecución como | |
| sea posible. Esto mejora los tiempos de ejecución al evitar numerosas | |
| ejecuciones de 'cm fileinfo' separadas. | |
| Además, esta característica no se encuentra disponible actualmente para | |
| directorios controlados. | |
| A continuación se encuentra la lista completa de nombres de atributo. Los | |
| nombres marcados con asterisco ('*') no se mostrarán: | |
| ClientPath Ruta local del ítem en disco. | |
| RelativePath Ruta relativa del ítem en el espacio de trabajo. | |
| ServerPath Ruta del repositorio para el ítem. | |
| (Nota: Los espacios de trabajo transformado no | |
| están actualmente soportados para esta opción.) | |
| Size Tamaño del ítem. | |
| Hash Suma 'hash' del ítem. | |
| Owner Nombre del usuario propietario del ítem. | |
| RevisionHeadChangeset (*) Changeset de la revisión cargada en el | |
| changeset head de la rama. | |
| (Ver nota más arriba.) | |
| RevisionChangeset Changeset de la revisión cargada en el espacio | |
| de trabajo. | |
| RepSpec Especificación del repositorio para el ítem. | |
| (Use 'cm help objectspec' para más información | |
| sobre especificaciones de repositorio.) | |
| Status Estado del ítem en el espacio de trabajo: | |
| añadido, desprotegido (checked-out), eliminado... | |
| Type Tipo de la revisión (texto, binario, directorio, | |
| symlink o desconocido). | |
| Changelist Lista de cambios (si existe) a la que pertenece | |
| el ítem. | |
| IsLocked (*) Si el ítem está bloqueado por un checkout | |
| exclusivo o no. | |
| LockedBy (*) Usuario que bloqueó el ítem mediante | |
| checkout exclusivo. | |
| LockedWhere (*) Localización del ítem bloqueado mediante | |
| checkout exclusivo. | |
| IsUnderXlink Si el ítem está localizado en un Xlink o no. | |
| UnderXlinkTarget Destino del Xlink (si existe) donde el ítem se | |
| encuentra. | |
| UnderXlinkPath Ruta de servidor del ítem en el repositorio del | |
| Xlink (si existe). | |
| UnderXlinkWritable Si el Xlink al que pertenece el ítem es de | |
| escritura o no. | |
| UnderXlinkRelative Si el Xlink al que pertenece el ítem es | |
| relativo o no. | |
| IsXlink Si el ítem es un Xlink o no. | |
| XlinkTarget Repositorio destino al que el ítem apunta, si es | |
| un Xlink. | |
| XlinkName Nombre del ítem Xlink. | |
| XlinkWritable Si el ítem Xlink es un Xlink de escritura o no. | |
| XlinkRelative Si el ítem Xlink es un Xlink relativo o no. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar su salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {ClientPath} | |
| {RelativePath} | |
| {ServerPath} | |
| {Size} | |
| {Hash} | |
| {Owner} | |
| {RevisionHeadChangeset} | |
| {RevisionChangeset} | |
| {Status} | |
| {Type} | |
| {Changelist} | |
| {IsLocked} | |
| {LockedBy} | |
| {LockedWhere} | |
| {IsUnderXlink} | |
| {UnderXlinkTarget} | |
| {UnderXlinkPath} | |
| {UnderXlinkWritable} | |
| {UnderXlinkRelative} | |
| {IsXlink} | |
| {XlinkTarget} | |
| {XlinkName} | |
| {XlinkWritable} | |
| {XlinkRelative} | |
| {RepSpec} | |
| Tenga en cuenta que las opciones --format y --xml son mutuamente excluyentes, | |
| por lo que no se pueden utilizar simultáneamente. | |
| Ejemplos: | |
| cm fileinfo file1.txt file2.txt dir/ | |
| cm fileinfo "New Project.csproj" --xml | |
| cm fileinfo assets.art --fields=ServerPath,Size,IsLocked,LockedBy | |
| cm fileinfo proj_specs.docx --fields=ServerPath,RevisionChangeset --xml | |
| cm fileinfo samples.ogg --format="{ServerPath}[{Owner}] -> {Size}" | |
| == CMD_DESCRIPTION_FIND_QUERY == | |
| Obtiene una serie de objetos en base a unos criterios de búsqueda. | |
| == CMD_USAGE_FIND_QUERY == | |
| Sintaxis: | |
| cm find <object_type> | |
| [where <str_conditions>] | |
| [on repository '<repspec>' | on repositories '<repspec1>','<repspec2>'[,...]] | |
| [order by <sort_field> ['asc' | 'desc']] | |
| [[limit <maxresults>] [offset <offset>]] | |
| [--format=<str_format>] [--dateformat=<date_format>] | |
| [--nototal] [--file=<dump_file>] [--xml] | |
| [--encoding=<name>] | |
| object_type Objecto a buscar. | |
| Algunos de estos objetos permiten la cláusula 'order by'. | |
| Use 'cm help showfindobjects' para más información sobre | |
| estos objetos, aquellos que permiten ordenación y por qué campos. | |
| Lea la Guía de 'cm find' para más información: | |
| https://www.plasticscm.com/download/help/cmfind | |
| Opciones: | |
| str_conditions Condiciones de búsqueda sobre los atributos del objeto. | |
| repspec Nombre o especificación del repositorio (o repositorios) | |
| donde buscar. | |
| Para 'on repositories', use una coma para separar las | |
| especificaciones de repositorio. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de repositorio.) | |
| sort_field Nombre del campo elegido para la ordenación. Tenga en cuenta | |
| que esos campos son limitados. Use 'cm help showfindobjects' para | |
| consultar qué objetos se permiten ordenar y por qué campos. | |
| maxresults Número máximo de resultados devueltos por la búsqueda. | |
| offset Número de resultados que se omiten antes de empezar a devolver | |
| los resultados de la búsqueda. | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Lea la Guía de 'cm find' para ver todos los atributos | |
| de objeto que se pueden usar para el formato de salida: | |
| https://www.plasticscm.com/download/help/cmfind | |
| --dateformat Configura el formato de salida para la impresión de fechas. | |
| --nototal No muestra el número total de registros. | |
| --file Fichero al que volcar los resultados. | |
| --xml Imprime el resultado en formato XML a la salida estándar. | |
| --encoding Especifica el encoding que se usará en la salida, por | |
| ejemplo, utf-8. Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| == CMD_HELP_FIND_QUERY == | |
| Notas: | |
| Si no se especifica ningún repositorio, la búsqueda se realiza sobre el | |
| repositorio configurado en el espacio de trabajo. | |
| Cuando se ejecutan búsquedas desde la línea de comandos usando operadores de | |
| comparación (>, <, >=, <=), el intérprete de comandos (o shell) considera a | |
| estos operadores como redirecciones de E/S. Por lo que es necesario escribir | |
| la búsqueda entre comillas dobles. | |
| El comando 'cm find' acepta una cadena de formato para mostrar la salida. | |
| Cada parámetro de salida se identifica con un nombre, y el usuario se | |
| puede referir a él escribiéndolo entre llaves '{' y '}'. | |
| Los parámetros de salida se corresponden normalmente con atributos del objeto. | |
| Estas son cadenas de formato válidas: | |
| --format={id}{date}{name} | |
| --format="{item}#{branch} con fecha {date}" | |
| Consideraciones sobre XML y encoding: | |
| Cuando se especifica la opción --xml, se muestra el resultado como texto XML | |
| en la salida estándar. Por defecto se utiliza la codificación estándar del | |
| sistema operativo, por lo que es posible que los caracteres no ANSI no se | |
| visualicen correctamente en la consola. Pero si se redirige la salida a un | |
| fichero, el contenido se visualizará correctamente. | |
| Cuando se especifican simultáneamente las opciones --xml y --file, se | |
| utiliza por defecto la codificación UTF-8. | |
| Ejemplos: | |
| cm find revision | |
| cm find revision "where changeset = 23 and owner = 'user'" | |
| cm find branch "on repository 'rep1'" | |
| cm find label "on repositories 'rep1', 'rep:default@localhost:8084'" | |
| cm find branch "where parent = 'br:/main' on repository 'rep1'" | |
| cm find revision "where item = 'item:.'" --format="{item}#{branch}" | |
| cm find revision "where item = 'item:.'" --xml --file=c:\queryresults\revs.xml | |
| cm find label "where owner='me' limit 10 offset 20" | |
| cm find branches "where owner='me' order by branchname desc limit 10" | |
| == CMD_DESCRIPTION_FINDCHANGED == | |
| Obtiene una lista de los ficheros cambiados. Este comando está obsoleto y solo | |
| se mantiene por retrocompatibilidad. Use 'cm status'. | |
| == CMD_USAGE_FINDCHANGED == | |
| Sintaxis: | |
| cm findchanged | fc [-R | -r | --recursive] [--checkcontent] | |
| [--onlychanged] [<path>] | |
| Opciones: | |
| -R Busca recursivamente en los directorios. | |
| --checkcontent Compara los ficheros por contenido. | |
| --onlychanged Encuentra solo los ficheros cambiados; los ficheros | |
| desprotegidos no se devolverán en la búsqueda. | |
| path (Por defecto, el directorio actual.) | |
| Ruta inicial de búsqueda de los ficheros cambiados. | |
| == CMD_HELP_FINDCHANGED == | |
| Notas: | |
| Si no se especifica la opción '--checkcontent', Unity VCS busca cambiados | |
| basándose en el registro de tiempo (timestamp) de los ficheros. | |
| Si se especifica la opción '--checkcontent', entonces lo que se compara es | |
| el contenido de los ficheros o las carpetas y no el timestamp. | |
| Este comando es útil para detectar ficheros que han cambiado durante una | |
| desconexión del servidor de Unity VCS. La salida de este comando permite | |
| usar una tubería (pipe) con el comando 'checkout' y así poder comprobar | |
| los cambios más tarde (ver ejemplos). | |
| Ejemplos: | |
| cm findchanged . | |
| (Busca ficheros cambiados en el directorio actual.) | |
| cm findchanged -R . | cm checkout - | |
| (Desprotege los elementos cambiados.) | |
| == CMD_DESCRIPTION_FINDCHECKEDOUT == | |
| Obtiene una lista de ficheros desprotegidos. Este comando está obsoleto y se | |
| mantiene por retrocompatibilidad. Use 'cm status'. | |
| == CMD_USAGE_FINDCHECKEDOUT == | |
| Sintaxis: | |
| cm findcheckouts | fco [--format=<str_format>] [--basepath] | |
| Opciones: | |
| --format Muestra el mensaje de salida con el formato indicado. | |
| Consulte las Notas para más información. | |
| --basepath Ruta por la que comenzar a buscar desprotegidos. Si no | |
| se especifica ninguna ruta, se usará la ruta actual. | |
| == CMD_HELP_FINDCHECKEDOUT == | |
| Notas: | |
| Este comando es útil para, en un único paso, proteger o deshacer las | |
| desprotecciones de todos los ficheros desprotegidos, y redirigir la salida | |
| estándar a otro comando. Vea los ejemplos. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} Fecha. | |
| {1} Propietario. | |
| {2} Espacio de trabajo. | |
| {3} Nombre de la máquina cliente. | |
| {4} Ruta del fichero. | |
| {5} Información de rama y repositorio. | |
| Ejemplos: | |
| cm findcheckouts --format="File {4} changed on branch {5}" | |
| (Busca los ficheros desprotegidos y formatea la salida con la ruta del | |
| fichero y la información de la rama y repositorio.) | |
| cm findcheckouts --format={4} | cm checkin - | |
| (Protege todos los ficheros desprotegidos.) | |
| cm findcheckouts --format={4} | cm undocheckout - | |
| (Deshace la desprotección de todos los ficheros desprotegidos.) | |
| == CMD_DESCRIPTION_FINDPRIVATE == | |
| Obtiene una lista de ítems privados. Este comando está obsoleto y se mantiene | |
| por retrocompatibilidad. Use 'cm status'. | |
| == CMD_USAGE_FINDPRIVATE == | |
| Sintaxis: | |
| cm findprivate | fp [-R | -r | --recursive] [--exclusions] [<path>] | |
| Opciones: | |
| -R Busca recursivamente en los directorios. | |
| --exclusions Permite interrumpir la búsqueda dentro de las rutas | |
| ignoradas (definidas en el fichero ignore.conf). | |
| path (Por defecto, directorio actual.) | |
| Ruta por la que comenzar a buscar los ficheros privados. | |
| == CMD_HELP_FINDPRIVATE == | |
| Notas: | |
| Si no se especifica ninguna ruta, Unity VCS comenzará a buscar por el | |
| directorio actual. | |
| Este comando es útil para añadir los elementos privados de la ruta | |
| redireccionando la salida estándar al comando 'add'. | |
| Vea los ejemplos. | |
| Ejemplos: | |
| cm findprivate . | |
| cm findprivate -R | cm add - | |
| (Busca recursivamente items privados y los añade al repositorio.) | |
| == CMD_DESCRIPTION_GETCONFIG == | |
| Obtiene información de configuración. | |
| == CMD_USAGE_GETCONFIG == | |
| Sintaxis: | |
| cm getconfig [setfileasreadonly] [location] [extensionworkingmode] | |
| [extensionprefix] [defaultrepserver] | |
| setfileasreadonly Muestra si los ficheros protegidos se dejan en modo | |
| solo lectura o no. | |
| location Muestra la ruta del fichero de configuración del | |
| cliente. | |
| extensionworkingmode Muestra el modo de trabajo de la extensión. | |
| extensionprefix Muestra el prefijo de la extensión configurada. | |
| defaultrepserver Muestra el servidor de repositorios configurado por | |
| defecto. | |
| == CMD_HELP_GETCONFIG == | |
| Ejemplos: | |
| cm getconfig setfileasreadonly | |
| == CMD_DESCRIPTION_GETFILE == | |
| Descarga el contenido de una revisión especificada. | |
| == CMD_USAGE_GETFILE == | |
| Sintaxis: | |
| cm getfile | cat <revspec> [--file=<output_file>] [--debug] | |
| [--symlink] [--raw] | |
| revspec Especificación de la revisión. (Use 'cm help objectspec' para | |
| más información sobre las especificaciones de revisiones.) | |
| Opciones: | |
| --file Fichero donde guardar la salida. Por defecto, se imprime en | |
| la salida estándar. | |
| --debug Cuando se especifica la revisión de un directorio, el | |
| comando muestra el id de la revisión y la protección del | |
| sistema del fichero. | |
| --symlink Aplica la operación al symlink pero no al destino (target). | |
| --raw Muestra los datos del fichero sin procesar (raw data). | |
| == CMD_HELP_GETFILE == | |
| Ejemplos: | |
| cm cat myfile.txt#br:/main | |
| (Obtiene la última revisión del fichero 'myfile.txt' en la rama 'br:/main'.) | |
| cm getfile myfile.txt#cs:3 --file=tmp.txt | |
| (Obtiene el changeset 3 del fichero 'myfile.txt' y escribe su contenido en | |
| el fichero 'tmp.txt'.) | |
| cm cat serverpath:/src/foo.c#br:/main/task003@myrepo | |
| (Obtiene el contenido del fichero '/src/foo.c' del último changeset de la | |
| rama '/main/task003' en el repositorio 'myrepo'.) | |
| cm cat revid:1230@rep:myrep@repserver:myserver:8084 | |
| (Obtiene la revisión con id igual a 1230.) | |
| cm getfile rev:info\ --debug | |
| (Obtiene todas las revisiones del directorio 'info'.) | |
| == CMD_DESCRIPTION_GETREVISION == | |
| Carga una revisión en el espacio de trabajo. | |
| == CMD_USAGE_GETREVISION == | |
| Este comando modifica la revisión cargada en el espacio de trabajo, con lo que | |
| puede afectar a futuros merges. | |
| Este es un comando avanzado heredado de antiguas versiones; úselo con precaución. | |
| Sintaxis: | |
| cm getrevision <revspec> | |
| revspec Especificación de la revisión. (Use 'cm help objectspec' para | |
| más información sobre las especificaciones de revisiones.) | |
| == CMD_HELP_GETREVISION == | |
| Ejemplos: | |
| cm getrevision file.txt#cs:3 | |
| (Carga la revisión del changeset 3 del fichero 'file.txt'.) | |
| == CMD_DESCRIPTION_GETSTATUS == | |
| Obtiene el estado de un ítem. | |
| == CMD_USAGE_GETSTATUS == | |
| Este comando está pensado para la automatización de otros comandos. Con lo que, | |
| es posible, que no resulte muy intuitivo. | |
| Sintaxis: | |
| cm getstatus | gs <item_path>[ ...] [--format=<str_format>] [--stats] | |
| [-R | -r | --recursive] | |
| item_path Ítem o ítems de los que obtener el estado. Use comillas | |
| dobles (" ") para especificar rutas que contengan espacios. | |
| Use un espacio en blanco para separar rutas de ítems. | |
| Opciones: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --stats Muestra estadísticas sobre el proceso de obtención del estado. | |
| -R Muestra recursivamente el estado en las rutas indicadas. | |
| == CMD_HELP_GETSTATUS == | |
| Notas: | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} Ruta del ítem. | |
| {1} Estado del ítem: | |
| 0 privado, | |
| 1 protegido, | |
| 2 desprotegido. | |
| Lectura desde stdin: | |
| El comando 'getstatus' puede leer rutas desde stdin. Para ello, pase como | |
| argumento un guión "-". | |
| Por ejemplo: cm getstatus - | |
| Las rutas se leerán hasta que se introduzca una línea en blanco. | |
| Este tipo de lectura permite usar una tubería (pipe) para especificar de qué | |
| ficheros se van a obtener su estado. | |
| Por ejemplo: | |
| dir /S /B *.c | cm getstatus --format="Path {0} Status {1}" - | |
| (En Windows, obtiene el estado de todos los ficheros del workspace con | |
| extensión .c.) | |
| Ejemplos: | |
| cm getstatus file1.txt file2.txt | |
| (Obtiene el estado de los ficheros.) | |
| cm gs info\ -R --format="The item {0} has the status {1}" | |
| (Obtiene el estado del directorio y de todos sus ficheros y muestra la | |
| salida formateada.) | |
| == CMD_DESCRIPTION_GETTASKBRANCHES == | |
| Obtiene las ramas asociadas con una tarea. | |
| == CMD_USAGE_GETTASKBRANCHES == | |
| Este comando está pensado para la automatización de otros comandos. Con lo que, | |
| es posible, que no resulte muy intuitivo. | |
| Sintaxis: | |
| cm gettaskbranches | gtb <task_name> [--format=<str_format>] | |
| [--dateformat=<date_format>] | |
| task_name Identificador de la tarea. | |
| Opciones: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --dateformat Configura el formato de salida para la impresión de fechas. | |
| == CMD_HELP_GETTASKBRANCHES == | |
| Notas: | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una nueva línea. | |
| {name} Nombre de la rama. | |
| {owner} Propietario de la rama. | |
| {date} Fecha de creación de la rama. | |
| {parent} Rama padre. | |
| {comment} Comentario de la rama. | |
| {repname} Repositorio donde se encuentra la rama. | |
| {repserver} Nombre del servidor. | |
| Ejemplos: | |
| cm gettaskbranches 4311 | |
| cm gtb 4311 --format="br:{name}" | |
| cm gtb 4311 --format="br:{name} {date}" --dateformat="yyyy/MM/dd HH:mm:ss" | |
| == CMD_DESCRIPTION_GETWWI == | |
| Muestra información del selector del espacio de trabajo. | |
| == CMD_USAGE_GETWWI == | |
| Sintaxis: | |
| cm wi [<wk_path>] | |
| wk_path Ruta en disco del workspace a consultar. | |
| == CMD_HELP_GETWWI == | |
| Notas: | |
| El comando 'wi' muestra la configuración actual del espacio de trabajo | |
| (repositorio, rama o etiqueta.) | |
| Ejemplos: | |
| cm wi c:\mywk | |
| == CMD_DESCRIPTION_GWP == | |
| Obtiene información del espacio de trabajo a partir de una ruta. | |
| == CMD_USAGE_GWP == | |
| Este comando está pensado para la automatización de otros comandos. Con lo que, | |
| es posible, que no resulte muy intuitivo. | |
| Sintaxis: | |
| cm getworkspacefrompath | gwp <item_path> [--format=<str_format>] [--extended] | |
| item_path Fichero o directorio en disco. | |
| Opciones: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --extended Muestra más información sobre el espacio de trabajo: type y | |
| dynamic además del resto de campos. Consulte las Notas para | |
| más información. | |
| == CMD_HELP_GWP == | |
| Notas: | |
| Este comando muestra información del espacio de trabajo de la ruta indicada. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} | {wkname} Nombre del espacio de trabajo. | |
| {1} | {wkpath} Ruta del espacio de trabajo. | |
| {2} | {machine} Nombre de la máquina del cliente. | |
| {3} | {owner} Propietario del espacio de trabajo. | |
| {4} | {guid} GUID del espacio de trabajo. | |
| {5} | {type} Tipo de espacio de trabajo: partial (gluon) o regular. | |
| {6} | {dynamic} Un espacio de trabajo puede ser dynamic (plasticfs) | |
| o static. | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una nueva línea. | |
| Ejemplos: | |
| cm gwp c:\myworkspace\code\file1.cpp --format="Espacio de trabajo: {wkname}" | |
| cm gwp . --format="Nombre: {wkname} | Tipo: {type}, {dynamic}" | |
| == CMD_DESCRIPTION_HELP == | |
| Muestra la ayuda de un comando de Unity VCS. | |
| == CMD_USAGE_HELP == | |
| Sintaxis: | |
| cm help <command> | |
| == CMD_HELP_HELP == | |
| == CMD_DESCRIPTION_IOSTATS == | |
| Muestra estadísticas relativas al hardware. | |
| == CMD_USAGE_IOSTATS == | |
| Sintaxis: | |
| cm iostats [<repserverspec>] [<list_of_tests>[ ...]] | |
| [--nettotalmb=<value_mb>] [--networkiterations=<value_iter>] | |
| [--diskdatasize=<value_size>] [--disktestpath=<value_path>] | |
| [--systemdisplaytime=<value_time>] | |
| [--systemdisplaytimeinterval=<value_interval>] | |
| Opciones: | |
| repserverspec Servidor de Unity VCS disponible para poder | |
| realizar pruebas de red como, por ejemplo, | |
| "serverUploadTest" o "serverDownloadTest". | |
| Si no se indica ningún servidor, el comando | |
| intentará comunicarse con el servidor | |
| configurado por defecto. | |
| (Use 'cm help objectspec' para más información | |
| sobre las especificaciones de servidores.) | |
| list_of_tests Tests disponibles. Use un espacio en blanco | |
| para separar los diferentes tests. | |
| Consulte las Notas para más información. | |
| --nettotalmb Cantidad de datos de usuario (en MegaBytes) | |
| transmitidos en un test de red, por ejemplo, | |
| "serverDownloadTest" y "serverUploadTest". | |
| Debe ser un valor comprendido entre "4" y "512" | |
| (por defecto, 16). | |
| --networkiterations Número de iteraciones de los tests de red | |
| "serverDownloadTest" y "serverUploadTest". | |
| Debe ser un valor comprendido entre "1" y "100" | |
| (por defecto, 1). | |
| --diskdatasize Cantidad de datos (en MegaBytes) que se | |
| escribirán y leerán en el test de disco | |
| "diskTest". | |
| Debe ser un valor comprendido entre "100" y | |
| "4096" (por defecto, 512). | |
| --disktestpath Ruta donde el test de disco "diskTest" escribe | |
| los ficheros de tests. Si no se indica ninguna | |
| ruta, se intentará usar el directorio temporal | |
| del sistema. | |
| --systemdisplaytime Intervalo de tiempo (en segundos) en el que se | |
| muestra el uso de los recursos del sistema. | |
| Esta opción está disponible para los tests | |
| "systemNetworkUsage" y "systemDiskUsage". | |
| Debe ser un valor comprendido entre "1" y | |
| "3600" (por defecto, 5 segundos). | |
| --systemdisplaytimeinterval Intervalo de tiempo (en segundos) entre las | |
| muestras de rendimiento del sistema. Esta | |
| opcion está disponible para los tests | |
| "systemNetworkUsage" y "systemDiskUsage". | |
| Debe ser un valor comprendido entre "1" and "60" | |
| (por defecto, 1 segundo). | |
| == CMD_HELP_IOSTATS == | |
| Notas: | |
| Este comando requiere de un servidor disponible para usarse durante los tests | |
| de velocidad de red ("serverUploadTest" y "serverDownloadTest"). | |
| La ruta de la opción '--diskTestPath' debe ser una ruta dentro de la unidad | |
| física de disco que se va a probar. Si no se especifica ninguna ruta, el | |
| comando intentará usar la ruta temporal por defecto del sistema. | |
| La unidad de disco de la ruta especificada debe tener suficiente espacio | |
| libre para ejecutar la prueba. | |
| Durante la ejecución del comando, el sistema puede sufrir una caída de | |
| rendimiento a causa de las pruebas realizadas. | |
| Test disponibles: | |
| --serveruploadtest (Defecto). Mide la velocidad de subida de datos | |
| desde el cliente de Unity VCS al servidor. | |
| --serverdownloadtest (Defecto). Mide la velocidad de bajada de datos | |
| desde el servidor de Unity VCS al cliente. | |
| --disktest (Defecto). Mide la velocidad de lectura y | |
| escritura de disco. | |
| --systemnetworkusage Muestra el uso actual de los recursos de red del | |
| sistema. Se muestran contadores de rendimiento | |
| de interfaz de red (Network Interface) | |
| proporcionados por Microsoft Windows. | |
| Test disponible solo en Microsoft Windows. | |
| --systemdiskusage Muestra el uso actual de los discos físicos del | |
| sistema. Se muestran contadores de rendimiento | |
| de interfaz de red (Network Interface) | |
| proporcionados por Microsoft Windows. | |
| Test disponible solo en Microsoft Windows. | |
| Ejemplos: | |
| cm iostats MYSERVER:8087 --serveruploadtest --serverdownloadtest --nettotalmb=32 | |
| == CMD_DESCRIPTION_ISSUETRACKER == | |
| Obtiene, actualiza o busca el estado de una tarea en el sistema de incidencias | |
| (issue tracker) especificado. | |
| == CMD_USAGE_ISSUETRACKER == | |
| Sintaxis: | |
| cm issuetracker <name> status get <task_id> <parameter>[ ...] | |
| cm issuetracker <name> status update <task_id> <status> <parameter>[ ...] | |
| cm issuetracker <name> status find <status> <parameter>[ ...] | |
| cm issuetracker <name> connection check <parameter>[ ...] | |
| name Nombre del sistema de incidencias. | |
| Solo Jira está soportado por el momento. | |
| task_id Número de la tarea que se quiere consultar o actualizar. | |
| status Estado de tarea válido en el sistema especificado. | |
| Parámetros de Jira (todos son obligatorios): | |
| --user=<user> El usuario a autenticar. | |
| --password=<pwd> La contraseña a autenticar. | |
| --host=<url> La url del sistema de seguimiento de incidencias. | |
| --projectkey=<key> La clave del proyecto de Jira. | |
| == CMD_HELP_ISSUETRACKER == | |
| Ejemplos: | |
| cm issuetracker jira status get 11 --user=user@mail.es --password=pwd \ | |
| --host=https://user.atlassian.net --projectkey=PRJ | |
| (Obtiene el estado de la tarea 11 para el proyecto 'PRJ'.) | |
| cm issuetracker jira status update 11 "Done" --user=user@mail.es \ | |
| --password=pwd --host=https://user.atlassian.net --projectkey=PRJ | |
| (Actualiza el estado a 'Done' de la tarea 11 para el proyecto 'PRJ'.) | |
| cm issuetracker jira status find "Done" --user=user@mail.es --password=pwd \ | |
| --host=https://user.atlassian.net --projectkey=PRJ | |
| (Obtiene los ids de las tareas cuyo estado es "Done" en el proyecto 'PRJ'.) | |
| cm issuetracker jira connection check --user=user@mail.es --password=pwd \ | |
| --host=https://user.atlassian.net --projectkey=PRJ | |
| (Comprueba si los parámetros de configuración son válidos o no.) | |
| == CMD_DESCRIPTION_LICENSEINFO == | |
| Muestra información de la licencia y de su uso. | |
| == CMD_USAGE_LICENSEINFO == | |
| Sintaxis: | |
| cm licenseinfo | li [--server=<repserverspec>] [--inactive] [--active] | |
| [--sort=(name|status)] | |
| Opciones: | |
| --server: Obtiene la información de la licencia del servidor | |
| especificado. Si no se especifica ningún servidor, el | |
| comando se ejecutará contra el servidor configurado en | |
| el cliente. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de servidores.) | |
| --inactive Muestra únicamente usuarios inactivos en la sección | |
| "Uso de licencia". | |
| --active Muestra únicamente usuarios activos en la sección de | |
| "Uso de licencia". | |
| --sort Ordena usuarios usando el campo especificado: | |
| 'name' o 'status'. | |
| == CMD_HELP_LICENSEINFO == | |
| Notas: | |
| Se muestra información acerca de la fecha de expiración, usuarios activos y | |
| no activos, etc. | |
| Ejemplos: | |
| cm licenseinfo | |
| cm licenseinfo --server=myserver:8084 | |
| cm licenseinfo --sort=name | |
| == CMD_DESCRIPTION_LINKTASK == | |
| Enlaza un changeset a una tarea de un sistema de control de tareas. | |
| == CMD_USAGE_LINKTASK == | |
| Este comando está pensado para la automatización de otros comandos. Con lo que, | |
| es posible, que no resulte muy intuitivo. | |
| Sintaxis: | |
| cm linktask | lt <csetspec> <ext_prefix> <task_name> | |
| csetspec Especificación del changeset para enlazarlo a una tarea. | |
| (Use 'cm help objectspec' para más información sobre las | |
| especificaciones de changesets.) | |
| ext_prefix Prefijo del sistema de control de tareas configurado. | |
| task_name Identificador de la tarea en el sistema de control de tareas. | |
| == CMD_HELP_LINKTASK == | |
| Ejemplos: | |
| cm lt cs:8@rep:default@repserver:localhost:8084 jira PRJ-1 | |
| == CMD_DESCRIPTION_LOCK_LIST == | |
| Muestra los bloqueos de un servidor. | |
| == CMD_USAGE_LOCK_LIST == | |
| Sintaxis: | |
| cm lock list | ls [<revspec> [ ...]] [--server=<server>] | |
| [--onlycurrentuser] [--onlycurrentworkspace] | |
| [--ignorecase] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| revspec Si se especifican una o más revisiones, el comando | |
| mostrará una línea de bloqueo por cada revisión solo si | |
| el ítem asociado está bloqueado en el servidor. | |
| Si no se especifica ninguna revisión, el comando mostrará | |
| todos los ítems bloqueados en el servidor por defecto (o | |
| en el indicado en la opción '--server'). | |
| Use un espacio en blanco para separar revisiones en caso | |
| de especificar más de una. | |
| (Use 'cm help objectspec' para más información sobre las | |
| especificaciones de revisiones.) | |
| Opciones: | |
| --server Especificación del servidor de repositorios. | |
| Esta opción anula el servidor por defecto que se | |
| obtiene del espacio de trabajo actual o del fichero | |
| client.conf. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de servidores.) | |
| --onlycurrentuser Filtra el resultado mostrando solo los bloqueos | |
| llevados a cabo por el usuario actual. | |
| --onlycurrentworkspace Filtra el resultado mostrando solo los bloqueos | |
| del espacio de trabajo actual (comparándolos por | |
| nombre). | |
| --ignorecase Ignora mayúsculas y minúsculas en las rutas donde | |
| se usa una especificación de ruta de servidor. Por | |
| ejemplo, con esta opción, el comando funcionará tanto | |
| con "/src/foo.c" como con "/sRc/fOO.c". | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_LOCK_LIST == | |
| Notas: | |
| El comando muestra una lista de los elementos actualmente bloqueados en el | |
| servidor por defecto. También acepta una lista de especificaciones de | |
| revisión; en este caso, solo se mostrarán los bloqueos asociados a los | |
| elementos especificados. | |
| Es posible usar también la opción '--server=<server>' para consultar los | |
| bloqueos en ese servidor en concreto. | |
| El comando muestra una línea por cada bloqueo en el servidor especificado: | |
| - GUID del elemento bloqueado. | |
| - Nombre del usuario que realizó el bloqueo. | |
| - Nombre del espacio de trabajo donde se realizó el bloqueo. | |
| - Ruta del elemento bloqueado (formato de ruta de servidor). | |
| Ejemplos: | |
| cm lock list | |
| cm lock ls --server=myserver:8084 | |
| cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084 | |
| cm lock ls revid:3521@default itemid:2381@secondary --onlycurrentuser | |
| cm lock ls --onlycurrentuser | |
| cm lock ls --onlycurrentuser --onlycurrentworkspace | |
| cm lock list --machinereadable --startlineseparator=">" \ | |
| --endlineseparator="<" --fieldseparator="," | |
| == CMD_DESCRIPTION_LISTUSERS == | |
| Lista usuarios y grupos. | |
| == CMD_USAGE_LISTUSERS == | |
| Sintaxis: | |
| cm listusers | lu <repserverspec> [--onlyusers] [--onlygroups] | |
| [--filter= <str_filter>] | |
| cm listusers | lu <repserverspec> --group=<group_name> | |
| repserverspec Especificación del servidor de repositorios. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de servidores de repositorio.) | |
| Opciones: | |
| --onlyusers Muestra únicamente los usuarios. | |
| --onlygroups Muestra únicamente los grupos. | |
| --filter Muestra únicamente los usuarios o grupos que coinciden con | |
| el filtro especificado. | |
| --group Muestra únicamente los usuarios que pertenecen a un grupo | |
| determinado. Esta opción no es compatible con onlyusers, | |
| onlygroups, ni filter. | |
| == CMD_HELP_LISTUSERS == | |
| Ejemplos: | |
| cm lu localhost:8084 | |
| (Muestra todos los usuarios del servidor.) | |
| cm listusers localhost:8084 --onlyusers --filter=m | |
| (Muestra los usuarios del servidor cuyo nombre contiene 'm'.) | |
| cm listusers codice@cloud --group=Administrators | |
| (Muestra los usuarios del grupo Administrators de la organización 'codice@cloud'.) | |
| == CMD_DESCRIPTION_LOCATION == | |
| Muestra la ruta del cliente 'cm'. | |
| == CMD_USAGE_LOCATION == | |
| Sintaxis: | |
| cm location | |
| == CMD_HELP_LOCATION == | |
| == CMD_DESCRIPTION_LOCK == | |
| Este comando permite al usuario gestionar bloqueos. | |
| == CMD_USAGE_LOCK == | |
| Sintaxis: | |
| cm lock <command> [options] | |
| Comandos: | |
| list | ls | |
| unlock | |
| Para obtener más información de cada uno de los comandos use lo siguiente: | |
| cm lock <command> --usage | |
| cm lock <command> --help | |
| == CMD_HELP_LOCK == | |
| Ejemplos: | |
| cm lock list | |
| cm lock | |
| (La opción 'list' es opcional si no hay argumentos.) | |
| cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084 | |
| cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5 | |
| == CMD_DESCRIPTION_LOG == | |
| Obtiene información sobre revisiones en changesets. | |
| == CMD_USAGE_LOG == | |
| Sintaxis: | |
| cm log [<csetspec> | <repspec>] [--from=<csetspec_from>] [--allbranches] | |
| [--ancestors] [--csformat=<str_format>] [--itemformat=<str_format>] | |
| [--xml[=<output_file>]] [--encoding=<name>] | |
| [--repositorypaths | --fullpaths | --fp] | |
| Opciones: | |
| csetspec Obtiene todos los cambios hechos en el changeset | |
| especificado. | |
| (Use 'cm help objectspec' para más información sobre las | |
| especificaciones de changesets.) | |
| repspec Obtiene todos los cambios hechos en el repositorio | |
| especificado. | |
| (Use 'cm help objectspec' para más información sobre las | |
| especificaciones de repositorios.) | |
| --from Lista todos los cambios hechos en cada changeset desde | |
| el changeset especificado en [csetspec_from] hasta el | |
| changeset especificado en [csetspec]. | |
| El changeset [csetspec_from] no se incluye en la salida. | |
| Esta opción se ignorará si lo que se proporciona es una | |
| especificación de repositorio. | |
| --allbranches Muestra información sobre los changesets creados en un | |
| intervalo especificado para todas las ramas donde dichos | |
| changesets se crearon. | |
| --ancestors Muestra información sobre los changesets accesibles | |
| a través del padre y de los enlaces de mezcla (enlaces | |
| de merge) para el changeset especificado en [csetspec]. | |
| Si también se especifica el changeset [csetspec_from], | |
| este se usará como límite inferior para todas las rutas. | |
| Nota: Los cambios del changeset no se mostrarán cuando | |
| se use esta opción. | |
| --csformat Muestra información del changeset en el formato | |
| especificado. Consulte las Notas para más información. | |
| No puede combinarse con --xml. | |
| --itemformat Muestra información del ítem en el formato especificado. | |
| Consulte las Notas para más información.. | |
| No puede combinarse con --xml. | |
| --xml Imprime el resultado en formato XML a la salida estándar. | |
| También es posible especificar un fichero de salida. No | |
| puede combinarse con --csformat o --itemformat. | |
| --encoding Usado con la opción --xml, especifica el encoding que se | |
| usará en la salida XML, por ejemplo, utf-8. | |
| Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y su | |
| formato (al final de la página en la columna "Name"). | |
| --fullpaths, --fp Imprime las rutas completas de espacio de trabajo para | |
| ficheros y directorios cuando sea posible. | |
| --repositorypaths Imprime las rutas de repositorio (rutas de servidor) en | |
| lugar de las rutas de espacio de trabajo. (Esta opción | |
| anula la opción '--fullpaths'.) | |
| == CMD_HELP_LOG == | |
| Notas: | |
| - Si no se especifica ningún changeset [csetspec] ni ninguna otra opción, | |
| el comando muestra información de cada changeset creado en el último mes | |
| en cada rama. | |
| - Si solo se especifica la opción '--from', el comando muestra información | |
| de cada changeset desde el especificado en '--from' hasta el último | |
| changeset de la rama donde el especificado fue creado. | |
| - Si la opción '--allbranches' se indica sin ningún intervalo, el comando | |
| muestra la misma información que aparecería si solo se hubiera especificado | |
| 'csetspec'. | |
| - Si se usa la opción '--from', el comando muestra información desde el | |
| changeset 'csetspec_from'+1 en adelante. | |
| - El repositorio qe se utiliza para mostrar la información de los changesets | |
| es el repositorio cargado en la ruta desde donde se ejecuta el comando. | |
| Este comando acepta una cadena de formato para los ítems ('--itemformat') y | |
| una cadena de formato para los changesets ('--csformat'). | |
| Los parámetros de salida de '--csformat' son los siguientes: | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una línea nueva. | |
| {changesetid} Número de changeset. | |
| {branch} Rama donde se creó el changeset. | |
| {date} Fecha de creación del changeset. | |
| {owner} Propietario del changeset. | |
| {comment} Comentario del changeset. | |
| {items} Ítems involucrados en el changeset. | |
| {repository} Repositorio donde existe el changeset. | |
| {repserver} Nombre del servidor. | |
| Los parámetros de salida de '--itemformat' son los siguientes: | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una línea nueva. | |
| {path} Ruta del ítem. | |
| {branch} Rama donde se creó el changeset. | |
| {date} Fecha de creación del changeset. | |
| {owner} Propietario del changeset. | |
| {shortstatus} Imprime el estado en el formato corto. Vea abajo. | |
| {fullstatus} Imprime el estado en el formato largo. Vea abajo. | |
| Formato corto para el estado y su correspondiente formato largo: | |
| 'A' Added | |
| 'D' Deleted | |
| 'M' Moved | |
| 'C' Changed | |
| Estas son cadenas válidas de formateo de salida: | |
| --csformat="{newline}Changeset {changesetid} creado en {date};{tab} ítems cambiados: {items}." | |
| --itemformat="{newline}El ítem {path} se creó en la rama {branch}." | |
| Ejemplos: | |
| cm log | |
| (Muestra información de todos los changesets creados en el último mes en | |
| cualquier rama.) | |
| cm log cs:16 | |
| (Muestra la información de los cambios realizados en el changeset 16 en la | |
| rama en que se creó dicho changeset.) | |
| cm log cs:16 --csformat="{newline}Changeset {changesetid} creado el día {date}; \ | |
| {tab} ítems cambiados: {items}." | |
| (Muestra la información en el formato especificado.) | |
| cm log --from=cs:20 cs:50 | |
| (Muestra información de todas las revisiones de todos los changesets | |
| comprendidos entre el 21 y el 50.) | |
| cm log --from=cs:20 cs:50 --allbranches | |
| (Muestra información de todas las revisiones de todos los changesets | |
| comprendidos entre el 21 y el 50 en todas las ramas del repositorio.) | |
| cm log rep:myrep@localhost:8084 | |
| (Muestra información de todos los changesets creados en el repositorio | |
| especificado. No hay que especificar ningún espacio de trabajo para ejecutar | |
| el comando.) | |
| cm log --from=cs:20@rep:mainRep@localhost:8084 | |
| (Muestra información de todas las revisiones de todos los changesets desde | |
| el changeset 21. No hay que especificar ningún espacio de trabajo para | |
| ejecutar el comando porque se está indicando una especificación completa de | |
| changeset.) | |
| == CMD_DESCRIPTION_LS == | |
| Lista el contenido de árbol. | |
| == CMD_USAGE_LS == | |
| Sintaxis: | |
| cm ls | dir [<paths>[ ...]] [--format=<str_format>] [--symlink] | |
| [--selector[=<selector_format>]] [--tree=<obj_spec>] | |
| [-R | -r | --recursive] | |
| [--xml[=<output_file>]] [--encoding=<name>] | |
| Opciones: | |
| paths Lista de rutas a mostrar. Use un espacio en blanco para | |
| separar rutas. | |
| Use comillas dobles (" ") para especificar rutas que | |
| contengan espacios. | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. No puede | |
| combinarse con --xml. | |
| --symlink Incluye en el checkin al symlink pero no al destino | |
| (target). | |
| --selector Obtiene el contenido del selector del espacio de trabajo | |
| activo. | |
| Si se especifica un valor para 'selector_format', entonces | |
| muestra el selector especificado. | |
| Esta opción está prácticamente obsoleta ya que los | |
| selectores no son una parte central de Unity VCS desde la | |
| versión 4.x. | |
| --tree Lista el árbol en el changeset o rama especificados. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones.) | |
| -R Lista recursivamente. | |
| --xml Imprime el resultado en formato XML a la salida estándar. | |
| También es posible especificar un fichero de salida. No | |
| puede combinarse con --format. | |
| --encoding Usado con la opción --xml, especifica el encoding que se | |
| usará en la salida XML, por ejemplo, utf-8. | |
| Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y su | |
| formato (al final de la página en la columna "Name"). | |
| == CMD_HELP_LS == | |
| Notas: | |
| - Es posible especificar rutas con metacaracteres (*, ?, ...). | |
| - La lista resultante depende del selector del espacio de trabajo. | |
| - La salida del comando se puede formatear especificando una cadena de formato. | |
| - Si no se especifica alguna de estas opciones '--tree' o '--selector', | |
| entonces la ruta indicada tiene que ser una ruta de servidor ('cm path'), | |
| por ejemplo, /dir/file.txt, y no una ruta de espacio de trabajo, por | |
| ejemplo, C:\Users\myuser\mywk\dir\file.txt. | |
| - Si no se indica ninguna ruta, se asumirá que la ruta de espacio de trabajo | |
| es el directorio actual. Si se especifica alguna de estas opciones '--tree' | |
| o '--selector', entonces se asumirá como ruta la raíz ("/"). | |
| La cadena de formato por defecto que se mostrará es: | |
| "{size,10} {date:dd/MM/yyyy} {date:HH:mm} \ | |
| {type,-6} {location,-12} {checkout,-5} {name} \ | |
| {symlinktarget}" | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {size} | |
| {formattedsize} | |
| {date} | |
| {type} | |
| dir directorio, | |
| txt fichero de texto, | |
| File fichero. | |
| {location} Por ejemplo: br:branch#cset | |
| {checkout} | |
| {name} | |
| {changeset} | |
| {path} | |
| {repspec} | |
| {owner} | |
| {revid} | |
| {parentrevid} | |
| {itemid} | |
| {brid} | |
| {repid} | |
| {server} | |
| {symlinktarget} | |
| {hash} | |
| {chmod} | |
| {wkpath} Ruta relativa a la raíz del espacio de trabajo | |
| {branch} | |
| {newlocation} cset@branch | |
| {guid} (El comando tardará más tiempo en resolverse) | |
| {itemguid} | |
| {transformed} Muestra la regla aplicada para ítems transformados. | |
| Lea la Guía del Administrador para más información sobre | |
| Transformable workspaces: | |
| https://www.plasticscm.com/download/help/adminguide | |
| You can customize the 'ls' format setting the PLASTIC_LS_FORMAT environment | |
| variable. | |
| Configure la variable de entorno PLASTIC_LS_FORMAT para especificar la | |
| salida del comando y evitar así tener que especificar un valor para la | |
| opción '--format' cada vez que ejecute el comando 'cm ls'. | |
| Ejemplos: | |
| cm ls | |
| cm ls c:\workspace\src | |
| cm ls --format={name} | |
| (Muestra solo nombres de ficheros.) | |
| cm ls --symlink | |
| (Muestra información de los symlinks y no del fichero o directorio al que | |
| apuntan.) | |
| cm ls code --selector | |
| (Muestra el contenido del subdirectorio 'code' del selector del espacio de | |
| trabajo actual.) | |
| cm ls /code --selector="rep 'myrep' path '/' branch '/main'" | |
| (Muestra el contenido del subdirectorio '/code' del selector especificado. | |
| La ruta se ha especificado en formato servidor.) | |
| cm ls /code --tree=44@myrep@denver:7070 | |
| (Lista el subdirectorio '/code' en el changeset 44 del repositorio 'myrep' | |
| en el servidor 'denver:7070'.) | |
| cm ls /code --tree=br:/main/scm13596@myrep@denver:7070 | |
| (Lista el subdirectorio '/code' en el último changeset de la rama | |
| '/main/scm13596' del repositorio 'myrep' en el servidor 'denver:7070'.) | |
| cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070 | |
| (Lista el subdirectorio '/code' en el changeset | |
| ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 del repositorio 'myrep' en el servidor | |
| 'denver:7070'.) | |
| == CMD_DESCRIPTION_TRIGGER_LIST == | |
| Lista los triggers de un determinado tipo en un servidor. | |
| == CMD_USAGE_TRIGGER_LIST == | |
| Sintaxis: | |
| cm trigger | tr list | ls [<subtype-type>] [--server=<repserverspec>] | |
| [--format=<str_format>] | |
| Opciones: | |
| subtype-type Ejecución y operación del trigger. | |
| (Use 'cm showtriggertypes' para ver la lista de tipos de | |
| triggers.) | |
| --server Lista los triggers del servidor especificado. | |
| Si no se especifica ningún servidor, el comando se | |
| ejecuta en el servidor configurado en el cliente. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de servidor.) | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| == CMD_HELP_TRIGGER_LIST == | |
| Notas: | |
| Si no se especifica el tipo, muestra todos los triggers del servidor. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} Posición del trigger. | |
| {1} Nombre del trigger. | |
| {2} Ruta del trigger. | |
| {3} Propietario del trigger. | |
| {4} Tipo del trigger. | |
| {5} Filtro del trigger. | |
| Ejemplos: | |
| cm trigger list after-mklabel | |
| (Lista todos los triggers del tipo 'after-mklabel' en el servidor configurado | |
| en el cliente.) | |
| cm tr ls before-mkbranch --server=myserver:8084 | |
| (Lista todos los triggers del tipo 'before-mkbranch' en el servidor | |
| 'myserver:8084'.) | |
| == CMD_DESCRIPTION_MANIPULATESELECTOR == | |
| Cambia el selector a una fecha. | |
| == CMD_USAGE_MANIPULATESELECTOR == | |
| Este comando está pensado para la automatización de otros comandos. Con lo que, | |
| es posible, que no resulte muy intuitivo. | |
| Sintaxis: | |
| cm manipulateselector | ms [<wk_path> | <wk_spec>] --atdate=<sel_date> | |
| wk_path Ruta del espacio de trabajo. | |
| wk_spec Especificación del espacio de trabajo. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de espacios de trabajo.) | |
| Opciones: | |
| --atdate Devuelve un selector que recreará el espacio de trabajo con | |
| los contenidos que se cargarían en la fecha especificada. | |
| == CMD_HELP_MANIPULATESELECTOR == | |
| Notas: | |
| Si no se indica ni la ruta o la especificación del espacio de trabajo, el | |
| comando tomará el directorio actual como ruta del espacio de trabajo. | |
| Ejemplos: | |
| cm manipulateselector c:\workspace --atdate=yyyy-MM-ddTHH:mm:ss | |
| cm manipulateselector --atdate=yyyy-MM-ddTHH:mm:ss | |
| cm manipulateselector > mySelector.txt --atdate=yyyy-MM-ddTHH:mm:ss | |
| cm manipulateselector wk:build_wk@BUILDER --atdate=yyyy-MM-ddTHH:mm:ss | |
| == CMD_DESCRIPTION_MERGE == | |
| Mezcla una rama con otra. | |
| == CMD_USAGE_MERGE == | |
| Sintaxis: | |
| cm merge <source_spec> [--merge] [--cherrypicking] [--forced] | |
| [--mergetype=(onlyone|onlysrc|onlydst|try|forced)] | |
| [--interval-origin=<csetspec> | --ancestor=<csetspec>] | |
| [--keepsource | --ks] [--keepdestination | --kd] | |
| [--automaticresolution=<conflict-types>[;...]] | |
| [--subtractive] [--mount] [--printcontributors] | |
| [--noprintoperations] [--silent] | |
| [(--to=<brspec> | --destination=<brspec>)[--shelve]] | |
| [--no-dst-changes] | |
| [-c=<str_comment> | --commentsfile=<comments_file>] | |
| [--resolveconflict --conflict=<index> | |
| --resolutionoption=(src|dst|(rename --resolutioninfo=<strname>)) | |
| --mergeresultfile=<path> --solvedconflictsfile=<path>] | |
| [--nointeractiveresolution] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--xml] [--encoding] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| source_spec Especificación del objeto origen de la mezcla (merge). | |
| Este puede ser: | |
| - especificación de una rama: '[br:/]br_name' | |
| - especificación de una etiqueta: 'lb:lb_name' | |
| - especificación de un changeset: 'cs:cs_number' | |
| - especificación de un almacenamiento (shelve): 'sh:shelve_number' | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones.) | |
| Opciones: | |
| --merge Realiza el merge. Si no se especifica esta opción, | |
| se muestran los conflictos encontrados. | |
| --cherrypicking Realiza el merge de los cambios incluidos en los | |
| changesets origen. Esta opción se omitirá si el | |
| origen del merge es una etiqueta. | |
| --forced No comprueba si el origen y el destino ya están | |
| conectados. | |
| Esta opción solo es válida para el merge de intervalo | |
| y para el cherry picking. | |
| --mergetype Especifica el tipo de merge. Consulte las Notas | |
| para más información. | |
| --interval-origin Especifica el changeset inicio del intervalo. El | |
| merge solo tendrá en cuenta las diferencias entre | |
| el changeset origen y el inicio del intervalo | |
| especificado. | |
| --ancestor Alias para '--interval-origin'. | |
| --keepsource Acepta todos los cambios del contribuidor origen | |
| para los elementos con conflictos. | |
| --keepdestination Preserva los cambios del contribuidor destino | |
| para elementos con conflictos. | |
| --automaticresolution Opción para resolver conflictos de directorio. Esta | |
| opción permite elegir automáticamente entre el | |
| contribuidor origen (source) o el contribuidor | |
| destino (destination) para resolver el conflicto. | |
| Use punto y coma (;) para separar los tipos de | |
| conflicto. Consulte las Notas para más información. | |
| --subtractive Elimina los cambios introducidos por un merge. | |
| El parámetro (source_spec) que se pasa al comando | |
| especifica el origen a partir del cual eliminar los | |
| cambios. Debe ser un changeset. En el caso de un | |
| intervalo de changesets, debe utilizar la opción | |
| '--interval-origin' para definir el inicio del | |
| intervalo. Para eliminar un cambio, el sistema | |
| crea una nueva revisión desprotegida con todo el | |
| contenido anterior excepto los cambios eliminados. | |
| --mount El punto de montaje del repositorio especificado. | |
| --printcontributors Muestra los contribuidores (base, origen y destino). | |
| --noprintoperations Resuelve las mezclas (merges) sin mostrar | |
| información sobre la resolución. | |
| --silent Solo se imprimen mensajes en caso de error. | |
| --to | --destination Realiza una operación de merge-to a la rama de | |
| especificada con resolución completa de conflictos. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de ramas.) | |
| Una mezcla "merge-to" (o mezcla sin espacio de | |
| trabajo) es una mezcla que se hace en el lado del | |
| servidor. Mientras que las mezclas normales | |
| ocurren en un espacio de trabajo mezclando desde | |
| ("from") una rama, etiqueta o changeset, una mezcla | |
| "merge-to" tiene lugar en el servidor. Mientras que | |
| en mezclas normales el destino es el espacio de | |
| trabajo, en una mezcla "merge-to" se debe | |
| especificar el destino (por eso se llama "to", | |
| 'hacia' en inglés). | |
| Lea la siguiente guía para más información: | |
| https://www.plasticscm.com/download/help/mergeto | |
| --shelve Crea un almacenamiento (shelve) con los cambios del | |
| resultado del merge (además de información de | |
| trazabilidad de la mezcla) en lugar de crear | |
| un nuevo changeset. Esta opción no es válida cuando | |
| el origen del merge es un shelve. Esta opción sólo | |
| está disponible para el merge del lado del servidor | |
| (merge-to). Por ello, hay que especificar las | |
| opciones '--to' y '--merge'. | |
| --no-dst-changes Asegura que el contribuidor destino no tiene cambios | |
| (el changeset destino es también el antecesor | |
| común). Cuando hay cambios en el destino, no se | |
| permite hacer el merge. | |
| -c Añade un comentario al changeset que se crea al | |
| hacer la mezcla. | |
| --commentsfile Asigna el comentario especificado en el fichero al | |
| changeset que se crea al hacer la mezcla. | |
| --resolveconflict (Usado principalmente por plugins. Consulte las | |
| Notas para más información.) | |
| Usado para resolver un conflicto de directorio. | |
| --conflict Usado con '--resolveconflict', especifica el | |
| índice del conflicto a resolver empezando por 1. | |
| --resolutionoption Usado con '--resolveconflict', indica el tipo de | |
| resolución de conflicto. Puede ser una de las | |
| siguientes opciones: 'src', 'dst', 'rename'. | |
| Consulte las Notas para más información. | |
| --resolutioninfo Usado con '--resolveconflict', proporciona el | |
| nombre que se usará cuando la opción | |
| '--resolutionoption' es 'rename'. | |
| --mergeresultfile Usado con '--resolveconflict', guarda en un fichero | |
| la información del resultado de la mezcla entre | |
| diferentes llamadas. El fichero especificado se | |
| crea en la primera llamada y se actualiza en las | |
| las siguientes llamadas. | |
| --solvedconflictsfile Usado con '--resolveconflict', guarda en un fichero | |
| la información de los conflictos solucionados | |
| entre diferentes llamadas. El fichero especificado | |
| se crea en la primera llamada y se actualiza en | |
| las siguientes llamadas. | |
| --nointeractiveresolution (Usado principalmente por plugins. Consulte las | |
| Notas para más información.) | |
| Evita preguntar al usuario cuando hay un conflicto | |
| manual. Así, por ejemplo, un conflicto de directorio | |
| no podrá ser resuelto. | |
| --machinereadable (Usado principalmente por plugins. Consulte las | |
| Notas para más información.) | |
| Muestra el resultado en un formato fácil de parsear. | |
| --xml Imprime el resultado en formato XML a la salida estándar. | |
| También es posible especificar un fichero de salida. No | |
| puede combinarse con --format ni --resolveconflict. | |
| --encoding Usado con la opción --xml, especifica el encoding que se | |
| usará en la salida XML, por ejemplo, utf-8. | |
| Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y su | |
| formato (al final de la página en la columna "Name"). | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. (Por defecto, | |
| una cadena de texto vacía.) | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. (Por defecto, | |
| una cadena de texto vacía.) | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| (Por defecto, un espacio en blanco.) | |
| == CMD_HELP_MERGE == | |
| Notas: | |
| Este comando se utiliza para meclar cambios entre dos ramas, o entre una | |
| etiqueta y una rama. El destino del merge siempre debe ser una rama. | |
| El origen del merge se especifica como argumento. | |
| El destino es el contenido actual del espacio de trabajo. | |
| Por ejemplo, para mostrar los elementos que se mezclarán desde la rama | |
| task001 a la rama principal, el selector debe apuntar a la rama principal, | |
| el espacio de trabajo debe estar actualizado, y entonces ejecutar: | |
| cm merge br:/task001 | |
| Para que el merge se realice, hay que añadir la opción '--merge': | |
| cm merge br:/task001 --merge | |
| Para definir el origen de la mezcla, puede usar las siguientes especificaciones: | |
| - Especificación de rama (brspec): | |
| [br:/]br_name | |
| Por ejemplo: br:/main/task001 | |
| (Mezcla desde el último changeset de la rama especificada.) | |
| - Especificación de etiqueta (lbspec): | |
| lb:lb_name | |
| Por ejemplo: lb:BL001 | |
| (Mezcla desde el último changeset etiquetado.) | |
| - Especificación de changeset (csetspec): | |
| cs:cs_number | |
| Por ejemplo: cs:25 | |
| (Mezcla desde el contenido del changeset especificado.) | |
| - Especificación de almancenamiento o shelve (shspec): | |
| sh:shelve_number | |
| Por ejemplo: sh:2 | |
| (Mezcla desde el contenido del shelve.) | |
| Para resolver automáticamente conflictos de directorio use la opción | |
| "--automaticresolution" y especifique el tipo de conflicto seguido por el | |
| contribuidor (origen o destino) que se seleccionará durante el merge. | |
| (Separe cada par "tipo de conflicto"-"contribuidor" con punto y coma (;).) | |
| Por ejemplo: | |
| cm merge cs:2634 --merge --automaticresolution=eviltwin-src;changedelete-src | |
| (La operación de merge desde el changeset 2634 resuelve los conflictos | |
| "eviltwin" y "changedelete" manteniendo al contribuidor origen ("-src") | |
| en ambos conflictos.) | |
| - El sufijo "-src" añadido después del tipo de conflicto indica al comando | |
| merge que debe mantener los cambios del contribuidor origen (source). | |
| - El sufijo "-dst" mantendrá los cambios del contribuidor destino | |
| (destination). | |
| Esta es la lista de tipos de conflictos que soporta el comando merge: | |
| "movedeviltwin", "eviltwin", "changedelete", "deletechange", "movedelete", | |
| "deletemove", "loadedtwice", "addmove", "moveadd", "divergentmove", | |
| "cyclemove", "all". | |
| El valor "all" anula el resto de opciones. En el siguiente ejemplo, el | |
| conflicto "eviltwin-dst" será ignorado: | |
| cm merge br:/main/task062 --merge --automaticresolution=all-src;eviltwin-dst | |
| Consulte el siguiente enlace para más información sobre conflictos de merge: | |
| https://www.plasticscm.com/download/help/directorymerges | |
| Estas son los valores para la opción --mergetype: | |
| onlyone Merge automático si solo uno de los contribuidores modificó | |
| el elemento. | |
| onlysrc Merge automático si solo el contribuidor origen modificó el | |
| elemento. | |
| onlydst Merge automático si solo el contribuidor destino modificó el | |
| elemento. | |
| try Merge automático si solo un contribuidor ha modificado la | |
| parte del fichero en conflicto (para cada conflicto). | |
| forced Intenta resolver siempre los conflictos no automáticos. | |
| Estas son las opciones que se usan principalmente por plugins e integraciones: | |
| - "--resolveconflict" para resolver un conflicto de directorio. Se | |
| deben usar las siguientes opciones: | |
| - "--conflict" es el índice del conflicto que se quiere resolver | |
| (empezando por 1). | |
| - "--resolutionoption" indica el tipo de resolución de conflicto. | |
| Puede ser: | |
| - "src" para mantener el cambio del origen y descartar el | |
| cambio del destino | |
| - "dst" para mantener el cambio del destino y descartar el | |
| cambio del origen | |
| - "rename" (solo si el tipo de conflicto soporta esta | |
| resolución) para renombar el destino al nombre | |
| proporcionado en la opción "--resolutioninfo". | |
| - "--resolutioninfo" para proporcionar el nombre a usar | |
| con el tipo de resolución "rename" | |
| - "--mergeresultfile" y "--solvedconflictsfile", ambos se usan | |
| para guardar informacación de la mezcla entre las diferentes | |
| llamadas. | |
| - "nointeractiveresolution" indica a la mezcla que no pregunte al usuario | |
| en caso de necesitarse una resolución manual de un conflicto. | |
| - "--machinereadable" y "--startlineseparator", "--endlineseparator", | |
| "fieldseparator" se usan para imprimir la salida a un formato fácil | |
| de leer, tratar o parsear. | |
| Por ejemplo: | |
| cm merge --machinereadable --startlineseparator=start@_@line \ | |
| --endlineseparator=new@_@line --fieldseparator=def#_#sep \ | |
| --mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \ | |
| --solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \ | |
| --resolveconflict --conflict=1 --resolutionoption=rename \ | |
| --resolutioninfo=bin_dst br:/main/task --merge | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplos: | |
| cm merge br:/task001 | |
| (No realiza la mezcla, simplemente muestra los elementos que se van a | |
| mezclar.) | |
| cm merge br:/task001 --merge | |
| (Realiza el merge desde la rama task001.) | |
| cm merge cs:5 --merge --cherrypicking --interval-origin=cs:2 | |
| (Cherry pick del intervalo de changesets (2,5].) | |
| cm merge cs:8 --merge --subtractive --keepdestination | |
| (Merge sustractivo del changeset 8, preservando los cambios del destino | |
| para aquellos elementos con conflictos.) | |
| cm merge br:/main/task001 --to=br:/main --merge -c="Integrated new UI" | |
| (Realiza el merge en el lado del servidor -a.k.a. "merge-to"-, desde la | |
| rama 'task001' hasta la rama 'main' y añade un comentario.) | |
| cm merge br:/main/task001 --to=br:/main --merge --shelve | |
| (Realiza el merge en el lado del servidor desde la rama 'task001' a la rama | |
| 'main' y deja el resultado en un shelve.) | |
| cm merge sh:2 --to=br:/main --merge --no-dst-changes | |
| (Aplica el shelve 2 en la rama 'main' solo si fue creado desde la cabeza | |
| actual de 'main'.) | |
| == CMD_DESCRIPTION_ATTRIBUTE_CREATE == | |
| Crea un atributo nuevo. | |
| == CMD_USAGE_ATTRIBUTE_CREATE == | |
| Sintaxis: | |
| cm attribute | att create | mk <att_name> | |
| att_name Nombre del atributo. | |
| == CMD_HELP_ATTRIBUTE_CREATE == | |
| Notas: | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplos: | |
| cm attribute create status | |
| (Crea el atributo 'status'.) | |
| cm att mk integrated | |
| (Crea el atributo 'integrated'.) | |
| == CMD_DESCRIPTION_BRANCH == | |
| Permite al usuario gestionar ramas. | |
| == CMD_USAGE_BRANCH == | |
| Sintaxis: | |
| cm branch | br <command> [options] | |
| Comandos: | |
| create | mk | |
| delete | rm | |
| rename | |
| history | |
| showmain | |
| showmerges | |
| Para obtener más información sobre cada comando: | |
| cm branch command --usage | |
| cm branch command --help | |
| == CMD_HELP_BRANCH == | |
| Ejemplos: | |
| cm branch /main/scm21345 | |
| cm branch create /main/scm21345 | |
| cm branch delete /main/scm21345 | |
| cm branch rename /main/scm21345 scm21346 | |
| cm branch history /main/scm21345 | |
| cm branch showmain | |
| cm branch showmerges file.txt | |
| == CMD_DESCRIPTION_BRANCH_CREATE == | |
| Crea una rama. | |
| == CMD_USAGE_BRANCH_CREATE == | |
| Sintaxis: | |
| cm branch | br [create | mk] <brspec> | |
| [--changeset=<csetspec> | --label=<lbspec>] | |
| [-c=<str_comment> | -commentsfile=<comments_file>] | |
| brspec Nombre o especificación de la nueva rama. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de ramas.) | |
| Opciones: | |
| --changeset Changeset usado como punto de partida de la nueva rama. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de changesets.) | |
| --label Etiqueta usada como punto de partida de la nueva rama. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de ramas.) | |
| -c Asigna el comentario especificado a la nueva rama. | |
| --commentsfile Asigna el comentario especificado en el fichero a la | |
| nueva rama. | |
| == CMD_HELP_BRANCH_CREATE == | |
| Notas: | |
| Para crear una rama de primer nivel, especifique el nombre sin jerarquía. | |
| Por ejemplo: | |
| cm br /dev | |
| Si no se especifica el parámetro '--changeset', la base de la nueva rama | |
| será el último changeset de la rama madre. En caso de que la rama sea de | |
| primer nivel, se utilizará como base el changeset 0. | |
| Para especificar comentarios use la opción "-c" o "-m" del siguiente modo: | |
| cm branch main/task001 -c="Este es el comentario" | |
| cm branch main/task001 -m "Este es el comentario" | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplos: | |
| cm branch task001 | |
| cm branch create task001 | |
| cm branch mk task001 | |
| cm br mk task001 | |
| (Todos los ejemplos anteriores, crean una rama de primer nivel llamada | |
| 'task001' en el repositorio del espacio de trabajo actual.) | |
| cm branch br:/task001/task002 | |
| (Crea la rama 'task002' como hija de 'task001'.) | |
| cm br /main/task001@myrep@myserver:8084 -c="my comment" | |
| (Crea la rama 'task001' como hija de 'main' en el repositorio | |
| 'myrepo@myserver:8084' y asigna como comentario el texto 'my comment'.) | |
| cm br mk br:/main/task001 --changeset=2837 -commentsfile=commenttask001.txt | |
| (Crea la rama 'task001' como hija de 'main' con base el changeset '2837' | |
| y asigna como comentario el texto del fichero 'commenttask001.txt'.) | |
| == CMD_DESCRIPTION_BRANCH_DELETE == | |
| Borra una o más ramas. | |
| == CMD_USAGE_BRANCH_DELETE == | |
| Sintaxis: | |
| cm branch | br delete | rm <brspec>[ ...] | |
| brspec Rama a borrar. Use un espacio en blanco para separar ramas. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de ramas.) | |
| == CMD_HELP_BRANCH_DELETE == | |
| Notas: | |
| Este comando borra una o más ramas. | |
| Ejemplos: | |
| cm branch delete /main/task001 | |
| (Borra la rama con nombre 'task001' que es hija de 'main' en el repositorio | |
| del espacio de trabajo actual.) | |
| cm br rm main/task002 /main/task012@reptest@myserver:8084 | |
| (Borra la rama '/main/task002' del repositorio del espacio de trabajo actual | |
| y la rama '/main/task012' del repositorio 'reptest@myserver:8084'.) | |
| == CMD_DESCRIPTION_BRANCH_RENAME == | |
| Renombra una rama. | |
| == CMD_USAGE_BRANCH_RENAME == | |
| Sintaxis: | |
| cm branch | br rename <brspec> <new_name> | |
| brspec Rama a renombrar. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de ramas.) | |
| new_name Nuevo nombre para la rama. | |
| == CMD_HELP_BRANCH_RENAME == | |
| Notas: | |
| Este comando renombra una rama. | |
| Ejemplos: | |
| cm branch rename /main/task0 task1 | |
| (Renombra la rama '/main/task0' a '/main/task1'.) | |
| cm br rename br:/main@reptest@server2:8084 secondary | |
| (Renombra la rama 'main' del repositorio 'reptest' a 'secondary'.) | |
| == CMD_DESCRIPTION_BRANCH_HISTORY == | |
| Muestra la historia de una rama. | |
| == CMD_USAGE_BRANCH_HISTORY == | |
| Sintaxis: | |
| cm branch | br history <brspec> [--dateformat=<date_format>] | |
| [--machinereadable] | |
| brspec Especificación de la rama de la que obtener la historia. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de ramas.) | |
| Opciones: | |
| --dateformat Configura el formato de salida para la impresión de | |
| fechas. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| == CMD_HELP_BRANCH_HISTORY == | |
| Ejemplos: | |
| cm branch history br:/main/scm001@myrepository@myserver:8084 | |
| (Muestra la historia de la rama '/main/scm001' del repositorio 'myrepository' | |
| en el servidor 'myserver'.) | |
| cm br history main --dateformat="yyyy, dd MMMM" --machinereadable | |
| (Muestra la historia de la rama 'main' del repositorio actual con un formato | |
| de fecha determinado y con un formato sencillo de parsear.) | |
| == CMD_DESCRIPTION_BRANCH_SHOWMAIN == | |
| Muestra la rama principal de un repositorio. | |
| Con toda probabilidad, la rama principal de sus repositorios se denominará '/main'. | |
| Este comando está pensado para la automatización de otros comandos. | |
| == CMD_USAGE_BRANCH_SHOWMAIN == | |
| Sintaxis: | |
| cm branch | br showmain [<repspec>] [--encoding=<name>] | |
| [--format=<format_str>] [--dateformat=<date_format>] | |
| repspec Especificación del repositorio de donde mostrar la rama principal. | |
| Si no se especifica ningún repositorio, se mostrará la rama | |
| principal del repositorio del espacio de trabajo actual. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de repositorio.) | |
| Opciones: | |
| --encoding Especifica el encoding que se usará en la salida, por | |
| ejemplo, utf-8. Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --dateformat Configura el formato de salida para la impresión de fechas. | |
| == CMD_HELP_BRANCH_SHOWMAIN == | |
| Notas: | |
| Este comando muestra la rama principal de un repositorio. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {id} Id de la rama. | |
| {comment} Comentario. | |
| {date} Fecha. | |
| {name} Nombre. | |
| {owner} Propietario. | |
| {parent} Nombre de la rama madre. | |
| {repository} Repositorio. | |
| {repname} Nombre del repositorio. | |
| {repserver} Servidor. | |
| {changeset} Último changeset de la rama (head). | |
| Ejemplos: | |
| cm branch showmain | |
| (Muestra la rama principal del repositorio del espacio de trabajo actual.) | |
| cm branch showmain repo@server:8084 | |
| (Muestra la rama principal del repositorio 'repo' en el servidor | |
| 'server:8084'.) | |
| cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8 | |
| (Muestra la rama principal del repositorio con las fechas en un determinado | |
| formato y la salida codificada en utf-8.) | |
| cm br showmain --format="{id} - {name}" | |
| (Muestra la rama principal del repositorio mostrando únicamente su id y | |
| nombre.) | |
| == CMD_DESCRIPTION_BRANCH_SHOWMERGES == | |
| Muestra las ramas que están pendientes de mezclar (merge). | |
| == CMD_USAGE_BRANCH_SHOWMERGES == | |
| Este comando está pensado para la automatización de otros comandos. Con lo que, | |
| es posible, que no resulte muy intuitivo. | |
| Sintaxis: | |
| cm branch | br showmerges <item_path>[ ...] | |
| [--format=<format_str>] | |
| [--dateformat=<date_format>] | |
| Opciones: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| --dateformat Configura el formato de salida para la impresión de fechas. | |
| == CMD_HELP_BRANCH_SHOWMERGES == | |
| Notas: | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {id} Id de la rama. | |
| {comment} Comentario. | |
| {date} Fecha. | |
| {name} Nombre. | |
| {owner} Propietario. | |
| {parent} Nombre de la rama madre. | |
| {parentid} Id de la rama madre. | |
| {repid} Id del repositorio. | |
| {repository} Repositorio. | |
| {repname} Nombre del repositorio. | |
| {repserver} Servidor del repositorio. | |
| Ejemplos: | |
| cm branch showmerges file.txt | |
| (Muestra las ramas involucradas en el merge pendiente del fichero file.txt.) | |
| cm branch showmerges file.txt --format="{date} {name}" --dateformat="ddMMyy" | |
| (Muestra las ramas involucradas en el merge mostrando solo la fecha y el | |
| nombre y con las fechas en un determinado formato.) | |
| == CMD_DESCRIPTION_REPOSITORY == | |
| Permite al usuario administrar repositorios. | |
| == CMD_USAGE_REPOSITORY == | |
| Sintaxis: | |
| cm repository | repo <command> [options] | |
| Comandos: | |
| create | mk | |
| delete | rm | |
| list | ls | |
| rename | |
| add | |
| Para obtener más información sobre cada comando: | |
| cm repository <command> --usage | |
| cm repository <command> --help | |
| == CMD_HELP_REPOSITORY == | |
| Ejemplos: | |
| cm repository | |
| cm repository list | |
| cm repository newrepo | |
| cm repository create newrepo | |
| cm repository rename oldname newname | |
| cm repository add C:\repo\ | |
| == CMD_DESCRIPTION_REPOSITORY_CREATE == | |
| Crea un repositorio en un servidor. | |
| == CMD_USAGE_REPOSITORY_CREATE == | |
| Sintaxis: | |
| cm repository | repo <rep_name> | |
| cm repository | repo <repserverspec> <rep_name>[ ...] | |
| cm repository | repo [create | mk] <rep_name> | |
| repserverspec Especificación del servidor de repositorios. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de repositorios de servidor.) | |
| rep_name Nombre del nuevo repositorio. Use un espacio en | |
| blanco para separar nombres de repositorio. | |
| == CMD_HELP_REPOSITORY_CREATE == | |
| Ejemplos: | |
| cm repository MyRep | |
| cm repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB | |
| cm repo create Rep01 | |
| cm repo mk list | |
| == CMD_DESCRIPTION_REPOSITORY_DELETE == | |
| Borra un repositorio de un servidor. | |
| == CMD_USAGE_REPOSITORY_DELETE == | |
| Sintaxis: | |
| cm repository | repo delete | rm <repspec> | |
| repspec Especificación del repositorio. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de repositorios.) | |
| == CMD_HELP_REPOSITORY_DELETE == | |
| Nota: | |
| Borra un repositorio del servidor de repositorios. | |
| No borra los datos de la base de datos; simplemente "desconecta" el | |
| repositorio de la base de datos para que no sean accesibles. (Los datos | |
| se pueden "reconectar" de nuevo con el comando 'cm repository add'.) | |
| Ejemplos: | |
| cm repository delete myrepository@repserver:myserver:8084 | |
| cm repository rm myrepository@myserver:8084 | |
| cm repo rm myrepository | |
| == CMD_DESCRIPTION_REPOSITORY_LIST == | |
| Lista los repositorios de un servidor. | |
| == CMD_USAGE_REPOSITORY_LIST == | |
| Sintaxis: | |
| cm repository | repo [list | ls] [<repserverspec>] [--format=<str_format>] | |
| repserverspec Especificación del servidor de repositorios. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de servidor de repositorios.) | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. | |
| == CMD_HELP_REPOSITORY_LIST == | |
| Notas: | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {repid} | {0} Identificador del repositorio. | |
| {repname} | {1} Nombre del repositorio. | |
| {repserver} | {2} Nombre del servidor del repositorio. | |
| {repowner} | {3} Propietario del repositorio. | |
| {repguid} | {4} Identificador único del repositorio. | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una nueva línea. | |
| Si el valor de opción '--format' es 'TABLE', la salida se imprimirá en formato | |
| tabla con los siguientes campos: {repid}, {repname} y {repserver}. | |
| Ejemplos: | |
| cm repository | |
| (Lista todos los repositorios.) | |
| cm repository list localhost:8084 --format="{1, -20} {3}" | |
| (Muestra el nombre del repositorio utilizando 20 espacios y alineado a la | |
| izquierda, un espacio y el propietario del repositorio.) | |
| cm repository ls localhost:8084 --format="{repname, -20} {repowner}" | |
| (Muestra el mismo resultado que el ejemplo anterior.) | |
| cm repo ls localhost:8084 --format=TABLE | |
| (Muestra la lista de repositorios en formato tabla con los siguientes | |
| campos: id del repositorio, nombre del repositorio, y el nombre del servidor | |
| de repositorios.) | |
| == CMD_DESCRIPTION_REPOSITORY_RENAME == | |
| Renombra un repositorio. | |
| == CMD_USAGE_REPOSITORY_RENAME == | |
| Sintaxis: | |
| cm repository | repo rename [<repspec>] <new_name> | |
| repspec Repositorio a renombrar. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de repositorio.) | |
| new_name Nuevo nombre para el repositorio. | |
| == CMD_HELP_REPOSITORY_RENAME == | |
| Notas: | |
| Este comando renombre un repositorio. | |
| Si no se proporciona ninguna especificación de repositorio, el comando tomará | |
| por defecto el repositorio actual. | |
| Ejemplos: | |
| cm repository rename development | |
| (El repositorio actual se renombra a 'development'.) | |
| cm repo rename rep:default@SERVER:8084 development | |
| (El repositorio 'default' del servidor 'SERVER' se renombra a 'development'.) | |
| == CMD_DESCRIPTION_REPOSITORY_ADD == | |
| Conecta un repositorio existente añadiendo su base de datos. | |
| == CMD_USAGE_REPOSITORY_ADD == | |
| Sintaxis: | |
| cm repository | repo add <db_file> <rep_name> <repserverspec> | |
| db_file Nombre del fichero de la base de datos. | |
| rep_name Nombre del repositorio. | |
| repserverspec Especificación del servidor de repositorios. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de servidor de repositorios.) | |
| == CMD_HELP_REPOSITORY_ADD == | |
| Nota: | |
| Reconecta una base de datos de repositorio ya existente al servidor. Este | |
| comando es útil para mover un repositorio de un servidor a otro, o para | |
| restaurar o reconectar un repositorio después de haber usado el comando | |
| 'cm repository delete'. | |
| Ejemplos: | |
| cm repository add rep_27 myrepository myserver:8084 | |
| == CMD_DESCRIPTION_TRIGGER_CREATE == | |
| Crea un nuevo trigger en un servidor. | |
| == CMD_USAGE_TRIGGER_CREATE == | |
| Sintaxis: | |
| cm trigger | tr create | mk <subtype-type> <new_name> <script_path> | |
| [--position=<new_position>] | |
| [--filter=<str_filter>] | |
| [--server=<repserverspec>] | |
| subtype-type Ejecución y operación del trigger. | |
| (Use 'cm showtriggertypes' para ver la lista de tipos de | |
| triggers.) | |
| new_name Nombre del nuevo trigger. | |
| script_path Ruta en disco del servidor donde se encuentra el script | |
| a ejecutar. Si la línea comienza con "webtrigger ", el | |
| trigger entenderá que se trata de un trigger web. | |
| Consulte las Notas para más información. | |
| Opciones: | |
| --position Posición para el trigger especificado. Esta posición no | |
| tiene que estar en uso por ningún otro trigger del mismo | |
| tipo. | |
| --filter Comprueba solo los ítems que concuerdan con el filtro | |
| especificado. | |
| --server Crea el trigger en el servidor especificado. | |
| Si no se especifica ningún servidor, el comando se | |
| ejecuta en el servidor configurado en el cliente. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de servidor.) | |
| == CMD_HELP_TRIGGER_CREATE == | |
| Notas: | |
| Web triggers: Para crear triggers web escriba "webtrigger <target-uri>" | |
| como comando de trigger. En este caso, el trigger ejecutará una consulta | |
| POST contra el URI especificado (donde el cuerpo de la petición contiene un | |
| diccionario JSON con las variables de entorno del trigger) y una clave INPUT | |
| apuntando a un array de cadenas de texto. | |
| Ejemplos: | |
| cm trigger create after-setselector "BackupMgr" "/path/to/script" --position=4 | |
| cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084 | |
| cm tr mk after-mklabel Log "/path/to/script" --filter="rep:myRep,LB*" | |
| (Este trigger se ejecutará solo si la etiqueta ha sido creada en el | |
| repositorio 'myRep' y si el nombre de la etiqueta comienza por 'LB'.) | |
| cm tr mk after-checkin NotifyTeam "webtrigger http://myserver.org/api" | |
| == CMD_DESCRIPTION_MOVE == | |
| Mueve o renombra un ítem. | |
| == CMD_USAGE_MOVE == | |
| Sintaxis: | |
| cm move ruta_origen ruta_destino | |
| ruta_origen: Ruta origen del ítem. | |
| ruta_destino: Ruta destino del ítem. | |
| == CMD_HELP_MOVE == | |
| Notas: | |
| Este comando mueve o renombra un ítem en el repositorio. | |
| Los cambios también se realizan en el sistema de ficheros local. | |
| Si la ruta de origen es un fichero, el destino puede ser un fichero o un | |
| directorio. En el primer caso, el fichero se renombra, si no, el ítem se | |
| mueve al directorio destino. | |
| Si la ruta de origen es un directorio, la ruta destino ha de serlo también. | |
| Requisitos para mover o renombrar un ítem: | |
| El ítem ha de estar controlado por Unity VCS. | |
| El directorio padre del ítem origen y del ítem destino han de estar desprotegidos. | |
| Ejemplos: | |
| cm move fichero.txt fichero.old (renombra el ítem) | |
| cm move .\fichero.old .\antiguos (mueve fichero.old al directorio antiguos) | |
| cm move .\src .\src2 (renombra el directorio) | |
| == CMD_DESCRIPTION_LABEL == | |
| Este comando permite al usuario efectuar operaciones con etiquetas. | |
| == CMD_USAGE_LABEL == | |
| Sintaxis: | |
| cm label | lb command [options] | |
| Comandos: | |
| create | mk | |
| delete | rm | |
| rename | |
| Para obtener más información sobre cada uno de los comandos ejecute: | |
| cm label command --usage | |
| cm label command --help | |
| == CMD_HELP_LABEL == | |
| Ejemplos | |
| cm label myNewLabel cs:42 | |
| (el comando 'create' es opcional) | |
| cm label rename myNewLabel newLabelName | |
| cm label delete newLabelName | |
| == CMD_DESCRIPTION_LABEL_CREATE == | |
| Crea una etiqueta nueva o etiqueta una changeset dado. | |
| == CMD_USAGE_LABEL_CREATE == | |
| Sintaxis: | |
| cm label [create] spec_etiqueta [spec_changeset | ruta] | |
| [--allxlinkedrepositories] | |
| [-c=str_comment | -commentsfile=<comments_file>] | |
| spec_etiqueta: Especificación de la etiqueta. Usa 'cm help objectspec' para | |
| obtener más información sobre especificaciones. | |
| spec_changeset: Nombre o especificación del changeset a etiquetar. Usa | |
| 'cm help objectspec' para obtener más información sobre especificaciones. | |
| ruta: Ruta del workspace a etiquetar | |
| Si no se especifica spec_changeset ni ruta se asumirá el directorio actual | |
| como workspace a etiquetar. | |
| Opciones: | |
| --allxlinkedrepositories (-s): Crea la etiqueta en todos los repositorios | |
| enlazados. | |
| -c: Añade un comentario a la etiqueta creada. | |
| --commentsfile=comment.txt: Carga el comentario del fichero especificado. | |
| == CMD_HELP_LABEL_CREATE == | |
| Notas: | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplos: | |
| cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt | |
| cm label BL002 cs:=1203 -c="first release" | |
| == CMD_DESCRIPTION_LABEL_DELETE == | |
| Borra una o más etiquetas. | |
| == CMD_USAGE_LABEL_DELETE == | |
| Sintaxis: | |
| cm label delete spec_etiqueta1 spec_etiqueta2 ... | |
| spec_etiqueta: Etiquetas a borrar, separadas por espacios. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de etiquetas. | |
| == CMD_HELP_LABEL_DELETE == | |
| Notas: | |
| Este comando borra una o más etiquetas creadas previamente. | |
| Ejemplos: | |
| cm label delete lb:BL001 (Se borra la etiqueta 'BL001') | |
| cm label delete lb:BL001 lb:BL002 | |
| == CMD_DESCRIPTION_LABEL_RENAME == | |
| Renombra una etiqueta. | |
| == CMD_USAGE_LABEL_RENAME == | |
| Sintaxis: | |
| cm label rename spec_etiqueta nuevo_nombre | |
| sepec_etiqueta: Especificación de la etiqueta que se va a renombrar. | |
| Usa 'cm help objectspec' para obtener más información sobre | |
| la especificación de etiquetas. | |
| nuevo_nombre: Nuevo nombre para la etiqueta. | |
| == CMD_HELP_LABEL_RENAME == | |
| Notas: | |
| Este comando renombra una etiqueta. | |
| Ejemplos: | |
| cm label rename lb:BL001 BL002 | |
| (La etiqueta 'BL001' se renombra a 'BL002') | |
| == CMD_DESCRIPTION_OBLITERATE == | |
| DEPRECATED | |
| == CMD_USAGE_OBLITERATE == | |
| == CMD_HELP_OBLITERATE == | |
| == CMD_DESCRIPTION_OBJECTSPEC == | |
| Explica cómo escribir object specs (especificaciones de objetos). | |
| == CMD_USAGE_OBJECTSPEC == | |
| Sintaxis: | |
| cm objectspec | |
| Para obtener toda la información sobre cómo construir specs de objetos. | |
| == CMD_HELP_OBJECTSPEC == | |
| Muchos comandos de Unity VCS esperan 'object specs' como entrada para | |
| referirse a un objeto concreto (normalmente una rama, un changeset, un | |
| repositorio, etc.). | |
| Esta documentación describe los diferentes tipos de "specs" disponibles y | |
| cómo construirlas. | |
| Cada tipo de especificación comienza con un tag único, por ejemplo "rep:" o "cs:". | |
| El tag se debe indicar para comandos que reciban especificaciones generales | |
| de objetos, como por ejemplo "cm setowner object_spec", pero a menudo se pueden | |
| omitir en comandos que solo acepten un tipo de especificación, como por ejemplo | |
| "cm getfile revision_spec". | |
| == Repository server spec (repserverspec) == | |
| repserver:name:port | |
| Ejemplos: | |
| cm lrep repserver:skull:8084 | |
| cm lrep skull:8084 | |
| Nota: | |
| Lo llamamos "rep" server spec (con el 'rep' delante) en lugar de | |
| simplemente 'server spec' por motivos históricos. Hace mucho tiempo | |
| Unity VCS tenía servidores de workspaces y repositorios separados, y | |
| el nombre ha sobrevivido. | |
| == Repository spec (repspec) == | |
| rep:rep_name@[repserverspec] | |
| Ejemplos: | |
| cm showowner rep:codice@localhost:6060 | |
| (Aquí la "rep:" es necesaria porque el comando showowner admite | |
| todo tipo de objetos). | |
| == Branch spec (brspec) == | |
| br:[/]br_name[@repspec] | |
| Ejemplos: | |
| cm switch br:/main@rep:plastic@repserver:skull:9095 | |
| (En este caso "br:", "rep:" y "repserver:" no son necesarios así | |
| que el comando se puede escribir de forma mucho más compacta: | |
| "cm switch main@plastic@skull:9095" .) | |
| cm find revisions "where branch='br:/main/task001'" | |
| Nota: | |
| La barra inicial '/' en las ramas no es obligatoria. Solíamos escribir | |
| todas las ramas como /main, /main/task001, etc. Pero ahora preferimos | |
| user formatos más cortos tipo main, main/task001. | |
| == Changeset spec (csetspec) == | |
| cs:cs_number|cs_guid[@repspec] | |
| Se puede especificar el número o el GUID del changeset. | |
| Ejemplos: | |
| cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070 | |
| == Label spec (labelspec) == | |
| lb:lb_name[@repspec] | |
| Ejemplos: | |
| cm switch lb:RELEASE2.0 | |
| cm switch lb:RELEASE1.4@myrep@MYSERVER:8084 | |
| == Revision spec == | |
| Hay distintos tipos de specs de revisiones: | |
| rev:item_path[#(brspec|csetspec|labelspec)] | |
| rev:serverpath:item_path#(brspec|cset_spec|lb_spec) | |
| rev:revid:rev_id[@rep_spec] | |
| rev:itemid:item_id#(br_spec|cset_spec|lb_spec) | |
| Ejemplos: | |
| cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20 | |
| cm diff serverpath:/doc/readme.txt#cs:19@myrepo \ | |
| serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084 | |
| cm cat revid:1230@rep:myrep@repserver:myserver:8084 | |
| == Item spec == | |
| Se usa muy raras veces. | |
| item:path | |
| Ejemplo: | |
| cm find revision "where item='item:.'" | |
| == Attribute spec == | |
| att:att_name[@repspec] | |
| Ejemplo: | |
| cm rmattributereal att:merged@code@doe:8084 cs:25@code@doe:8084 | |
| == Workspace specs == | |
| wk:name@clientmachine | |
| Se usa muy poco porque solamente aplica a los comandos relacionados con los | |
| workspaces. Es útil para indicar el nombre del workspace en lugar del path. | |
| Ejemplo: | |
| cm showselector wk:codebase@modok | |
| Nota: | |
| Estas specs vienen de los viejos tiempos de Plastic SCM 2.x en los que | |
| los 'workspace servers' eran una forma de almacenar metadatos de forma | |
| centralizada. Se eliminaron por cuestiones de rendimiento. | |
| == CMD_DESCRIPTION_PARTIAL == | |
| Ejecuta comandos en un espacio de trabajo parcial. | |
| == CMD_USAGE_PARTIAL == | |
| Sintaxis: | |
| cm partial comando [opciones] | |
| Comandos: | |
| configure | |
| add | |
| undo | |
| co | checkout | |
| unco | undocheckout | |
| ci | checkin | |
| mv | move | |
| rm | remove | |
| stb | switch | |
| upd | update | |
| shelve | shelveset | |
| Para obtener más información de cada uno de los comandos ejecute: | |
| cm partial comando --usage | |
| cm partial comando --help | |
| == CMD_HELP_PARTIAL == | |
| Ejemplos: | |
| cm partial configure +/fondo-azul.png | |
| cm partial update paisaje-1024.png | |
| cm partial checkin ojos-verde.png ojos-negro.png | |
| == CMD_DESCRIPTION_PARTIAL_ADD == | |
| Añade un ítem al repositorio. | |
| == CMD_USAGE_PARTIAL_ADD == | |
| Sintaxis: | |
| cm partial add [-R | -r | --recursive] [--silent] [--parents] [--ignorefailed] | |
| [--skipcontentcheck] | |
| [--format=<str-format>] [--errorformat=<str-format>] | |
| <rutas>+ | |
| rutas Rutas de los ítems a añadir separados por espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Usa * para añadir todo el contenido del directorio | |
| actual. | |
| Opciones: | |
| -R Añade los ítems recursivamente. | |
| --silent No muestra ninguna salida. | |
| --parents Incluye los directorios padre de los ítems indicados en | |
| la operación. | |
| --ignorefailed Si un ítem no se puede añadir, la operación de add | |
| continuará sin él. Importante: si un directorio no se | |
| puede añadir, su contenido tampoco se añadirá. | |
| --skipcontentcheck Cuando la extensión no es suficiente para determinar si | |
| el fichero es de tipo texto o binario, se asumirá que es | |
| binario en lugar de usar el contenido para detectar el | |
| tipo. | |
| --format Devuelve la salida en el formato especificado. Consulta | |
| los ejemplos para más información. | |
| --errorformat En caso de error, devuelve el mensaje en el formato | |
| especificado. Consulta los ejemplos para más información. | |
| == CMD_HELP_PARTIAL_ADD == | |
| Notas: | |
| Requisitos para añadir ítems: | |
| - El directorio padre del ítem a añadir debe existir en el repositorio. | |
| Ejemplos: | |
| cm partial add pic1.png pic2.png | |
| (Añade los ítems pic1.png y pic2.png.) | |
| cm partial add c:\workspace\imagen.png | |
| (Añade el ítem imagen.png en el directorio c:\workspace.) | |
| cm partial add -R c:\workspace\src | |
| (Añade recursivamente todos los ítems del directorio especificado.) | |
| cm partial add --parents ejemplos\diseño01.png | |
| (Añade el ítem diseño01.png y su directorio padre ejemplos.) | |
| cm partial add -R * | |
| (Añade recursivamente todo el contenido del directorio actual.) | |
| cm partial add -R * --format="ADD {0}" --errorformat="ERR {0}" | |
| (Añade recursivamente todo el contenido del directorio actual imprimiendo | |
| por pantalla 'ADD <item>' para los archivos añadidos correctamente y | |
| 'ERR <item>' para los archivos que no se pudieron añadir.) | |
| == CMD_DESCRIPTION_PARTIAL_CHECKIN == | |
| Crea una nueva revisión de un ítem. | |
| == CMD_USAGE_PARTIAL_CHECKIN == | |
| Sintaxis: | |
| cm partial checkin | ci [opciones] [<ruta>+] | |
| [-c=<str_comment> | -commentsfile=<comments_file>] | |
| [--all | -a] [--applychanged] [--keeplock] | |
| [--symlink] [--ignorefailed] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| ruta Rutas de los ítems a proteger, separados por espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Usa . para aplicar la operación de checkin al directorio | |
| actual. | |
| Opciones: | |
| -c Añade un comentario al changeset creado en la operación | |
| de protección. | |
| -commentsfile Añade el comentario existente en el fichero especificado | |
| al changeset creado en la operación de protección. | |
| --all | -a Los ítems cambiados, movidos y borrados localmente en | |
| las rutas especificadas también son protegidos. | |
| --applychanged Protege los ítems cambiados localmente junto con los | |
| ítems desprotegidos. | |
| --private Incluye en el checkin los ítems privados. | |
| --keeplock Mantiene el bloqueo de aquellos elementos que estaban | |
| bloqueados después de la operación de protección. | |
| --symlink Realizar la operación de checkin sobre el fichero de | |
| link y no al que apunta. | |
| --ignorefailed Los cambios locales que no se pueden aplicar (porque el | |
| bloqueo (checkout exclusivo) no se puede obtener o | |
| porque están en conflicto con los cambios del servidor) | |
| son descartados y el checkin continúa sin ellos. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_PARTIAL_CHECKIN == | |
| Notas: | |
| - Si no se especifican [opciones] ni [rutas], la operación involucrará a | |
| todos los cambios pendientes en el espacio de trabajo. | |
| - La operación de protección se aplica siempre recursivamente desde la | |
| ruta indicada. | |
| - Requisitos para proteger un ítem: | |
| - El ítem debe estar controlado por Unity VCS. | |
| - El ítem ha de estar desprotegido. | |
| - Si un ítem ha sido cambiado pero no desprotegido, no es necesario | |
| especificar la opción --applychanged, salvo que en las rutas a ser | |
| protegidas se incluyan directorios o rutas con wildcards ('*'). | |
| La revisión ha de tener cambios. Es decir, no se pueden proteger los | |
| mismos datos. | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplos: | |
| cm partial checkin figura.png paisaje.png | |
| (Protege los ítems figura.png and paisaje.png.) | |
| cm partial checkin . -commentsfile=micomentario.txt | |
| (Protege los ítems de la ruta actual y aplica el comentario existente en el | |
| fichero micomentario.txt.) | |
| cm partial ci fondo.png -c="Nuevo fondo añadido" --keeplock | |
| (Protege el ítem fondo.png, incluye el comentario especificado y mantiene el | |
| bloqueo.) | |
| cm partial checkin --applychanged | |
| (Protege todos los cambios pendientes en el espacio de trabajo.) | |
| cm partial checkin link --symlink | |
| (Proteger el fichero de symlink y no al que apunta.) | |
| == CMD_DESCRIPTION_PARTIAL_CHECKOUT == | |
| Desprotege los ítems dejándolos preparados para ser modificados. | |
| == CMD_USAGE_PARTIAL_CHECKOUT == | |
| Síntaxis: | |
| cm partial checkout | co [<ruta>+] [--resultformat=str_format] | |
| [--silent] [--ignorefailed] | |
| Opciones: | |
| ruta Rutas de los ítems a desproteger, separados por | |
| espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Usa . para aplicar la operación de checkout al | |
| directorio actual. | |
| --resultformat Devuelve la salida en el formato especificado. | |
| --silent No muestra ninguna salida. | |
| --ignorefailed Si un ítem no se puede desproteger/bloquear (no se puede | |
| hacer un checkout exclusivo), la operación de checkout | |
| continuará sin él. | |
| == CMD_HELP_PARTIAL_CHECKOUT == | |
| Notas: | |
| Para desproteger un ítem: | |
| - El ítem debe estar controlado por Unity VCS. | |
| - El ítem debe estar protegido. | |
| Si se han configurado bloqueos en el servidor (existe el fichero lock.conf), | |
| entonces cada vez que se produzca una desprotección, Unity VCS comprobará si | |
| se aplica alguna de las reglas. Si es así, la ruta permanecerá en checkout | |
| exclusivo (bloqueada), con lo que nadie podrá desprotegerlo simultáneamente. | |
| Puedes obtener todos los bloqueos del servidor usando 'cm listlocks'. | |
| Lee la documentación Administrator Guide para más información. | |
| Examples: | |
| cm partial checkout imagen1.png imagen2.png | |
| (Desprotege los ítems imagen1.png and imagen2.png.) | |
| cm partial co *.png | |
| (Desprotege todos los ítems png.) | |
| cm partial checkout . | |
| (Desprotege el directorio actual.) | |
| cm partial checkout -R c:\workspace\paisaje | |
| (Desprotege recursivamente el directorio paisaje.) | |
| cm partial co diseño01.png --exclusive | |
| (Desprotege el ítem exclusivamente.) | |
| == CMD_DESCRIPTION_PARTIAL_CONFIGURE == | |
| Permite configurar tu espacio de trabajo, cargando o descargando elementos. | |
| == CMD_USAGE_PARTIAL_CONFIGURE == | |
| Sintaxis: | |
| cm partial configure <+|-ruta>+ [--silent] [--ignorefailed] [--ignorecase] | |
| [--restorefulldirs] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| ruta Rutas a cargar o descargar, separadas por espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Todas las rutas deben comenzar con "/". | |
| Opciones: | |
| --silent No muestra ninguna salida. | |
| --ignorefailed Ignora cualquier error durante la operación. | |
| --ignorecase Ignora mayúsculas y minúsculas. Con esta opción el | |
| comando funcionará para "/Data/Textures" incluso si el | |
| usuario indica "/data/teXtures". | |
| --restorefulldirs Resetea una configuración de directorio incorrecta | |
| (ocurre cuando una operación no parcial es ejecutada en | |
| un espacio de trabajo parcial). | |
| Los directorios de esta lista se configuran por | |
| completo (full check), lo que significa que bajarán | |
| automáticamente el nuevo contenido durante el update. | |
| Esta operación no descarga ningún fichero, simplemente | |
| restaura la configuración de directorio en un espacio | |
| de trabajo parcial. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_PARTIAL_CONFIGURE == | |
| Notas: | |
| El comando siempre asume recursividad. | |
| Ejemplos: | |
| cm partial configure +/paisaje-gris.png | |
| (Carga paisaje-gris.png.) | |
| cm partial configure -/paisaje-negro.png | |
| (Descarga paisaje-negro.) | |
| cm partial configure +/textura -/textura/textura01.png | |
| (Carga todo el contenido del directorio textura excepto textura01.png.) | |
| cm partial configure -/ | |
| (Descarga todo el directorio de trabajo.) | |
| cm partial configure -/ +/ | |
| (Carga todo el directorio de trabajo.) | |
| cm partial configure +/figura-64.png --ignorefailed | |
| (Carga figura-64.png, estuviera o no ya cargado previamente.) | |
| cm partial configure +/ --restorefulldirs | |
| (Fija todos los directorios para que descarguen el nuevo contenido automáticamente.) | |
| cm partial configure +/src/lib --restorefulldirs | |
| (Fija sólo /src/lib y sus subdirectorios para que descarguen el nuevo contenido automáticamente.) | |
| == CMD_DESCRIPTION_PARTIAL_MOVE == | |
| Mueve o renombra un archivo o directorio. | |
| == CMD_USAGE_PARTIAL_MOVE == | |
| Sintaxis: | |
| cm partial move | mv src_path dst_path [--format=str_format] | |
| src_path Ruta origen del ítem. | |
| dst_path Ruta destino del ítem. | |
| Options: | |
| --format Devuelve la salida en el formato especificado. | |
| == CMD_HELP_PARTIAL_MOVE == | |
| Notas: | |
| Este comando mueve o renombra un ítem en el repositorio. | |
| Los cambios también se aplican localmente. | |
| Si la ruta de origen es un fichero, el destino puede ser un fichero o un | |
| directorio. En el primer caso, el fichero se renombra. En el segundo, el | |
| fichero se renombra. | |
| Si la ruta de origen en un directorio, el destino ha de serlo también. | |
| El ítem a mover o renombrar debe existir. | |
| Formato: | |
| {0} Ruta de origen. | |
| {1} Ruta de destino. | |
| Examples: | |
| cm partial move fichero.png fichero-azul.png | |
| (Renombra el ítem.) | |
| cm partial mv .\fichero-azul.png .\azulFicheros | |
| (Mueve fichero-azul.png a azulFicheros.) | |
| cm partial move .\diseño .\marketing | |
| (Renombra un directorio.) | |
| == CMD_DESCRIPTION_PARTIAL_RM == | |
| Borra un ítem del control de versiones. | |
| == CMD_USAGE_PARTIAL_RM == | |
| Sintaxis: | |
| cm partial remove | rm <ruta>+ [--nodisk] | |
| ruta Ítems a borrar, separados por espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Opciones: | |
| --nodisk Borra del control de versiones, pero mantiene el ítem en | |
| disco. | |
| == CMD_HELP_PARTIAL_RM == | |
| Notas: | |
| Los ítems se borran de disco. Los ítems borrados son borrados del directorio | |
| padre en el control de versiones. | |
| Requisitos: | |
| - El ítem debe estar controlado. | |
| Ejemplos: | |
| cm partial remove src | |
| (Borra src. Si src es un directorio, equivale a ejecutar: | |
| cm partial remove -R src.) | |
| cm partial remove c:\workspace\pic01.png --nodisk | |
| (Borra pic01.png del control de versiones, pero lo mantiene en el disco.) | |
| == CMD_DESCRIPTION_PARTIAL_SHELVESET == | |
| Use este comando para administrar shelvesets parciales. | |
| == CMD_USAGE_PARTIAL_SHELVESET == | |
| Sintaxis: | |
| cm partial shelveset | shelve <command> [options] | |
| Comandos: | |
| create | mk | |
| apply | |
| delete | rm | |
| Para obtener más información sobre cada comando: | |
| cm partial shelveset <command> --usage | |
| cm partial shelveset <command> --help | |
| == CMD_HELP_PARTIAL_SHELVESET == | |
| Ejemplos: | |
| cm partial shelveset create -c="my comment" | |
| cm partial shelveset apply sh:3 | |
| cm partial shelveset delete sh:5 | |
| == CMD_DESCRIPTION_PARTIAL_SHELVESET_CREATE == | |
| Almacena los cambios pendientes escogidos. | |
| == CMD_USAGE_PARTIAL_SHELVESET_CREATE == | |
| Sintaxis: | |
| cm partial shelveset | shelve create | mk [<item_path>[ ...]] | |
| [-c=<str_comment> | -commentsfile=<comments_file>] | |
| [--applychanged] [--symlink] [--ignorefailed] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| Opciones: | |
| -c Añade un comentario al shelveset creado en la operación | |
| de protección. | |
| -commentsfile Añade el comentario existente en el fichero especificado | |
| al shelveset creado en la operación de protección. | |
| --applychanged Protege los ítems cambiados localmente junto con los | |
| ítems desprotegidos. | |
| --symlink Realizar la operación de shelve sobre el fichero de | |
| link y no al que apunta. | |
| --ignorefailed Los cambios locales que no se pueden aplicar (porque el | |
| bloqueo (checkout exclusivo) no se puede obtener o | |
| porque están en conflicto con los cambios del servidor) | |
| son descartados y el shelve continúa sin ellos. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_PARTIAL_SHELVESET_CREATE == | |
| El comando partial shelveset create almacena los ítems en checkout especificados | |
| dentro del repositorio. De este modo el contenido queda almacenado en el | |
| servidor sin necesidad de hacer checkin. | |
| Notas: | |
| - Si no se especifican [opciones] ni [rutas], la operación involucrará a | |
| todos los cambios pendientes en el espacio de trabajo. | |
| - La operación de protección se aplica siempre recursivamente desde la | |
| ruta indicada. | |
| - La operacion de creación de protección es la operación por defecto, | |
| lo que significa que si no se especifica ninguna otra, el comando tratará | |
| de ejecutar una nueva creación de protección. | |
| - Requisitos para proteger un ítem: | |
| - El ítem debe estar controlado por Unity VCS. | |
| - El ítem ha de estar desprotegido. | |
| - Si un ítem ha sido cambiado pero no desprotegido, no es necesario | |
| especificar la opción --applychanged, salvo que en las rutas a ser | |
| protegidas se incluyan directorios o rutas con wildcards ('*'). | |
| La revisión ha de tener cambios. Es decir, no se pueden proteger los | |
| mismos datos. | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplos: | |
| cm partial shelveset figura.png paisaje.png | |
| (Crea un nuevo shelveset con los ítems figura.png and paisaje.png.) | |
| cm partial shelveset . -commentsfile=micomentario.txt | |
| (Crea un nuevo shelveset con los ítems de la ruta actual y aplica el | |
| comentario existente en el fichero micomentario.txt.) | |
| cm partial shelve fondo.png -c="Nuevo fondo añadido" | |
| (Crea un nuevo shelveset el ítem fondo.png, incluye el comentario | |
| especificado.) | |
| cm partial shelveset --applychanged | |
| (Crea un nuevo shelveset con todos los cambios locales junto con los | |
| cambios controlados pendientes en el espacio de trabajo.) | |
| cm partial shelveset link --symlink | |
| (Crea un nuevo shelveset con fichero de symlink, en lugar del fichero al | |
| que apunta.) | |
| == CMD_DESCRIPTION_PARTIAL_SHELVESET_APPLY == | |
| El comando partial shelveset apply restaura los contenidos almancenados en el | |
| repositorio. | |
| == CMD_USAGE_PARTIAL_SHELVESET_APPLY == | |
| Sintaxis: | |
| cm partial shelveset apply shelve_spec [opciones] | |
| shelve_spec: Restaura los contenidos almancenados en el repositorio | |
| identificados por "shelve_spec" | |
| Opciones: | |
| --encoding=codificación: Especifica la codificación de los ficheros de | |
| origen (por ejemplo, UTF-8 o Unicode) | |
| --comparisonmethod=tipo: cualquiera de las siguientes opciones: | |
| ignoreeol: Ignora diferencias de final de línea. | |
| ignorewhitespaces: Ignora diferencias de espacios en blanco. | |
| ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en | |
| blanco. | |
| recognizeall: Detecta diferencias de final de línea y espacios en | |
| blanco. | |
| == CMD_HELP_PARTIAL_SHELVESET_APPLY == | |
| El comando partial shelveset apply restaura los contenidos almancenados en el | |
| repositorio. | |
| Ejemplo: Aplicar un shelve almacenado en el repositorio: | |
| cm partial shelveset apply sh:3 | |
| == CMD_DESCRIPTION_PARTIAL_SHELVESET_DELETE == | |
| Borra un shelveset. | |
| == CMD_USAGE_PARTIAL_SHELVESET_DELETE == | |
| Sintaxis: | |
| cm partial shelveset delete shelve_spec | |
| shelve_spec: Elimina los contenidos almancenados en el repositorio | |
| identificados por "shelve_spec" | |
| == CMD_HELP_PARTIAL_SHELVESET_DELETE == | |
| El comando partial shelveset delete borra un shelveset creado anteriormente. | |
| Ejemplo: | |
| cm partial shelveset delete sh:3 | |
| (Elimina un shelveset almacenado en el repositorio.) | |
| == CMD_DESCRIPTION_PARTIAL_SWITCH == | |
| Establece la rama especificada como rama de trabajo. | |
| == CMD_USAGE_PARTIAL_SWITCH == | |
| Sintaxis: | |
| cm switch branch_spec [--report | --silent] [--workspace=path] [--noinput] | |
| (Establece la rama de trabajo y actualiza el workspace.) | |
| cm switch branch_spec --configure <+|-ruta>+ [--silent] | |
| [--ignorefailed] [--ignorecase] [--workspace=path] | |
| (Establece la rama de trabajo y configura el workspace como haría el | |
| comando 'cm partial configure'.) | |
| branch_spec Especificación de rama. | |
| ruta Rutas a cargar o descargar, separadas por espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Todas las rutas deben comenzar con "/". | |
| Opciones: | |
| --silent No muestra salida. | |
| --report Imprime una lista de los cambios efectuados una vez | |
| termina la operación. Pierde efecto si se utiliza | |
| la opción --silent conjuntamente. | |
| --configure Configura (carga / descarga rutas) el espacio de | |
| trabajo después de haber actualizado la rama de trabajo. | |
| Usa 'cm partial configure --help' para aprender más | |
| sobre como especificar las rutas a configurar. | |
| --ignorefailed Ignora cualquier error durante la operación | |
| de configuración. | |
| --ignorecase Ignora mayúsculas y minúsculas en las rutas a | |
| configurar. Con esta opción el comando funcionará | |
| para "/Data/Textures" incluso si el usuario indica | |
| "/data/teXtures". | |
| --noinput Ignora las pregunta interactiva para continuar la | |
| operación haciendolos shelve a los cambios pendientes. | |
| --workspace=path Ruta del espacio de trabajo a cambiar. | |
| --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se | |
| redirige la salida estándar. | |
| Usa 'cm help objectspec' para aprender más sobre cómo indicar especificaciones | |
| de ramas. | |
| == CMD_HELP_PARTIAL_SWITCH == | |
| Notas: | |
| Este comando permite a los usuarios especificar una rama, como rama de | |
| trabajo. Después de actualizar la rama, actualiza el espacio de trabajo | |
| a la nueva rama como haría un 'cm partial update'. Sin embargo, si se | |
| especifica la opción --configure, permite configurar el espacio de trabajo | |
| teniendo en cuenta los elementos cargados en la nueva rama como haría un | |
| 'cm partial configure'. | |
| Ejemplos: | |
| cm switch br:/main/task | |
| (Establece /main/task como rama de trabajo y actualiza el espacio de | |
| trabajo.) | |
| cm switch br:/main/task --configure +/art/images | |
| (Establece /main/task como rama de trabajo y configura el directorio | |
| /art/images.) | |
| == CMD_DESCRIPTION_PARTIAL_UNCO == | |
| Deshace la desprotección de un ítem. | |
| == CMD_USAGE_PARTIAL_UNCO == | |
| Sintaxis: | |
| cm partial undocheckout | unco <ruta>+ [--silent] [--keepchanges | -k] | |
| ruta Ítems sobre los que aplicar la operación, separados por | |
| espacios. | |
| Usa comillas (") para especificar rutas con espacios. | |
| Usa . para aplicar la operación al directorio actual. | |
| Opciones: | |
| --silent No muestra ninguna salida. | |
| --keepchanges (-k) Deshace la desprotección dejando los cambios locales. | |
| Ejemplo: un checkout lo deja como changed con el | |
| contenido en disco que tenia antes de hacer el unco. | |
| Esta opción no puede utilizarse con workspaces dinámicos. | |
| == CMD_HELP_PARTIAL_UNCO == | |
| Notas: | |
| Si un ítem está desprotegido y no quieres protegerlo, puede deshacer la | |
| desprotección usando este comando. | |
| Se puede deshacer la desprotección tanto a ficheros como a carpetas. | |
| El ítem se actualizará al estado anterior previo a ser desprotegido. | |
| Requisitos: | |
| - El ítem debe estar controlado. | |
| - El ítem debe estar desprotegido. | |
| Ejemplos: | |
| cm partial undocheckout . | |
| (Deshace las desprotecciones del directorio actual.) | |
| cm partial undocheckout pic1.png pic2.png | |
| cm unco c:\workspace\diseño01.png | |
| (Deshace las desprotecciones de los ítems especificados.) | |
| == CMD_DESCRIPTION_PARTIAL_UNDO == | |
| Deshace cambios en un workspace. | |
| == CMD_USAGE_PARTIAL_UNDO == | |
| Syntaxis: | |
| cm partial undo [path]+ [--symlink] [-r | --recursive] [Filtros]+ | |
| [Opciones de salida] | |
| path Rutas de los ficheros o carpetas a los que aplicar | |
| la operación, separados por espacios. Se pueden | |
| utilizar comillas (") para especificar rutas con | |
| espacios. Si no se especifica ninguna ruta, por | |
| defecto la operación se ejecutará sobre los ficheros | |
| en el directorio actual. | |
| Opciones: | |
| --symlink Aplica la operación de undo al enlace simbólico y | |
| no a su destino. | |
| -r Ejecuta el undo de manera recursiva. | |
| Filtros: | |
| Si ninguna de estas opciones está presente, por defecto se deshacen todos | |
| los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas | |
| opciones. | |
| Si un fichero o directorio tiene uno o más de los tipos de cambio | |
| especificados, todos los cambios en ese fichero o directorio serán | |
| deshechos. | |
| Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero | |
| está tanto movido como checkedout, ambos cambios se desharán. | |
| --checkedout Selecciona ficheros y directorios marcados para | |
| cambios. | |
| --unchanged Selecciona ficheros sin modificaciones en su | |
| contenido. | |
| --changed Selecciona ficheros y directorios cambiados o | |
| marcados para cambios. | |
| --deleted Selecciona ficheros y directorios eliminados. | |
| --moved Selecciona ficheros y directorios movidos. | |
| --added Selecciona ficheros y directorios añadidos. | |
| Opciones de salida: | |
| --silent | --machinereadable [--startlineseparator=sep] | |
| [--endlineseparator=sep] [--fieldseparator=sep] | |
| --silent No muestra ninguna salida. | |
| --machinereadable Muestra la salida en un formato fácil de tratar. | |
| --startlineseparator Usado en conjunto con la opción '--machinereadable', | |
| especifica cómo deberían comenzar las líneas. | |
| --endlineseparator Usado en conjunto con la opción '--machinereadable', | |
| especifica cómo deberían terminar las líneas. | |
| --fieldseparator Usado en conjunto con la opción '--machinereadable', | |
| especifica cómo deberían separarse las líneas. | |
| == CMD_HELP_PARTIAL_UNDO == | |
| Notas: | |
| El comand undo es peligroso - deshace trabajo de una manera irreversible. | |
| Una vez que el undo termina, no hay manera posible de recuperar el estado | |
| anterior de los ficheros y directorios afectados. Si no se especifica | |
| ninguna ruta en los argumentos, por defecto se desharán los cambios en todos | |
| los elementos del directorio actual, pero NO de manera recursiva. | |
| Estos comandos son equivalentes ejecutados desde el directorio /src: | |
| /src | |
| |- file.txt | |
| |- code.cs | |
| \- /test | |
| |- test_a.py | |
| \- test_b.py | |
| $ cm partial undo | |
| $ cm partial undo * | |
| $ cm partial undo file.txt code.cs /test | |
| $ cm partial undo . | |
| $ cm partial undo /src file.txt code.cs | |
| Si se quiere que la operación sea recursiva, se necesita especificar la | |
| opción -r. | |
| Para deshacer todos los cambios debajo de un directorio (incluyendo los | |
| cambios sobre el propio directorio): | |
| $ cm partial undo dirpath -r | |
| Si dirpath es la ruta de un workspace, todos los cambios dentro del | |
| workspace serán deshechos. | |
| Examples: | |
| $ cm partial undo . -r | |
| (Deshace todos los cambios en el directorio actual de manera recursiva. Si | |
| se ejecuta desde la raíz del workspace, deshace todos los cambios en el | |
| workspace completo.) | |
| $ cm partial co file.txt | |
| $ cm partial undo file.txt | |
| (Deshace el checkout en file.txt.) | |
| $ echo content >> file.txt | |
| $ cm partial undo file.txt | |
| (Deshace el cambio local en file.txt.) | |
| $ cm partial undo src | |
| (Deshace los cambios en el directorio src y en todos los ficheros | |
| controlados que contenga) | |
| $ cm partial undo src/* | |
| (Deshace los cambios en todos los elementos contenidos en src, sin afectar | |
| al propio directorio. Por la expansión del wildcard, es equivalente a | |
| 'cm partial undo src/file1.txt src/file2.txt'). | |
| $ cm partial undo *.cs | |
| (Deshace cambios en cada elemento que encaje con el patrón *.cs en el | |
| directorio actual.) | |
| $ cm partial undo *.cs -r | |
| (Deshace cambios en cada elemento que encaje con el patrón *.cs en el | |
| directorio actual, y en cada directorio por debajo de una manera recursiva.) | |
| $ cm partial co file1.txt file2.txt | |
| $ echo content >> file1.txt | |
| $ cm partial undo --unchanged | |
| (Deshace el checkout en file2.txt por no estar modificado, ignorando | |
| file1.txt ya que tiene cambios locales.) | |
| $ echo content >> file1.txt | |
| $ echo content >> file2.txt | |
| $ cm partial co file1.txt | |
| $ cm partial undo --checkedout | |
| (Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt | |
| ya que no está en checkout.) | |
| $ cm partial add file.txt | |
| $ cm partial undo file.txt | |
| (Deshace el añadido de file.txt, dejándolo de nuevo como privado.) | |
| $ rm file1.txt | |
| $ echo content >> file2.txt | |
| $ cm partial add file3.txt | |
| $ cm partial undo --deleted --added * | |
| (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando | |
| el cambio en file2.txt.) | |
| == CMD_DESCRIPTION_PARTIAL_UPDATE == | |
| Actualiza el espacio de trabajo parcial. | |
| == CMD_USAGE_PARTIAL_UPDATE == | |
| Sintaxis: | |
| cm partial update [<ruta>+] | |
| [--changeset=número] | |
| [--silent | --report] [--dontmerge] | |
| [--xml[=<output_file>]] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| ruta Rutas a actualizar, separadas por espacios. Las dobles | |
| comillas (") deben usarse para especificar rutas que | |
| contienen espacios. | |
| Si se usa . entonces se actualiza el directorio actual. | |
| Si no se especifica ninguna ruta, entonces se actualiza todo | |
| el espacio de trabajo parcial. | |
| Opciones: | |
| --changeset Actualiza el espacio de trabajo parcial al changeset | |
| especificado. | |
| --silent No muestra salida a no ser que ocurra un error. | |
| --xml Imprime por defecto a la salida estándar en formato | |
| XML. Se permite especificar un fichero de salida. | |
| --report Imprime una lista de los cambios efectuados una vez que | |
| termina la operación. Esta opción no tiene efecto si se | |
| utiliza la opción --silent. | |
| --dontmerge No procesa los conflictos de fichero. El resto de cambios | |
| se procesan con normalidad. Esta opción puede ser útil en | |
| automatización para evitar interacción con el usuario. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| == CMD_HELP_PARTIAL_UPDATE == | |
| Notas: | |
| El comando update actualiza los ficheros desactualizados. | |
| El comando update siempre asume recursividad. | |
| Si todas las rutas especificadas son ficheros dentro del mismo xlink y | |
| se usa la opción --changeset, entonces las versiones a actualizar se buscan | |
| dentro del changeset del repositorio del xlink. | |
| Ejemplos: | |
| cm partial update | |
| (Actualiza todo el espacio de trabajo parcial.) | |
| cm partial update . | |
| (Actualiza todos los hijos del directorio actual.) | |
| cm partial update fichero1.txt | |
| (Actualiza el fichero fichero1.txt.) | |
| cm partial update fichero1.txt fichero2.txt | |
| (Actualiza los ficheros fichero1.txt y fichero2.txt.) | |
| cm partial update src --report | |
| (Actualiza todos los hijos del directorio src, mostrando una lista de los | |
| cambios aplicados al finalizar.) | |
| cm partial update src --changeset=4 | |
| (Actualiza todos los hijos del directorio src, al contenido | |
| que cargaban en el changeset 4.) | |
| cm partial update xlink/first.png --changeset=4 | |
| (Actualiza el fichero xlink/first.png al contenido que cargaba en el | |
| changeset 4 del repositorio del xlink.) | |
| cm partial update . --changeset=2 --xml=output.xml 2>errors.txt | |
| (Actualiza todos los hijos del directorio actual al contenido que cargaba en el | |
| changeset 2 del repositorio e informa del resultado en formato XML. La salida | |
| la almacena en un archivo output.xml y los potenciales errores los redirige | |
| al archivo errors.txt. | |
| NOTA: la redirección puede variar dependiendo de la consola empleada.) | |
| == CMD_DESCRIPTION_PATCH == | |
| Genera un parche a partir de una spec o aplica un parche generado en el workspace actual. | |
| == CMD_USAGE_PATCH == | |
| Sintaxis: | |
| cm patch [source_spec] source_spec | |
| [--output=output_file] [--tool=/path/to/diff] | |
| cm patch --apply patch_file [--tool=/path/to/patch] | |
| source_spec Especificación de rama o changeset | |
| output_file Fichero que contendrá la salida del comando. Se | |
| mostrará en pantalla si no se especifica. | |
| Opciones: | |
| --output Indica el fichero de destino para almacenar los | |
| contenidos del parche. | |
| --tool Especifica la ruta hacia la herramienta necesaria para | |
| ejecutar la operación (diff o patch). | |
| == CMD_HELP_PATCH == | |
| Notas: | |
| Este comando genera un fichero patch que contiene las diferencias de una | |
| rama o un changeset, así como las diferencias entre changesets. Encuentra | |
| diferencias para ficheros tanto de texto como binarios. | |
| El parámetro --apply permite aplicar los contenidos de un fichero patch | |
| en el workspace actual. | |
| Limitaciones: | |
| Si el fichero de salida de patch ya existe, el comando no lo | |
| sobreescribirá. | |
| Si el fichero con modificaciones en el patch no existe, el comando no | |
| creará uno nuevo para aplicar los cambios. | |
| Importante: | |
| Este comando requiere las utilidades Diff y Patch, disponibles | |
| en http://gnuwin32.sourceforge.net/packages/patch.htm y | |
| http://gnuwin32.sourceforge.net/packages/diffutils.htm | |
| Tras su instalación se recomienda agregar su ubicación a la variable | |
| de entorno PATH. | |
| Ejemplos: | |
| cm patch cs:4@default@localhost:8084 | |
| (Muestra en pantalla las diferencias del changeset 4 en formato patch.) | |
| cm patch br:/main --output=file.patch | |
| (Obtiene un fichero file.patch con las diferencias de la rama "main".) | |
| cm patch br:/main --output=file.patch --tool=C:\gnu\diff.exe | |
| (Misma operación con un ejecutable indicado explícitamente.) | |
| cm patch cs:2@default cs:4@default | |
| (Muestra en pantalla las diferencias entre los changeset 2 y 4.) | |
| cm patch --apply file.patch --tool=C:\gnu\patch.exe | |
| (Aplica el parche contenido en file.patch al workspace actual con un | |
| ejecutable indicado explícitamente.) | |
| == CMD_DESCRIPTION_PROFILE == | |
| Permite al usuario administrar perfiles de conexión configurados en el cliente. | |
| == CMD_USAGE_PROFILE == | |
| Sintaxis: | |
| cm profile | profile <command> [options] | |
| Comandos: | |
| list | ls | |
| create | mk | |
| delete | rm | |
| Para obtener más información sobre cada comando: | |
| cm profile <command> --usage | |
| cm profile <command> --help | |
| == CMD_HELP_PROFILE == | |
| Ejemplos: | |
| cm profile | |
| cm profile list | |
| cm profile create | |
| cm profile delete 1 | |
| == CMD_DESCRIPTION_PROFILE_LIST == | |
| Lista los perfiles de conexión configurados en el cliente. | |
| == CMD_USAGE_PROFILE_LIST == | |
| Sintaxis: | |
| cm profile [list | ls] [--format=<str_format>] | |
| Opciones: | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las notas para más información. | |
| == CMD_HELP_PROFILE_LIST == | |
| Notas: | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {index} | {0} Índice del perfil dentro de la lista | |
| {name} | {1} Nombre del perfil | |
| {server} | {2} Servidor del perfil | |
| {user} | {3} Usuario del perfil | |
| {workingmode} | {4} Modo de trabajo del perfil | |
| {securityconfig} | {5} Configuración de seguridad del perfil | |
| {tab} Inserta un tabulador | |
| {newline} Inserta una nueva línea | |
| Ejemplos: | |
| cm profile | |
| (Lista todos los perfiles usando el formato por defecto.) | |
| cm profile --format="{index,2} {server,-20}" | |
| (Muestra el índice del perfil utilizando 2 espacios y alineado a la derecha, | |
| dos espacios, y el servidor de repositorios utilizando veinte espacios, | |
| alineado a la izquierda.) | |
| cm profile --format="{0,2} {2,-20}" | |
| (Muestra el mismo resultado que el ejemplo anterior.) | |
| == CMD_DESCRIPTION_PROFILE_CREATE == | |
| Crea un nuevo perfil de conexión. | |
| == CMD_USAGE_PROFILE_CREATE == | |
| Sintaxis: | |
| cm profile [create | mk] | |
| (Crea un nuevo perfil de conexión de manera interactiva.) | |
| cm profile [create | mk] --server=<server_addr> --username=<username> | |
| --password=<password> --workingmode=<workingmode> | |
| (Crea un nuevo perfil de conexión usando un modo de autenticación basado | |
| en usuario y contraseña.) | |
| cm profile [create | mk] --server=<server_addr> --username=<username> | |
| --token=<token> --workingmode=SSOWorkingMode | |
| (Crea un nuevo perfil de conexión usando un modo de autenticación basado | |
| en Single Sign On.) | |
| Opciones: | |
| --server Crea el perfil de conexión para el servidor especificado. | |
| --username El nombre de usuario que va a ser utilizado en el perfil de | |
| conexión. | |
| --password La contraseña, en texto plano, que será usada en el perfil | |
| de conexión. Esta opción solo es válida para los modos de | |
| autenticación basados en usuario y contraseña. | |
| --token El token, en texto plano, que será usado en el perfil de | |
| conexión. Esta opción solo es válida para los modos de | |
| autenticación basados en token (por ahora solo SSOWorkingMode). | |
| --workingmode El modo de autenticación del servidor. | |
| Modos de autenticación disponibles: | |
| LDAPWorkingMode (LDAP) | |
| UPWorkingMode (User and password) | |
| SSOWorkingMode (Single Sign On) | |
| == CMD_HELP_PROFILE_CREATE == | |
| Notas: | |
| Cuando se utiliza este comando en modo interactivo (sin opciones) el cliente | |
| trata de conectarse con el servidor para obtener el modo de autenticación y | |
| comprobar las credenciales. Esto garantiza que el perfil de conexión | |
| resultante sea correcto. | |
| Cuando se utiliza este comando con opciones, el cliente genera el perfil de | |
| conexión sin conectar con el servidor. Esto es útil para crear perfiles de | |
| conexión para su uso en automatización. | |
| Ejemplos: | |
| cm profile create | |
| (Crea un perfil de conexión de manera interactiva.) | |
| cm profile create --server=plastic.domain.com:8087 --username=sergio | |
| --password=thisissupersecret --workingmode=LDAPWorkingMode | |
| (Crea un perfil de conexión contra 'plastic.domain.com:8087' con el usuario | |
| 'sergio' y la contraseña 'thisissupersecret' usando el modo de autenticación | |
| LDAP.) | |
| cm profile mk --server=plastic.domain.com:8087 --username=sergio | |
| --token="TOKENAMoKJ9iAA(...)12fssoprov:unityid" | |
| (Crea un perfil de conexión contra 'plastic.domain.com:8087' con el usuario | |
| 'sergio' y el token especificado usando el modo de autenticación Single Sign | |
| On.) | |
| == CMD_DESCRIPTION_PROFILE_DELETE == | |
| Borra un perfil de conexión de la configuración del cliente. | |
| == CMD_USAGE_PROFILE_DELETE == | |
| Sintaxis: | |
| cm profile delete | rm <index | name> | |
| cm profile delete | rm --index=<index> | |
| cm profile delete | rm --name=<name> | |
| index Índice del perfil en la lista de perfiles de conexión. | |
| name Nombre del perfil. | |
| Opciones: | |
| --index Utilizado para desambiguación en caso de que un perfil tenga un | |
| número por nombre. | |
| --name Utilizado para desambiguación en caso de que un perfil tenga un | |
| número por nombre. | |
| == CMD_HELP_PROFILE_DELETE == | |
| Notas: | |
| Borra un perfil de conexión de la configuración del cliente. | |
| Funciona especificando tanto el índice del perfil como su nombre. | |
| El comando 'cm profile list' no muestra el nombre del perfil por defecto, | |
| use 'cm profile list --help' para saber cómo mostrar el nombre del perfil. | |
| Ejemplos: | |
| cm profile delete 1 | |
| (Borra el perfil con índice 1) | |
| cm profile delete 192.168.0.2:8087_UPWorkingMode | |
| (Borra el perfil con nombre '192.168.0.2:8087_UPWorkingMode'.) | |
| cm profile delete --name=12 | |
| (Borra el perfil con nombre '12'.) | |
| == CMD_DESCRIPTION_QUERY == | |
| Ejecuta una consulta SQL contra la base de datos del servidor. | |
| == CMD_USAGE_QUERY == | |
| Uso: | |
| cm query comandosql [--outputfile=ruta] | |
| [--solveuser=nombre_columna1,nombre_columna2,...] | |
| [--solvepath=nombre_columna1,nombre_columna2,...] | |
| [--columnwidth=valor] | |
| --outputfile: Escribe en un fichero el resultado de la consulta. | |
| --solveuser: Indica al intérprete de consultas que la(s) columna(s) | |
| especificada(s) contiene(n) usuarios. Se tratarán de resolver | |
| identificadores de usuario a nombres de usuario. | |
| --solvepath: Indica al intérprete de consultas que la(s) columna(s) | |
| especificadas(s) contiene(n) identificadores de ítem. Se tratarán de | |
| resolver los identificadores a rutas de disco. | |
| --columnwidth: Especifica la anchura de cada columna del resultado de la | |
| consulta. | |
| == CMD_HELP_QUERY == | |
| Notas: | |
| Este comando permite a los usuarios ejecutar consultas SQL directamente | |
| contra la base de datos del servidor. | |
| A continuación se detalla el esquema (tablas y campos de cada tabla) | |
| disponibles para realizar consultas. | |
| ITEMS | |
| OBJECTID (integer) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| REVISIONS | |
| OBJECTID (integer) | |
| SIZEBYTES (integer) | |
| ITEMID (integer) | |
| BRANCHID (integer) | |
| CHANGESET (integer) | |
| COMMENT (string) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| CHECKOUTS | |
| REVISIONID (integer) | |
| WORKSPACESERVER (string) | |
| CLIENTMACHINE (string) | |
| EXCLUSIVE (char) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| BRANCHES | |
| OBJECTID (integer) | |
| NAME (string) | |
| PARENTBRANCHID (integer) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| LABELS | |
| OBJECTID (integer) | |
| NAME (string) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| LABELEDREVISIONS | |
| LABELID (integer) | |
| REVISIONID (integer) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| LINKS | |
| OBJECTID (integer) | |
| NAME (string) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| LINKEDOBJECTS | |
| LINKID (integer) | |
| SOURCEOBJECTID (integer) | |
| DESTINATIONOBJECTID (integer) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| ATTRIBUTES | |
| OBJECTID (integer) | |
| NAME (string) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| OBJECTSWITHATTRIBUTES | |
| ATTRIBUTEID (integer) | |
| SOURCEOBJECTID (integer) | |
| ATTRIBUTEVALUE (string) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| CHANGESETS | |
| CHANGESETNUMBER (integer) | |
| CREATIONDATE (datetime) | |
| OWNER (string) | |
| Además, a la hora de escribir consultas, existen dos functiones predefinidas | |
| para trabajar con usuarios y rutas de disco. | |
| Estas funciones son las siguientes: | |
| * SolveUser(nombre_usuario), resuelve el nombre de usuario dado al formato que | |
| maneja Unity VCS. | |
| * SolvePath(path), resuelve rutas de disco a identificadores de ítem itemid. | |
| Para mostrar el resultado de las consultas de forma legible al usuario, se | |
| puede indicar al intérprete de consultas que convierta identificadores de | |
| usuario a nombres de usuario, e identificadores de ítem a rutas de disco. | |
| Para ello se utilizan las opciones: | |
| --solveuser=nombre_columna | |
| --solvepath=nombre_columna | |
| Se pueden especificar varios nombres de columnas separados por comas. | |
| Ejemplos: | |
| cm query "SELECT * FROM revision" | |
| cm query "SELECT b.sname as br_name, o.dtimestamp as date from branch b, object o, seid s | |
| where b.iobjid=o.iobjid and o.fidowner=s.iseidid and s.scode='SolveUser(juan)'" | |
| cm query "SELECT * FROM REVISION WHERE itemid=SolvePath(c:\mi_workspace)" | |
| cm query "SELECT r.iobjid, r.fiditem as ruta, s.scode as nombre_usuario FROM revision r, object o, seid s | |
| WHERE r.iobjid=o.iobjid and o.fidowner=s.iseidid" --solveuser=nombre_usuario --solvepath=ruta | |
| == CMD_DESCRIPTION_ATTRIBUTE_DELETE == | |
| Borra uno o más atributos. | |
| == CMD_USAGE_ATTRIBUTE_DELETE == | |
| Sintaxis: | |
| cm attribute | att delete | rm <att_spec>[ ...] | |
| att_spec Atributos a borrar. Use un espacio en blanco para separar | |
| atributos. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de atributos.) | |
| == CMD_HELP_ATTRIBUTE_DELETE == | |
| Notas: | |
| Este comando borra uno o más atributos. | |
| Ejemplos: | |
| cm attribute delete att:status | |
| (Borra el atributo 'status'.) | |
| cm att rm status att:integrated@reptest@server2:8084 | |
| (Borra los atributos 'status' e 'integrated'.) | |
| == CMD_DESCRIPTION_ATTRIBUTE_UNSET == | |
| Desasigna un atributo a un objeto. | |
| == CMD_USAGE_ATTRIBUTE_UNSET == | |
| Sintaxis: | |
| cm attribute | att unset <att_spec> <object_spec> | |
| att_spec Especificación del atributo. (Use 'cm help objectspec' | |
| para más información sobre las especificaciones de | |
| atributos.) | |
| object_spec Especificación del objeto sobre el que desasignar el | |
| atributo. Se pueden fijar atributos a ramas, changesets, | |
| shelvesets, etiquetas, items y revisiones. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones.) | |
| == CMD_HELP_ATTRIBUTE_UNSET == | |
| Notas: | |
| Este comando elimina la asignación de un atributo que ha sido aplicado | |
| previamente a un objeto. Este comando no borra el atributo en sí. | |
| Ejemplo: | |
| cm attribute unset att:status br:/main/SCM105 | |
| (Desasigna el atributo 'status' que estaba aplicado a la rama 'main/SCM105'.) | |
| cm att unset att:integrated@reptest@localhost:8084 cs:25@reptest@localhost:8084 | |
| (Desasigna el atributo 'integrated' que estaba aplicado al changeset 25. | |
| Tanto el atributo como el changeset se encuentran en el repositorio 'reptest'.) | |
| == CMD_DESCRIPTION_ATTRIBUTE_RENAME == | |
| Renombra un atributo. | |
| == CMD_USAGE_ATTRIBUTE_RENAME == | |
| Sintaxis: | |
| cm attribute | att rename <att_spec> <new_name> | |
| att_spec Atributo a renombrar. (Use 'cm help objectspec' para | |
| más información sobre especificaciones de atributos.) | |
| new_name Nuevo nombre para el atributo. | |
| == CMD_HELP_ATTRIBUTE_RENAME == | |
| Notas: | |
| Este comando renombra un atributo. | |
| Ejemplos: | |
| cm attribute rename att:status state | |
| (Renombra el atributo 'status' a 'state') | |
| == CMD_DESCRIPTION_ATTRIBUTE_EDIT == | |
| Edita el comentario de un atributo. | |
| == CMD_USAGE_ATTRIBUTE_EDIT == | |
| Sintaxis: | |
| cm attribute | att edit <att_spec> <new_comment> | |
| att_spec Atributo al cual editar su comentario. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones de atributos.) | |
| new_comment Nuevo comentario para el atributo. Este comentario puede ser | |
| una lista de posibles valores que el usuario puede seleccionar | |
| cuando asigne un atributo a un objeto. Consulte las Notas | |
| para más información. | |
| == CMD_HELP_ATTRIBUTE_EDIT == | |
| Notas: | |
| Este comando cambia el comentario de un atributo. | |
| Para especificar la lista de valores por defecto para un atributo, indique | |
| un texto como este en el comentario del atributo: | |
| 'default: valor_uno, "valor dos", valor3, "Valor final"'. | |
| Ejemplos: | |
| cm attribute edit att:status "The status of a branch in the CI pipeline." | |
| (Edita el comentario del atributo 'status'.) | |
| cm attribute edit att:status "Status of a branch. default: open, resolved, reviewed" | |
| (Edita el comentario del atributo 'status'. Y también especifica una lista | |
| de valores. De este modo, cuando el usuario asigne el atribute 'status' a un | |
| objeto, podrá seleccionar uno de los siguientes valores: 'open', 'resolved' | |
| o 'reviewed'.) | |
| == CMD_DESCRIPTION_REPLICATE == | |
| ATENCIÓN: Este comando se ha declarado obsoleto. | |
| Ha sido reemplazado por 'pull' (equivalente a 'replicate') y por 'push' | |
| (equivalente a 'replicate --push'). | |
| Replica datos desde un repositorio remoto. | |
| == CMD_USAGE_REPLICATE == | |
| Uso: | |
| cm replicate br_spec dst_rep_spec [--nodata] [translateOptions] [authOptions] | |
| cm replicate hydrate br_spec [src_rep_spec] [authOptions] | |
| cm replicate hydrate cs_spec [src_rep_spec] [authOptions] | |
| cm replicate br_spec --package=packagename [--changeset=número] | |
| cm replicate dst_rep_spec --import=packagename | |
| br_spec: la rama para ser replicada/hidratada. Es una especificación | |
| completa de rama con el siguiente formato: | |
| br:/NOMBRE_RAMA[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]] | |
| cs_spec: changeset para ser hidratado. Es una espec. de changeset: | |
| cs:NUMERO_CHANGESET[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]] | |
| src_rep_sec: repositorio origen de los datos. Es una especificación | |
| completa de repositorio: | |
| rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto | |
| dst_rep_sec: repositorio destino de la replica. Es una especificación | |
| completa de repositorio: | |
| rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto | |
| Opciones: | |
| --package para crear un paquete de replicación. | |
| --import para importar un paquete concreto. | |
| --nodata para replicar los cambios de una rama sin replicar sus datos. Esta | |
| opción no se puede usar para la réplica con paquetes ni con la opción | |
| --push. | |
| Opciones de traducción: | |
| --trmode=[copy | name | table] para especificar cómo tratar los | |
| nombres de usuario cuando se importen los datos en el | |
| repositorio de destino: | |
| * copy -> es el utilizado por defecto. Copia los SEIDs en el | |
| repositorio de destino. | |
| * name -> realiza una traducción por nombre entre el modo | |
| de autentificación de origen y el de destino. | |
| * table -> se usará una tabla de traducción en la que se | |
| especifican los nombres de origen y cómo han de quedar | |
| en el destino. | |
| --trtable=[translationTable] | |
| una tabla de traducción es un fichero que contiene entradas | |
| en la forma nombre antiguo;nombre nuevo. | |
| Opciones de autentificación: | |
| Hay dos formas de especificar los datos de autentificación: | |
| 1) Especificando un fichero de autentificación. | |
| --authfile=fichero, un fichero que contiene dos líneas: el modo de | |
| autentificación en la primera línea y los datos de autentificación | |
| (ver --authdata) o una cadena vacía en la segunda. | |
| 2) Especificando la autentificación mediante parámetros. | |
| Para ello hay que especificar el modo de autentificación mediante el | |
| modificador: | |
| --authmode=[NameWorkingMode | NameIDWorkingMode | | |
| LDAPWorkingMode | ADWorkingMode | UPWorkingMode] | |
| Si está trabajando en UPWorkingMode o LDAPWorkingMode, puede | |
| especificar los datos de autentificación de dos formas: | |
| 2.1) Para UPWorkingMode o LDAPWorkingMode: | |
| --authdata=datos_de_autentificación | |
| Ejemplos: | |
| --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode) | |
| --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode) | |
| 2.2) Solamente para UPWorkingMode: | |
| --user=usuario | |
| --password=contraseña | |
| == CMD_HELP_REPLICATE == | |
| Notas: | |
| El comando 'replicate' replica datos desde una rama hacia un | |
| repositorio de destino. Todos los datos de la rama de origen, incluyendo | |
| revisiones, ítems, changesets, etiquetas, revisiones de código, links | |
| y seguridad serán replicados. | |
| Su cliente Unity VCS debe estar configurado para trabajar con el | |
| repositorio de destino. | |
| La replicación también gestiona la 'reconciliación' de ramas que han | |
| sido modificadas tanto en origen como en destino, mediante la creación | |
| de 'ramas de entrega' (fetch branches) que podrán ser integradas | |
| posteriormente para resolver los conflictos. | |
| La replicación puede funcionar en tres modos diferentes: | |
| 1- Comunicación directa entre servidores: lo que significa que el servidor | |
| de destino se comunicará con el de origen para sincronizar la rama | |
| especificada. | |
| 2- Generación de paquete de exportación: el cliente se conectará | |
| únicamente con el destino para generar un paquete de replicación con los | |
| datos y los metadatos de la rama especificada. Se usará el modificador | |
| --package. El usuario podrá especificar, opcionalmente, un changeset | |
| inicial desde el cual generar la replicación. | |
| 3- Importar un paquete generado previamente, usando la opción --import. | |
| En los modos 1 y 2 será necesaria la autentificación contra el servidor | |
| de origen. El comando 'replicate' acepta parámetros para especificar los | |
| diferentes modos de autentificación. | |
| Ejemplos: | |
| cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 | |
| cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=name | |
| cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=table --trtable=tabla.txt | |
| cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --authmode=NameWorkingMode --user=john.doe | |
| Significa que se autentificará contra el servidor 'MADRID' usando NameWorkingMode como usuario 'john.doe' | |
| cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data | |
| Creará un paquete de replicación | |
| cm replicate rep:mine@repserver:casa:9094 --import=replicationpackage.data | |
| Importará el paquete creado con anterioridad | |
| cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data --changeset=1230 | |
| Generará un paquete de replicación de la rama br:/main/releaseBL060 desde el changeset 1230 | |
| cm replicate /main@project1@LONDRES:8084 projectx@localhost:8084 --nodata | |
| Replicará la rama /main del servidor LONDRES a mi servidor sin replica los datos. | |
| cm replicate hydrate /main@projectx@localhost:8084 project1@LONDRES:8084 | |
| Hidratará los datos de la rama /main de mi servidor, usando los datos del servidor LONDRES. | |
| Nota adicional: | |
| La tabla de traducción tiene entradas (una por línea) con el siguiente | |
| formato: | |
| nombre antiguo;nombre nuevo | |
| == CMD_DESCRIPTION_PULL == | |
| Replica datos desde un repositorio remoto. | |
| == CMD_USAGE_PULL == | |
| Uso: | |
| cm pull src_br_spec dst_rep_spec | |
| [--preview] [--nodata] [translateOptions] | |
| [--user=usr_name [--password=pwd] | AuthOptions] | |
| (Replicación directa entre servidores. Hace pull de una rama desde un | |
| repositorio.) | |
| cm pull dst_rep_spec --package=pack_file [AuthOptions] | |
| (Replicación basada en paquetes. Importa el paquete en el servidor de | |
| destino.) | |
| cm pull hydrate dst_br_spec [src_rep_spec] | |
| [--user=usr_name [--password=pwd] | AuthOptions] | |
| (Introduce los datos restantes para todos los changesets de una rama | |
| replicada previamente con la opción --nodata. Si no se especifica un | |
| repositorio del que obtener los datos, Unity VCS intentará usar el | |
| origen de replicación original de la rama.) | |
| cm pull hydrate dst_cs_spec [src_rep_spec] | |
| [--user=usr_name [--password=pwd] | AuthOptions] | |
| (Introduce los datos restantes para un changeset replicado previamente | |
| con la opción --nodata. Si no se especifica un repositorio del que obtener | |
| los datos, Unity VCS intentará usar el origen de replicación original de | |
| la rama.) | |
| src_br_spec La rama a ser replicada desde un repositorio remoto. | |
| dst_br_spec La rama a ser hidratada. | |
| Especificación de ramas: | |
| [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]] | |
| dst_cs_spec El changeset a ser hidratado. | |
| Especificación de changesets: | |
| cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]] | |
| dst_rep_spec El repositorio de destino. | |
| Especificación de repositorio: | |
| [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto] | |
| --package El fichero de donde se importa un paquete de replicación | |
| creado anteriormente. | |
| Es útil para mover datos entre servidores sin una | |
| conexión de red directa. | |
| Consule 'cm push' para crear paquetes de replicación. | |
| Opciones: | |
| --preview Proporciona información sobre qué cambios serán traídos | |
| durante el pull, pero no se ejecuta ninguna acción más. | |
| Esta opción es útil para comprobar qué datos serán | |
| replicados antes de ejecutar el pull. | |
| --user, --password Credenciales para utilizar en caso de que el modo de | |
| autenticación de los servidores origen y destino | |
| difieran, y no exista un profile para autenticarse | |
| contra el remoto. | |
| --nodata Replica los metadatos de una rama sin replicar los | |
| datos. Esta opción no se puede utilizar al importar un | |
| paquete de replicación. | |
| Opciones de traducción (translateOptions): | |
| --trmode={copy|name|table} | |
| El servidor de origen y de destino pueden utilizar modos distintos de | |
| autenticación. Este argumento especifica cómo se han de traducir los | |
| nombres de usuario del origen al destino. | |
| - copy El modo por defecto, indica que los nombres de usuario serán | |
| simplemente copiados. | |
| - name Los nombres de usuario serán emparejados entre origen y | |
| destino por coincidencia. | |
| - table Se utilizará una tabla de traducción (más información a | |
| continuación). | |
| --trtable={translation_table_file} | |
| Si el modo de traducción es 'table', entonces una tabla de traducción | |
| es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo. | |
| Cuando la rama se escribe en el repositorio de destino, los objetos | |
| creados por un usuario identificado por "nombreantiguo" en el | |
| repositorio de origen serán asignados al usuario identificado por | |
| "nombrenuevo" en el repositorio de destino. | |
| Opciones de autentificación (AuthOptions): | |
| Hay dos formas de especificar los datos de autentificación: | |
| 1) Especificando la autentificación mediante parámetros: | |
| --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode} | |
| (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA | |
| (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA== | |
| El parámetro '--authdata' es el contenido del campo <SecurityConfig> | |
| en los ficheros client.conf o profiles.conf. El fichero profiles.conf | |
| puede ser generado desde la GUI de Unity VCS (Windows). | |
| Si se utiliza UPWorkingMode, se puede especificar simplemente: | |
| --authmode=UPWorkingMode --user=user --password=pwd | |
| 2.1) Para UPWorkingMode o LDAPWorkingMode: | |
| --authdata=datos_de_autentificación | |
| Ejemplos: | |
| --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode) | |
| --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode) | |
| 2.2) Solamente para UPWorkingMode: | |
| --user=usuario | |
| --password=contraseña | |
| 1) Especificando un fichero de autentificación. Se pueden tener varios | |
| ficheros de autenticación, uno por servidor al que se conecte, | |
| conteniendo las credenciales específicas para dicho servidor. | |
| --authfile=fichero | |
| Contiene 2 líneas: | |
| Línea 1) modo de autenticación, igual que para --authmode. | |
| Línea 2) datos de autenticación, igual que para --authdata. | |
| == CMD_HELP_PULL == | |
| Notas: | |
| El comando pull replica ramas (junto a sus changesets) entre un repositorio | |
| origen y otro destino. Los repositorios pueden encontrarse en diferentes | |
| servidores. | |
| Hay dos operaciones de replicación: push y pull. | |
| Una operación de 'pull' significa que la operación de replicación hará que | |
| el servidor destino obtenga datos desde el origen. El cliente se conectará | |
| con el servidor destino, y, desde ese host, establecerá una conexión con el | |
| repositorio origen para recuperar los datos pedidos. Durante el pull, será | |
| el servidor destino el que se conecte al origen. | |
| Aunque en un escenario distribuido típico el desarrollador haga pùsh de los | |
| cambios en su servidor local al servidor central, también puede ser | |
| necesario hacer pull de los últimos cambios en el servidor central al | |
| servidor local. | |
| La replicación puede resolver situaciones en las que se hagan cambios | |
| concurrentes en la misma rama en dos repositorios replicados: | |
| - Push: si se intenta hacer push de datos locales a un repositorio que tenga | |
| datos más nuevos que los que se están enviando, el sistema pedirá hacer | |
| pull de los últimos cambios, resolver el merge resultante y, finalmente, | |
| tratar de repetir el push. | |
| - Pull: cuando se hace pull de changesets de una rama remota, estos estarán | |
| correctamente enlazados a sus changesets padre. Si el changeset que se ha | |
| traído no es un hijo del último changeset de la rama, entonces aparecerá | |
| un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o | |
| dicho de otro modo, más de un changeset final de rama. Será necesario | |
| hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo. | |
| El pull puede funcionar de dos modos: | |
| 1) Comunicación directa entre servidores: lo que significa que el servidor | |
| de destino se comunicará con el de origen para sincronizar la rama | |
| especificada. | |
| 2) Importación de un paquete de replicación generado con push, con la opción | |
| --package. | |
| El modo 1) requere que el usuario que ejecute el comando esté autenticado | |
| contra el servidor remoto, bien o usando la autenticación por defecto en | |
| el fichero client.conf, mediante un profile creado previamente, o | |
| especificando los argumentos --authmode y --authdata (o --user y --password | |
| en caso de que el modo de autenticación sea UPWorkingMode). | |
| El modo 2) require usar un paquete de replicación generado previamente con | |
| el comando push. | |
| Recuerde que la replicación pull funciona de una manera indirecta. Cuando | |
| se ejecuta, el comando pide al repositorio destino que se conecte con el | |
| origen para obtener la rama especificada. | |
| Sin embargo, esto se puede hacer de manera directa utilizando el comando | |
| push, que hará que sea el repositorio origen quien envíe los datos | |
| directamente al destino. | |
| Ejemplos: | |
| cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 | |
| (Hace pull de la rama principal de remoteserver a myserver. En este caso, | |
| ambos servidores están configurados con el mismo modo de autenticación.) | |
| cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA | |
| (Hace pull de la misma rama que antes, pero ahora el servidor remoto está | |
| configurado para autenticar usuarios contra un Active Directory. Por ejemplo, | |
| se puede conectar de una máquina Linux a un servidor Windows configurado | |
| para usar Active Directory. Para ello, se especificará el usuario y la | |
| contraseña cifrada.) | |
| cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret | |
| (Hace pull de la misma rama, pero ahora ambos usuarios están autenticados | |
| en el servidor remoto mediante el sistema de gestión de usuarios integrado | |
| en Unity VCS.) | |
| cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --nodata | |
| (Hace pull de la rama principal de remoteserver a myserver pero sin datos.) | |
| cm pull hydrate br:/main@projectx@myserver:8084 projectx@remoteserver:8084 | |
| (Introduce los datos de todos los changesets de la rama principal obteniendo | |
| dichos datos del repositorio en remoteserver.) | |
| cm pull hydrate cs:122169@projectx@myserver:8084 projectx@remoteserver:8084 | |
| (Introduce los datos del changeset 122169 en myserver obteniendo dichos | |
| datos del repositorio en remoteserver.) | |
| Nota adicional: | |
| La tabla de traducción tiene entradas (una por línea) de la forma: | |
| nombre antiguo;nombre nuevo | |
| == CMD_DESCRIPTION_PUSH == | |
| Replica datos hacia un repositorio remoto. | |
| == CMD_USAGE_PUSH == | |
| Uso: | |
| cm push src_br_spec dst_rep_spec | |
| [--preview] [translateOptions] | |
| [--user=usr_name [--password=pwd] | AuthOptions] | |
| (Replicación directa entre servidores. Hace push de una rama hacia un | |
| repositorio.) | |
| cm push src_br_spec --package=pack_file [AuthOptions] | |
| (Replicación basada en paquetes. Crea un paquete de replicación con la | |
| rama especificada.) | |
| src_br_spec La rama a ser replicada desde un repositorio remoto. | |
| Especificación de ramas: | |
| [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]] | |
| dst_cs_spec El changeset a ser hidratado. | |
| Especificación de changesets: | |
| cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]] | |
| dst_rep_spec El repositorio de destino. | |
| Especificación de repositorio: | |
| [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto] | |
| --package Exporta un paquete de replicación al fichero especificado. | |
| Es útil para mover datos entre servidores sin una | |
| conexión de red directa. | |
| Opciones: | |
| --preview Proporciona información sobre qué cambios serán enviados | |
| durante el push, pero no se ejecuta ninguna acción más. | |
| Esta opción es útil para comprobar qué datos serán | |
| replicados antes de ejecutar el push. | |
| --user, --password Credenciales para utilizar en caso de que el modo de | |
| autenticación de los servidores origen y destino | |
| difieran, y no exista un profile para autenticarse | |
| contra el remoto. | |
| --nodata Replica los metadatos de una rama sin replicar los | |
| datos. Esta opción no se puede utilizar al exportar un | |
| paquete de replicación. | |
| Opciones de traducción (translateOptions): | |
| --trmode={copy|name|table} | |
| El servidor de origen y de destino pueden utilizar modos distintos de | |
| autenticación. Este argumento especifica cómo se han de traducir los | |
| nombres de usuario del origen al destino. | |
| - copy El modo por defecto, indica que los nombres de usuario serán | |
| simplemente copiados. | |
| - name Los nombres de usuario serán emparejados entre origen y | |
| destino por coincidencia. | |
| - table Se utilizará una tabla de traducción (más información a | |
| continuación). | |
| --trtable={translation_table_file} | |
| Si el modo de traducción es 'table', entonces una tabla de traducción | |
| es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo. | |
| Cuando la rama se escribe en el repositorio de destino, los objetos | |
| creados por un usuario identificado por "nombreantiguo" en el | |
| repositorio de origen serán asignados al usuario identificado por | |
| "nombrenuevo" en el repositorio de destino. | |
| Opciones de autentificación (AuthOptions): | |
| Hay dos formas de especificar los datos de autentificación: | |
| 1) Especificando la autentificación mediante parámetros: | |
| --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode} | |
| (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA | |
| (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA== | |
| El parámetro '--authdata' es el contenido del campo <SecurityConfig> | |
| en los ficheros client.conf o profiles.conf. El fichero profiles.conf | |
| puede ser generado desde la GUI de Unity VCS (Windows). | |
| Si se utiliza UPWorkingMode, se puede especificar simplemente: | |
| --authmode=UPWorkingMode --user=user --password=pwd | |
| 2.1) Para UPWorkingMode o LDAPWorkingMode: | |
| --authdata=datos_de_autentificación | |
| Ejemplos: | |
| --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode) | |
| --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode) | |
| 2.2) Solamente para UPWorkingMode: | |
| --user=usuario | |
| --password=contraseña | |
| 1) Especificando un fichero de autentificación. Se pueden tener varios | |
| ficheros de autenticación, uno por servidor al que se conecte, | |
| conteniendo las credenciales específicas para dicho servidor. | |
| --authfile=fichero | |
| Contiene 2 líneas: | |
| Línea 1) modo de autenticación, igual que para --authmode. | |
| Línea 2) datos de autenticación, igual que para --authdata. | |
| == CMD_HELP_PUSH == | |
| Notas: | |
| El comando pull replica ramas (junto a sus changesets) entre un repositorio | |
| origen y otro destino. Los repositorios pueden encontrarse en diferentes | |
| servidores. | |
| Hay dos operaciones de replicación: push y pull. | |
| Una operación de 'push' significa que la operación de replicación enviará | |
| datos desde el repositorio origen al repositorio destino. En este caso, el | |
| cliente se conectará al repositorio origen, recuperando los datos para ser | |
| replicados, y entonces los enviará al repositorio destino. Mientras que el | |
| origen necesita tener conectividad con el destino, el destino no se | |
| conectará con el origen. | |
| En un escenario distribuido típico el desarrollador hace push de los | |
| cambios en su servidor local al servidor central. También puede ser | |
| necesario hacer pull de los últimos cambios en el servidor central al | |
| servidor local. | |
| La replicación puede resolver situaciones en las que se hagan cambios | |
| concurrentes en la misma rama en dos repositorios replicados: | |
| - Push: si se intenta hacer push de datos locales a un repositorio que tenga | |
| datos más nuevos que los que se están enviando, el sistema pedirá hacer | |
| pull de los últimos cambios, resolver el merge resultante y, finalmente, | |
| tratar de repetir el push. | |
| - Pull: cuando se hace pull de changesets de una rama remota, estos estarán | |
| correctamente enlazados a sus changesets padre. Si el changeset que se ha | |
| traído no es un hijo del último changeset de la rama, entonces aparecerá | |
| un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o | |
| dicho de otro modo, más de un changeset final de rama. Será necesario | |
| hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo. | |
| El push puede funcionar de dos modos: | |
| 1) Comunicación directa entre servidores: lo que significa que el servidor | |
| de origen se comunicará con el de destino para sincronizar la rama | |
| especificada. | |
| 2) Exportación de un paquete de replicación: El cliente únicamente se | |
| conectará con el origen y generará un paquete de replicación que contenga | |
| tanto los datos como los metadatos para la rama especificada. Para ello | |
| se utilizará el argumento --package. | |
| Ambos modos requeren que el usuario ejecutando el comando esté autenticado | |
| contra el servidor, bien o usando la autenticación por defecto en el fichero | |
| client.conf, mediante un profile creado previamente, o especificando los | |
| argumentos --authmode y --authdata (o --user y --password en caso de que | |
| el modo de autenticación sea UPWorkingMode). | |
| La replicación push funciona de una manera directa. Cuando se ejecuta, el | |
| comando replicará la rama seleccionada del origen al destino, en vez de | |
| pedir al repositorio destino que se conecte al repositorio origen para | |
| obtener la rama especificada (como hace pull). | |
| Ejemplos: | |
| cm push br:/main@project1@myserver:8084 projectx@remoteserver:8084 | |
| (Hace push de la rama main desde myserver a remoteserver. En este caso, | |
| ambos servidores están configurados con el mismo modo de autenticación.) | |
| cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA | |
| (Hace push de la misma rama que antes, pero ahora el servidor remoto está | |
| configurado para autenticar usuarios contra un Active Directory. Por ejemplo, | |
| se puede conectar de una máquina Linux a un servidor Windows configurado | |
| para usar Active Directory. Para ello, se especificará el usuario y la | |
| contraseña cifrada.) | |
| cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret | |
| (Hace push de la misma rama, pero ahora ambos usuarios están autenticados | |
| en el servidor remoto mediante el sistema de gestión de usuarios integrado | |
| en Unity VCS.) | |
| Nota adicional: | |
| La tabla de traducción tiene entradas (una por línea) de la forma: | |
| nombre antiguo;nombre nuevo | |
| == CMD_DESCRIPTION_CLONE == | |
| Clona un repositorio remoto. | |
| == CMD_USAGE_CLONE == | |
| Sintaxis: | |
| cm clone <src_rep_spec> [<dst_rep_spec> | <dst_repserver_spec>] | |
| [--user=<usr_name> [--password=<pwd>] | AuthOptions] | |
| [TranslateOptions] | |
| (Clonado directo repositorio-a-repositorio.) | |
| cm clone <src_rep_spec> --package=<pack_file> | |
| [--user=<usr_name> [--password=<pwd>] | AuthOptions] | |
| (Clonado a un paquete intermedio que se podrá importar posteriormente al | |
| repositorio destino mediante un pull.) | |
| src_rep_spec Repositorio origen de la operación de clonado. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de repositorio.) | |
| dst_rep_spec Repositorio destino de la operación de clonado. Si | |
| existe, debe estar vacío. Si no existe, se creará. | |
| Si no se especifica, el comando utilizará el servidor | |
| de repositorios por defecto. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de repositorios. | |
| dst_repserver_spec Servidor de repositorios destino de la operación de | |
| clonado. Si existe un repositorio con el mismo nombre | |
| que <src_rep_spec>, debe estar vacío. Si no existe, se | |
| creará. | |
| Si no se especifica, el comando utilizará el servidor | |
| de repositorios por defecto. | |
| (Use 'cm help objectspec' para más información sobre | |
| las especificaciones de servidor de repositorio.) | |
| Options: | |
| --user, --password Credenciales para utilizar en caso de que el modo de | |
| autenticación de los servidores origen y destino | |
| difieran, y no exista un perfil para autentificarse | |
| en el destino. | |
| --package Exporta el repositorio indicado a un fichero de paquete | |
| en lugar de a otro repositorio. | |
| Es útil para mover datos entre servidores sin una | |
| conexión de red directa. | |
| El paquete resultante se importará mediante el comando | |
| pull. | |
| TranslateOptions Consulte las opciones de traducción para más información. | |
| AuthOptions Consulte las opciones de autentificación para más | |
| información. | |
| Opciones de traducción (TranslateOptions): | |
| --trmode=(copy|name|table --trtable=<translation_table_file>) | |
| Los repositorios origen y destino pueden utilizar distintos modos de | |
| autenticación. La opción --trmode especifica cómo se han de traducir los | |
| nombres de usuario del origen al destino. La opción --trmode puede tener | |
| uno de los siguientes valores: | |
| copy (Defecto.) Indica que los identificadores de los usuario | |
| serán simplemente copiados. | |
| name Los identificadores de usuario serán emparejados entre origen | |
| y destino por nombre. | |
| table Se utilizará la tabla de traducción indicada en la opción | |
| --trtable (más información a continuación). | |
| --trtable=<translation_table_file> | |
| Si el modo de traducción es 'table', entonces una tabla de traducción | |
| es un fichero que contiene líneas de la forma <nombreantiguo;nombrenuevo> | |
| (uno por línea). Cuando la rama se escribe en el repositorio de destino, | |
| los objetos creados por un usuario identificado por "nombreantiguo" en | |
| el repositorio de origen serán asignados al usuario identificado por | |
| "nombrenuevo" en el repositorio de destino. | |
| Opciones de autentificación (AuthOptions): | |
| Hay dos formas de especificar los datos de autentificación: | |
| 1) Usando parámetros de autentificación: --authmode=<mode> --authdata=<data> | |
| --authmode=(NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode) | |
| Por ejemplo: | |
| (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA | |
| (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA== | |
| La línea '--authdata' es el contenido de la entrada <SecurityConfig> | |
| en los ficheros client.conf o profiles.conf. El fichero profiles.conf | |
| puede ser generado desde la GUI de Unity VCS en la pestaña Perfiles | |
| de Conexión en la ventana de Preferencias. | |
| Si se utiliza UPWorkingMode, se puede especificar: | |
| --authmode=UPWorkingMode --user=<user> --password=<pwd> | |
| 2) Especificando un fichero de autentificación. Pueden existir varios | |
| ficheros de autentificación, uno por cada servidor al que se conecte, | |
| conteniendo las credenciales específicas para dicho servidor. | |
| --authfile=<authentication_file> | |
| Contiene 2 líneas: | |
| Línea 1) modo de autenticación, igual que para --authmode. | |
| Línea 2) datos de autenticación, igual que para --authdata. | |
| == CMD_HELP_CLONE == | |
| Notas: | |
| El comando clone puede replicar ramas (junto a sus changesets, etiquetas, | |
| atributos, reviews, etc.) desde un repositorio origen a un repositorio | |
| destino. Los repositorios pueden encontrarse en diferentes servidores. | |
| El repositorio destino puede existir de antemano, pero si contiene datos | |
| previos, la operación de clonado fallará. | |
| La operación de clonado NO clona submódulos ni repositorios que se encuentren | |
| bajo un Xlink. | |
| Ejemplos: | |
| cm clone awesomeProject@tardis@cloud | |
| (Clona el repositorio 'awesomeProject' de la organización Cloud tardis@cloud | |
| a un repositorio local del mismo nombre.) | |
| cm clone repo@server.home:9095 repo-local | |
| (Clona 'repo' desde 'server.home:9095' en 'repo-local' localizado en el | |
| servidor de repositorios por defecto del usuario.) | |
| cm clone project@192.168.111.130:8084 repserver:192.168.111.200:9095 | |
| (Clona 'project' desde '192.168.111.130:8084' a | |
| 'project@192.168.111.200:9095'.) | |
| cm clone project@ldapserver:8084 --authfile=credentials.txt --trmode=table --trtable=table.txt | |
| (Clona el repositorio 'project' desde 'ldapserver:8084' utilizando un fichero | |
| de autentificación contra el servidor remoto, y traduciendo los usuarios | |
| siguiendo la tabla de traducción especificada.) | |
| cm clone project@server.home:9095 --package=project.plasticpkg | |
| cm mkrep project@mordor.home:8084 | |
| cm pull --package=project.plasticpkg project@mordor.home:8084 | |
| (Clona 'project' desde 'server.home:9095' al paquete 'project.plasticpkg' | |
| que se importa posteriormente en el repositorio 'project' de | |
| 'mordor.home:8084' mediante una operación de pull.) | |
| == CMD_DESCRIPTION_REVERT == | |
| Carga en el espacio de trabajo la revisión especificada y desprotege el elemento. | |
| == CMD_USAGE_REVERT == | |
| Sintaxis: | |
| cm revert cset_spec | |
| cset_spec Especificación del changeset que contiene la revisión del ítem | |
| cuyo contenido se desea cargar en el espacio de trabajo. | |
| Usa 'cm help objectspec' para obtener más información sobre la | |
| especificación de changesets. | |
| == CMD_HELP_REVERT == | |
| Notas: | |
| El ítem ha de esta estar protegido. | |
| Ejemplos: | |
| cm revert dir#cs:0 | |
| cm revert C:\mywks\dir\file1.txt#cs:23456 | |
| == CMD_DESCRIPTION_REVISION_HISTORY == | |
| Muestra la historia de un ítem. | |
| == CMD_USAGE_REVISION_HISTORY == | |
| Sintaxis: | |
| cm history | hist <item_path>[ ...] [--long | --format=<str_format>] | |
| [--symlink] [--xml[=<output_file>]] [--encoding=<name>] | |
| [--moveddeleted] | |
| item_path Ruta de los ítems. Use un espacio en blanco para separar | |
| rutas de ítems. Use comillas dobles (" ") para especificar | |
| rutas que contengan espacios. | |
| Las rutas pueden ser rutas de revisiones en servidor. | |
| (Use 'cm help objectspec' para más información sobre las | |
| especificaciones.) | |
| Opciones: | |
| --long Muestra información adicional. | |
| --format Muestra el mensaje de salida en el formato indicado. | |
| Consulte las Notas para más información. No puede | |
| combinarse con --xml. | |
| --symlink Aplica la operación al symlink pero no al destino (target). | |
| --xml Imprime el resultado en formato XML a la salida estándar. | |
| También es posible especificar un fichero de salida. No | |
| puede combinarse con --format. | |
| --encoding Usado con la opción --xml, especifica el encoding que se | |
| usará en la salida XML, por ejemplo, utf-8. | |
| Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y su | |
| formato (al final de la página en la columna "Name"). | |
| --moveddeleted Incluye las operaciones de movidos y borrado en la historia. | |
| --limit Muestra las N revisiones más recientes para los elementos | |
| especificados, ordenados por fecha y por changeset id. Si | |
| se proporciona un número negativo, el comando devolverá una | |
| lista vacía. Si se proporciona un número mayor al número de | |
| revisiones del elemento solicitado, devolverá las existentes. | |
| == CMD_HELP_REVISION_HISTORY == | |
| Notas: | |
| Este comando muestra una lista de revisiones para el ítem indicado, e | |
| información de etiqueta, rama y comentario de cada revisión. | |
| Parámetros de formato de salida (opción --format): | |
| Este comando acepta una cadena de formato para mostrar la salida. | |
| Los parámetros de salida de este comando son los siguientes: | |
| {0} | {date} Fecha. | |
| {1} | {changesetid} Número de changeset. | |
| {2} | {branch} Rama. | |
| {4} | {comment} Comentario. | |
| {5} | {owner} Propietario de la revisión. | |
| {6} | {id} Id de revisión. | |
| {7} | {repository} Repositorio. | |
| {8} | {server} Servidor. | |
| {9} | {repspec} Especificación de repositorio. | |
| {10}| {datastatus} Disponibilidad del dato de la revision. | |
| {11}| {path} Ruta o spec pasada como <item_path>. | |
| {12}| {itemid} Id del elemento. | |
| {13}| {size} Tamaño. | |
| {14}| {hash} Código hash. | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una nueva línea. | |
| Ejemplos | |
| cm history file1.txt "file2.txt" | |
| cm hist c:\workspace --long | |
| (Muestra toda la información.) | |
| cm history link --symlink | |
| (Aplica la operación al fichero de symlink y no al destino.) | |
| cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver | |
| (Muestra la historia de una revisión de una ruta de servidor en la rama | |
| especificada.) | |
| cm history bar.c, foo.c --long --limit=2 | |
| (Muestra las últimas 2 revisiones para los elemetos bar.c and foo.c.) | |
| == CMD_DESCRIPTION_REVISION_TREE == | |
| Muestra un árbol de revisiones para el ítem dado. | |
| == CMD_USAGE_REVISION_TREE == | |
| Sintaxis: | |
| cm tree ruta | |
| ruta: Ruta del ítem sobre el que se mostrará el árbol. | |
| Opciones: | |
| --symlink: Efectúa la operación sobre el fichero de link y no sobre el ítem | |
| al que apunta. | |
| == CMD_HELP_REVISION_TREE == | |
| Ejemplos: | |
| cm tree fichero1.txt | |
| cm tree c:\workspace | |
| cm tree link --symlink | |
| (Efectúa la operación sobre el fichero de symlink | |
| y no sobre el que apunta.) | |
| == CMD_DESCRIPTION_RM == | |
| Use este comando para borrar ficheros y directorios. | |
| == CMD_USAGE_RM == | |
| Sintaxis: | |
| cm remove | em comando [opciones] | |
| Comandos: | |
| controlled (opcional) | |
| private | |
| Para obtener más información sobre cada comando: | |
| cm remove comando --usage | |
| cm remove comando --help | |
| == CMD_HELP_RM == | |
| Ejemplos: | |
| cm remove \fichero_controlado.txt | |
| cm remove private \fichero_privado.txt | |
| == CMD_DESCRIPTION_RM_CONTROLLED == | |
| Borra un ítem del control de versiones. | |
| == CMD_USAGE_RM_CONTROLLED == | |
| Sintaxis: | |
| cm remove [opciones] rutas | |
| rutas: Rutas de los ítem a borrar. | |
| Opciones: | |
| -R: Descender recursivamente dentro de directorios. | |
| == CMD_HELP_RM_CONTROLLED == | |
| Notas: | |
| El ítem nunca borra del disco. | |
| Requisitos para borrar: | |
| El ítem ha de estar controlado en Unity VCS. | |
| El directorio padre debe estar desprotegido. | |
| El elemento no debe estar desprotegido. | |
| Si el ítem es un directorio, no debe tener desprotecciones pendientes. | |
| Ejemplos: | |
| cm remove src (borra el directorio 'src') | |
| cm remove c:\workspace\fichero.txt | |
| == CMD_DESCRIPTION_RM_PRIVATE == | |
| Borra ficheros y directorios privados. | |
| Advertencia: este comando elimina permanentemente ficheros y directorios, y no | |
| son recuperables. Es recomendable utilizar antes la opción '--dry-run' para | |
| comprobar qué ficheros y directorios serán afectados por el comando. | |
| == CMD_USAGE_RM_PRIVATE == | |
| Sintaxis: | |
| cm remove | rm private <ruta>+ [-r] [--verbose] [--dry-run] | |
| ruta Ruta del fichero o directorio a borrar. | |
| Se pueden usar comillas (") para especificar rutas que | |
| contengan espacios. | |
| Opciones: | |
| --r Elimina ficheros privados recursivamente dentro de | |
| directorios controlados. | |
| --ignored También se elimina ficheros y directorios ignorados y | |
| cloaked. | |
| --verbose Muestra todos las rutas afectadas. | |
| --dry-run Ejecuta el comando sin hacer cambios en disco. | |
| == CMD_HELP_RM_PRIVATE == | |
| Notas: | |
| Si la ruta especificada corresponde a un fichero o directorio privados, este | |
| será eliminado de disco. | |
| Si la ruta corresponde a un fichero bajo control de versiones, el comando | |
| fallará. | |
| Si la ruta pertenece a un directorio bajo control de versiones, el comando | |
| fallará salvo que se especifique la opción '-r', en cuyo caso se borrarán | |
| todos los ficheros y directorios privados dentro del directorio controlado | |
| especificado. | |
| Ejemplos: | |
| cm remove private private_directory | |
| (Eliminina el directorio 'private_directory'.) | |
| cm remove private c:\workspace\controlled_directory | |
| (Falla, pues el directorio 'controlled_directory' no es privado.) | |
| cm remove private -r c:\workspace\controlled_directory | |
| (Elimina todos los ficheros y directorios privados dentro de | |
| 'controlled_directory'.) | |
| cm rm private --dry-run --verbose c:\workspace\controlled_directory -r | |
| (Muestra todas las rutas afectadas por la operación de borrado de elementos | |
| privados dentro de 'controlled_directory' sin borrar nada.) | |
| cm rm private --verbose c:\workspace\controlled_directory -r | |
| (Muestra todas las rutas afectadas por la operación de borrado de elementos | |
| privados dentro de 'controlled_directory', ejecutando el borrado.) | |
| == CMD_DESCRIPTION_TRIGGER_DELETE == | |
| Borra un trigger. | |
| == CMD_USAGE_TRIGGER_DELETE == | |
| Sintaxis: | |
| cm trigger | tr delete | rm <subtype-type> <position_number> | |
| [--server=<repserverspec>] | |
| subtype-type Ejecución y operación del trigger. | |
| (Use 'cm showtriggertypes' para ver la lista de tipos de | |
| triggers.) | |
| position_number Posición asignada al trigger cuando se creó. | |
| Opciones: | |
| --server Borra el trigger del servidor especificado. | |
| Si no se especifica ningún servidor, el comando se | |
| ejecuta en el servidor configurado en el cliente. | |
| == CMD_HELP_TRIGGER_DELETE == | |
| Ejemplos: | |
| cm trigger delete after-setselector 4 | |
| cm tr rm after-setselector 4 | |
| == CMD_DESCRIPTION_ATTRIBUTE_SET == | |
| Asigna un atributo al objeto indicado. | |
| == CMD_USAGE_ATTRIBUTE_SET == | |
| Sintaxis: | |
| cm attribute | att set <att_spec> <object_spec> <att_value> | |
| att_spec Especificación del atributo. (Use 'cm help objectspec' | |
| para más información sobre especificaciones de atributos.) | |
| object_spec Especificación del objeto al que asignar el atributo. | |
| Objetos válidos para este comando: rama, changeset, | |
| shelveset, etiqueta, item y revisión. | |
| (Use 'cm help objectspec' para más información sobre | |
| especificaciones.) | |
| att_value Valor del atributo que se asignará al objeto. | |
| == CMD_HELP_ATTRIBUTE_SET == | |
| Notas: | |
| Un atributo se asigna a un objeto para añadirle más información. | |
| Se pueden asignar atributos a los siguientes objetos: ramas, changesets, | |
| shelvesets, etiquetas, items y revisiones. | |
| Ejemplo: | |
| cm attribute set att:status br:/main/SCM105 open | |
| (Aplica el atributo 'status' a la rama 'SCM105' asignándola el valor 'open'.) | |
| cm att set att:integrated@reptest@server2:8084 lb:LB008@reptest@server2:8084 yes | |
| (Aplica el atributo 'integrated' a la etiqueta 'LB008' del repositorio 'reptest | |
| asignándola el valor 'yes'.) | |
| == CMD_DESCRIPTION_SETOWNER == | |
| Establece el propietario de un objeto. | |
| == CMD_USAGE_SETOWNER == | |
| Sintaxis: | |
| cm setowner | sto --user=usuario | --group=grupo spec_objeto | |
| --user Nombre de usuario. Nuevo propietario del objeto. | |
| --group Nombre de grupo. Nuevo propietario del objeto. | |
| spec_objeto Especificación del objeto sobre el que asignar el nuevo | |
| propietario. | |
| Se puede asignar nuevo usuario a los siguientes objetos: | |
| repserver, repositorio, rama, changeset, etiqueta, item, | |
| revisión y atributo. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de objetos. | |
| == CMD_HELP_SETOWNER == | |
| Notas: | |
| Es posible modificar el propietario de un objeto mediante el comando | |
| setowner. El propietario de un objeto puede ser un usuario o un grupo. | |
| Para especificar un usuario se utiliza la opción –-user=xxx y para | |
| especificar un grupo se utiliza la opción -–group=xxx. El objeto que se | |
| quiere modificar se especifica mediante una especificación de objeto. | |
| Se puede modificar el propietario de los siguientes objetos: | |
| servidor de repositorios, repositorio, rama, changeset, etiqueta, item, | |
| revisión y atributo. | |
| Ejemplos: | |
| cm setowner --user=danipen repserver:localhost:8084 | |
| (establece a 'danipen' como propietario del servidor de repositorios) | |
| cm sto --group=development rep:principal@PlasticServer:8084 | |
| (establece al grupo 'development' como el propietario del repositorio 'principal') | |
| == CMD_DESCRIPTION_SETSELECTOR == | |
| Establece un selector para un espacio de trabajo. | |
| == CMD_USAGE_SETSELECTOR == | |
| Sintaxis: | |
| cm setselector [opciones] [wk_ruta | wk_spec] [--noinput] | |
| wk_ruta Ruta del espacio de trabajo sobre el que establecer el | |
| selector. | |
| wk_spec Especificación del espacio de trabajo sobre el que | |
| establecer el selector. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre especificaciones de espacios de trabajo. | |
| Opciones: | |
| --file Fichero del que cargar un selector. | |
| --ignorechanges Ignora el mensaje de aviso de cambios pendientes que se | |
| muestra si existen cambios pendientes cuando se | |
| actualiza el espacio de trabajo. | |
| --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se | |
| redirige la salida estándar. | |
| --noinput Ignora las preguntas interactivas para continuar la | |
| operación con cambios pendientes o haciendolos shelve. | |
| == CMD_HELP_SETSELECTOR == | |
| Notas: | |
| Este comando establece un selector para un espacio de trabajo determinado. | |
| Un workspace necesita información acerca de dónde obtener las revisiones | |
| con las que trabajará el usuario. Para especificar esa información se | |
| utilizan los selectores. | |
| Mediante un selector se puede indicar, por ejemplo, que se carguen las | |
| revisiones desde una rama determinada o desde la rama ‘main’, desde una | |
| etiqueta, y especificar la rama donde se alojarán las desprotecciones. | |
| Si no se especifica ningún fichero del que cargar el selector se abrirá | |
| un editor de texto. | |
| Indicar una ruta o una especificación de workspace es opcional. Si no se | |
| especifica ninguno el selector se fijará para el espacio de trabajo en | |
| el que se encuentra el usuario. | |
| Un selector de ejemplo: | |
| repository "default" // indica el repositorio con el que se trabaja | |
| path "/" // se aplica al path raíz | |
| branch "/main" // se obtendrán las últimas revisiones de br:/main | |
| checkout "/main" // los checkouts se ubicarán en la rama br:/main | |
| Ejemplos: | |
| cm setselector | |
| cm setselector --file=c:\selectores\miRama.xml | |
| cm setselector --file=c:\selectores\rama5.xml MiWorkspace | |
| cm setselector wk:workspace_projA@BEARDTONGUE | |
| == CMD_DESCRIPTION_SHELVE == | |
| El comando shelve almacena el contenido de las revisiones en checkout. | |
| == CMD_USAGE_SHELVE == | |
| Este comando está obsoleto. Se ha reemplazado por 'cm shelveset'. | |
| Sintaxis: | |
| cm shelve [opciones] [rutas] | |
| rutas: rutas de los items a guardar. | |
| Opciones: | |
| --apply=shelve_spec : Restaura los contenidos almancenados en el | |
| repositorio, identificados por "shelve_spec" en el espacio de trabajo | |
| local. | |
| --delete=shelve_spec: Elimina los contenidos almancenados en el repositorio | |
| identificados por "shelve_spec" | |
| --all (-a): Los ítems cambiados, movidos y borrados localmente, en las | |
| rutas dadas, también serán guardados. | |
| --dependencies: Incluir las dependencias de los cambios locales entre los | |
| ítems a guardar. | |
| -c=comentarios: Añade un comentario al shelve creado en la operación. | |
| --commentsfile=comment.txt: Carga el comentario del fichero especificado. | |
| --summaryformat: El comando imprime sólamente la especificación del | |
| objeto creado en el repositorio principal, omitiendo los objetos | |
| que pudieran crearse en repositorios 'xlinked'. También se omite | |
| cualquier otro mensaje que el comando pudiera imprimir. | |
| Opción diseñada para implementar automatizaciones. | |
| --mount: El punto de montaje del respositorio especificado. | |
| --encoding=codificación: Especifica la codificación de los ficheros de | |
| origen (por ejemplo, UTF-8 o Unicode) | |
| --comparisonmethod=tipo: cualquiera de las siguientes opciones: | |
| ignoreeol: Ignora diferencias de final de línea. | |
| ignorewhitespaces: Ignora diferencias de espacios en blanco. | |
| ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en | |
| blanco. | |
| recognizeall: Detecta diferencias de final de línea y espacios en | |
| blanco. | |
| == CMD_HELP_SHELVE == | |
| Notas: | |
| - Si no se especifican [opciones] ni [rutas], la operación involucrará a | |
| todos los cambios pendientes en el espacio de trabajo. | |
| - La operación de shelve se aplica siempre recursivamente desde la | |
| ruta indicada. | |
| - Requisitos para hacer shelve de un ítem: | |
| * El ítem debe estar controlado por Unity VCS. | |
| * El ítem ha de estar desprotegido. | |
| Ejemplos: | |
| cm shelve | |
| cm shelve fichero1.txt fichero2.txt | |
| Comentarios: | |
| Para especificar comentarios use el switch "-c" o "-m" del siguiente modo: | |
| cm shelve -c="my comment" | |
| cm shelve -m "my comment" | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplo: Aplicar un shelve almacenado en el repositorio: | |
| cm shelve --apply=sh:3 | |
| Ejemplo: Eliminar un shelve almacenado en el repositorio | |
| cm shelve --delete=sh:3 | |
| Ejemplo: Shelve 'changelist' | |
| cm status --short --changelist=pending_to_review | cm shelve - | |
| (El comando listará los paths en el changelist llamado 'pending_to_review' | |
| y dicha lista será redirigida a la entrada del comando 'shelve'). | |
| == CMD_DESCRIPTION_SHELVESET == | |
| Use este comando para administrar shelvesets. | |
| == CMD_USAGE_SHELVESET == | |
| Sintaxis: | |
| cm shelveset comando [opciones] | |
| Comandos: | |
| create | mk | |
| delete | rm | |
| apply | |
| Para obtener más información sobre cada comando: | |
| cm shelveset command --usage | |
| cm shelveset command --help | |
| == CMD_HELP_ATTRIBUTE == | |
| Ejemplos: | |
| cm shelveset create -c="my comment" | |
| cm shelveset delete sh:3 | |
| cm shelve apply sh:3 | |
| == CMD_DESCRIPTION_SHELVESET_CREATE == | |
| El comando shelve almacena los cambios pendientes. | |
| == CMD_USAGE_SHELVESET_CREATE == | |
| Sintaxis: | |
| cm shelveset create [opciones] [rutas] | |
| rutas: rutas de los items a guardar. | |
| Opciones: | |
| --all (-a): Los ítems cambiados, movidos y borrados localmente, en las | |
| rutas dadas, también serán guardados. | |
| --dependencies: Incluir las dependencias de los cambios locales entre los | |
| ítems a guardar. | |
| -c=comentarios: Añade un comentario al shelve creado en la operación. | |
| --commentsfile=comment.txt: Carga el comentario del fichero especificado. | |
| --summaryformat: El comando imprime sólamente la especificación del | |
| objeto creado en el repositorio principal. | |
| == CMD_HELP_SHELVESET == | |
| Ejemplos: | |
| cm shelveset create -c="my comment" | |
| cm shelveset delete sh:3 | |
| cm shelve apply sh:3 | |
| == CMD_HELP_SHELVESET_CREATE == | |
| El comando shelveset create almacena los ítems en checkout especificados | |
| dentro del repositorio. De este modo el contenido queda almacenado en el | |
| servidor sin necesidad de hacer check in. | |
| Notas: | |
| - Si no se especifican [opciones] ni [rutas], la operación involucrará a | |
| todos los cambios pendientes en el espacio de trabajo. | |
| - La operación de shelve se aplica siempre recursivamente desde la | |
| ruta indicada. | |
| - Requisitos para hacer shelve de un ítem: | |
| * El ítem debe estar controlado por Unity VCS. | |
| * El ítem ha de estar desprotegido. | |
| Ejemplos: | |
| cm shelveset create | |
| cm shelveset fichero1.txt fichero2.txt | |
| Comentarios: | |
| Para especificar comentarios use el switch "-c" o "-m" del siguiente modo: | |
| cm shelveset -c="my comment" | |
| cm shelveset -m "my comment" | |
| Configure la variable de entorno PLASTICEDITOR para especificar un editor | |
| para escribir el comentario. Si la variable de entorno PLASTICEDITOR está | |
| configurada pero no se indica ningún comentario, el editor se abrirá para | |
| que pueda escribir el comentario. | |
| Ejemplo: Shelve 'changelist' | |
| cm status --short --changelist=pending_to_review | cm shelveset - | |
| (El comando listará los paths en el changelist llamado 'pending_to_review' | |
| y dicha lista será redirigida a la entrada del comando 'shelve'). | |
| == CMD_DESCRIPTION_SHELVESET_DELETE == | |
| Borra un shelveset almacenado en el repositorio. | |
| == CMD_USAGE_SHELVESET_DELETE == | |
| Sintaxis: | |
| cm shelveset delete shelve_spec | |
| shelve_spec: Elimina los contenidos almancenados en el repositorio | |
| identificados por "shelve_spec" | |
| == CMD_HELP_SHELVESET_DELETE == | |
| El comando shelveset delete borra un shelveset creado anteriormente. | |
| Ejemplo: | |
| cm shelveset delete sh:3 | |
| (Elimina un shelveset almacenado en el repositorio.) | |
| == CMD_DESCRIPTION_SHELVESET_APPLY == | |
| El comando shelveset apply restaura los contenidos almancenados en el | |
| repositorio. | |
| == CMD_USAGE_SHELVESET_APPLY == | |
| Sintaxis: | |
| cm shelveset apply shelve_spec [<change_path>[ ...]] [opciones] | |
| shelve_spec: Restaura los contenidos almancenados en el repositorio | |
| identificados por "shelve_spec" | |
| change_path: Ruta(s) del cambio(s) a aplicar. Es la ruta de servidor, | |
| una de las que se imprime con la opción --preview. Cuando no se indica | |
| ninguna ruta se aplican todos los cambios del shelve. | |
| Opciones: | |
| --preview: Muestra los cambios a aplicar en el workpsace sin aplicarles | |
| --mount: El punto de montaje del respositorio especificado. | |
| --encoding=codificación: Especifica la codificación de los ficheros de | |
| origen (por ejemplo, UTF-8 o Unicode) | |
| --comparisonmethod=tipo: cualquiera de las siguientes opciones: | |
| ignoreeol: Ignora diferencias de final de línea. | |
| ignorewhitespaces: Ignora diferencias de espacios en blanco. | |
| ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en | |
| blanco. | |
| recognizeall: Detecta diferencias de final de línea y espacios en | |
| blanco. | |
| == CMD_HELP_SHELVESET_APPLY == | |
| El comando shelveset apply restaura los contenidos almancenados en el | |
| repositorio. | |
| Ejemplo: Aplicar un shelve almacenado en el repositorio: | |
| cm shelveset apply sh:3 | |
| Ejemplo: Aplicar solo 1 cambio almacenado en un shelve en el repositorio: | |
| cm shelveset apply sh:3 /src/foo.c | |
| == CMD_DESCRIPTION_SHOW_FIND_OBJECTS == | |
| Muestra la lista de objetos disponibles y sus atributos correspondientes. | |
| == CMD_USAGE_SHOW_FIND_OBJECTS == | |
| Sintaxis: | |
| cm showfindobjects | |
| == CMD_HELP_SHOW_FIND_OBJECTS == | |
| Objetos y atributos disponibles: | |
| attribute: | |
| Se puede buscar atributos filtrando por los siguientes campos: | |
| Type : string. | |
| Value : string. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Comment : string. | |
| SrcObj : object spec. | |
| ID : integer. | |
| attributetype: | |
| Se puede buscar tipos de atributo filtrando por los siguientes campos: | |
| Name : string. | |
| Value : string. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Comment : string. | |
| Source : object spec. | |
| ID : integer. | |
| Campos de replicación. Consulte la sección "campos relacionados con la réplica" | |
| en esta guía para más información sobre: | |
| ReplLogId | |
| ReplSrcDate | |
| ReplSrcId | |
| ReplSrcRepository | |
| ReplSrcServer | |
| branch: | |
| Se puede buscar ramas filtrando por los siguientes campos: | |
| Name : string. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Changesets : fecha (de los changesets en la rama). | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Attribute : string. | |
| AttrValue : string. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| Parent : branch spec. | |
| Comment : string. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Item : item spec or item id (integer). | |
| ID : integer. | |
| Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar | |
| por los siguientes campos: | |
| date | |
| branchname | |
| Campos de replicación. Consulte la sección "campos relacionados con la réplica" | |
| en esta guía para más información sobre: | |
| ReplLogId | |
| ReplSrcDate | |
| ReplSrcId | |
| ReplSrcRepository | |
| ReplSrcServer | |
| changeset: | |
| Se puede buscar changesets filtrando por los siguientes campos: | |
| Branch : branch spec. | |
| ChangesetId : integer. | |
| Attribute : string. | |
| AttrValue : string. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía | |
| para más info. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Comment : string. | |
| OnlyWithRevisions : boolean. | |
| ReturnParent : boolean. | |
| Parent : changeset id (integer). | |
| ID : integer. | |
| Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar | |
| por los siguientes campos: | |
| date | |
| changesetid | |
| Campos de replicación. Consulte la sección "campos relacionados con la réplica" | |
| en esta guía para más información sobre: | |
| ReplLogId | |
| ReplSrcDate | |
| ReplSrcId | |
| ReplSrcRepository | |
| ReplSrcServer | |
| label: | |
| Se puede buscar etiquetas filtrando por los siguientes campos: | |
| Name : string. | |
| Attribute : string. | |
| AttrValue : string. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Branch : branch spec. | |
| Branchid : integer. | |
| Changeset : changeset id (integer). | |
| Comment : string. | |
| ID : integer. | |
| Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar | |
| por los siguientes campos: | |
| date | |
| labelname | |
| Campos de replicación. Consulte la sección "campos relacionados con la réplica" | |
| en esta guía para más información sobre: | |
| ReplLogId | |
| ReplSrcDate | |
| ReplSrcId | |
| ReplSrcRepository | |
| ReplSrcServer | |
| merge: | |
| Se puede buscar merges filtrando por los siguientes campos: | |
| SrcBranch : branch spec. | |
| SrcChangeset : changeset id (integer). | |
| DstBranch : branch spec. | |
| DstChangeset : changeset id (integer). | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para | |
| más info. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Type : string. | |
| Los posibles valores son 'merge', 'cherrypick', | |
| 'cherrypicksubstractive', 'interval', 'intervalcherrypick' | |
| e 'intervalcherrypicksubstractive' | |
| ID : integer. | |
| replicationlog: | |
| Se puede buscar replication log filtrando por los siguientes campos: | |
| Branch : branch spec. | |
| RepositoryName : string. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para | |
| más info. | |
| Server : string. | |
| Package : boolean. | |
| ID : integer. | |
| review: | |
| Se puede buscar code reviews filtrando por los siguientes campos: | |
| Status : string. | |
| Assignee : string. | |
| Title : string. | |
| Target : object spec. | |
| TargetId : integer. | |
| TargetType : string. | |
| Los posibles valores son 'branch' y 'changeset'. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Id : integer. | |
| Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar | |
| por los siguientes campos: | |
| date | |
| modifieddate | |
| status | |
| revision: | |
| Se puede buscar revisiones filtrando por los siguientes campos: | |
| Branch : branch spec. | |
| Changeset : changeset id (integer). | |
| Item : string o integer. | |
| ItemId : integer. | |
| Attribute : string. | |
| AttrValue : string. | |
| Archived : boolean. | |
| Comment : string. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía | |
| para más info. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| Parent : revision id (integer). | |
| ReturnParent : boolean. | |
| Shelve : shelve id (integer). | |
| Size : integer (en bytes). | |
| Type : string. | |
| Los posibles valores son 'dir', 'bin' y 'txt'. | |
| WorkspaceCheckoutId : integer. | |
| ID : integer. | |
| Campos de replicación. Consulte la sección "campos relacionados con la réplica" | |
| en esta guía para más información sobre: | |
| ReplLogId | |
| ReplSrcDate | |
| ReplSrcId | |
| ReplSrcRepository | |
| ReplSrcServer | |
| shelve: | |
| Se puede buscar shelves filtrando por los siguientes campos: | |
| Owner : usuario. | |
| Admite el usuario especial 'me'. | |
| Date : fecha. | |
| Consulte la sección "constantes de fecha" en esta guía para más | |
| info. | |
| Attribute : string. | |
| AttrValue : string. | |
| Comment : string. | |
| GUID : Identificador Global Único. | |
| Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | |
| Parent : integer. | |
| ShelveId : integer. | |
| ID : integer. | |
| Campos de replicación. Consulte la sección "campos relacionados con la réplica" | |
| en esta guía para más información sobre: | |
| ReplLogId | |
| ReplSrcDate | |
| ReplSrcId | |
| ReplSrcRepository | |
| ReplSrcServer | |
| Campos relacionados con la réplica: | |
| Muchos objetos mantienen información de replicación, lo que significa que | |
| Unity VCS mantiene el rastro de dónde se crearon originalmente. | |
| Los campos que se pueden utilizar son: | |
| ReplSrcServer : Significa "servidor origen de la réplica", y es el | |
| servidor de donde se trajeron los objetos. | |
| Ejemplo: | |
| cm find branch "where replsrcserver='skull.codicefactory.com:9095'" | |
| ReplSrcRepository : string. Significa "repositorio origen de la réplica", | |
| y es el repositorio de donde se trajeron los objetos. | |
| Ejemplo: | |
| cm find branch "where \ | |
| replsrcserver = 'skull.codicefactory.com:9095' \ | |
| and replsrcrepository = 'codice'" | |
| ReplLogId : integer. El identificador de la operación de réplica. | |
| En Unity VCS, cada vez que un objeto nuevo se crea de una | |
| réplica, también se crea un nuevo 'replicationlog'. | |
| Ejemplo: | |
| cm find replicationlog | |
| 324054 9/13/2018 02:00:15 /main/scm23064 sluisp plasticscm.com T | |
| 327255 9/11/2018 12:33:38 /main/scm23042 maria plasticscm.com T | |
| 329631 9/17/2018 13:06:49 /main/scm23099 sluisp plasticscm.com T | |
| Ahora se pueden buscar las ramas creadas en la réplica 327255, en | |
| caso de haber alguna: | |
| cm find branch "where replogid=327255" | |
| ReplSrcDate: fecha. Es la fecha en la que la operación de réplica tuvo | |
| lugar. Los objetos replicados mantienen la fecha en la que | |
| fueron creados originalmente, por lo que este campo es útil | |
| si se necesita buscar objetos que fueron replicados en un | |
| determinado marco temporal. | |
| Ejemplo: | |
| cm find replicationlog "where date > 'one week ago'" | |
| 8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc | |
| Ahora se puede verificar que la rama replicada se creó antes de la | |
| propia operación de réplica: | |
| cm find branch "where repllogid = 8780433" | |
| 8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T | |
| ReplSrcId: integer. Es el ID del servidor origen de la réplica | |
| (ReplSrcServer). Este ID se puede descubrir buscando objetos | |
| de tipo 'replicationsource' con el comando 'cm find'. | |
| Ejemplo: | |
| cm find replicationsource | |
| 7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27 | |
| 8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9 | |
| Ahora se pueden buscar los changesets replicados desde | |
| codice@AFRODITA:8087 de la siguiente forma: | |
| cm find changesets "where replsrcid = 7860739" | |
| Constantes de fecha: | |
| Se pueden usar fechas formateadas siguiendo la configuración de localización | |
| del Sistema Operativo. Por ejemplo, si el SO muestra fechas en el formato | |
| 'dd/MM/yyyy', se pueden utilizar fechas como '31/12/2018' en las consultas. | |
| Sin embargo, también se pueden utilizar las siguientes constantes para | |
| facilitar la escritura de las queries: | |
| 'today' : la fecha de hoy. | |
| 'yesterday' : la fecha de ayer. | |
| 'this week' : la fecha del lunes de la semana actual. | |
| 'this month' : la fecha del primer día del mes actual. | |
| 'this year' : la fecha del 1 de enero del año actual. | |
| 'one day ago' : un día antes de la fecha actual. | |
| 'one week ago' : una semana antes de la fecha actual. | |
| 'one month ago' : un mes antes de la fecha actual. | |
| 'n days ago' : 'n' días antes de la fecha actual. | |
| 'n months ago' : 'n' meses antes de la fecha actual. | |
| 'n years ago' : 'n' años antes de la fecha actual. | |
| Las siguientes cláusulas 'where' son válidas para campos que admitan fechas: | |
| '(...) where date > 'today' (...)' | |
| '(...) where date < 'yesterday' (...)' | |
| '(...) where date > 'this week' (...)' | |
| '(...) where date > 'this month' (...)' | |
| '(...) where date < 'one day ago' and date > '3 days ago' (...)' | |
| '(...) where date < 'one week ago' and date > '3 weeks ago' (...)' | |
| '(...) where date < 'one month ago' and date > '3 months ago' (...)' | |
| '(...) where date > '1 year ago' (...)' | |
| También se puede forzar un determinado formato de fecha en el comando | |
| 'cm find' utilizando el flag --dateformat. Lee 'cm find --help' para más | |
| información. | |
| == CMD_DESCRIPTION_TRIGGER_SHOWTYPES == | |
| Muestra la lista de los tipos de triggers disponibles. | |
| == CMD_USAGE_TRIGGER_SHOWTYPES == | |
| Sintaxis: | |
| cm trigger showtypes | |
| == CMD_DESCRIPTION_SHOWACL == | |
| Muestra la ACL (Lista de Control de Acceso) de un elemento. | |
| == CMD_USAGE_SHOWACL == | |
| Sintaxis: | |
| cm showacl [opciones] spec_objeto | |
| spec_objeto Especificación del objeto sobre el que mostrar el ACL. | |
| Objetos válidos para este comando son repserver, | |
| repositorio, rama, changeset, etiqueta, item y atributo. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de objetos. | |
| Opciones: | |
| --extended Muestra información detallada. | |
| --xml Permite volcar la salida del comando en formato xml | |
| a la salida estándar. También se permite especificar | |
| un fichero de salida (--xml=output.xml). | |
| --encoding Si se utiliza con la opción --xml, permite especificar | |
| el encoding con el que se guardará la salida del | |
| comando. Por ejemplo: --encoding=utf-8 | |
| Consulte la documentación de la MSDN para obtener la | |
| tabla completa de codificaciones soportadas y su formato; | |
| al final de la página en la columna "Name": | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| == CMD_HELP_SHOWACL == | |
| Notas: | |
| Este comando se utiliza para obtener una lista de permisos de un usuario o | |
| un grupo sobre un elemento del repositorio. | |
| Ejemplos: | |
| cm showacl repserver:PlasticServer:8084 | |
| cm showacl br:/main --extended | |
| == CMD_DESCRIPTION_SHOWCOMMANDS == | |
| Muestra todos los comandos disponibles. | |
| == CMD_USAGE_SHOWCOMMANDS == | |
| Sintaxis: | |
| cm showcommands | |
| == CMD_HELP_SHOWCOMMANDS == | |
| == CMD_DESCRIPTION_SHOWOWNER == | |
| Muestra el propietario de un elemento del repositorio. | |
| == CMD_USAGE_SHOWOWNER == | |
| Sintaxis: | |
| cm showowner spec_objeto | |
| spec_objeto Especificación del objeto para mostar su propietario. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de objetos. | |
| El objeto debe ser uno de los siguientes: repserver, | |
| repositorio, rama, changeset, etiqueta, atributo, | |
| revisión e item. | |
| == CMD_HELP_SHOWOWNER == | |
| Notas: | |
| Este comando muestra el propietario de un elemento del repositorio. | |
| Puede ser un usuario o un grupo. | |
| El propietario se puede modificar con el comando 'cm setowner'. | |
| Ejemplos: | |
| cm showowner repserver:PlasticServer:8084 | |
| cm showowner rev:fichero.cs#br:/main#LAST | |
| == CMD_DESCRIPTION_SHOWPERMISSIONS == | |
| Muestra la lista de los permisos disponibles. | |
| == CMD_USAGE_SHOWPERMISSIONS == | |
| Sintaxis: | |
| cm showpermissions | |
| == CMD_HELP_SHOWPERMISSIONS == | |
| Ejemplos: | |
| cm showpermissions | |
| == CMD_DESCRIPTION_SHOWSELECTOR == | |
| Muestra el selector del espacio de trabajo actual. | |
| == CMD_USAGE_SHOWSELECTOR == | |
| Sintaxis: | |
| cm showselector [wk_ruta | wk_spec] | |
| wk_ruta Ruta del espacio de trabajo para mostrar su selector | |
| wk_spec Especificación del espacio de trabajo para mostrar su | |
| selector. | |
| Usa 'cm help objectspec' para obtener más información sobre | |
| especificaciones de espacios de trabajo. | |
| == CMD_HELP_SHOWSELECTOR == | |
| Notas: | |
| Si no se especifica una ruta o un especificador de espacio de trabajo, | |
| el comando tomará como ruta el directorio actual. | |
| Ejemplos: | |
| cm showselector c:\workspace | |
| cm showselector | |
| cm showselector > miSelector.txt | |
| cm showselector wk:build_wk@BUILDER | |
| == CMD_DESCRIPTION_SUPPORT == | |
| Este comando permite al usuario efectuar operaciones de soporte. | |
| == CMD_USAGE_SUPPORT == | |
| Sintaxis: | |
| cm support comando [opciones] | |
| Comandos: | |
| bundle | |
| Para obtener más información sobre cada uno de los comandos ejecute: | |
| cm support comando --usage | |
| cm support comando --help | |
| == CMD_HELP_SUPPORT == | |
| Ejemplos: | |
| cm support | |
| cm support bundle | |
| cm support bundle c:\outputfile.zip | |
| == CMD_DESCRIPTION_SUPPORT_BUNDLE == | |
| Crea el paquete de soporte con los ficheros de log relevantes. | |
| Este paquete se puede adjuntar cuando se solicita la ayuda, cuando | |
| se pregunte por información extra o cuando se envíe un error. | |
| == CMD_USAGE_SUPPORT_BUNDLE == | |
| Sintaxis: | |
| cm support bundle [outputfile] | |
| Opciones: | |
| outputfile Crea el paquete de soporte en la ruta especificado. | |
| == CMD_HELP_SUPPORT_BUNDLE == | |
| Notas: | |
| Este comando permite al usuario crear un paquete de soporte con los | |
| ficheros de log relevantes. Es posible especificar un fichero de salida. | |
| Ejemplos: | |
| cm support bundle | |
| (Crea el paquete de soporte en el directorio temporal) | |
| cm support bundle c:\outputfile.zip | |
| (Crea el paquete de soporte en la ruta especificado) | |
| == CMD_DESCRIPTION_SWITCH == | |
| Actualiza el espacio de trabajo a la rama, etiqueta, changeset o shelve especificado. | |
| == CMD_USAGE_SWITCH == | |
| Sintaxis: | |
| cm switch brspec | csetspec | lbspec | shspec | |
| [--workspace=path] [--repository=name] | |
| [--forcedetailedprogress] [--noinput] | |
| [--silent] [--verbose] [--xml[=<output_file>]] [--encoding=<name>] | |
| Opciones: | |
| --workspace Ruta del espacio de trabajo a cambiar. | |
| --repository Repositorio al que se va a cambiar. | |
| --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se | |
| redirige la salida estándar. | |
| --noinput Ignora las preguntas interactivas para continuar la | |
| operación con cambios pendientes o haciendolos shelve. | |
| --silent Solo se imprimen mensajes en caso de error. | |
| --verbose Muestra información adicional. | |
| --xml Imprime el resultado en formato XML a la salida | |
| estándar. También es posible especificar un fichero | |
| de salida. | |
| --encoding Usado con la opción --xml, especifica el encoding | |
| que se usará en la salida XML, por ejemplo, utf-8. | |
| Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| Usa 'cm help objectspec' para aprender más sobre cómo indicar | |
| especificaciones de changesets, ramas y etiquetas. | |
| == CMD_HELP_SWITCH == | |
| Notas: | |
| Este comando permite a los usuarios actualizar el espacio de trabajo | |
| con el contenido del objeto especificado (rama, etiqueta o changeset). | |
| Ejemplos: | |
| cm switch br:/main | |
| cm switch lb:Rel1.1 | |
| cm switch Rel2.0 | |
| cm switch cs:4375 | |
| cm switch 5632 | |
| cm switch sh:2 | |
| == CMD_DESCRIPTION_SWITCH_TO_BRANCH == | |
| Establece la rama especificada como rama de trabajo. | |
| == CMD_USAGE_SWITCH_TO_BRANCH == | |
| Sintaxis: | |
| cm switchtobranch [opciones] [spec_rama] | |
| spec_rama: Especificación de rama. | |
| Opciones: | |
| --label=nombre | --changeset=número: Carga las revisiones de la etiqueta | |
| o changeset especificado. Si no se especifica spec_rama, una de | |
| estas opciones es obligatoria. | |
| --workspace | -wk=path: Ruta del espacio de trabajo a cambiar. | |
| == CMD_HELP_SWITCH_TO_BRANCH == | |
| Notas: | |
| Este comando permite a los usuarios especificar una rama, como rama de | |
| trabajo. Adicionalmente se puede especificar una etiqueta o un changeset, | |
| desde la cual se cargarán las revisiones. | |
| Si no se especifica rama, se ha de especificar una etiqueta o un changeset | |
| obligatoriamente. Consulte el manual para obtener más información. | |
| Si no se especifica repositorio, la rama se fija sobre el repositorio | |
| actual. | |
| Ejemplos: | |
| cm switchtobranch br:/main | |
| cm switchtobranch br:/main/tarea001 | |
| cm switchtobranch --label=BL050 | |
| (Configuración de sólo lectura. Se cargan revisiones del changeset etiquetado) | |
| == CMD_DESCRIPTION_SYNC == | |
| Sincroniza con Git | |
| == CMD_USAGE_SYNC == | |
| Sintaxis: | |
| cm synchronize | sync repspec git [url [--user=usr_name --pwd=pwd]] [--author] | |
| [[--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent]=value] | |
| [--skipgitlfs] [--gitpushchunk=<value>] | |
| repspec Especificación del repositorio. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de repositorios. | |
| git (Default). | |
| Opciones: | |
| url URL del repositorio remoto | |
| (http(s):// o git:// o una URL ssh). | |
| --user Nombre de usuario para la URL especificada. | |
| --pwd Contraseña para la URL especificada. | |
| --txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent | |
| Opciones para detectar ítems movidos, del mismo modo que | |
| lo hace la GUI de Unity VCS. | |
| --author Usa los valores de nombre y fecha (timestamp) del autor | |
| en git (git committer by default). | |
| --skipgitlfs Ignora la configuración de Git LFS que haya en el | |
| fichero '.gitattributes'. Se comporta como si no | |
| tuviese soporte de Git LFS. | |
| --gitpushchunk Procesa la operación de push (exportar cambios de | |
| Unity VCS a Git) en bloques de un determinado número | |
| de changesets. Esta opción solo es útil en | |
| repositorios muy grandes para evitar problemas con | |
| la red o con el tamaño del paquete a enviar a Git o | |
| simplemente con el fin de depurar otros problemas. | |
| Usa bloques de 1000 changesets si no se especifica | |
| un valor concreto. | |
| == CMD_HELP_SYNC == | |
| Notas: | |
| En caso de sincronizar con un servidor que no requiera credenciales, tras | |
| la primera sincronización no es necesario introducir el parámetro URL. | |
| Este comando no soporta repositorios locales. | |
| En el caso de usar el protocolo SSH, es necesario tener añadido al PATH | |
| el cliente por línea de comandos 'ssh' y que esté correctamente configurado | |
| para conectarse al servidor remoto (claves públicas/privadas). | |
| Ejemplos: | |
| cm sync default@localhost:8087 git git://localhost/repository | |
| == CMD_DESCRIPTION_TRIGGER == | |
| Use este comando para administrar triggers. | |
| == CMD_USAGE_TRIGGER == | |
| Sintaxis: | |
| cm trigger | tr <command> [options] | |
| Comandos: | |
| create | mk | |
| delete | rm | |
| edit | |
| list | ls | |
| showtypes | |
| Para obtener más información sobre cada comando: | |
| cm trigger <command> --usage | |
| cm trigger <command> --help | |
| == CMD_HELP_TRIGGER == | |
| Ejemplos: | |
| cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084 | |
| cm tr edit before-mklabel 7 --position=4 --server=myserver:8084 | |
| cm tr ls before-mkbranch --server=myserver:8084 | |
| cm tr rm after-setselector 4 | |
| cm tr showtypes | |
| == CMD_DESCRIPTION_TUBE == | |
| Ejecuta comandos relacionados con Plastic Tube. | |
| == CMD_USAGE_TUBE == | |
| Sintaxis: | |
| cm tube config -u=user -p=password | |
| cm tube create remoteuser | |
| cm tube remove remoteuser | |
| cm tube local | |
| cm tube remote | |
| cm tube share <repository_spec>+ -u=remoteuser -a=access_mode | |
| cm tube unshare <repository_spec>+ -u=remoteuser | |
| cm tube connect | |
| cm tube disconnect | |
| cm tube status | |
| Opciones: | |
| -u Usuario de Tube (el usuario de plasticscm.com) | |
| -p Password del usuario | |
| -a Acceso: pull, push o ambos (pull | push | pull,push) | |
| rep_spec Especificación del repositorio. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de repositorios. | |
| == CMD_HELP_TUBE == | |
| Notas: | |
| config | |
| Configura Unity VCS para usar Plastic Tube con el usuario y password | |
| especificados. | |
| create | |
| Crea el Tube remoteuser -> myuser. | |
| El usuario 'myuser' permite a 'remoteuser' conectarse al servidor | |
| de 'myuser'. | |
| Pueden establecerse conexiones de 'remoteuser' a 'myuser'. | |
| Sólo pueden crearse un Tube de otro usuario al usuario actual de | |
| Plastic Tube. | |
| remove | |
| Elimina el Tube remoteuser -> myuser. | |
| local | |
| Lista los repositorios locales compartidos en el servidor local y los | |
| usuarios con quien son compartidos. | |
| remote | |
| Lista los repositorios remotamente compartidos que son compartidos con | |
| el usuario actual de Plastic Tube. | |
| share | |
| Comparte el repositorio(s) local con el usuario y remoto y los permisos | |
| especificados. | |
| unshare | |
| Deja de compartir el repositorio local con el usuario remoto. | |
| connect | |
| Conecta el servidor de Unity VCS a Plastic Tube. | |
| disconnect | |
| Desconecta el servidor de Unity VCS de Plastic Tube. | |
| status | |
| Muestra si el servidor de Unity VCS está conectado a Plastic Tube. | |
| Ejemplos: | |
| cm tube config -u=ruben@codicesoftware.com -p=rubenpassword | |
| cm tube create pablo@codicesoftware.com | |
| ('pablo@codicesoftware.com' puede conectar con el usuario actual del Tube) | |
| cm tube remove pablo@codicesoftware.com | |
| cm tube local | |
| cm tube remote | |
| cm tube share repo@server:8087 -u=pablo@codicesoftware.com -a=pull,push | |
| cm tube share repo@server:8087 doc@server:8087 -u=pablo@codicesoftware.com -a=push | |
| cm tube unshare repo@server:8087 -u=pablo@codicesoftware.com | |
| cm tube connect | |
| cm tube disconnect | |
| cm tube status | |
| == CMD_DESCRIPTION_UNCO == | |
| Deshace la desprotección de un ítem. | |
| == CMD_USAGE_UNCO == | |
| Sintaxis: | |
| cm undocheckout | unco <item_path>+ [--all] [--symlink] [--silent] | |
| [--keepchanges | -k] | |
| item_path Especificación de los ítems para deshacer la desprotección, | |
| separados por comas. | |
| Se pueden usar comillas (") para especificar rutas que | |
| contengan espacios. | |
| Use . para aplicar la operación al directorio actual. | |
| Opciones: | |
| --all (-a) Los ítems especificados que han sido cambiados, movidos | |
| y borrados localmente también serán deshechos. | |
| --symlink Deshace la protección del fichero de link y no al | |
| elemento al que apunta. | |
| --silent No muestra salida. | |
| --keepchanges (-k) Deshace la desprotección dejando los cambios locales. | |
| Ejemplo: un checkout lo deja como changed con el | |
| contenido en disco que tenia antes de hacer el unco. | |
| Esta opción no puede utilizarse con workspaces dinámicos. | |
| == CMD_HELP_UNCO == | |
| Notas: | |
| Si se desean descartar los cambios realizados en un ítem desprotegido | |
| previamente, se utiliza este comando. | |
| El ítem se cambia a la revisión justamente anterior. | |
| Requisitos para deshacer la desprotección: | |
| El ítem ha de estar controlado por Unity VCS | |
| El ítem ha de estar desprotegido | |
| Ejemplos: | |
| cm undocheckout . | |
| (Desprotege el directorio actual) | |
| cm undocheckout fichero1.txt fichero2.txt | |
| cm unco c:\workspace\fichero.txt | |
| cm undocheckout -R c:\workspace\src | |
| (Deshace la desprotección de 'src' recursivamente) | |
| cm unco link --symlink | |
| (Efectúa la desprotección sobre el fichero de symlink y no del que apunta.) | |
| cm unco code\cgame\cg_main.c --all | |
| (Deshace la desprotección del fichero cambiado) | |
| Deshacer 'changelist'. Ejemplo: | |
| cm status --short --changelist=pending_to_review | cm undocheckout - | |
| (El comando listará los paths en el changelist llamado 'pending_to_review' | |
| y dicha lista será redirigida a la entrada del comando 'uncheckout'). | |
| == CMD_DESCRIPTION_UNCOUNCHANGED == | |
| Deshace la desprotección en elementos que no han cambiado. | |
| == CMD_USAGE_UNCOUNCHANGED == | |
| Sintaxis: | |
| cm uncounchanged [opciones] | |
| Opciones: | |
| -R|-r|--recursive Descender recursivamente dentro de directorios. | |
| == CMD_HELP_UNCOUNCHANGED == | |
| Notas: | |
| Este comando se aplica desde la raíz del workspace recursivamente. | |
| Ejemplos: | |
| cm uncounchanged | |
| == CMD_DESCRIPTION_UNDELETE == | |
| Recupera en el espacio de trabajo la revisión especificada en la ruta dada. | |
| == CMD_USAGE_UNDELETE == | |
| Sintaxis: | |
| cm undelete rev_spec ruta | |
| rev_spec: Especificación de la revisión del ítem cuyo contenido se desea | |
| cargar en el espacio de trabajo. | |
| path: Ruta donde se va a restaurar. | |
| == CMD_HELP_UNDELETE == | |
| Notas: | |
| El elemento a recuperar no debe de estar ya cargado en el workspace. | |
| La operación de recuperar no esta soportada para xlinks. | |
| Ejemplos: | |
| cm undelete revid:756 C:\mywks\src\foo.c | |
| cm undelete itemid:68#cs:2 C:\mywks\dir\myfile.pdf | |
| cm undelete serverpath:/src#br:/main C:\mywks\Dir | |
| == CMD_DESCRIPTION_UNDOCHANGE == | |
| Deshace los cambios hechos en un fichero. | |
| == CMD_USAGE_UNDOCHANGE == | |
| Notas: | |
| Si se desean descartar los cambios en un ítem, independientemente de su | |
| estado (desprotegido o modificado sin hacer desprotección), este comando | |
| vuelve a la revisión anterior. Si se ordena realizar la operación sobre | |
| un directorio en vez de un fichero la acción se realiza recursivamente por | |
| defecto. | |
| Ejemplos: | |
| cm unc . (Descarta los cambios de los ítems del directorio actual). | |
| cm unc fichero1.txt fichero2.txt | |
| cm unc c:\workspace\fichero1.txt | |
| == CMD_HELP_UNDOCHANGE == | |
| Ejemplos: | |
| cm unc . (Descarta los cambios de los ítems del directorio actual). | |
| cm unc fichero1.txt fichero2.txt | |
| cm unc c:\workspace\fichero1.txt | |
| == CMD_DESCRIPTION_UNDO == | |
| Deshace cambios en un workspace. | |
| == CMD_USAGE_UNDO == | |
| Syntaxis: | |
| cm undo [<path>[ ...]] [--symlink] [-r | --recursive] [<filter>[ ...]] | |
| [--silent | --machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| path Rutas de los ficheros o directorios sobre los que deshacer los | |
| cambios. Use comillas dobles (" ") para especificar rutas que | |
| contengan espacios. Use un espacio en blanco para separar rutas | |
| de ítems. | |
| Si no se especifica ninguna ruta, la operación se ejecutará | |
| sobre los ficheros del directorio actual. | |
| filter Aplica el filtro o filtros indicados a las rutas especificadas. | |
| Use un espacio en blanco para separar filtros. Consulte la | |
| sección Filtros para más información. | |
| Opciones: | |
| --symlink Deshace los cambios en el symlink pero no en el | |
| destino (target). | |
| -r Deshace los cambios recursivamente. | |
| --silent No muestra ninguna salida. | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| Filtros: | |
| Las rutas se pueden filtrar usando uno o varios de los filtros a continuación. | |
| Cada uno de estos filtros se refiere a un tipo de cambio: | |
| --checkedout Selecciona ficheros y directorios desprotegidos (checked-out). | |
| --unchanged Selecciona ficheros sin cambios. | |
| --changed Selecciona ficheros y directorios cambiados o desprotegidos | |
| (checked-out). | |
| --deleted Selecciona ficheros y directorios borrados. | |
| --moved Selecciona ficheros y directorios movidos. | |
| --added Selecciona ficheros y directorios añadidos. | |
| Si la ruta contiene alguno de los tipos de cambios especificados en los | |
| filtros, entonces solo esos tipos de cambios se desharán en dicha ruta. | |
| Por ejemplo, si se especifica a la vez --checkedout y --moved, si un fichero | |
| está tanto movido como checkedout, ambos tipos de cambios se desharán. | |
| Si no se especifica ningun filtro, se deshacen todos los tipos de cambios. | |
| == CMD_HELP_UNDO == | |
| Notas: | |
| - Si no se especifica ninguna ruta, se deshacen todos los cambios en el | |
| directorio actual pero no recursivamente. | |
| - Si se especifica una o más rutas, se deshacen todos los cambios en las | |
| rutas especificadas pero no recursivamente. | |
| - Para hacer que el undo sea recursivo hay que especificar la opción -r. | |
| Así para deshacer todos los cambios de un directorio incluyendo los cambios | |
| sobre el propio directorio habría que ejecutar lo siguiente: | |
| cm undo dirpath -r | |
| Si dirpath es la ruta de un workspace, entonces se deshacen todos los | |
| cambios dentro del workspace. | |
| - El comando undo es peligroso porque deshace los cambios irreversiblemente. | |
| Es decir, no hay manera posible de recuperar el estado anterior de los | |
| ficheros y directorios afectados. | |
| - En el siguiente escenario: | |
| /src | |
| |- file.txt | |
| |- code.cs | |
| \- /test | |
| |- test_a.py | |
| \- test_b.py | |
| Estos comandos son equivalentes (ejecutados desde el directorio /src): | |
| cm undo | |
| cm undo * | |
| cm undo file.txt code.cs /test | |
| Y estos también son equivalentes (también ejecutados desde /src): | |
| cm undo . | |
| cm undo /src file.txt code.cs | |
| Ficheros borrados: | |
| Para deshacer borrados de fichero o directorios hay que especificar la | |
| ruta completa del fichero o directorio, o el directorio padre más la opción | |
| -r (recursivo). | |
| Por ejemplo: | |
| cm undo . | |
| (NO deshace los borrados (solo otros cambios) en el directorio actual.) | |
| cm undo . -r | |
| (Deshace todos los borrados (y otros cambios) recursivamente del directorio | |
| actual.) | |
| cm undo src/file.txt | |
| (Deshace el borrado (u otro cambio) del fichero src/file.txt.) | |
| Ejemplos: | |
| cm undo . -r | |
| (Deshace recursivamente todos los cambios en el directorio actual. Si | |
| se ejecuta desde la raíz del workspace, deshace todos los cambios en el | |
| workspace completo.) | |
| cm co file.txt | |
| cm undo file.txt | |
| (Deshace el checkout en file.txt.) | |
| cm undo c:\otroworkspace\file.txt | |
| (Deshace los cambios en 'file.txt' que se encuentra en un workspace distinto | |
| del que se está trabajando.) | |
| echo content >> file.txt | |
| cm undo file.txt | |
| (Deshace el cambio local en file.txt.) | |
| cm undo src | |
| (Deshace los cambios en el directorio src y en todos los ficheros | |
| controlados que contenga) | |
| cm undo src/* | |
| (Deshace los cambios en todos ficheros y directorios en src sin afectar | |
| al propio directorio.) | |
| cm undo *.cs | |
| (Deshace cambios en cada fichero y directorio que cumpla el patrón *.cs en | |
| el directorio actual.) | |
| cm undo *.cs -r | |
| (Deshace recursivamente cambios en cada fichero y directorio que cumpla el | |
| patrón *.cs en el directorio actual y en cada directorio por debajo.) | |
| cm co file1.txt file2.txt | |
| echo content >> file1.txt | |
| cm undo --unchanged | |
| (Deshace el checkout en file2.txt y no en file1.txt ya que file1.txt sí | |
| tiene cambios locales.) | |
| echo content >> file1.txt | |
| echo content >> file2.txt | |
| cm co file1.txt | |
| cm undo --checkedout | |
| (Deshace el cambio en el fichero desprotegido (checked-out) file1.txt e | |
| ignora file2.txt ya que no está en checked-out.) | |
| cm add file.txt | |
| cm undo file.txt | |
| (Deshace el añadido de file.txt dejándolo de nuevo como privado.) | |
| $ rm file1.txt | |
| $ echo content >> file2.txt | |
| $ cm add file3.txt | |
| $ cm undo --deleted --added * | |
| (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando | |
| el cambio en file2.txt.) | |
| == CMD_DESCRIPTION_LOCK_UNLOCK == | |
| Deshace los bloqueos en los elementos de un servidor. | |
| == CMD_USAGE_LOCK_UNLOCK == | |
| Sintaxis: | |
| cm lock unlock [<repserverspec>] <guid>[ ...] | |
| repserverspec Especificación del servidor de repositorio. | |
| (Use 'cm help objectspec' para más información sobre las | |
| especificaciones de servidores de repositorio.) | |
| guid Lista de GUIDs de ítems a desbloquear. Use un | |
| espacio en blanco para separar GUIDs. | |
| == CMD_HELP_LOCK_UNLOCK == | |
| Notas: | |
| - El comando usa el servidor especificado para desbloquear los ítems. | |
| - Si no se especifica ningún servidor, el comando intentará obtener un | |
| servidor del espacio de trabajo actual. | |
| - Si con los pasos anteriores no se pudo obtener ningún servidor, el comando | |
| utilizará el servidor de la configuración actual del cliente de Unity VCS. | |
| - Únicamente el administrador del servidor puede ejecutar el comando 'cm unlock'. | |
| - Para especificar un GUID, indique los 32 dígitos separados por guiones con | |
| el siguiente formato (y, opcionalmente, incluidos entre llaves): | |
| {00000000-0000-0000-0000-000000000000} | |
| o | |
| 00000000-0000-0000-0000-000000000000 | |
| Ejemplos: | |
| cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5 | |
| (Deshace el bloqueo del ítem indicado.) | |
| cm lock unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \ | |
| bcb98a61-2f62-4309-9a26-e21a2685e075 | |
| (Deshace los bloqueos de los ítems indicados del servidor 'DIGITALIS'.) | |
| cm lock unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \ | |
| 71263c17-5eaf-5271-4d2c-a25f72e101d4 | |
| (Deshace los bloqueos de los ítems indicados del servidor cloud 'tardis'.) | |
| == CMD_DESCRIPTION_UPDATE == | |
| Actualiza el espacio de trabajo. | |
| == CMD_USAGE_UPDATE == | |
| Sintaxis: | |
| cm update [<ruta> | --last] | |
| [--changeset=csetspec] [--cloaked] [--dontmerge] [--forced] | |
| [--ignorechanges] [--override] [--recursewk] [--skipchangedcheck] | |
| [--silent] [--verbose] [--xml[=output_file]] [--encoding=name] | |
| [--machinereadable [--startlineseparator=<sep>] | |
| [--endlineseparator=<sep>] [--fieldseparator=<sep>]] | |
| [--forcedetailedprogress] [--noinput] | |
| ruta Ruta a actualizar. | |
| Use . para aplicar la actualización al directorio actual. | |
| Si no se especifica ninguna ruta, se actualiza todo | |
| el workspace. | |
| --last Antes de la actualización, cambia el selector del | |
| espacio de trabajo (workspace) desde una configuración | |
| de changeset o de etiqueta a una configuración de | |
| rama. | |
| El selector se cambia a la rama a la que pertenece el | |
| changeset o la etiqueta. | |
| Opciones: | |
| --changeset Actualiza el espacio de trabajo a un changeset concreto. | |
| (Use 'cm help objectspec' para obtener más información | |
| sobre la especificación de changesets.) | |
| --cloaked Incluye los ítems cloaked en la operación de update. | |
| Si no se utiliza esta opción, se ignorarán durante | |
| la actualización todos los ítems cloaked. | |
| --dontmerge El update merge no se llevará cabo en el caso en que | |
| se requiera esa operación. | |
| --forced Fuerza la actualización de todos los ítems a aquella | |
| revisión especificada en el selector. | |
| --ignorechanges Si existen cambios pendientes durante la actualización | |
| del espacio de trabajo, se ignorarán y se continuará | |
| con la actualización. | |
| --noinput Ignora las preguntas interactivas para continuar la | |
| operación con cambios pendientes o haciendolos shelve. | |
| --override Ignoran los ficheros cambiados fuera del control de | |
| Unity VCS. Su contenido se sobrescribirá con el | |
| contenido del servidor. | |
| --recursewk Actualiza todos los espacios de trabajo de la ruta | |
| actual. Esto es útil para actualizar todos los | |
| espacios de trabajo contenidos en la ruta indicada. | |
| --skipchangedcheck Comprueba si hay cambios locales en el workspace | |
| antes de actualizar. Esta opción es útil para | |
| acelerar la actualización cuando siempre se | |
| desprotegen (checkout) ficheros antes de | |
| modificarlos. | |
| --silent Solo se imprimen mensajes en caso de error. | |
| --verbose Muestra información adicional. | |
| --xml Imprime el resultado en formato XML a la salida | |
| estándar. También es posible especificar un fichero | |
| de salida. | |
| --encoding Usado con la opción --xml, especifica el encoding | |
| que se usará en la salida XML, por ejemplo, utf-8. | |
| Consulte la documentación de MSDN en | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| para obtener la tabla de codificaciones soportadas y | |
| su formato (al final de la página en la columna "Name"). | |
| --machinereadable Muestra el resultado en un formato fácil de parsear. | |
| --startlineseparator Usado con '--machinereadable', indica cómo deben | |
| empezar las líneas del resultado. | |
| --endlineseparator Usado con '--machinereadable', indica cómo deben | |
| terminar las líneas del resultado. | |
| --fieldseparator Usado con '--machinereadable', indica cómo deben | |
| separarse los campos de cada línea resultante. | |
| --forcedetailedprogress Fuerza mostrar el progreso detallado incluso cuando | |
| se redirige la salida estándar. | |
| == CMD_HELP_UPDATE == | |
| Notas: | |
| El comando 'update' solo descarga los ficheros necesarios. | |
| El comando asume recursividad. | |
| Cuando se especifica la opción --last, no es necesario especificar una ruta. | |
| En ese caso, el espacio de trabajo del directorio actual se actualizará. | |
| (Especificar la opción --last puede hacer que el selector del espacio de | |
| trabajo cambie a un configuración de rama si previamente apuntaba a un | |
| changeset o una etiqueta.) | |
| Ejemplos: | |
| cm update | |
| (Actualiza el espacio de trabajo actual.) | |
| cm update . | |
| (Actualiza recursivamente el contenido del directorio actual.) | |
| cm update . --forced --verbose | |
| (Fuerza la actualización de todas las revisiones y muestra información | |
| adicional.) | |
| cm update --last | |
| cm update . --machinereadable --startlineseparator=">" | |
| (Actualiza recursivamente el directorio actual y muestra por pantalla el | |
| resultado en un formato simple y fácil de parsear, comenzando cada línea con | |
| el separador indicado.) | |
| == CMD_DESCRIPTION_VERSION == | |
| Muestra el número de versión del cliente. | |
| == CMD_USAGE_VERSION == | |
| Sintaxis: | |
| cm version | |
| == CMD_HELP_VERSION == | |
| == CMD_DESCRIPTION_WHOAMI == | |
| Muestra el usuario actual de Unity VCS. | |
| == CMD_USAGE_WHOAMI == | |
| Sintaxis: | |
| cm whoami | |
| == CMD_HELP_WHOAMI == | |
| == CMD_USAGE_WKTREENODESTATUS == | |
| Uso: | |
| cm wktreenodestatus path1, path2, ... | |
| == CMD_DESCRIPTION_WORKSPACE == | |
| Use este comando para administrar workspaces. | |
| == CMD_USAGE_WORKSPACE == | |
| Sintaxis: | |
| cm workspace | wk comando [options] | |
| Comandos: | |
| list | ls | |
| create | mk | |
| delete | rm | |
| move | mv | |
| rename | |
| Para obtener más información sobre cada comando: | |
| cm workspace comando --usage | |
| cm workspace comando --help | |
| == CMD_HELP_WORKSPACE == | |
| Ejemplos: | |
| cm workspace create myWorkspace wk_path | |
| cm workspace list | |
| cm workspace delete myWorkspace | |
| == CMD_DESCRIPTION_WORKSPACE_CREATE == | |
| Crea un nuevo workspace. | |
| == CMD_USAGE_WORKSPACE_CREATE == | |
| Sintaxis: | |
| cm workspace | wk [create | mk] <rep_spec> | |
| [create | mk] <nombre> <ruta> [<rep_spec>] | |
| [create | mk] <nombre> <ruta> [--selector[=<fichero_selector>] | |
| (Crea un nuevo workspace.) | |
| cm workspace | wk [create | mk] <nombre> <ruta> --dynamic --tree=[<tree>] | |
| (Crea un workspace dinámico. Esta característica es experimental, | |
| y solamente se encuentra disponible en Windows.) | |
| nombre Nombre del nuevo workspace. | |
| ruta Ruta de acceso del workspace. | |
| rep_spec Crea el nuevo workspace con el repositorio especificado. | |
| Use 'cm help objectspec' para obtener más | |
| información sobre especificaciones de repositorios. | |
| Opciones: | |
| --selector Edita el selector para el nuevo workspace. | |
| Si se especifica selector-file, entonces el selector | |
| para el nuevo workspace se fiha desde el fichero | |
| especificado. | |
| --dynamic Crea un workspace dinámico. Esta funcionalidad es | |
| todavía experimental, y solo está disponible para | |
| Windows. Si se usa esta opción, es obligatorio usar el | |
| parámetro --tree. | |
| --tree Especifica el punto inicial al que apuntará el | |
| workspace dinámico. Puede ser una especificación de | |
| rama, changeset o etiqueta. El workspace continuará | |
| usando el repositorio de la especificación. Use | |
| 'cm help objectspec' para obtener más información sobre | |
| la especificación. | |
| == CMD_HELP_WORKSPACE_CREATE == | |
| Notas: | |
| - Un workspace es una vista del repositorio mapeado en el sistema de | |
| ficheros local, en un directorio especificado. Utilice los comandos | |
| 'cm showselector' y 'cm setselector' para ver y modificar el selector. | |
| - Si no se especifica rep_spec ni --selector, el workspace cargará | |
| automáticamente el contenido del primer repositorio (alfabéticamente) del | |
| servidor configurado en el fichero de configuración client.conf | |
| - Los workspaces dinámicos son una funcionalidad experimental (sólo Windows), | |
| y requiere que el programa plasticfs.exe se esté ejecutando en segundo | |
| plano. | |
| Ejemplos: | |
| cm workspace create mycode | |
| cm wk mk mycode | |
| (Crea un workspace llamado 'mycode' apuntando al repositorio del mismo nombre. | |
| El directorio del workspace se creará bajo el directorio actual.) | |
| cm wk mk mycode@localhost:8084 | |
| cm wk mk mycode@myorganization@cloud | |
| (Crea un workspace llamado 'mycode' igual que antes, pero es posible especificar | |
| un servidor de repositorios diferente.) | |
| cm workspace create myworkspace c:\workspace | |
| cm wk mk myworkspace /home/john/wkspace | |
| (Crea el workspace 'myworkspace' en 'c:\workspace' y '/home/john/wkspace' | |
| respectivamente.) | |
| cm wk mywktest c:\wks\wktest --selector=myselector.txt | |
| (Crea 'mywktest' utilizando como selector 'myselector.txt'.) | |
| cm wk mywkprj c:\wks\wkprj myrep@repserver:localhost:8084 | |
| (Crea 'mywkprj' en 'c:\wks\wkprj' con el repositorio seleccionado.) | |
| cm wk mywkprj c:\dynwks\mywkprj --dynamic --tree=br:/main@myrep@localhost:8084 | |
| (Crea el workspace dinámico 'mywkprj' en 'c:\dynwks\mywkprj' con el | |
| repositorio 'myrep@localhost:8084', apuntando a la rama '/main' la primera | |
| vez que se monte.) | |
| == CMD_DESCRIPTION_WORKSPACE_DELETE == | |
| Borra un workspace. | |
| == CMD_USAGE_WORKSPACE_DELETE == | |
| Sintaxis: | |
| cm workspace | wk delete | rm [ruta | wkspec] [--keepmetadata] | |
| ruta Ruta del workspace. | |
| wkspec Especificación del workspace a borrar. | |
| Use 'cm help objectspec' para obtener más información sobre la | |
| especificación de espacios de trabajo. | |
| Opciones: | |
| --keepmetadata: No elimina los archivos de metadatos del directorio | |
| .plastic. | |
| == CMD_HELP_WORKSPACE_DELETE == | |
| Notas: | |
| Si no se especifican parámetros, se borrará el workspace actual. | |
| Ejemplos: | |
| cm workspace delete | |
| (Elimina el workspace actual) | |
| cm wk delete c:\workspace | |
| cm workspace rm /home/danipen/wks | |
| cm wk rm wk:MiWorkspace | |
| cm wk rm wk:MiWorkspace@DIGITALIS | |
| == CMD_DESCRIPTION_WORKSPACE_LIST == | |
| Muestra la lista de workspaces. | |
| == CMD_USAGE_WORKSPACE_LIST == | |
| Sintaxis: | |
| cm workspace | wk [list | ls] [--format=str_format] | |
| Opciones: | |
| --format Devuelve el mensaje de respuesta con el formato | |
| especificado. Consulte la ayuda para más información. | |
| == CMD_HELP_WORKSPACE_LIST == | |
| Notas: | |
| Este comando acepta una cadena de texto formateada para mostrar la | |
| salida. | |
| Los parámetros de salida del comando son los siguientes: | |
| {0} | {wkname} Nombre del workspace. | |
| {1} | {machine} Nombre de la máquina. | |
| {2} | {path} Ruta del workspace. | |
| {3} | {wkid} Identificador único del workspace. | |
| {4} | {wkspec} Especificación del workspace en el formato: | |
| 'wkname@machine'. | |
| {tab} Inserta un tabulador. | |
| {newline} Inserta una nueva línea. | |
| Ejemplos: | |
| cm wk | |
| (Lista todos los workspaces.) | |
| cm workspace list --format={0}#{3,40} | |
| cm workspace list --format={wkname}#{wkid,40} | |
| (Lista todos los workspaces mostrando el nombre del workspaces, el | |
| símbolo '#' y el identificador del workspace utilizando 40 espacios y | |
| alineado a la izquierda.) | |
| cm wk --format="Workspace {0} in path {2}" | |
| cm wk --format="Workspace {wkname} in path {path}" | |
| (Lista todos los workspaces, mostrando los resultados en cadenas | |
| formateadas.) | |
| == CMD_DESCRIPTION_WORKSPACE_MOVE == | |
| Mueve un workspace. | |
| == CMD_USAGE_WORKSPACE_MOVE == | |
| Sintaxis: | |
| cm workspace | wk move | mv [wkspec] ruta | |
| Opciones: | |
| wkspec Especificación del workspace a ser movido. | |
| Use 'cm help objectspec' para obtener más información sobre la | |
| especificación de espacios de trabajo. | |
| ruta La ruta destino a la que mover el workspace. | |
| == CMD_HELP_WORKSPACE_MOVE == | |
| Notas: | |
| Este comando permite al usuario mover workspace a otro lugar en disco. | |
| Ejemplos: | |
| cm workspace move myWorkspace \new\workspaceDirectory | |
| (Mueve el workspace a la ruta especificada.) | |
| cm wk mv C:\wkspaces\newpath | |
| (Mueve el workspace de trabajo a 'C:\wkspaces\newpath') | |
| == CMD_DESCRIPTION_WORKSPACE_RENAME == | |
| Cambia el nombre de un workspace. | |
| == CMD_USAGE_WORKSPACE_RENAME == | |
| Sintaxis: | |
| cm workspace | wk rename [nombre_antiguo] nombre_nuevo | |
| nombre_antiguo Nombre antiguo del workspace. | |
| nombre_nuevo Nombre nuevo del workspace. | |
| == CMD_HELP_WORKSPACE_RENAME == | |
| Notas: | |
| Este comando renombra un workspace. Si no se especifica nombre_antiguo, | |
| el sistema tomará el nombre del workspace actual. | |
| Ejemplos: | |
| cm workspace rename miworkspace wk2 | |
| (El workspace 'miworkspace' se renombra a 'wk2'.) | |
| cm wk rename nuevoNombre | |
| (El workspace actual se renombra a 'nuevoNombre'.) | |
| == CMD_DESCRIPTION_WORKSPACESTATUS == | |
| Muestra el changeset cargado en un workspace y si los hay los elementos cambios que contiene. | |
| == CMD_USAGE_WORKSPACESTATUS == | |
| Sintaxis: | |
| cm status [workspacepath] [opciones] [tipos_de_búsqueda] | |
| workspacepath: El path de un workspace determinado o una ruta por debajo | |
| del mismo. La búsqueda de cambiados se realizará a partir del path | |
| especificado y de manera recursiva. | |
| Opciones generales: | |
| --changelist=NAME: Muestra los cambios en el 'changelist' llamado "NAME". | |
| --changelists: Muestra los cambios agrupados en 'changelists'. | |
| --cutignored: Evita mostrar los contenidos de los directorios ignorados. | |
| Requiere el tipo de búsqueda --ignored. | |
| --header: Solo imprimirá la información del changeset cargado en el | |
| workspace, no realizará la búsqueda de elementos cambiados. | |
| --noheader: El comando no imprimirá el estado del workspace, sólo | |
| realizará e imprimirá la búsqueda de elementos cambiados. | |
| --nomergesinfo: La información de los merges de los cambios no se imprimirá. | |
| --head: El comando imprimirá el estado del último changeset de la rama. | |
| --short: Muestra únicamente rutas de elementos que tienen cambios. | |
| --symlink: Aplica la operación a los enlaces simbólicos en lugar de | |
| aplicarla a sus destinos. | |
| --dirwithchanges: Muestra directorios que contienen cambios (ítems | |
| añadidos, movidos o eliminados en su interior). | |
| --xml: Permite volcar la salida del comando en formato xml. Por defecto la | |
| salida sale en la pantalla, pero si se especifica un fichero | |
| (--xml=output.xml) la salida se vuelca en dicho fichero. | |
| --pretty: Imprime los cambios del workspace en formato de tabla. | |
| --encoding: si se utiliza con la opción --xml, permite especificar el | |
| encoding con el que se guardará la salida del comando. Consulte la | |
| documentación de la MSDN para obtener la tabla completa de | |
| codificaciones soportadas y su formato; al final de la página en la | |
| columna "Name": | |
| http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx | |
| --wkrootrelativepaths, --wrp: Muestra rutas relativas a la raíz del | |
| workspace en vez de rutas relativas al directorio actual. | |
| --fullpaths, --fp: Fuerza al comando a imprimir rutas absolutas, | |
| sobreescribiendo cualquier otra configuración acerca de impresión | |
| de rutas. | |
| --iscochanged: Incluye información sobre si el contenido de un fichero en | |
| checkout ha sido o modificado o no. Esta opción sólo está disponible en | |
| combinación con las opciones "--compact", "--xml" y | |
| "--machinereadable". | |
| Si no se especifica la opción "--iscochanged", las opciones | |
| "--compact", "--xml" o "--machinereadable" sólamente mostrarán el | |
| estado "CO" para un fichero en checkout cuyo contenido ha cambiado. | |
| Si se especifica la opción "--iscochanged", las opciones "--compact", | |
| "--xml" o "--machinereadable" mostrarán el estado "CO+CH" para un | |
| fichero en checkout cuyo contenido ha cambiado. | |
| Opciones del viejo formato: | |
| --cset: El comando imprimirá el estado del workspace en el viejo formato. | |
| --compact: El comando imprimirá el estado del workspace y la búsqueda de | |
| elementos cambiados en el viejo formato. | |
| --noheaders: Usado junto con --compact, la información de cada grupo de | |
| cambiós no se imprimirá. (No aplica al nuevo formato.) | |
| Tipos de búsqueda: | |
| --added: El comando busca elementos añadidos. | |
| --checkout: El comando busca elementos en checkout. | |
| --changed: El comando busca elementos cambiados. | |
| --copied: El comando busca elementos copiados. | |
| --replaced: El comando busca elementos reemplazados. | |
| --deleted: El comando busca elementos borrados. | |
| --localdeleted: El comando busca elementos borrados localmente. | |
| --moved: El comando busca elementos movidos. | |
| --localmoved: El comando busca elementos movidos localmente. | |
| --percentofsimilarity (-p)=valor: Porcentaje de similitud entre dos | |
| ficheros para considerarlos el mismo en la búsqueda de movidos | |
| locales, su valor por defecto es un 20%. | |
| --txtsameext: Sólo aquellos ficheros de texto que tengan la misma | |
| extensión serán tenidos en cuenta para la búsqueda de movidos basada | |
| en la similitud del contenido. Por defecto todos los ficheros de texto | |
| son procesados. | |
| --binanyext: Cualquier fichero binario es tenido en cuenta para la | |
| búsqueda de movidos basada en la similitud del contenido. Por defecto | |
| sólo aquellos ficheros binarios que tengan la misma extensión | |
| son procesados. | |
| --private: El comando busca elementos no controlados. | |
| --ignored: El comando busca elementos ignorados. | |
| --hiddenchanged: El comando busca elementos cambiados marcados como | |
| ocultos (incluye '--changed'). | |
| --cloaked: El comando busca elementos marcados como cloaked. | |
| --controlledchanged: Este modificador engloba los siguientes parámetros: | |
| '--added' '--checkout' '--copied' '--replaced' '--deleted' '--moved'. | |
| --all (-a): Este modificador engloba los siguientes parámetros: | |
| '--controlledchanged' '--changed' '--localdeleted' '--localmoved' | |
| '--private'. | |
| == CMD_HELP_WORKSPACESTATUS == | |
| Notas: | |
| El comando status muestra el changeset cargado en un workspace | |
| y si los hay, los cambios que contiene. | |
| Se puede utilizar el comando para saber cuál es el changeset con el que se | |
| está trabajando en un momento dado, y poder utilizarlo, por ejemplo, para | |
| marcar configuraciones concretas mediante etiquetas de tipo changeset. | |
| También es útil para conocer los cambios pendientes que existen dentro | |
| del workspace, los tipos de cambios que deseamos obtener del workspace pueden | |
| ser modificados gracias a los parámetros que el comando admite. Por defecto | |
| se muestran todos los cambios, controlados y locales. | |
| El porcentaje de similitud entre dos ficheros usado por el algoritmo de | |
| cálculo de movidos locales se puede especicifar mediante la option '--percentofsimilarity' | |
| o '-p' y su rango va desde 0 hasta 100. Si este parámetro no es especidicado | |
| su valor por por defecto es del 20%. | |
| A través de éste comando, también es posible mostrar los cambios agrupados | |
| en 'changelists' de cliente. El changelist por defecto del sistema (llamado | |
| 'default'), agrupa los cambios que no están contenidos en el resto de | |
| 'changelists', por lo que los cambios que se muestran especificando éste | |
| 'changelist', dependerán del tipo de búsquedas especificados en el comando. | |
| La opción de mostrar cambios agrupados en 'changelists' requiere mostrar cambios | |
| controlados (en estado 'added', 'checkout', 'copied', 'replaced', 'deleted' o | |
| 'moved'), por lo que la opción '--controlledchanged' se activará automáticamente | |
| cuando se muestren 'changelists'. | |
| El formato por defecto para la salida en XML es UTF-8. Es posible cambiar | |
| dicho encoding usando la opción --encoding=otro_encoding. | |
| El comando 'status' imprime por defecto rutas relativas al directorio de trabajo, | |
| a menos que se especifiquen las opciones '--machinereadable' o '--short' | |
| (en cuyo caso, se imprimen rutas absolutas). | |
| Si se usa la opción '--xml', el comando 'status' imprimirá por defecto rutas | |
| relativas a la raíz del workspace, a menos que se especifique adicionalmente | |
| la opción '--fp' (en cuyo caso, se imprimen rutas absolutas). | |
| Ejemplos: | |
| cm status | |
| (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado | |
| y los elementos en checkout, añadidos, copiados, reemplazados, borrados, borrados locales, | |
| movidos, movidos locales, y privados. La busqueda de los elementos se realiza | |
| sobre el workspace de forma recursiva) | |
| cm status --controlledchanged | |
| (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado | |
| y los elementos del workspace en checkout, añadidos, copiados, reemplazados, | |
| borrados, y movidos) | |
| cm status --added | |
| (Ejecutándolo dentro de workspace el comando imprime el changeset cargado | |
| y solamente los elementos añadidos. La búsqueda de los elementos se realiza | |
| sobre el workspace de forma recursiva) | |
| cm status c:\workspaceLocation\code\client --added | |
| (El comando imprime el changeset cargado y solamente los elementos añadidos. | |
| La búsqueda de los elementos se realiza sobre el path proporcionado de forma recursiva) | |
| cm status --changelists | |
| cm status --changelist | |
| (El comando muestra todos los cambios en el espacio de trabajo, agrupados | |
| por 'changelists'). | |
| cm status --changelist=pending_to_review | |
| (El comando muestra los cambios que contiene el changelist 'pending_to_review') | |
| cm status --changelist=default --private | |
| (El comando muestra los cambios que contiene el changelist 'default', | |
| el changelist por defecto del sistema, mostrando elementos privados, | |
| además de elementos con cambios controlados si los hubiese). | |
| cm status --short --changelist=pending_to_review | cm checkin - | |
| (Se protegen los cambios en el changelist llamado 'pending_to_review'). | |
| cm status c:\workspaceLocation\code\client --xml=output.xml | |
| (Guarda la salida del status en el fichero output.xml, en formato XML y | |
| usando UTF-8.) | |
| cm status --ignored | |
| (Muestra todos los elementos ignorados) | |
| Salida: | |
| IG src | |
| IG src/version.c | |
| IG out/app.exe | |
| cm status --ignored --cutignored | |
| (Muestra ficheros ignorados cuyo directorio padre no está ignorado y | |
| directorios ignorados pero no el árbol de sus contenidos) | |
| Salida: | |
| IG src | |
| IG out/app.exe | |
| == CMD_DESCRIPTION_XLINK == | |
| Crea, edita o muestra un xlink | |
| == CMD_USAGE_XLINK == | |
| Sintaxis: | |
| cm xlink [-w] [-rs] xlink_path / <csetspec | lbspec | brspec> [<expansion_rules>+] | |
| (Crea un xlink). | |
| cm xlink [-rs] xlink_path /relative_path <csetspec | lbspec | brspec> [<expansion_rules>+] | |
| (Crea un xlink parcial de solo lectura apuntando a /relative_path en lugar | |
| de apuntar a la raíz por defecto / ). | |
| cm xlink -e xlink_path <csetspec | lbspec | brspec> | |
| (Edita un xlink para cambiar la especificación destino). | |
| cm xlink -s|--show xlink_path | |
| (Muestra la información de un xlink incluyendo las reglas de expansión). | |
| cm xlink -ar|--addrules xlink_path <expansion_rules>+ | |
| (Añade al xlink las reglas de expansión proporcionadas). | |
| cm xlink -dr|--deleterules xlink_path <expansion_rules>+ | |
| (Borra del xlink las reglas de expansión especificadas). | |
| xlink_path Ruta en el espacio de trabajo actual donde se cargan | |
| los contenidos del repositorio que se va a enlazar | |
| (cuando se crea un xlink) o que ya está enlazado | |
| (cuando se edita un xlink). | |
| csetspec Especificación del changeset que se va a enlazar. | |
| Determina qué versión y rama se carga en el espacio de | |
| trabajo para el repositorio enlazado. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de changesets. | |
| lbspec Especificación de la etiqueta que se va a enlazar. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de etiquetas. | |
| brspec Especificación de la rama que se va a enlazar. | |
| Usa el changeset actual a donde la rama especificada | |
| está apuntando. | |
| Usa 'cm help objectspec' para obtener más información | |
| sobre la especificación de ramas. | |
| -e Indica que el comando va a editar un xlink existente | |
| para cambiar la especificación del changeset enlazado. | |
| -s | --show Muestra información sobre el xlink seleccionado. | |
| -ar | --addrules Añade una o más reglas de expansión al xlink indicado. | |
| -dr | --deleterules Borra una o más reglas de expansión del xlink indicado. | |
| expansion_rules Especifica una o más reglas de expansión. Cada regla de | |
| expansión es un par (rama)-(rama a enlazar) | |
| br:/main/fix-br:/main/develop/fix | |
| Opciones: | |
| -w Crea un xlink de escritura. Esto significa que los | |
| contenidos bajo el xlink se podrán editar mediante el | |
| uso de autoexpansión de ramas. | |
| -rs Relative server. Permite crear un xlink a un repositorio | |
| que es una réplica de otro que existe en un servidor | |
| central. De este modo se reconcilian automáticamente los | |
| repositorios replicados con el original. | |
| Ejemplos: | |
| cm xlink codigo\segundorepositorio / 1@segundo@localhost:8084 | |
| cm xlink codigo\segundorepositorio / lb:LB001@segundo@localhost:8084 | |
| cm xlink -s codigo\segundorepositorio | |
| cm xlink -ar codigo\segundorepositorio br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix | |
| cm xlink -dr codigo\segundorepositorio br:/main/fix-br:/main/develop/fix | |
| == CMD_HELP_XLINK == | |
| Notas: | |
| Este comando crea un xlink al changeset especificado. Por defecto se | |
| creará como un xlink de sólo lectura. Esto significa que los contenidos | |
| correspondientes a otro repositorio cargados por debajo del xlink no | |
| podrán ser modificados. | |
| Para la edición del changeset de un xlink se puede utilizar una sintaxis | |
| reducida en la que no hay que especificar el resto de parámetros del | |
| xlink. Solamente es necesario en nuevo changeset al que apuntará. | |
| Auto-expansión de ramas: | |
| Cuando se realiza un cambio en uno de los repositorios enlazados en modo | |
| de lectura y escritura (opción -e) es necesario crear una nueva rama en | |
| dicho repositorio basándose en la rama en la que se está trabajando en el | |
| repositorio principal. Para determinar el nombre de dicha rama, se aplican | |
| las siguientes reglas: | |
| 1) Se comprueba si el nombre completo de la rama existe en el | |
| repositorio enlazado: | |
| - Si existe, se utiliza dicha rama. | |
| - Si no existe, Unity VCS construye el nombre de la rama de esta forma: | |
| - Nombre de la rama que contiene el changeset enlazado + nombre | |
| de la rama del repositorio principal. | |
| - Si existe una rama con dicho nombre, se utiliza como rama de | |
| trabajo. | |
| - Si no, se crea una rama nueva con el nombre así construido y | |
| se establece como base de la rama el changeset enlazado. | |
| 2) Después, se crea una nueva versión del xlink dentro de la nueva rama | |
| apuntando al nuevo changeset. | |
| De este modo, la estructura completa del xlink se mantiene actualizada con | |
| los últimos cambios en las versiones correctas. | |
| Ejemplos: | |
| cm xlink code\firstrepo / 1@first@localhost:8084 | |
| (Crea un xlink en la carpeta 'firstrepo' en el espacio de trabajo actual | |
| donde el changeset '1' en el repositorio 'first' se enlazará). | |
| cm xlink opengl\include /includes/opengl 1627@includes@localhost:8087 | |
| (Crea un xlink parcial de solo lectura en la ruta 'opengl\include' en el | |
| espacio de trabajo actual donde la ruta '/includes/opengl' en el changeset | |
| '1627' del repositorio 'includes' se enlazará como raíz. Esto significa | |
| que cualquier ítem dentro de '/includes/opengl' se enlazará en | |
| 'opengl\include' mientras que el resto del repositorio se ignorará). | |
| cm xlink -w -rs code\secondrepo / lb:LB001@second@localhost:8084 | |
| (Crea un xlink de escritura y relativo en la ruta 'secondrepo' en el | |
| espacio de trabajo actual donde la etiqueta'LB001' en el repositorio | |
| 'second' se enlazará). | |
| cm xlink code\thirdrepo / 3@third@localhost:8087 br:/main-br:/main/scm003 | |
| (Crea un xlink en la ruta 'thirdrepo' dentro del espacio de trabajo actual | |
| donde el changeset '3' en el repositorio 'third' se enlazará). | |
| cm xlink -e code\secondrepo br:/main/task1234@second@localhost:8084 | |
| (Edita el xlink 'code\secondrepo' para cambiar el repositorio destino | |
| enlazando la rama 'main/task1234' en el repositorio 'second'). | |
| cm xlink --show code\thirdrepo | |
| (Muestra información del xlink 'code\thirdrepo' incluyendo las reglas de | |
| expansión si éstas existen). | |
| cm xlink -ar code\secondrepo br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix | |
| (Añade dos reglas de expansión al xlink 'code\secondrepo'). | |
| cm xlink -dr code\secondrepo br:/main/fix-br:/main/develop/fix | |
| (Borra la regla de expansión del xlink 'code\secondrepo'). | |
| cm xlink code\secondrepo / 1@second@localhost:8084 | |
| cm xlink code\secondrepo / lb:LB001@second@localhost:8084 | |
| == CMD_USAGE_AUTOCOMPLETE == | |
| Sintaxis: | |
| cm autocomplete install | |
| Instala el autocompletado de comandos para 'cm' en la shell. | |
| cm autocomplete uninstall | |
| Desinstala el autocompletado de comandos para 'cm' de la shell. | |
| cm autocomplete --line <shell_line> --position <cursor_position> | |
| Devuelve sugerencias de autocompletado para 'shell_line', que deben ser | |
| insertadas en 'cursor_position'. Este comando no está pensado para ser | |
| ejecutado por el usuario final, pero está documentado en caso de que se | |
| quiera extender el soporte de autocompletado a otras shells. | |
| shell_line La linea que el usuario ha escrito en la shell cuando se | |
| pidió el autocompletado. | |
| En Bash, encuentra en la variable de entorno COMP_LINE. | |
| En PowerShell, se encuentra en la variable $wordToComplete. | |
| cursor_position La posición del cursor cuando se pidió el autocompletado. | |
| En Bash, se encuentra en la variable de entorno COMP_POINT. | |
| En PowerShell, se encuentra en la variable $cursorPoint. | |
| == CMD_DESCRIPTION_API == | |
| Arranca un servidor HTTP local que escucha peticiones de REST API. | |
| == CMD_USAGE_API == | |
| Sintaxis: | |
| cm api [(-p|--port)=<portnumber>] [(-r|--remote)] | |
| Opciones: | |
| -p | --port Pide al servidor escuchar en el puerto <portnumber> | |
| en lugar del 9090. | |
| -r | --remote Permite conexiones entrantes remotas, es decir, | |
| aquellas que provienen de otras máquinas en vez de | |
| la local. | |
| == CMD_HELP_API == | |
| Notas: | |
| El comando 'cm api' permite a los programadores realizar operaciones Unity VCS | |
| de cliente en sus máquinas. | |
| Lea la Guía de Unity VCS API para más información: | |
| https://www.plasticscm.com/documentation/restapi/plastic-scm-version-control-rest-api-guide | |
| Por defecto, la API escucha solamente conexiones locales en el puerto 9090. | |
| Para detener el servidor, presione la tecla Enter. | |
| Ejemplos: | |
| cm api | |
| (Arranca la API en el puerto 9090; únicamente conexiones locales.) | |
| cm api -r | |
| (Arranca la API en el puerto 9090; permite cualquier conexión entrante.) | |
| cm api --port=15000 -r | |
| (Arranca la API en el puerto 15000; permite cualquier conexión entrante.) | |
| == CMD_DESCRIPTION_CONFIGURECLIENT == | |
| Configura el cliente de Unity VCS y especificar un servidor por defecto para el usuario actual. | |
| == CMD_USAGE_CONFIGURECLIENT == | |
| Sintaxis: | |
| cm configure [--language=<idioma> --workingmode=<modo> [AuthParameters] | |
| --server=<servidor> [--port=<puerto>]] [--clientconf=<ruta_clientconf>] | |
| --language Idiomas disponibles: | |
| en (English) | |
| es (Spanish) | |
| --workingmode Modos de seguridad/usuarios disponibles: | |
| NameWorkingMode (Name) | |
| NameIDWorkingMode (Name + ID) | |
| LDAPWorkingMode (LDAP) | |
| ADWorkingMode (Active Directory) | |
| UPWorkingMode (User and password) | |
| SSOWorkingMode (Single Sign On) | |
| AuthParameters Parámetros de autenticación (solo para modos LDAPWorkingMode y UPWorkingMode): | |
| --user=<usuario> | |
| --password=<contraseña> | |
| Parámetros de Single Sign On (solo para modos SSOWorkingMode): | |
| --user=<usuario> | |
| --token=<token> | |
| --server Nombre/dirección IP del servidor de Unity VCS | |
| --port Puerto del servidor de Unity VCS | |
| (el puerto es opcional para servidores de Cloud) | |
| --clientconf Ruta del fichero de configuración a crear (opcional) | |
| Este argumento puede ser una ruta completa, un nombre de fichero o un directorio. | |
| Si no se especifica este parámetro, el directorio por defecto para el fichero | |
| de configuración 'client.conf' será: | |
| * '%LocalAppData%\plastic4' en Windows | |
| * '$HOME/.plastic4' en linux/macOS | |
| Ejemplos: | |
| --clientconf=c:/path/to/myclient.conf | |
| (La ruta especificada se utilizará para crear el fichero de configuración del cliente) | |
| --clientconf=myclient.conf | |
| (Se utilizará el fichero 'myclient.conf' dentro del directorio de configuración por defecto) | |
| --clientconf=c:/exisitingDirectory | |
| (Se utilizará el nombre de fichero por defecto, client.conf, en el directorio especificado) | |
| == CMD_HELP_CONFIGURECLIENT == | |
| Notas: | |
| El comando 'cm configure' no podrá ser usado en las versiones Cloud Edition o DVCS Edition de Unity VCS. | |
| Use de forma alternativa la aplicación 'plastic --configure'. | |
| Ejemplos: | |
| cm configure | |
| (ejecuta la versión interactiva del comando de configuración del cliente de Unity VCS) | |
| cm configure --language=en --workingmode=LDAPWorkingMode --user=jack --password=01234 \ | |
| --server=plastic.mymachine.com --port=8084 | |
| (configura el cliente de Unity VCS con los parámetros especificados, y creará el fichero | |
| de configuración 'client.conf' en el directorio por defecto). | |
| cm configure --language=en --workingmode=NameWorkingMode --server=plastic.mymachine.com \ | |
| --port=8084 --clientconf=clientconf_exp.conf | |
| (configura el cliente de Unity VCS con los parámetros especificados, y creará el fichero | |
| de configuración 'client.conf' en el directorio especificado). | |