Importare in massa i progetti

Importa in massa i progetti se devi evitare l'inserimento manuale e dispendioso dei dati o migrarli da un altro sistema.

È possibile anche aggiornare più progetti contemporaneamente utilizzando le sessioni in Utilità di importazione in massa. Per maggiori informazioni, consultare Aggiornare in massa i progetti esistenti.

Come funziona

Apri una nuova sessione Utilità di importazione in massa e scarica il modello Excel dalla pagina Utilità di importazione in massa in Launchpad. Prepara i dati nel modello e successivamente caricalo nella pagina Utilità di importazione in massa.

Dove si trovano i progetti caricati?

Una volta che carichi i progetti, i dati sono disponibili nell'applicazione Progetti.

Flusso di lavoro

Autorizzazioni

Solo gli Amministratori di sistema possono caricare in massa le risorse Diligent One da Utilità di importazione in massa.

Caricare nuovi progetti in massa

Apri una nuova sessione di Utilità di importazione in massa e scarica il modello Excel

1. Apri Launchpad.

   Nota

   Se l'azienda utilizza più di un'istanza su Launchpad, assicurarsi che quella appropriata sia attiva.

2. Selezionare Impostazioni piattaforma > Organizzazione.

   Se non visualizzi l'opzione Organizzazione, l'account utilizzato per l'accesso non dispone dei privilegi di amministratore.

3. In Utilità di importazione in massa, fai clic su Gestisci le risorse in massa.

   Comincia una nuova sessione di Utilità di importazione in massa, con l'ID della sessione aggiunto all'URL.

   Attenzione

   Comincia sempre una nuova sessione per aggiungere nuove risorse, altrimenti potresti perdere i dati caricati in precedenza.

   Scopri di più

   Per esempio: vuoi importare 200 entità in due lotti (100 + 100). Se carichi i lotti uno dopo l'altro nella stessa sessione poi, dopo l'upload del secondo lotto, i dati caricati nel primo verranno sostituiti da quelli del secondo. Per evitare questa perdita di dati, carica il primo lotto in una sessione e inizia una nuova sessione per il loto successivo. Allo stesso modo, comincia una nuova sessione per aggiungere altre nuove risorse.

   Nota

   Puoi utilizzare le sessioni precedenti per aggiornare i dati caricati in precedenza. Per maggiori informazioni, consulta Aggiornare la funzionalità in Utilità di importazione in massa.

4. In Seleziona risorsa, seleziona una delle seguenti opzioni nel tipo di risorsa:

   • Progetti > Tipi di progetto: per creare progetti per tipo di progetto. Il modello è dinamico e ha configurazioni integrate del tipo di progetto selezionato. Utilizzando questa opzione, è possibile creare più risorse Diligent One (progetti, framework, obiettivi, rischi, controlli e mitigazioni) in base a un tipo di progetto.
   • Tutte le risorse: per importare in massa tutte le risorse contemporaneamente: progetti, framework, obiettivi, rischi, controlli, mitigazioni, issue, azioni, richieste, entità e mappe di conformità. Il modello è statico e ci vuole dello sforzo per completarlo, in quanto dovrai capire la configurazione delle risorse manualmente.
5. Fai clic su Scarica il modello.xlsx.

   Il modello di Excel si salva in computer locale.

Prepara i dati nel modello

1. Apri il modello scaricato e vai al foglio di lavoro Projects. Se si tratta di un modello dinamico, il nome del foglio di lavoro è una combinazione della risorsa e del suo ID di tipo di progetto. Per esempio: Projects-85692.
2. Copia e incolla o inserisci i dati nel modello. Per aiuto con l'inserimento dei dati, consulta Consigli per preparare i contenuti.
   Nota

   • Se utilizzi Add-in per Excel, assicurati che l'opzione ACL Add-In sia disabilitata prima di modificare il modello Excel. Per scoprire come farlo, consultare Configurare Add-In per Excel.
   • Non modificare il nome del foglio di lavoro o dei campi. Questi sono sensibili alle maiuscole e non devono essere modificati.
   • Il numero massimo di righe che possono essere caricate contemporaneamente è 2.000 (inclusi tutti i fogli di lavoro).

   Campo	Descrizione
   referenceId obbligatorio	Specifica un ID univoco per la risorsa. Deve essere univoco per ogni riga nel foglio di lavoro. Può contenere una combinazione di testo e numeri e la lunghezza massima è di 255 caratteri. Questo campo è la chiave primaria per ogni riga nel modello. Ne avrai bisogno se vuoi aggiornare nuovamente questa risorsa. Importante Puoi utilizzare gli ID di riferimento per associare le risorse l'una all'altra, al volo. Per esempio, puoi creare un nuovo progetto e un nuovo obiettivo associato a quel progetto nello stesso upload. Puoi farlo creando un collegamento tra il progetto e l'obiettivo fornendo il referenceId nel campo richiesto. Per scoprire di più sull'associazione delle risorse Diligent One su Utilità di importazione in massa, consultare Utilizzare gli ID di riferimento per collegare le risorse su Utilità di importazione in massa. Nota Quando si aggiungono o aggiornano le risorse utilizzando Utilità di importazione in massa vengono richiesti gli ID di riferimento. Non sono disponibili quando si aggiungono o si aggiornano le risorse dall'interfaccia utenti di Diligent One.
   name obbligatorio	Inserire un nome descrittivo per il progetto. La lunghezza massima è di 120 caratteri. Per informazioni sui progetti, consultare Creare progetti
   stato	Viene specificato lo stato attuale del progetto. Quelli che seguono sono gli stati disponibili. draft proposed active completed Quello predefinito è attivo. Nota Utilizza solo valori predefiniti inglesi per questo campo. I valori personalizzati inglesi e quelli localizzati (non inglesi) non sono ancora supportati in Utilità di importazione in massa. Per maggiori informazioni sugli stati dei progetti, consultare Configurare gli stati dei progetti.
   description	Viene specificata la descrizione dettagliata del progetto. Consiglio Utilizza i tag HTLM per formattare il testo. Per esempio: <b>, <i>, <ol>, <ul>. Per informazioni sui progetti, consultare Creare progetti
   Informazioni	Vengono specificate le circostanze contestuali del progetto.
   budget	Viene specificato il numero totale di ore che sono state allocate per il progetto.
   certificazione	Viene specificato lo stato della funzione Certificazioni per il progetto. True: abilitato. False: disabilitato. L'impostazione predefinita è False. Per maggiori informazioni, consultare Creare programmi di certificazione.
   managementResponse	Viene specificato la risposta della Direzione alla valutazione complessiva del progetto.
   maxSampleSize	Viene specificata la dimensione totale del campione suddivisa tra i cicli di testing, definita nel progetto. L'impostazione predefinita è 0. Questo campo dipende dal tipo di progetto, che è dipendente dal flusso di lavoro. Per maggiori informazioni, consultare Eseguire procedure e testare i controlli.
   numberOfTestingRounds	Viene specificato il numero di cicli di testing effettuati nel progetto. L'impostazione predefinita è 0. Questo campo dipende dal tipo di progetto, che è dipendente dal flusso di lavoro. Per maggiori informazioni, consultare Eseguire procedure e testare i controlli.
   opinion	Viene specificata la valutazione finale del risultato del progetto.
   opinionDescription	Viene specificata una dichiarazione formale in merito al risultato del progetto, inclusi osservazioni e raccomandazioni.
   purpose	Vengono specificati i risultati, gli obiettivi o gli scopi previsti del progetto.
   startDate obbligatorio	Viene specificata la data in cui è pianificato l'inizio del progetto. La data deve essere nel formato AAAA/MM/GG
   targetDate obbligatorio	Viene specificata la data in cui è pianificato il completamento del progetto. La data deve essere nel formato AAAA/MM/GG
   projectTypeId obbligatorio (solamente modello statico)	Viene specificato il tipo di progetto associato al progetto. L'ID del tipo di progetto è disponibile nell'URL quando navighi a quel tipo di progetto. Per esempio: https://stark.projects.highbond.com/audit_types /36245/description, dove 36245 è l'ID del tipo di progetto. Per maggiori informazioni, consultare Flussi di lavoro e tipi di progetto.
   ambito	Vengono specificate le cose che sono coperte dal progetto. Per maggiori informazioni, consultare Pianificare progetti
   controlPerformance	Viene specificato lo stato della funzione Performance del controllo per il progetto. True: abilitato. False: disabilitato. L'impostazione predefinita è False. Per maggiori informazioni, consultare Pianificare la performance del controllo.
   riskAssurance	Viene specificato lo stato della funzione Assurance del rischio per il progetto. True: abilitato. False: disabilitato. L'impostazione predefinita è False. Per maggiori informazioni, consultare Guida introduttiva all'assurance per il rischio.
   entità	Vengono specificati gli ID delle entità contrassegnate agli elementi del progetto. Puoi trovare l'ID dell'entità nell'URL quando navighi a un'entità. Per esempio: https://stark.projects.highbond.com/ auditable_entities/33055, dove 33055 è l'ID dell'entità. Puoi fornire più ID separati da virgole. Nota In alternativa, in questo campo, è possibile anche fornire l'ID di riferimento di una nuova entità aggiunta nel modello attuale. Questo assocerà il progetto all'entità quando si carica il modello. Per scoprire di più sull'associazione delle risorse Diligent One su Utilità di importazione in massa, consultare Utilizzare gli ID di riferimento per collegare le risorse su Utilità di importazione in massa. Per informazioni sulle entità, consultare Impostare i tag di entità.
   tagList	Un elenco separato da una virgola di tag associati al progetto. Per maggiori informazioni, consultare Contrassegnare i progetti. Nota Se un valore inizia con una parentesi quadrata e contiene una virgola, un punto e virgola o un'interruzione di linea, racchiudere il valore tra virgolette doppie (" ").
   customAttributes_1_term - customAttributes_n_term	Vengono specificati i campi di attributo personalizzato da 1 a n. Gli attributi personalizzati nel modello Excel dipendono dal tipo di modello, come segue: Progetti > Tipi di progetto: per impostazione predefinita, il modello conterrà i campi degli attributi personalizzati definiti nel tipo di progetto. Tutte le risorse: devi controllare manualmente e inserire i campi degli attributi personalizzati, sia il termine che il valore. Il modello avrà un paio di attributi di termini e valori personalizzati e potrai aggiungere nove paia in più se richiesto. Per aggiungere, segui la stessa convenzione di denominazione aggiungendo un contatore, ad esempio: attributiPersonalizzati_2_termine, attributiPersonalizzati_2_valore , ecc. Gli attributi personalizzati di un progetto, un framework e i loro componenti sono definiti nel tipo di progetto. Per maggiori informazioni sugli attributi personalizzati, consulta Personalizzare termini, campi e notifiche.
   customAttributes_1_value - customAttributes_n_value	Vengono specificati i valori degli attributi personalizzati da 1 a n. Gli attributi personalizzati nel modello Excel dipendono dal tipo di modello, come segue: Progetti > Tipi di progetto: per impostazione predefinita, il modello conterrà i campi degli attributi personalizzati definiti nel tipo di progetto. Tutte le risorse: devi controllare manualmente e inserire i campi degli attributi personalizzati, sia il termine che il valore. Il modello avrà un paio di attributi di termini e valori personalizzati e potrai aggiungere nove paia in più se richiesto. Per aggiungere, segui la stessa convenzione di denominazione aggiungendo un contatore, ad esempio: attributiPersonalizzati_2_termine, attributiPersonalizzati_2_valore , ecc. Gli attributi personalizzati di un progetto, un framework e i loro componenti sono definiti nel tipo di progetto. Per maggiori informazioni sugli attributi personalizzati, consulta Personalizzare termini, campi e notifiche. Nota Se un valore inizia con una parentesi quadrata e contiene una virgola, un punto e virgola o un'interruzione di linea, racchiudi il valore tra virgolette doppie (" "). Per esempio: "[2021]", "Prima, seconda risorsa", "Questo è importante: anche questo". Per un campo a scelta multipla, puoi aggiungere valori multipli separando ogni valore con una virgola. Per un elenco a discesa o un campo a scelta multipla, assicurati che i valori siano esattamente gli stessi forniti nelle opzioni.

   Nota

   Nel modello dinamico, per un campo con elenco a discesa, le opzioni in questo elenco appaiono solo per la prima riga. Per ottenere quelle opzioni per più righe, copia la prima e incollala nelle righe richieste.

3. Salva e chiudi il modello.

Consigli per preparare il contenuto

La preparazione del contenuto implica:

• copiare e incollare i dati di origine nel modello Excel
• inserire i dati, dove applicabile, nel modello Excel
• salvare il modello in preparazione alla carica in massa

Utilizzare gli ID di riferimento per collegare le risorse in Utilità di importazione in massa

L'ID di riferimento è un campo nel modello Excel di Utilità di importazione in massa. È il primo in tutti i fogli di lavoro ed è disponibile per tutte le risorse. È un identificatore univoco per ogni record nel foglio di lavoro.

Utilizzando gli ID di riferimento, è possibile associare le risorse Diligent One l'una con l'altra, al volo. Per esempio, si possono creare un progetto e un obiettivo associati al progetto nella stessa importazione. Puoi farlo fornendo il referenceId nel campo richiesto.

Caricare i dati

Esegui una delle seguenti operazioni:

• Trascina e rilascia il modello nella finestra del browser.
• Fai clic su Seleziona i file dal tuo computer e seleziona il modello aggiornato dal tuo computer.

  Può essere caricato un solo modello Excel alla volta (ogni file è convalidato separatamente).

Risultato Appare un messaggio di successo o errore a seconda del risultato del processo e l'ultima sessione viene caricata nella tabella Sessioni.

Sessioni in Utilità di importazione in massa

Una sessione nell'Utilità di importazione in massa è una serie di interazioni utente per importare le risorse Diligent One. Ogni sessione utente viene registrata nella tabella Sessioni.

La tabella Sessioni contiene le seguenti informazioni.

Nome del campo	Descrizione
Sessioni web	Mostra l'elenco delle sessioni web. Una sessione web si riferisce a una completata utilizzando l'interfaccia utente di Utilità di importazione in massa. Una nuova sessione inizia ogni volta che apri la pagina di Utilità di importazione in massa.
Sessioni API	Mostra l'elenco delle sessioni API. Una sessione API si riferisce a una completata utilizzando una piattaforma API come Postman, ecc.
Aggiorna	Ricarica la tabella Sessioni.
ID della sessione	Identificativo della sessione. Nelle sessioni web, puoi fare clic sull'ID della sessione per andare a una in particolare, e l'ID della sessione viene aggiunto all'URL. Per esempio: https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc, dove bcc1e04e-4cd3-46d2-a8be-0b9083baccdc è l'ID della sessione. Nota Gli ID della sessione sia di quelle che web che di quelle API sembrano simili: assicurati di non scambiare gli ID per evitare errori.
Data	Mostra la data e l'orario della sessione. Puoi ordinare la data in ordine crescente o decrescente.
Caricato da	Mostra il nome dell'utente.
Stato	Mostra lo stato dell'upload, se è riuscito o meno. Puoi fare clic sullo stato per visualizzare i dettagli di importazione completi.
Nome del file	Mostra il nome del modello/del log di errore caricato. Per esempio: HighBond_Template.xlsx, ErrorLog.xlsx. Template: puoi fare clic su e scaricare il modello per correggere qualsiasi dato caricato precedentemente. Error log Un log di errore viene generato quando un upload non riesce. Puoi controllare il log di errore per rettificare gli errori e ricaricare il modello. Nota Il modello e il log di errore sono disponibili per il download per un massimo di 18 mesi dalla data di caricamento. Il collegamento per scaricare il modello è disponibile per le sessioni di Utilità di importazione in massa a partire dal 13 maggio 2022. Non puoi scaricare il modello delle sessioni precedenti a questa data.

Aggiornare in massa i progetti esistenti

È possibile aggiornare più elementi contemporaneamente su Utilità di importazione in massa utilizzando le sessioni.

Risoluzione dei problemi

Puoi scaricare e controllare il log dell'errore dalla tabella Sessioni. Comprendi gli errori comuni di carica in massa e scopri come correggerli.

La seguente tabella fornisce un elenco di possibili errori che potrebbero verificarsi durante l'upload del modello.

Errore	Soluzione/i
Potrebbero esserci più di 2.000 righe nel file caricato (inclusi tutti i fogli di lavoro).	Rimuovi le righe extra dal modello e ricaricalo.
I campi obbligatori potrebbero essere vuoti o mancare nel file caricato.	Assicurati che tutti i campi obbligatori (segnati con i nomi delle colonne rosse e arancione nel modello) siano completate. Nota Se non vengono forniti dati nei campi obbligatori, la riga non è elaborata.
Il formato dei dati potrebbe non essere corretto.	Assicurati che i dati nei campi di testo siano validi e non ne superino la lunghezza massima: 255 caratteri. I campi di testo RTF non hanno una limitazione di caratteri.
I valori dei dati potrebbero essere non validi o non corrispondere a quelli dell'elenco a discesa.	Per esempio: il valore dei campi received e endRecurrentNotifications nel foglio Requests deve essere True o False.
Campi non validi nel modello.	Non aggiungere nuovi campi al modello. Non rimuovere campi dal modello.
Il modello potrebbe non essere nel formato atteso.	Assicurati che il formato del file sia .xlsx.
Nomi del foglio di lavoro non valido.	Non modificare il nome del foglio di lavoro.
La sessione potrebbe essere scaduta.	Aggiorna la pagina e riprova a caricare.
L'ID di sessione potrebbe essere non valido.	Assicurati di stare utilizzando un'ID di sessione web.