Propiedades de página

Los comandos page properties listan las propiedades personalizadas (metadatos clave-valor) asociadas a una página de Confluence. Estas propiedades las establecen apps, macros e integraciones, y no son visibles en el cuerpo de la página.

Alias: props, prop

Esto es útil para:

inventario y auditoria de metadatos entre páginas
planificacion de migración, entendiendo que integraciones están en uso
gobernanza, verificando que las propiedades requeridas esten presentes

Propiedades por ID


acp2md page properties by-id PAGE_ID [flags]

Ejemplos


# Salida en tabla (por defecto)
acp2md page properties by-id 123456
 
# Salida JSON
acp2md page properties by-id 123456 --format json
 
# Salida YAML
acp2md page properties by-id 123456 --format yaml
 
# Guarda en un archivo
acp2md page properties by-id 123456 --format json --output props.json
 
# Limita resultados
acp2md page properties by-id 123456 --limit 10
 
# Envia el ID de página por stdin
echo "123456" | acp2md page properties by-id

Flags

Flag	Short	Predeterminado	Descripcion
`--format`	`-f`	`table`	Formato de salida: `table`, `json`, `yaml`, `csv`, `tsv`
`--limit`		`0`	Numero máximo total de propiedades a devolver (`0` = todas)
`--output`	`-o`	(stdout)	Ruta del archivo de salida

Propiedades por título


acp2md page properties by-title "PAGE TITLE" [flags]

Ejemplos


# Lista propiedades por título de página
acp2md page properties by-title "API Reference"
 
# Ordena por la página modificada mas recientemente
acp2md page properties by-title "Release Notes" --sort -modified-date
 
# Salida JSON
acp2md page properties by-title "Project Overview" --format json --output props.json
 
# Envia el título por stdin
echo "Team Guidelines" | acp2md page properties by-title

Flag adicional

Flag	Short	Predeterminado	Descripcion
`--sort`	`-S`	(ninguno)	Ordena coincidencias: `id`, `-id`, `created-date`, `-created-date`, `modified-date`, `-modified-date`, `title`, `-title`

El resto de los flags de by-id también están disponibles.

En v1.0.0, page properties auto-página hasta alcanzar --limit o agotar el conjunto de resultados. El CLI actual no expone un flag --cursor.

Propiedades por URL


acp2md page properties by-url URL [flags]

Alias: url, u

Extrae el ID de página de una URL de Confluence y lista propiedades. Formatos de URL compatibles:

https://domain.atlassian.net/wiki/spaces/KEY/pages/123456/Page+Title
https://domain.atlassian.net/wiki/spaces/KEY/pages/123456
https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Ejemplos


# Lista propiedades desde una URL de Confluence
acp2md page properties by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456"
 
# Salida JSON
acp2md page properties by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" --format json
 
# Guarda en un archivo
acp2md page properties by-url "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" --output props.json
 
# Envia la URL por stdin
echo "https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456" | acp2md page properties by-url

Flags

Se aplican todos los flags de by-id.

Las propiedades son distintas de las etiquetas de página. Usa --include-labels en los comandos page convert o page get para incluir etiquetas en la salida.