Risoluzione degli errori di caricamento delle risorse e metadati causati da caratteri non supportati nei nomi file di AEM
AEM Assets applica una convalida rigida ai nomi delle risorse e delle cartelle; pertanto, caricamenti, aggiornamenti dei metadati, azioni di pubblicazione e risposte API non riescono se un nome file contiene un carattere non supportato, ad esempio *, /, :, #, %, & o {}. L’interfaccia utente di AEM blocca completamente questi caratteri, mentre le importazioni in blocco e l’acquisizione API li bonifica o li codifica in URL in modo silenzioso, e i sistemi a valle come Dynamic Media o l’API di Assets restituiscono quindi percorsi interrotti. La causa è che AEM, l’archivio JCR sottostante e i sistemi connessi non possono memorizzare o elaborare in modo sicuro tali caratteri. Se si rinominano le risorse interessate in modo da utilizzare solo i caratteri consentiti e si riacquisiscono, vengono ripristinati i caricamenti, le modifiche ai metadati, la pubblicazione e i percorsi API puliti.
Descrizione description
Ambienti:
- Adobe Experience Manager as a Cloud Service
- Adobe Experience Manager Managed Services
- Adobe Experience Manager 6.5 (on-premise)
- AEM Assets, l’importazione in blocco e l’API Assets
- Dynamic Media (Scene7) e Asset Share Commons
Problema/Sintomi:
- Il caricamento dell’interfaccia utente di AEM non riesce con il messaggio Caratteri “*/:
[`]` |#%{}?& non sono consentiti nel nome file”. - Gestisci pubblicazione restituisce Le risorse selezionate non sono valide quando un nome file contiene #.
- Non è possibile aggiornare i metadati di risorse i cui nomi di file contengono & o altri caratteri non validi.
- Le relazioni tra risorse non vanno a buon fine e Impossibile aggiornare la relazione a causa di caratteri speciali nei nomi delle risorse.
- L’importazione di massa o S3 rinomina le risorse mediante caratteri di escape, ad esempio un apostrofo su
%27o % su%25. - L’API di Assets restituisce percorsi danneggiati in cui un carattere non supportato decodifica in ?, ad esempio un apice più il carattere ?.
Causa principale:
AEM, l’archivio JCR sottostante e i sistemi a valle come Dynamic Media e l’API di Assets non possono memorizzare o elaborare in modo sicuro i nomi delle risorse che contengono determinati caratteri. L’interfaccia utente di AEM applica la convalida lato client, mentre l’importazione in blocco e l’acquisizione API applicano le regole di bonifica JCR e di codifica URL. I caratteri non supportati causano errori di acquisizione, errori di aggiornamento dei metadati, problemi di pubblicazione e risposte API non funzionanti.
Come confermare
- Seleziona il nome del file in base all’elenco dei caratteri non consentiti per la variante AEM. Il messaggio di errore dell’interfaccia utente mostra i caratteri non validi:
* / : [ \ ] | # % { } ? & ;=per AEM as a Cloud Service e lo stesso set per AEM 6.5. - Determina come è stata acquisita la risorsa: caricamento manuale dell’interfaccia utente, importazione S3, importazione in blocco, Gestione pacchetti o API. I caricamenti manuali non riescono immediatamente in caso di caratteri non validi, le importazioni S3 e in blocco vengono bonificate automaticamente e Gestione pacchetti ignora la convalida.
Risoluzione resolution
Per risolvere il problema, segui la procedura riportata di seguito:
- Rinomina la risorsa per rimuovere i caratteri non supportati. Nell’interfaccia utente di AEM, seleziona la risorsa, apri Proprietà e rinominala oppure ricarica la risorsa con un nome file bonificato che utilizza solo caratteri consentiti. Riprovare l’azione non riuscita, che si tratti dell’aggiornamento dei metadati, della pubblicazione o della relazione.
- Per i problemi in blocco che interessano centinaia o migliaia di risorse, applica una ridenominazione sistematica. Definisci una convenzione di denominazione bonificata — sostituisci e con “e”, rimuovi # e sostituisci spazi con trattini — quindi acquisisci nuovamente i file corretti in AEM oppure esegui uno script di automazione nel sistema di origine o in DAM a monte per bonificare i nomi prima del caricamento. Cerca le risorse in precedenza non valide e conferma i nomi aggiornati.
- Convalidare le integrazioni a valle. Conferma che i nomi bonificati risolvano i problemi con le miniature e i download di Asset Share Commons, percorsi API di Assets che non vengono più visualizzati? caratteri e flussi di lavoro di caricamento e ricerca di Dynamic Media. Test dei flussi di ricerca, chiamate API e pubblicazione.
- Conferma la correzione. Ricarica la risorsa con il nome file bonificato e verifica che venga caricata senza un avviso di convalida, che i metadati vengano salvati, che Gestisci pubblicazione venga eseguito senza l’errore Le risorse selezionate non siano valide e che l’API Assets restituisca un percorso senza ? caratteri.
Se il problema persiste
Contatta il supporto Adobe se i caricamenti, le modifiche ai metadati o le pubblicazioni continuano a non riuscire dopo aver bonificato i nomi dei file, se le risposte API mostrano una formattazione del percorso errata per i nomi di file che contengono solo caratteri consentiti o se l’importazione in blocco si comporta in modo incoerente negli ambienti. Specifica i nomi di file, il metodo di caricamento, gli URL dell’ambiente, i messaggi di errore e le schermate.