Manifeste de ressource web

Identifiant du schéma : web-resource-manifest@1 Schéma lisible par machine : web-resource-manifest.schema.json

La description canonique des métadonnées d’une ressource web (section 6.15) : un fichier d’application — JavaScript, CSS, HTML, JSON, XML, texte ou image — stocké dans la base de données de la plateforme et packagé comme composant de solution à part entière, de sorte qu’il voyage avec la solution au lieu d’être récupéré depuis un hôte externe. Les octets du fichier voyagent séparément (intégrés au package de solution) ; ce manifeste en constitue les métadonnées, validées de manière identique qu’une ressource soit créée depuis le Centre de contrôle d’administration, soumise par un appel d’API direct, générée par un assistant IA ou transportée dans une importation de solution — la règle du chemin de validation unique (section 6.7).

Les ressources web ne sont volontairement pas du stockage d’objets : le stockage d’objets est le magasin de blobs distinct destiné aux gros volumes de fichiers opérationnels ou d’utilisateurs, alors qu’une ressource web est un petit fichier d’application conservé dans la base de données et versionné avec la solution. Une taille maximale par ressource fait respecter cette frontière.

Structure

Champ	Type	Obligatoire	Remarques
logicalName	string	oui	Préfixé par l’éditeur, en forme de chemin (p. ex. par_/dashboard/remoteEntry.js). En minuscules ; lettres, chiffres, _, ., / et - uniquement. Le segment de chemin permet aux nombreux fichiers d’un bundle de partager une même base.
displayName	string	oui	Nom lisible affiché dans la grille des ressources web.
description	string | null	non	Brève description.
type	string	oui	L’un de JavaScript, Css, Html, Json, Xml, PlainText, Png, Jpeg, Gif, Svg, Ico, Binary. Détermine le Content-Type servi et si le fichier est textuel (modifiable en ligne) ou binaire (téléversement uniquement).
contentHash	string	oui	SHA-256 en hexadécimal minuscule des octets du fichier. Réimporter un contenu identique est idempotent, et la réponse servie peut être mise en cache comme immuable pour chaque empreinte.
sizeBytes	integer	oui	Taille des octets du fichier (≥ 0).

Où il est validé

• Création — l’Application Layer valide le manifeste selon web-resource-manifest@1, exige que logicalName commence par le préfixe de l’éditeur propriétaire et rejette tout contenu dépassant la taille maximale, avant de stocker les octets.
• Importation de solution — chaque manifeste de ressource web intégré à un package de solution est validé à nouveau selon le même schéma avant que la ressource ne soit stockée dans l’environnement cible.

Service

La plateforme sert les octets d’une ressource web depuis sa propre origine, en définissant Content-Type à partir de type et en renvoyant contentHash comme ETag fort. Servir depuis 'self' est ce qui permet de charger le bundle d’une application ou d’un contrôle personnalisé sous une CSP stricte sans autoriser d’origine externe (section 6.15, « mode Packagé »).

Voir aussi

• Manifeste d’application personnalisée — en mode Packagé, la sortie de build d’une application personnalisée est stockée sous forme de ressources web et son remoteEntryUrl pointe vers le chemin servi par la plateforme.
• Package de solution — comment les composants (y compris les ressources web) voyagent entre environnements.