Crear un recurso web

Objetivo

Agregar un recurso web (un archivo de aplicación como un paquete de JavaScript, una hoja de estilos, un fragmento HTML, un logotipo o un SVG) que la plataforma guarda en la base de datos y empaqueta con su solución, de modo que viaja a donde se importe la solución.

Un recurso web es para los archivos con los que se construye una aplicación. Un documento grande que un usuario carga en tiempo de ejecución no es un recurso web: eso va en el almacenamiento de archivos. Un límite de tamaño por archivo mantiene separadas ambas cosas.

Requisitos previos

• Ha iniciado sesión en el Centro de control de administración.
• Hay un entorno seleccionado en la barra superior y ha abierto una solución (consulte Crear una solución).

Pasos

1. En la solución abierta, elija Recursos web en la navegación de la izquierda.
2. Seleccione Nuevo.
3. Escriba un nombre para mostrar y un nombre lógico. El nombre lógico lleva el prefijo del editor y tiene forma de ruta; por ejemplo, par_/dashboard/app.js o par_/logo.svg.
4. Elija el tipo (JavaScript, CSS, HTML, JSON, XML, texto, PNG, JPEG, GIF, SVG, icono u otro/binario).
5. Proporcione el contenido:
   • Para un tipo de texto (JavaScript, CSS, HTML, JSON, XML, texto, SVG) puede editarlo en línea en el editor o cargar un archivo.
   • Para un tipo de imagen o binario, carga un archivo (no hay nada que escribir).
6. Seleccione Guardar. El archivo se guarda con la solución y la plataforma puede servirlo.
7. La lista muestra la Dirección de cada archivo: dónde la plataforma lo sirve. Ábrala en una pestaña nueva, o cópiela con el botón de al lado, para pasársela a lo que vaya a obtener el archivo.

Cargar una carpeta de archivos que se enlazan entre sí

Una página que enlaza su hoja de estilos, su script y sus imágenes por dirección relativa necesita todos esos archivos juntos. En lugar de crearlos uno a uno:

1. Comprima los archivos en un zip: los archivos mismos, no una carpeta que los contenga.
2. En Recursos web, seleccione Cargar una carpeta.
3. Dele un nombre para mostrar y una carpeta bajo el prefijo de su editor, por ejemplo par_/badge.
4. Elija el zip y seleccione Cargar.

Cada archivo se crea en esa carpeta conservando su ruta relativa, así que badge.html, que enlaza badge.css, encuentra par_/badge/badge.css.

Volver a cargar en la misma carpeta reemplaza lo que hay, y quita los archivos que el nuevo zip ya no contiene. Así se publica un cambio, porque un recurso web no se edita en el sitio. Los archivos que la plataforma no sirve, como un .map, se omiten, y el resultado dice cuáles.

Una aplicación o un control personalizado no se carga aquí. Cada uno es un único paquete, instalado en Aplicaciones personalizadas o Controles personalizados (consulte Registrar un control personalizado).

Qué ocurre entre bastidores

Los bytes del archivo se guardan en la base de datos de la plataforma y se registran como un componente de su solución, así que al exportar la solución el archivo viaja con ella y al importarla se vuelve a crear en el entorno de destino. La plataforma valida los metadatos del archivo, comprueba que el nombre lógico empiece por el prefijo de su editor y rechaza un archivo que supere el límite de tamaño: un archivo grande debe ir al almacenamiento de archivos. Después, la plataforma puede servir el archivo desde su propia dirección con el tipo de contenido correcto.

La Dirección de la lista es …/environments/<entorno>/webresources/<nombre lógico>, y responde a cualquiera, sin iniciar sesión: eso es lo que permite que una página, una impresora o un correo carguen el archivo. No ponga en un recurso web nada que no publicaría.

Solución de problemas

• «…debe empezar por el prefijo del editor…». El nombre lógico tiene que empezar por el prefijo de su editor seguido de _ (por ejemplo, par_).
• «El manifiesto del recurso web no es válido…». El nombre lógico debe estar en minúsculas y contener solo letras, dígitos, _, ., / o - (sin espacios).
• «…supera el límite de …. Los archivos grandes van en Object Storage…». El archivo supera el límite de tamaño por recurso; guarde los archivos grandes en el almacenamiento de archivos, no en un recurso web.
• «Ya existe un recurso web '…' en este entorno». Ya hay un recurso con ese nombre lógico; elija otro nombre.
• «La entrada del paquete '…' tiene una ruta que saldría de su carpeta». El zip contiene un segmento .. o una ruta absoluta. Comprima los archivos mismos, no una ruta por encima de ellos.
• «El paquete no contiene ningún archivo que la plataforma pueda servir». Nada del zip tiene un tipo que la plataforma sirva. Compruebe que comprimió los archivos y no otra carpeta.
• «El paquete contiene … archivos; el límite es 200». Casi seguro que se comprimió la carpeta equivocada (lo más probable, node_modules).

Escenarios relacionados

• Crear una solución.
• Registrar una aplicación React personalizada.