[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

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.

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.

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

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