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, 1–65535. Vacío: el del protocolo, 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, 1–65535. Vacío: el del protocolo, 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 — un login SFTP real con el usuario y la contraseña de la carpeta (o con la clave privada instalada para esa carpeta en el despliegue, que tiene prioridad, igual que en el envío), timeout de conexión de 5 segundos. Un usuario o una contraseña incorrectos dan
SFTP authentication failed; un servidor que no responde,SFTP connection failed to host on port <port>; una carpeta sin usuario,SFTP credentials are required. - 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.
Al crear una carpeta (POST) se guardan el port y el xml_enabled que se envían. Un port fuera de 1–65535, o sin él, se guarda vacío y el envío usa el puerto del protocolo.
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.