Target Folders
La pestaña Target Folders de la sección External Storage cataloga los destinos FTP, SFTP y S3 que el Editor de grabaciones usa para entregar clips cortados. La otra pestaña de External Storage es Remote Folders — shares de red usados para respaldar grabaciones antes de la retención.
Qué es
La acción Send to del Editor entrega un clip cortado (y un sidecar XML de metadatos opcional) al Target Folder elegido. Cada Target Folder es un registro de conexión guardado — el operador elige uno desde el diálogo y las credenciales, el host y la ruta viajan con la petición como una referencia id en lugar de inline.
Toda operación requiere el rol System Administrator. Las passwords y las S3 secret keys son solo escritura en la API — las respuestas GET devuelven has_password: true/false en lugar del valor almacenado.
Campos del formulario por protocolo
FTP
| Etiqueta UI | Campo API | Notas |
|---|---|---|
| Name | name | Nombre visible. |
| Host | host | Hostname o IP del servidor FTP. |
| Port | port | Puerto FTP. Por defecto 21. |
| Folder | folder | Ruta del directorio remoto. |
| User | user | Usuario FTP. |
| Password | password | Password FTP. Solo escritura. |
| Include XML metadata file | xml_enabled | Cuando es true, se genera y sube un sidecar XML junto al vídeo. |
SFTP
| Etiqueta UI | Campo API | Notas |
|---|---|---|
| Name | name | Nombre visible. |
| Host | host | Hostname o IP del servidor SFTP. |
| Port | port | Puerto SSH. Por defecto 22. |
| Folder | folder | Ruta del directorio remoto. |
| User | user | Usuario SSH. |
| Password | password | Password SSH. Solo escritura. |
| Include XML metadata file | xml_enabled | Misma semántica que en FTP. |
S3
El formulario S3 reetiqueta los campos que muestra la UI, pero los nombres de columna persistidos en la API se mantienen iguales a los de FTP / SFTP:
| Etiqueta UI | Campo API | Notas |
|---|---|---|
| Name | name | Nombre visible. |
| Bucket | host | Nombre del bucket S3 (almacenado en el campo host). |
| Region | folder | Región AWS (almacenada en el campo folder). |
| Access Key ID | user | AWS Access Key ID (almacenada en el campo user). |
| Secret Access Key | password | AWS Secret Access Key (almacenada en el campo password, solo escritura). |
| Include XML metadata file | xml_enabled | Misma semántica que en FTP. |
En el listado de Target Folders, la columna Host muestra el nombre del bucket S3 para entradas S3 (no se reetiqueta a Bucket en la vista de lista). La distinción la lleva la columna Protocol.
Columnas del listado
El listado de Target Folders expone seis columnas: Name, Protocol, Host, Folder, XML y Status.
Sidecar XML de metadatos
Cuando xml_enabled = true, el Editor genera un sidecar XML a partir de una plantilla del despliegue y lo sube junto al fichero de vídeo. La plantilla lleva placeholders para título del clip, descripción, categoría, destino de publicación y timestamps. Las plantillas se personalizan por despliegue por el System Administrator en el momento de la instalación — los operadores solo rellenan los campos del diálogo Send-to.
Validate
La acción Validate Connection llama a POST /c21apiv2/crud/targetfolders/{id}/validate. La comprobación corre:
- FTP — connect + login, timeout de 5 segundos.
- SFTP — SSH connect + auth, timeout de 5 segundos.
- S3 —
HeadBucketcontra la región y credenciales configuradas, timeout de 5 segundos.
La respuesta actualiza validation_status, validation_date y (en caso de fallo) un validation_error saneado.
Referencia de API
| Acción | Método + path |
|---|---|
| List | GET /c21apiv2/crud/targetfolders |
| Read | GET /c21apiv2/crud/targetfolders/{id} |
| Create | POST /c21apiv2/crud/targetfolders |
| Update | PUT /c21apiv2/crud/targetfolders/{id} |
| Delete | DELETE /c21apiv2/crud/targetfolders/{id} |
| Validate Connection | POST /c21apiv2/crud/targetfolders/{id}/validate |
Cross-links
- Editor de grabaciones — entrega Send to, el flujo por clip que consume Target Folders.
- Remote Folders — la otra pestaña de External Storage, para backup de retención.
- Integración con MediaCopilot — ruta de entrega separada de clips a un tenant MediaCopilot (basada en cuenta, no en un Target Folder).
FAQ
id en su diálogo Send-to del Editor. Solo un System Administrator puede crear o modificar las entradas.