DocumentazioneAEMGuida utente

[AEM Assets]{class="badge positive" title="Si applica ad AEM Assets)."}

Aggiungi risorse digitali a Adobe Experience Manager come Cloud Service Assets add-assets-to-experience-manager

Ultimo aggiornamento: 25 settembre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • User
  • Admin

Adobe Experience Manager Assets accetta molti tipi di risorse digitali da diverse origini. Memorizza i file binari originali e le rappresentazioni generate, elabora le risorse utilizzando i flussi di lavoro e i servizi Adobe AI e distribuisce i contenuti su molti canali e superfici.

Adobe Experience Manager arricchisce automaticamente il contenuto binario dei file digitali caricati, rendendo le risorse più ricercabili, riutilizzabili e pronte per la consegna. Experience Manager arricchisce questi file con rich metadata, smart tag, renditions e altri servizi Digital Asset Management (DAM). È possibile caricare vari tipi di file, ad esempio immagini, documenti e file di immagini raw, dalla cartella locale o da un’unità di rete in Experience Manager Assets.

Metodi per aggiungere risorse all’archivio

Oltre al caricamento del browser più comunemente utilizzato, esistono altri metodi per aggiungere risorse all’archivio Experience Manager. Questi altri metodi includono client desktop, come l’app desktop Adobe Asset Link o Experience Manager, script di caricamento e acquisizione creati dai clienti e integrazioni di acquisizione automatizzate aggiunte come estensioni Experience Manager.

Servizi aggiuntivi ed elaborazione

Anche se è possibile caricare e gestire qualsiasi file binario in Experience Manager, i formati di file più comunemente utilizzati supportano servizi aggiuntivi, come l’estrazione di metadati o la generazione di anteprime/rappresentazioni. Per ulteriori informazioni, vedere formati di file supportati.

Puoi anche scegliere di eseguire un’elaborazione aggiuntiva sulle risorse caricate. Sulla cartella è possibile configurare diversi profili di elaborazione delle risorse, in cui le risorse vengono caricate, per aggiungere automaticamente metadati, rappresentazioni o servizi di elaborazione delle immagini specifici, in modo che le risorse soddisfino i requisiti di consegna senza interventi manuali. Consulta Elabora risorse al momento del caricamento.

Panoramica dei metodi di caricamento

Assets forniscono i seguenti metodi di caricamento. Adobe consiglia di comprendere il caso d’uso e l’applicabilità di ogni opzione di caricamento prima di utilizzarla, perché il metodo giusto dipende dal volume, dal flusso di lavoro e dagli utenti tipo coinvolti.

Metodo di caricamento
Quando utilizzare?
Persona primaria
Interfaccia utente della console Assets
Caricamento occasionale, facilità di pressione e trascinamento, caricamento del mirino. Non utilizzare per caricare più risorse.
Tutti gli utenti
Carica API
Per decisioni dinamiche durante il caricamento.
Sviluppatore
app desktop Experience Manager
Acquisizione di risorse di volume ridotto, ma non per la migrazione.
Amministratore, addetto marketing
Adobe Asset Link
Utile quando creativi e addetti al marketing lavorano su risorse dalle app desktop Creative Cloud supportate.
Creative, addetto marketing
Acquisizione in blocco risorse
Consigliato per migrazioni su larga scala e acquisizioni in blocco occasionali. Solo per gli archivi dati supportati.
Amministratore, sviluppatore

Caricare le risorse upload-assets

Adobe Experience Manager Assets supporta due metodi per caricare uno o più file. Trascinare i file direttamente dal desktop nell’interfaccia utente di Assets (browser Web) e nella cartella di destinazione, oppure avviare il caricamento dall’interfaccia utente di Assets tramite il menu Crea. Entrambi i metodi aggiungono risorse digitali alla posizione della cartella selezionata.

IMPORTANT
A Assets caricati in Experience Manager con un nome file maggiore di 100 caratteri viene assegnato un nome abbreviato quando vengono utilizzati in Dynamic Media.
I primi 100 caratteri del nome del file vengono mantenuti invariati ed eventuali caratteri rimanenti vengono sostituiti da una stringa alfanumerica. Questo metodo di ridenominazione garantisce un nome univoco quando la risorsa viene utilizzata in Dynamic Media, evitando conflitti di denominazione tra le risorse. Inoltre, supporta la lunghezza massima del nome file di risorse consentita in Dynamic Media, in modo che il troncamento mantenga ogni risorsa conforme a tale limite.

  1. Nell’interfaccia utente di Assets, passa alla posizione in cui desideri aggiungere risorse digitali.

  2. Per caricare le risorse, utilizza uno dei seguenti metodi:

    • Sulla barra degli strumenti fare clic su Crea > File. Se necessario, puoi rinominare il file nella finestra di dialogo visualizzata.
    • In un browser che supporta HTML5, trascina le risorse direttamente nell’interfaccia utente Assets. In questo metodo non viene visualizzata la finestra di dialogo rinomina file.

    creamenu

    Per selezionare più file, tieni premuto il tasto Ctrl (Windows) o il tasto Command (macOS) e seleziona le risorse nella finestra di dialogo del selettore file. Quando si utilizza un iPad, è possibile selezionare un solo file alla volta.

  3. Per annullare un caricamento in corso, fare clic su Chiudi (X) accanto alla barra di avanzamento. Poiché l’annullamento interrompe il trasferimento in corso, Assets elimina la parte parzialmente caricata della risorsa corrente per evitare di lasciare un file incompleto. Se si annulla un’operazione di caricamento prima che vengano caricati tutti i file, Assets interrompe il caricamento del file corrente e aggiorna il contenuto. Tuttavia, i file che hanno già completato il caricamento non vengono eliminati e rimangono nella cartella di destinazione.

  4. La finestra di dialogo di avanzamento del caricamento in Assets visualizza il numero di file caricati correttamente e i file che non è stato possibile caricare, fornendo un chiaro stato del batch. Inoltre, nell’interfaccia utente di Assets viene visualizzata la risorsa più recente caricata o la cartella creata per prima.

NOTE
Per caricare le gerarchie di cartelle nidificate, vedi risorse per il caricamento in blocco.

Gestione dei caricamenti per le risorse esistenti handling-upload-existing-file

Il caricamento di una risorsa con lo stesso percorso (nome e posizione identici) di una risorsa esistente attiva una finestra di dialogo di avviso che presenta tre opzioni di risoluzione: Sostituisci risorsa esistente, Crea un’altra versione o Mantieni entrambe. Ogni opzione gestisce il duplicato in modo diverso:

  • Sostituisci risorsa esistente: la sostituzione di una risorsa esistente la sovrascrive completamente, pertanto i metadati e le eventuali modifiche precedenti, ad esempio annotazioni e ritagli, applicati alla risorsa esistente vengono eliminati definitivamente. Ciò si verifica perché la sostituzione scrive sulla risorsa memorizzata anziché mantenerne la cronologia.

    note
    NOTE
    L'opzione per la sostituzione delle risorse non è disponibile se la risorsa è bloccata o estratta.

  • Crea un’altra versione: viene creata una nuova versione della risorsa esistente nell’archivio, mantenendo lo stato precedente in modo che non venga perso alcun lavoro. È possibile visualizzare le due versioni nella Timeline e, se necessario, ripristinare la versione esistente precedente.

  • Mantieni entrambe: se scegli di mantenere entrambe le risorse, la nuova risorsa verrà rinominata in modo che coesistano sia la risorsa originale che quella appena caricata.

Per mantenere la risorsa duplicata in Assets, fai clic su Mantieni. Per eliminare la risorsa duplicata caricata, fai clic su Elimina.

Gestione del nome file e caratteri non consentiti filename-handling

Adobe Experience Manager (AEM) Assets blocca il caricamento di qualsiasi risorsa il cui nome file contiene un carattere non consentito. Quando un nome di file include uno o più caratteri non consentiti, Assets visualizza un messaggio di avviso e blocca il caricamento fino a quando i caratteri non consentiti non vengono rimossi o il file non viene rinominato con un nome consentito. Questa protezione viene eseguita nel punto di caricamento, pertanto i nomi di file problematici vengono rilevati prima che la risorsa entri nell’archivio.

Perché esistono queste restrizioni

Le restrizioni relative ai caratteri del nome file garantiscono che i nomi delle risorse e delle cartelle rimangano compatibili tra i file system, i livelli di archiviazione e gli URL web. Caratteri come barre, due punti e altri simboli riservati hanno un significato speciale nei percorsi dei file e negli URL, pertanto la loro limitazione impedisce conflitti di denominazione, collegamenti interrotti ed errori di consegna a valle.

Per adattarsi a specifiche convenzioni di denominazione dei file per la tua organizzazione, la finestra di dialogo Carica Assets consente agli utenti di specificare nomi di file lunghi durante il caricamento. I seguenti caratteri (separati da spazi) non sono supportati:

  • Caratteri non validi per il nome della risorsa: * / : [ \\ ] | # % { } ? & o ;= (un punto e virgola seguito da un segno di uguale)
  • Caratteri non validi per il nome della cartella di risorse: * / : [ \\ ] | # % { } ? \" . ^ ; + & \t

Esempi di nomi di file non validi:

  • JPG_JD_small file ~!)$@;(-_=+^',..jpg
  • JPG_JD_small file ~!)$@;=(-_+^',..jpg

Entrambi gli esempi vengono rifiutati perché contengono caratteri riservati degli elenchi precedenti. Per caricarli correttamente, rimuovi i caratteri non consentiti o sostituiscili con alternative consentite prima di riprovare a caricarli.

Caricare risorse in blocco bulk-upload

L’inserimento in blocco delle risorse gestisce grandi volumi di risorse in modo efficiente. Un’acquisizione su larga scala non è un’immagine di file ampia né una migrazione casuale. Per rendere un’acquisizione su larga scala un progetto significativo che soddisfi in modo efficiente lo scopo aziendale, pianifica la migrazione e cura l’organizzazione delle risorse in modo deliberato. Poiché ogni acquisizione è diversa, è opportuno tenere conto della composizione dell’archivio e delle esigenze aziendali specifiche anziché applicare regole generiche. Le seguenti best practice consentono di pianificare ed eseguire un’acquisizione in blocco:

  • Cura risorse: rimuovi le risorse non necessarie nell’archivio di Digital Asset Management (DAM). È consigliabile rimuovere le risorse non utilizzate, obsolete o duplicate. Questa gestione domestica riduce i dati trasferiti e il numero di risorse acquisite, il che si traduce in acquisizioni più veloci e affidabili.
  • Organizza risorse: è consigliabile organizzare il contenuto in un ordine logico definito, ad esempio per dimensione del file, formato del file, caso d’uso o priorità. I file di grandi dimensioni e complessi richiedono più tempo di elaborazione e risorse di sistema, pertanto il loro isolamento evita i colli di bottiglia di elaborazione. Puoi anche prendere in considerazione l’acquisizione separata di file di grandi dimensioni utilizzando l’opzione di filtro delle dimensioni del file (descritta di seguito).
  • Acquisizioni in blocco: prova a suddividere l’acquisizione in più progetti di acquisizione in blocco. L’acquisizione scaglionata ti consente di visualizzare il contenuto prima e di regolare l’acquisizione in base alle esigenze. Ad esempio, è possibile acquisire le risorse con elaborazione intensiva nelle ore non di picco o gradualmente in più blocchi. Tuttavia, puoi acquisire risorse più piccole e semplici che non richiedono molta elaborazione in un’unica operazione.

Per caricare un numero maggiore di file, utilizza uno dei seguenti approcci. Vedi anche casi d’uso e metodi

  • API per il caricamento di risorse: se necessario, usa uno script o uno strumento di caricamento personalizzato che utilizza le API per aggiungere ulteriore gestione delle risorse (ad esempio, tradurre i metadati o rinominare i file).
  • App desktop Experience Manager: utile per i creativi e gli esperti di marketing che caricano risorse dal file system locale. Utilizzala per caricare le cartelle nidificate disponibili localmente.
  • Strumento di acquisizione in blocco: utilizza per l’acquisizione di grandi quantità di risorse occasionalmente o inizialmente durante la distribuzione di Experience Manager.

Strumento Importazione in blocco risorse asset-bulk-ingestor

Lo strumento Importazione in blocco risorse è disponibile solo per il gruppo di amministratori per l’acquisizione su larga scala di risorse da archivi dati di Microsoft Azure Blob Storage o Amazon Simple Storage Service (S3). L’accesso è limitato agli amministratori, perché l’acquisizione in blocco è un’operazione privilegiata e di volume elevato che sposta un numero elevato di risorse direttamente nell’archivio e richiede autorizzazioni elevate per effettuare la configurazione in modo sicuro. Guarda un video con la procedura dettagliata sulla configurazione e l’acquisizione.

https://video.tv.adobe.com/v/341387/?captions=ita&quality=12&learn=on

L’immagine seguente illustra le varie fasi in cui gli amministratori acquisiscono le risorse in Adobe Experience Manager da un archivio dati. L’acquisizione procede attraverso una pipeline gestita in cui le risorse vengono lette dall’archiviazione dell’oggetto connesso, trasferite ed elaborate in Experience Manager, garantendo la gestione affidabile dei batch di grandi dimensioni:

Strumento di acquisizione in blocco

Prerequisiti

Per utilizzare questa funzionalità è necessario un account di archiviazione esterno o un bucket da Microsoft Azure o Amazon Web Services (AWS). Il processo di importazione in blocco legge le risorse di origine direttamente da questo account esterno, pertanto una posizione di archiviazione Azure o AWS configurata correttamente è una condizione preliminare obbligatoria.

NOTE
Crea il contenitore o il bucket dell'account di archiviazione come private e accetta connessioni solo da richieste autorizzate. La configurazione dell’archiviazione come privata limita l’accesso a chiamanti attendibili e autenticati, proteggendo le risorse di origine da accessi non autorizzati durante l’acquisizione. Tuttavia, non sono supportate ulteriori restrizioni sulle connessioni di rete in ingresso.
NOTE
Gli account di archiviazione esterni possono applicare regole di denominazione di file e cartelle diverse rispetto allo strumento Importazione in blocco. Consulta Gestione dei nomi di file durante l'importazione in blocco per ulteriori dettagli sui nomi non consentiti e con escape.

Configurare lo strumento Importazione in blocco configure-bulk-ingestor-tool

Per configurare lo strumento Importazione in blocco in Adobe Experience Manager, eseguire la procedura seguente:

  1. Passa a Strumenti > Assets > Importazione in blocco. Selezionare l’opzione Crea.

  2. Specifica un titolo per la configurazione dell’importazione in blocco nel campo Titolo.

  3. Selezionare il tipo di origine dati dall’elenco a discesa Importa Source.

  4. Immetti i valori per creare una connessione con l’origine dati. Se ad esempio si seleziona Archiviazione BLOB di Azure come origine dati, specificare i valori per l’account di archiviazione di Azure, il contenitore BLOB di Azure e la chiave di accesso di Azure.

  5. Seleziona la modalità di autenticazione richiesta dall’elenco a discesa. Le due modalità differiscono per il livello di accesso concesso: La chiave di accesso di Azure fornisce un accesso completo e senza restrizioni all’account di archiviazione di Azure, mentre il token SAS di Azure consente all’amministratore di limitare le funzionalità del token utilizzando le autorizzazioni e i criteri di scadenza. Di conseguenza, Azure SAS Token è l’opzione più restrittiva e concede solo l’accesso con ambito e limiti di tempo.

  6. Immetti il nome della cartella principale che contiene le risorse nell’origine dati nel campo Cartella di origine.

  7. (Facoltativo) Specifica la dimensione minima del file delle risorse in MB da includere nel processo di acquisizione nel campo Filtra per dimensione minima.

  8. (Facoltativo) Specifica la dimensione massima in MB del file delle risorse da includere nel processo di acquisizione del campo Filtra per dimensione max.

  9. (Facoltativo) Specifica un elenco separato da virgole di tipi MIME da escludere dall’acquisizione nel campo Escludi tipi MIME. I tipi MIME identificano il formato file di ciascuna risorsa, pertanto questo filtro consente di saltare i formati che non desideri importare. Ad esempio, image/jpeg, image/.*, video/mp4. Vedi tutti i formati di file supportati.

  10. Specifica un elenco separato da virgole di tipi MIME da includere nell’acquisizione nel campo Includi tipi MIME. Vedi tutti i formati di file supportati.

  11. Selezionare l’opzione Elimina file di origine dopo l’importazione per eliminare i file originali dall’archivio dati di origine dopo l’importazione in Experience Manager. In questo modo viene recuperata l’archiviazione nell’archivio dati di origine e si impedisce la reimportazione degli stessi file nelle esecuzioni successive.

  12. Seleziona la Modalità di importazione. Seleziona Ignora, Sostituisci o Crea versione. La modalità predefinita è Ignora: poiché nella destinazione esiste già una risorsa corrispondente, l’importazione viene ignorata dall’utente che acquisisce il contenuto, impedendo la sovrascrittura del contenuto esistente. Vedere il significato di sostituisci e crea opzioni di versione.

  13. Per definire il percorso in Digital Asset Management (DAM) in cui Experience Manager importa le risorse, specifica un percorso nel campo Cartella di Assets Target. Esempio: /content/dam/imported_assets.

  14. (Facoltativo) Specifica il file di metadati da importare, fornito in formato CSV, nel campo File di metadati. Specifica il file CSV nel percorso del BLOB di origine e fai riferimento al percorso durante la configurazione dello strumento Importazione in blocco. Il formato di file CSV a cui si fa riferimento in questo campo è lo stesso del formato di file CSV utilizzato quando Importa ed esporta metadati di risorse in blocco. Se si seleziona l’opzione Elimina file di origine dopo l’importazione, filtrare i file CSV utilizzando i campi Escludi o Includi tipo MIME o il campo Filtra per percorso/file, in quanto in questo modo si impedisce l’eliminazione o l’acquisizione del file CSV dei metadati come risorsa. È possibile utilizzare un’espressione regolare per filtrare i file CSV in questi campi.

  15. Fai clic su Salva per salvare la configurazione.

Gestire la configurazione dello strumento Importazione in blocco manage-bulk-import-configuration

Dopo aver creato una configurazione dello strumento Importazione in blocco, puoi convalidarla e valutarla prima di acquisire in blocco le risorse nell’istanza Experience Manager. La gestione della configurazione in questa fase ti consente di esaminarne le impostazioni, confermare la connessione all’origine della risorsa e testare la configurazione. In questo modo la configurazione si comporta come previsto e si evitano errori di acquisizione prima che le risorse vengano importate su larga scala.

Accedere alle opzioni di gestione della configurazione access-configuration-management-options

Per visualizzare le opzioni disponibili per la gestione della configurazione dello strumento Importazione in blocco, passa a Strumenti > Assets > Importazione in blocco, quindi seleziona la configurazione da gestire. La selezione della configurazione fa emergere le azioni di gestione disponibili per quella specifica configurazione, consentendo di esaminare, valutare e regolare la configurazione prima di avviare un’importazione in blocco completa. Poiché la valutazione viene eseguita prima dell’acquisizione, è possibile identificare e risolvere anticipatamente i problemi di configurazione, riducendo il rischio di importazioni di risorse non riuscite o incomplete.

Modificare la configurazione edit-configuration

Per modificare i dettagli di configurazione, effettua le seguenti operazioni:

  1. Seleziona la configurazione da modificare.
  2. Fai clic su Modifica per aprire la configurazione in modalità di modifica.
  3. Aggiorna i dettagli della configurazione modificabile come richiesto, quindi salva le modifiche.

Due campi rimangono fissi e non possono essere modificati durante l’operazione di modifica: title della configurazione e import data source. Questi valori sono bloccati perché definiscono l’identità della configurazione e l’origine dei dati importati. Una loro modifica dopo la creazione causerebbe l’interruzione dei riferimenti stabiliti al momento della configurazione. Tutti gli altri dettagli di configurazione rimangono disponibili per la modifica, consentendo di perfezionare le impostazioni senza ricreare la configurazione da zero.

Elimina la configurazione delete-configuration

Se si elimina una configurazione di importazione in blocco, questa viene rimossa definitivamente dall’elenco delle configurazioni disponibili. Elimina una configurazione quando non è più necessaria, quando è stata creata per errore o quando desideri sostituirla con una configurazione aggiornata.

Per eliminare una configurazione di importazione in blocco, effettua le seguenti operazioni:

  1. Seleziona la configurazione da rimuovere dall’elenco delle configurazioni di importazione in blocco.
  2. Fai clic su Elimina.

Questa azione rimuove la configurazione Importazione in blocco selezionata. Poiché l’eliminazione di una configurazione comporta la rimozione delle impostazioni salvate, prima di confermare l’eliminazione controllare attentamente la configurazione selezionata per assicurarsi di non rimuovere quella ancora in uso.

Convalidare la connessione all’origine dati validate-connection

La convalida della connessione conferma che Experience Manager può raggiungere l’origine dati e che le credenziali e i parametri di connessione forniti sono corretti prima dell’utilizzo della configurazione. L’esecuzione di questo controllo evita innanzitutto gli errori a valle causati da endpoint non raggiungibili o da autenticazione non valida.

Per convalidare la connessione all’origine dati, eseguire la procedura seguente:

  1. Seleziona la configurazione da convalidare.
  2. Fai clic su check.

Quando la connessione ha esito positivo, Experience Manager visualizza un messaggio di conferma che indica che la connessione all’origine dati è stata stabilita. Questo messaggio verifica che la configurazione sia valida e pronta per essere utilizzata.

Messaggio di completamento importazione in blocco

Risoluzione dei problemi di connessione non riuscita troubleshoot-connection

Se la convalida non riesce, Experience Manager visualizza un messaggio di errore invece della conferma del completamento. Per risolvere una connessione non riuscita, verificare quanto segue:

  • Dettagli connessione: Verificare che i valori dell’host, della porta e dell’endpoint nella configurazione siano immessi correttamente.
  • Credenziali: Verificare che il nome utente, la password o il token di autenticazione forniti per l’origine dati siano validi e aggiornati.
  • Accesso alla rete: Verificare che Experience Manager possa raggiungere l’origine dati tramite la rete e che i firewall o le regole di sicurezza non blocchino la connessione.

Dopo aver corretto la configurazione, fare di nuovo clic su check per eseguire nuovamente la convalida. Ripeti questo processo fino a quando il messaggio di operazione riuscita non conferma che la connessione è stata stabilita.

Richiama un’esecuzione dei test per il processo di importazione in blocco invoke-test-run-bulk-import

Selezionare la configurazione e fare clic su Esegui prova per richiamare un’esecuzione dei test per il processo di importazione in blocco. Una Dry Run convalida la configurazione dell’importazione in blocco selezionata e la relativa connessione di origine senza importare risorse, consentendo di verificare che le impostazioni siano corrette prima di eseguire il commit a un’importazione completa. L’esecuzione di un test riduce innanzitutto il rischio di importazioni parziali o non riuscite, in quanto genera problemi di configurazione o connettività in anticipo rispetto al processo effettivo.

Al termine dell’esecuzione dei test, Experience Manager visualizza i dettagli seguenti sul processo di importazione in blocco:

  • Stato connessione — se Experience Manager si connette correttamente al percorso di origine configurato utilizzando le credenziali fornite.
  • Assetsha rilevato — il numero di risorse trovate nel percorso di origine che corrispondono ai criteri di importazione.
  • Ambito di importazione stimato: una panoramica del contenuto che verrebbe importato, in modo da poter verificare la configurazione per i file desiderati.
  • Avvisi o errori — qualsiasi problema, ad esempio percorsi non raggiungibili, credenziali non valide o risorse non supportate, che impedirebbe un’importazione corretta.

Risultato esecuzione di prova

Rivedi questi dettagli per confermare che la configurazione è corretta. Se l’Esecuzione in prova riporta errori o avvisi, risolverli ed eseguire di nuovo il test prima di avviare il processo di importazione in blocco effettivo.

Gestione dei nomi dei file durante l’importazione in blocco filename-handling-bulkimport

Quando importi risorse o cartelle in blocco, Experience Manager Assets importa l’intera struttura di ciò che esiste nell’origine di importazione. Experience Manager segue le regole predefinite per i caratteri speciali nei nomi delle risorse e delle cartelle, pertanto questi nomi di file devono essere sottoposti a bonifica. In questo modo i nomi importati sono conformi alle regole dell’archivio e non interrompono i percorsi delle risorse. Sia per il nome della cartella che per il nome della risorsa, il titolo definito dall’utente rimane invariato ed è memorizzato nella proprietà jcr:title di Java Content Repository (JCR), che mantiene il titolo leggibile dall’utente indipendentemente dal nome tecnico bonificato.

Durante l’importazione in blocco, Experience Manager cerca le cartelle esistenti per evitare di reimportare le risorse e le cartelle e verifica inoltre le regole di bonifica applicate nella cartella padre in cui viene effettuata l’importazione. Se le regole di bonifica vengono applicate nella cartella principale, le stesse regole vengono applicate all’origine di importazione. Per le nuove importazioni, per gestire i nomi file di risorse e cartelle vengono applicate le seguenti regole di bonifica.

Nomi non consentiti nell’importazione in blocco

I seguenti caratteri sono non consentiti nei nomi di file e cartelle:

  • Caratteri di controllo e uso privato (da 0x00 a 0x1F, \u0081, \uE000)
  • Nomi di file o cartelle che terminano con un punto (.)

Di conseguenza, i file o le cartelle con nomi corrispondenti a queste condizioni vengono ignorati durante il processo di importazione e contrassegnati come non riusciti.

Gestione del nome della risorsa nell’importazione in blocco

Per i nomi file delle risorse, Experience Manager bonifica il nome e il percorso JCR utilizzando l’API: JcrUtil.escapeIllegalJcrChars.

  • I caratteri Unicode non vengono modificati

  • Sostituire i caratteri speciali con il relativo codice di escape URL. Ad esempio, new%asset.png è aggiornato a new%25asset.png:

    code language-none 
                    URL escape code

"               %22
%               %25
'               %27
*               %2A
/               %2F
:               %3A
[               %5B
\n              %0A
\r              %0D
\t              %09
]               %5D
|               %7C

Gestione del nome della cartella nell’importazione in blocco

Per i nomi di file della cartella, Experience Manager bonifica il nome e il percorso JCR utilizzando l’API: DamUtil.getSanitizedFolderName.

  • I caratteri maiuscoli vengono convertiti in minuscoli

  • I caratteri Unicode non vengono modificati

  • Sostituire i caratteri speciali con un trattino (‘-’). Ad esempio, new folder è aggiornato a new-folder:

    code language-none 
    "
#
%
&
*
+
.
:
;
?
[
]
^
{
}
|
/         It is used for split folder in cloud storage and is pre-handled, no conversion here.
\         Not allowed in Azure, allowed in AWS.
\t
space     It is the space character.

Pianificare un’importazione in blocco una tantum o ricorrente schedule-bulk-import

Per pianificare un’importazione in blocco una tantum o ricorrente, effettua le seguenti operazioni:

  1. Crea una configurazione di importazione in blocco.

  2. Seleziona la configurazione e seleziona Pianifica dalla barra degli strumenti.

  3. Imposta un’acquisizione una tantum o una pianificazione oraria, giornaliera o settimanale. Fai clic su Invia. I programmi ricorrenti garantiscono che le nuove risorse nell’origine di importazione vengano acquisite automaticamente all’intervallo definito senza la riesecuzione manuale.

    Pianifica processo di acquisizione in blocco

Visualizza la cartella di destinazione Assets view-assets-target-folder

Per visualizzare il percorso di destinazione Assets in cui vengono importate le risorse dopo l’esecuzione del processo di importazione in blocco, selezionare la configurazione e quindi fare clic su Visualizza Assets.

Eseguire lo strumento Importazione in blocco run-bulk-import-tool

Dopo la configurazione dello strumento Importazione in blocco e, facoltativamente, la gestione della configurazione dello strumento Importazione in blocco, gli amministratori possono eseguire il processo di configurazione per avviare l’acquisizione in blocco delle risorse.

Per avviare il processo di importazione in blocco, passare a Strumenti > Assets > Importazione in blocco, selezionare la Configurazione importazione in blocco, quindi fare clic su Esegui. Fai di nuovo clic su Esegui per confermare.

Experience Manager aggiorna lo stato del processo a Elaborazione e a Completata al completamento del processo. Per visualizzare le risorse importate in Experience Manager, fare clic su VisualizzaAssets.

Durante l’esecuzione del processo, puoi controllare il processo di acquisizione come segue:

  • Interrompi — seleziona la configurazione e fai clic su Interrompi per interrompere il processo di acquisizione in blocco.
  • Esegui — Fare di nuovo clic su Esegui per riprendere il processo dal punto in cui è stato interrotto.
  • Dry Run — Fare clic su Dry Run per visualizzare i dettagli delle risorse ancora in attesa di importazione, senza confermare l’acquisizione. Questo consente agli amministratori di verificare l’ambito dell’importazione prima che venga completata.

Gestisci processi dopo l’esecuzione manage-jobs-after-execution

Experience Manager consente di visualizzare la cronologia dei processi di importazione in blocco. La cronologia processo include lo stato del processo, l’autore del processo, i registri e altri dettagli quali la data e l’ora di inizio, la data e l’ora di creazione e la data e l’ora di fine. Questa cronologia fornisce un audit trail completo, consentendo agli amministratori di monitorare, risolvere e verificare ogni operazione di importazione in blocco.

Visualizzazione della cronologia dei processi per una configurazione di importazione in blocco viewing-job-history

La visualizzazione Cronologia processi consente di esaminare i record di esecuzione per una configurazione di importazione in blocco specifica, fornendo visibilità sulle esecuzioni di importazione precedenti e sui relativi risultati. Per accedere alla cronologia dei processi per una configurazione:

  1. Seleziona la configurazione di cui desideri rivedere la cronologia.
  2. Fare clic su Cronologia processi.
  3. Seleziona un processo specifico dall’elenco.
  4. Fai clic su Apri per visualizzare i dettagli completi del processo.

Pianifica processo di acquisizione in blocco

Adobe Experience Manager visualizza la cronologia dei processi, consentendo di controllare lo stato e i risultati di ogni processo di importazione in blocco registrato. L’analisi di questa cronologia è utile per verificare che le importazioni siano state completate correttamente e per risolvere eventuali processi non completati come previsto.

Nella pagina della cronologia dei processi di importazione in blocco è inoltre possibile fare clic su Elimina per rimuovere tale processo dalla configurazione. L’eliminazione di un processo rimuove il record dalla cronologia dei processi per la configurazione dell’importazione in blocco, consentendo di mantenere pulito l’elenco della cronologia e di concentrarsi sulle esecuzioni pertinenti.

Caricare risorse tramite client desktop upload-assets-desktop-clients

Adobe Experience Manager supporta due client desktop per il caricamento delle risorse, Adobe Asset Link e l’app desktop Experience Manager, oltre all’interfaccia utente del browser Web. Entrambi i client desktop consentono il caricamento diretto delle risorse senza aprire un browser web.

  • Adobe Asset Link fornisce accesso diretto a Experience Manager risorse dalle applicazioni desktop Adobe Photoshop, Adobe Illustrator e Adobe InDesign. Il documento attualmente aperto viene caricato in Experience Manager direttamente dall’interfaccia Adobe Asset Link, senza uscire da Photoshop, Illustrator o InDesign.
  • L’app desktop Experience Manager semplifica la gestione delle risorse sul desktop, indipendentemente dal tipo di file o dall’applicazione nativa che gestisce ogni risorsa. L’app desktop è il client preferito per il caricamento di file in gerarchie di cartelle nidificate dal file system locale, perché il caricamento del browser supporta solo elenchi di file flat. Di conseguenza, quando è importante mantenere la struttura delle cartelle, l’app desktop Experience Manager carica l’intera gerarchia in una singola operazione, mentre il browser richiede prima di tutto di appiattire i file.

Elabora risorse quando caricate process-when-uploaded

Applica profili di elaborazione alle cartelle di caricamento per eseguire elaborazioni aggiuntive sulle risorse caricate. Questi profili sono disponibili nella pagina Proprietà di una cartella in Assets e determinano il modo in cui ogni risorsa viene trasformata dopo essere stata aggiunta alla cartella.

Proprietà di una cartella di risorse con opzioni per aggiungere un profilo di elaborazione

Una risorsa digitale senza un’estensione o con un’estensione non corretta non viene elaborata come desiderato. Di conseguenza, durante il caricamento di tali risorse, potrebbe non accadere nulla o potrebbe essere applicato un profilo di elaborazione errato, perché il sistema si basa sull’estensione del file per selezionare il profilo corretto. Gli utenti possono comunque memorizzare i file binari nell’archivio Digital Asset Management (DAM), anche quando il profilo corretto non viene eseguito automaticamente.

Sono disponibili le seguenti schede:

  • I profili metadati applicano le proprietà metadati predefinite alle risorse caricate in tale cartella, garantendo metadati coerenti e ricercabili in tutta la cartella.
  • I profili di elaborazione generano più rappresentazioni di quanto sia possibile per impostazione predefinita, estendendo il set di versioni derivate prodotte da ogni risorsa di origine.

Inoltre, se Dynamic Media è abilitato nella distribuzione, sono disponibili le seguenti schede aggiuntive:

NOTE
Il ritaglio di Dynamic Media e altre operazioni sulle risorse sono non distruttive, il che significa che le operazioni non modificano l'originale caricato. Al contrario, Dynamic Media fornisce parametri per ritagliare o trasformare le risorse al momento della consegna. In questo modo il binario di origine rimane intatto e può essere riutilizzato per altre rappresentazioni.

Per le cartelle a cui è assegnato un profilo di elaborazione, il nome del profilo viene visualizzato sulla miniatura nella vista a schede. Nella vista a elenco, il nome del profilo viene visualizzato nella colonna Profilo di elaborazione.

Caricare o acquisire risorse tramite API upload-using-apis

La sezione asset upload della guida di riferimento per sviluppatori fornisce i dettagli tecnici completi delle API di caricamento e del protocollo, insieme ai collegamenti a un software Development Kit (SDK) open-source e a client di esempio. Queste API consentono agli sviluppatori di caricare o acquisire le risorse a livello di programmazione, abilitando flussi di lavoro automatizzati e ripetibili anziché caricamenti manuali. I client open-source SDK e di esempio accelerano l’integrazione fornendo implementazioni di riferimento pronte all’uso che mostrano come funziona in pratica il protocollo di caricamento.

Sicurezza e best practice per il caricamento delle risorse asset-upload-security-and-best-practices

La sicurezza di caricamento delle risorse regola il modo in cui i file inviati da utenti o sistemi vengono convalidati, analizzati, archiviati e serviti, proteggendo un’applicazione da contenuti dannosi, danneggiamento dei dati e utilizzo non corretto dell’archiviazione o della larghezza di banda. La protezione della pipeline di caricamento è ampiamente considerata essenziale, perché i caricamenti senza restrizioni o scarsamente convalidati sono tra i vettori più comuni per l’iniezione di malware, l’esecuzione di codice non autorizzato e l’esaurimento delle risorse server.

Controlli di sicurezza del caricamento core core-upload-security-controls

Un’efficace sicurezza per il caricamento delle risorse si basa su controlli a più livelli applicati in ogni fase del ciclo di vita del caricamento. I controlli chiave includono:

  • Convalida del tipo di file: verificare ogni caricamento in base a un elenco Consentiti di esplicito dei formati consentiti anziché a un inserisco nell’elenco Bloccati di, poiché è molto più difficile ignorare e impedire lo slittamento del contenuto eseguibile mascherato tramite i inserisce nell’elenco Consentiti di.
  • Limiti dimensioni file — Applica soglie dimensioni massime per evitare condizioni di rifiuto del servizio causate da caricamenti di dimensioni eccessive che potrebbero esaurire lo spazio su disco o la memoria.
  • Ispezione del contenuto - Analizzare la firma effettiva del file (byte magici) invece di considerare attendibile l’estensione del file o il tipo MIME (Multipurpose Internet Mail Extensions) fornito dal client, poiché gli autori di attacchi sfruttano regolarmente le estensioni per mascherare i file dannosi.
  • Analisi malware: esegui le risorse caricate tramite l’analisi antivirus o antimalware prima di renderle disponibili, garantendo che i file infetti vengano messi in quarantena anziché distribuiti ad altri utenti.
  • Eliminazione dei nomi di file: rimuovere o normalizzare i caratteri speciali, i separatori di percorso e le sequenze di controllo dai nomi di file per evitare attacchi di attraversamento dei percorsi e di escape delle directory.

Applica queste best practice in sequenza per rafforzare il flusso di lavoro di caricamento:

  1. Convalida sul server - Considera tutte le convalide lato client solo come consigliere e applica ogni controllo lato server, perché i controlli lato client possono essere ignorati da un attore dannoso.
  2. Memorizzare le risorse all’esterno della directory principale del Web. Mantenere i file caricati in un percorso che non può essere eseguito direttamente dal server Web, impedendo a un utente malintenzionato di eseguire uno script caricato come codice.
  3. Rinomina file caricati — Assegna identificatori non prevedibili generati dal server ai file archiviati per evitare la sovrascrittura delle risorse esistenti e impedire l’enumerazione del contenuto archiviato.
  4. Limita le autorizzazioni — Concedi ai file caricati le autorizzazioni minime di lettura e scrittura richieste e non contrassegnarli mai come eseguibili, in modo da impedire l’esecuzione di un file compromesso.
  5. Autenticazione e autorizzazione dei caricamenti - Verificare che l’utente richiedente disponga dell’autorizzazione per il caricamento, limitando l’esposizione ad abusi anonimi e invii non autorizzati.
  6. Limite di frequenza e limitazione: applica limiti di velocità di caricamento per utente o per sessione per ridurre il rischio di abuso automatico e esaurimento delle risorse.

Gestione e archiviazione dopo il caricamento handling-and-storage-after-upload

Le responsabilità di protezione continuano dopo l’accettazione di un file. Per proteggere le risorse durante l’archiviazione e la consegna:

  • Distribuire le risorse tramite connessioni crittografate — Distribuire il contenuto caricato tramite HTTPS (Hypertext Transfer Protocol Secure) in modo che i file non possano essere intercettati o manomessi durante il transito.
  • Individua i contenuti generati dall’utente. Distribuisci i caricamenti non attendibili da un dominio separato o da una rete CDN (Content Delivery Network) dedicata, perché l’isolamento di tali contenuti limita l’impatto degli attacchi di vulnerabilità cross-site scripting e di furto dei cookie.
  • Impostare intestazioni di risposta corrette — Restituire intestazioni precise di Content-Type e forzare i download, se necessario, in modo che i browser non interpretino erroneamente ed eseguano un file archiviato.
  • Caricamenti del registro e del controllo: registra i metadati di caricamento e gli eventi di accesso, per supportare l’analisi degli incidenti e rilevare tempestivamente i pattern di abuso.

Seguendo questi controlli e le best practice si stabilisce un approccio di difesa approfondito al caricamento delle risorse, riducendo il rischio che un singolo controllo non eseguito porti a un compromesso completo.

Caricamento binario diretto con URL predefiniti direct-binary-upload

Adobe Experience Manager (AEM) come Cloud Service carica le risorse tramite un flusso Direct Binary Upload, una sequenza in tre passaggi: (1) un client richiede un URL preceduto, (2) il binario viene caricato direttamente nell’archiviazione utilizzando tale URL e (3) la risorsa viene finalizzata con una chiamata API autenticata. Questa progettazione consente di scaricare il trasferimento binario di grandi dimensioni direttamente sullo storage, mantenendo al contempo la registrazione delle risorse sotto controllo autenticato.

Durata e riutilizzo degli URL url-lifetime-and-reuse

  • Gli URL presentati hanno breve durata e restano validi per circa un’ora. Tuttavia, il valore esatto Time to Live (TTL) non è un Service level agreement (SLA) pubblicato o garantito. Considera la durata come un dettaglio di implementazione che può cambiare e non richiede il codice rigido del valore nelle integrazioni.
  • Un URL prefirmato deve essere utilizzato immediatamente come parte di una singola sessione di caricamento. Non è progettato per essere archiviato e riutilizzato in un secondo momento e non è concepito per essere riutilizzabile in più caricamenti. Ogni sessione di caricamento ottiene il proprio URL.

Sicurezza degli URL prefirmati security-of-presigned-urls

  • La sola perdita di un URL prefirmato non è sufficiente per creare una risorsa, perché la creazione e la finalizzazione delle risorse dipendono da una chiamata API autenticata separata che utilizza credenziali valide e un uploadToken. Se un attore ottiene solo l’URL predefinito, non può completare la registrazione delle risorse senza un’autenticazione valida e il token di caricamento associato.
  • Questo requisito di autenticazione limita l’impatto pratico di un URL trapelato: le credenziali richieste e uploadToken fungono da secondo controllo, pertanto l’esposizione dell’URL di per sé non consente la registrazione di una risorsa non autorizzata.
  • Tratta gli URL prefirmati come valori sensibili nelle tue integrazioni. Evita di registrarli, usa sempre HTTPS e non renderli persistenti oltre la sessione di caricamento.

Autenticazione per caricamenti programmatici authentication-for-programmatic-uploads

Solo Le credenziali del servizio (JWT) supportano il caricamento programmatico di risorse in Adobe Experience Manager (AEM). Esistono due meccanismi di autenticazione per l’accesso alle API di AEM: non intercambiabili per le operazioni di caricamento delle risorse. La scelta di un tipo di credenziali errato è la causa più comune di integrazioni di caricamento non riuscite.

Tipo di credenziali
Dove viene generato
Se è supportato per l’API di caricamento risorse
Credenziali server-to-server (S2S) OAuth
Console per sviluppatori di Adobe
non supportato per le chiamate API di caricamento risorse. Poiché l’API Asset Upload rifiuta questo tipo di credenziali in modo definitivo, l’utilizzo di tali credenziali determina errori 403 Forbidden persistenti anche con un profilo di prodotto assegnato correttamente (ad esempio, Assets utenti Collaborator).
Credenziali servizio (JWT)
AEM Developer Console
è supportato per le chiamate API di caricamento risorse da server a server.
NOTE
La precedente API HTTP della risorsa per l’aggiornamento diretto del binario di una risorsa è obsoleta. Le nuove integrazioni utilizzano invece il flusso Direct Binary Upload, che è il metodo corrente e supportato per trasferire a livello di programmazione i file binari delle risorse in AEM.

L’account tecnico utilizzato per i caricamenti API deve disporre di elenchi di controllo di accesso (ACL) espliciti a livello di repository concessi a livello di percorso. Sono necessarie due autorizzazioni ACL:

  • jcr:read il /content/dam — concede l’accesso in lettura alla directory principale del contenuto di Digital Asset Management (DAM).
  • rep:write (o jcr:all) nella sottocartella di destinazione specifica — concede l’accesso in scrittura al percorso di destinazione in cui vengono caricate le risorse.

Questi ACL a livello di percorso sono necessari oltre al tipo di credenziali corretto e al profilo di prodotto o all’appartenenza al gruppo della console dell’amministratore corretti.

Un account tecnico può essere correttamente concesso in licenza e raggruppato e ricevere comunque 403 errori non consentiti. Ciò si verifica perché l’assegnazione del profilo di prodotto o del gruppo e gli ACL dell’archivio sono controlli indipendenti e entrambi sono obbligatori. Di conseguenza, se gli ACL a livello di percorso non sono stati concessi, all’account verrà negato l’accesso anche quando il tipo di credenziali e il profilo di prodotto sono configurati correttamente.

Rilevamento e quarantena di malware malware-detection-and-quarantine

Rilevamento malware in Adobe Experience Manager (AEM) analizza ogni file caricato e sposta i file infetti in un’area dedicata Quarantena, isolando le risorse sospette dal resto dell’archivio. Quando il rilevamento malware è attivato, il sistema esegue la scansione di ogni caricamento quando arriva e, dopo aver rilevato un’infezione, mette in quarantena il file automaticamente. In questo modo la minaccia viene isolata dai flussi di lavoro attivi e le risorse infette non possono essere pubblicate, scaricate o distribuite ad altri utenti.

L’accesso alle risorse messe in quarantena è disciplinato dalle autorizzazioni standard Adobe Experience Manager (AEM), applicate tramite un gruppo dedicato di amministratori di quarantena. Poiché la visibilità della quarantena non è associata a un singolo ruolo fisso, l’accesso può essere esteso in modo flessibile:

  • Per impostazione predefinita, i membri del gruppo Amministratori quarantena dispongono dell’accesso alle risorse messe in quarantena.
  • È possibile concedere l’accesso all’area di quarantena a gruppi personalizzati aggiuntivi quando i requisiti operativi o di sicurezza richiedono una supervisione più ampia.
  • Più gruppi possono pertanto mantenere la visibilità in quarantena contemporaneamente, anziché limitare la funzionalità a un solo ruolo.

Questo modello di autorizzazione garantisce che solo gli utenti autorizzati possano esaminare, rilasciare o rimuovere contenuti in quarantena, mantenendo un processo di revisione controllato per i file potenzialmente dannosi.

Per ulteriori informazioni sul rilevamento e la quarantena di malware, vedere Rilevamento malware.

Gestione dei tipi di file e restrizioni di caricamento file-type-handling-and-upload-restrictions

  • Adobe Experience Manager (AEM) non impone restrizioni predefinite per i tipi di file per i caricamenti. È possibile caricare file con estensioni eseguibili (ad esempio, .exe o .exe.pdf) come rappresentazioni di risorse.
  • Si tratta di un comportamento previsto, non di una vulnerabilità. AEM non esegue il rendering o l’esecuzione di contenuto attivo o script caricati, né nel browser né nel server. Poiché i file caricati vengono archiviati e utilizzati solo come rappresentazioni di risorse inerti anziché come codice, il caricamento di un file eseguibile non crea di per sé un rischio di esecuzione del codice remoto (RCE) nel modello di sicurezza predefinito di AEM. Le organizzazioni con requisiti di conformità più severi devono applicare la propria convalida di caricamento o inserire nell’elenco Consentiti se necessario, in quanto AEM non applica questa regola in modalità nativa e lascia tali controlli all’organizzazione di distribuzione.
  • I formati di file supportati e i tipi MIME (Multipurpose Internet Mail Extensions) per l’elaborazione delle risorse sono documentati separatamente. I tipi non supportati non vengono completamente elaborati, il che significa che tali file non supportati potrebbero non generare le rappresentazioni previste.

Best practice per il caricamento dell’affidabilità upload-reliability-best-practices

Ottimizzare le risorse prima del caricamento optimize-assets-before-upload

  • Per i tipi di risorse di grandi dimensioni o specializzate come video, PDF e GIF, segui i limiti di dimensione file consigliati, le impostazioni di codifica e i formati preferiti. Il rispetto di queste specifiche impedisce l’impatto sulle prestazioni della piattaforma durante il caricamento, l’elaborazione e la generazione di anteprima, perché file di dimensioni eccessive o non standard comportano il carico più pesante sui passaggi di transcodifica e generazione di miniature.

Utilizzare i percorsi di caricamento supportati per i file business-critical use-supported-upload-paths

  • Utilizza le API di caricamento o i flussi di interfaccia utente supportati per i file business-critical anziché caricamenti collettivi a livello di cartella ad hoc. I percorsi supportati applicano convalida, codifica e gestione degli errori coerenti, che li rendono la scelta più affidabile per i file che non possono tollerare il danneggiamento o la perdita.
  • I caricamenti di trascinamento della selezione a livello di cartella causano occasionalmente danneggiamento del file, per casi segnalati. Di conseguenza, non sono consigliati per le risorse critiche.

Se un caricamento a livello di cartella non riesce o danneggia un file folder-level-upload-fails

Acquisisci subito le prove, perché la causa sottostante è spesso specifica per l’ambiente o per il file e diventa difficile da diagnosticare dopo il fatto, una volta che tali prove vengono perse.

  1. Registra il messaggio di errore esatto o il comportamento osservato non appena si verifica.
  2. Acquisisci screenshot dello stato di errore ed eventuali finestre di dialogo di errore.
  3. Salvare un file di archivio HTTP (HAR) o registri di rete dalla sessione del browser, poiché acquisiscono i dettagli di richiesta/risposta necessari per tracciare l’errore.
  4. Mantenere il file interessato in modo che possa essere testato nuovamente in base al percorso di caricamento supportato.

L’acquisizione immediata di queste prove fornisce ai team di supporto e tecnici i dettagli specifici dell’ambiente e dei file necessari per riprodurre e risolvere il problema, mentre il tentativo di diagnosticare il danneggiamento dopo il fatto, senza registri o l’errore originale, è spesso poco pratico.

Elenco di controllo per la risoluzione dei problemi di caricamento troubleshooting-checklist-for-upload-failures

  1. 403 Non consentito durante il caricamento dell’API (Application Programming Interface): confermare prima il tipo di credenziali. Le credenziali OAuth S2S (server-to-server) da Adobe Developer Console sono non supportate per l’API di caricamento risorse. Utilizza le credenziali del servizio (JSON Web Token o JWT) emesse dalla console per sviluppatori Adobe Experience Manager (AEM). I due tipi di credenziali vengono forniti tramite console diverse e concedono ambiti diversi. Per questo motivo la sostituzione di uno dei due tipi di credenziali genera un 403 Non consentito anche quando l’account appare valido.

  2. 403 Non consentito nonostante le credenziali corrette e l’appartenenza al gruppo: confermare che l’account tecnico contiene jcr:read espliciti in /content/dam e rep:write/jcr:all nella cartella di destinazione specifica. L’appartenenza a un gruppo o a un profilo non sostituisce gli elenchi di controllo di accesso (ACL) a livello di cartella, perché AEM autorizza le scritture di risorse a livello di nodo dell’archivio anziché in base al solo ruolo. Di conseguenza, un account può appartenere al gruppo corretto ma essere comunque negato finché gli ACL a livello di nodo non vengono impostati sulla cartella di destinazione esatta.

  3. Il caricamento ha esito positivo, ma la risorsa non viene visualizzata o l’aspetto binario è danneggiato: escludi il caricamento bulk a livello di cartella come metodo di acquisizione. Riprova tramite l’API di caricamento standard o l’interfaccia utente (UI) e, se il problema si ripete, acquisisci i registri. I percorsi di acquisizione in blocco gestiscono i file binari in modo diverso rispetto all’API standard, pertanto isolare il metodo di acquisizione è il modo più veloce per determinare se il danneggiamento deriva dal percorso di caricamento stesso.

  4. Flag di revisione della sicurezza caricamento file senza restrizioni: chiarisci che AEM non esegue il contenuto attivo caricato lato server o nel browser per impostazione predefinita. Poiché tale contenuto non viene mai eseguito, il caricamento di file senza restrizioni è un comportamento previsto dalla piattaforma anziché un difetto: il rischio principale di contenuto attivo archiviato viene neutralizzato quando il contenuto non può essere eseguito. Ciò vale a meno che l’organizzazione non richieda una convalida aggiuntiva al momento del caricamento, nel qual caso tale convalida deve essere aggiunta come controllo dei criteri oltre al comportamento predefinito.

  5. Preoccupato per l’esposizione dell’URL prefirmato: un URL prefirmato è un collegamento preautorizzato a tempo limitato utilizzato per trasferire il binario direttamente nell’archivio. Conferma che l’URL è stato utilizzato entro la sua breve finestra di validità e che la finalizzazione della risorsa richiede ancora una chiamata autenticata separata con un uploadToken valido. Questa progettazione in due passaggi limita l’ambito di esposizione di un URL prefirmato trapelato (Uniform Resource Locator), perché il solo possesso dell’URL non può finalizzare una risorsa senza un uploadToken valido e autenticato separatamente. Di conseguenza, un URL che perde dopo la chiusura della finestra di validità non dispone di alcuna funzionalità di scrittura pratica.

Suggerimenti, best practice e limitazioni tips-limitations

  • Il caricamento binario diretto è un nuovo metodo per caricare le risorse. Per impostazione predefinita, è supportato dalle funzionalità e dai client del prodotto, inclusa l’interfaccia utente Experience Manager, Adobe Asset Link e l’app desktop Experience Manager. Qualsiasi codice personalizzato o esteso dai team tecnici di un cliente deve utilizzare le nuove API (Application Programming Interface) e i nuovi protocolli di caricamento.

  • Gestione cartelle di grandi dimensioni: Experience Manager Assetssupporta cartelle contenenti più di 1000 elementi figlio diretti (risorse o sottocartelle). Quando una cartella supera la soglia di 1000 elementi, l’interfaccia utente amministratore passa a un indice aggiornato in modo asincrono per elencare il contenuto della cartella. Poiché questo indice viene aggiornato in modo asincrono, le cartelle e le risorse appena create vengono visualizzate dopo un breve ritardo, in genere di pochi secondi. Quando si apre tale cartella nella visualizzazione Amministratore, un banner notifica agli utenti finali questo comportamento, indicando quanto segue: “Questa directory contiene 1000+ elementi. I caricamenti e le creazioni di nuove cartelle potrebbero subire ritardi.”

  • Sostituisci e rigenerazione ID risorsa: Quando si seleziona Sostituisci nella finestra di dialogo Conflitto nome, l’ID risorsa viene rigenerato per la nuova risorsa. Questo ID è diverso da quello della risorsa precedente. Se Assets Insights è abilitato per tenere traccia di impression o clic con Adobe Analytics, l’ID risorsa rigenerato invalida i dati acquisiti per la risorsa in Analytics, perché Analytics tiene traccia di impression e clic rispetto all’ID risorsa originale e non può riconciliare il nuovo ID con i record precedenti.

  • Caratteri non consentiti nei nomi file: Alcuni metodi di caricamento non impediscono agli utenti di caricare risorse con caratteri non consentiti nei nomi file. In questi casi, i caratteri non consentiti vengono sostituiti con il simbolo -.

  • Limitazione del caricamento del browser: Il caricamento di risorse tramite il browser supporta solo elenchi di file sequenziali e non gerarchie di cartelle nidificate. Per caricare tutte le risorse all’interno di una cartella nidificata, utilizza l’app desktop, che mantiene la struttura delle cartelle durante il trasferimento.

  • Struttura di cartelle di importazione in blocco: Il metodo di importazione in blocco importa l’intera struttura di cartelle così come esiste nell’origine dati. Tuttavia, solo le cartelle non vuote vengono create in Experience Manager, il che significa che le cartelle vuote nell’origine vengono omesse dalla gerarchia importata.

Consulta anche

Related Articles
recommendation-more-help
experience-manager-cloud-service-help-main-toc