Modalità di importazione dei dati

Quando si desidera aggiungere o aggiornare dati, eseguire l'utilità di importazione dati per importarli in CA APM. I dati importati vengono inseriti in CA MDB o vanno ad aggiornare quelli esistenti.
casm173
Quando si desidera aggiungere o aggiornare dati, eseguire l'utilità di importazione dati per importarli in CA APM. I dati importati vengono inseriti in CA MDB o vanno ad aggiornare quelli esistenti.
In questo scenario, l'amministratore di sistema esegue l'importazione dei dati. Tuttavia, l'amministratore può concedere a qualsiasi ruolo utente di CA APM l'accesso utente o l'accesso amministratore all'utilità di importazione dati. L'accesso utente consente agli utenti di creare importazioni, modificare o eliminare le proprie importazioni e visualizzare qualsiasi importazione creata da un altro utente. L'accesso amministratore consente agli utenti di creare importazioni e modificare o eliminare qualsiasi importazione creata dagli altri.
Il diagramma seguente illustra la procedura seguita dall'amministratore di sistema per importare i dati.
Diagramma che rappresenta la modalità di importazione dei dati
Diagram depicting how to import data
Per importare i dati di CA APM, procedere come segue:
Esempio: Importazione di nuovi dipendenti
Sam, amministratore di sistema di CA APM presso Document Management Company, desidera importare un gruppo di nuovi dipendenti. I nuovi dipendenti utilizzano il prodotto per la gestione degli asset hardware. Sam ha ricevuto dal reparto Risorse umane un file dei dati di origine con valori separati da virgola (.csv) contenente le informazioni sui dipendenti. Tutti i nuovi dipendenti con il ruolo di manager degli asset appartengono al dipartimento IT e lavorano presso la sede dell'azienda. Tuttavia, il file dei dati di origine contiene anche dati su nuovi dipendenti che lavorano in altre posizioni e non appartengono al dipartimento IT.
Sam desidera solo importare i dati relativi ai dipendenti IT che lavorano in sede. Pertanto crea un'importazione dei dati con l'utilità di importazione dati e il file dei dati di origine, in modo da includere i nuovi dipendenti in CA MDB. Sam crea un filtro di esclusione affinché siano importati soltanto i dipendenti del dipartimento IT presso la sede principale. Una volta eseguita l'importazione, controlla le statistiche di importazione, il file di registro dell'importazione e l'interfaccia utente per verificare se l'importazione è riuscita.
Revisione dei prerequisiti
Ai fini della corretta importazione dei dati, verificare di aver completato le seguenti attività:
  • Preparare un file dei dati di origine in formato di testo delimitato (ad esempio, con tabulazione o virgola). Questo file conterrà i dati che si desiderano importare.
    Si consiglia di includere l'oggetto di destinazione principale nel nome del file dei dati di origine. Questa convenzione di denominazione consente di individuare i file di dati quando si crea l'importazione. Un valore NULL nel file dei dati di origine cancella il valore del campo di destinazione corrispondente. Un campo vuoto nel file dei dati di origine fa sì che il valore del campo di destinazione corrispondente resti invariato.
    Se un valore nel file dei dati di origine contiene il delimitatore selezionato, è necessario racchiuderlo tra virgolette doppie. Ad esempio, selezionare la virgola come delimitatore per importare aziende. Si desidera includere il valore Document Management Company, Inc. nel file dei dati di origine. Specificare questo valore racchiuso tra virgolette: "Document Management Company, Inc".
  • (Facoltativo) Copiare i file dei dati di origine dal server locale in una delle posizioni seguenti. È possibile accedere alle seguenti posizioni sul server applicazioni di CA APM in cui è installato il servizio di gestione archiviazione. La posizione varia a seconda se si utilizza la funzione multi-tenancy.
    [ITAM Root Path]\Storage\Common Store\Import [ITAM Root Path]\Storage\Tenant_Name\Import
    Se si copia il file di dati prima di creare un'importazione, è possibile specificare il nome del file mentre viene creata l'importazione. Se non si copia il file di dati prima, è possibile caricare il file dal server locale mentre viene creata l'importazione.
  • (Facoltativo) Copiare gli eventuali file di mapping di legacy disponibili in una release precedente del prodotto dal server locale in una delle posizioni seguenti. È possibile accedere alle seguenti posizioni sul server applicazioni di CA APM in cui è installato il servizio di gestione archiviazione. La posizione varia a seconda se si utilizza la funzione multi-tenancy.
    [ITAM Root Path]\Storage\Common Store\Import [ITAM Root Path]\Storage\Tenant_Name\Import
Creazione di un'importazione dei dati da un file di dati
Creare un'importazione di dati utilizzando un file dei dati di origine (file di testo delimitato) contenente i dati che si desiderano importare. Selezionare il file, configurare i parametri di importazione e specificare il delimitatore (ad esempio, virgola o tabulazione) per separare i dati nel file.
È inoltre possibile creare un'importazione dei dati utilizzando un file di mapping di legacy tratto da una release precedente del prodotto. Per ulteriori informazioni, consultare l'articolo Creazione di un'importazione dei dati da un file di mapping di legacy.
Attenersi alla seguente procedura:
  1. Accedere a CA APM come amministratore.
    In questo scenario, l'amministratore di sistema esegue l'importazione dei dati. Tuttavia, l'amministratore può concedere a qualsiasi ruolo utente di CA APM l'accesso utente o l'accesso amministratore all'utilità di importazione dati. L'accesso utente consente agli utenti di creare importazioni, modificare o eliminare le proprie importazioni e visualizzare qualsiasi importazione creata da un altro utente. L'accesso amministratore consente agli utenti di creare importazioni e modificare o eliminare qualsiasi importazione creata dagli altri.
  2. Fare clic su Amministrazione, Utilità di importazione dati.
  3. Fare clic su Nuova importazione.
  4. Immettere le informazioni obbligatorie nell'area Informazioni di base e fornire altri dettagli se necessario. Di seguito si riporta la definizione di alcuni campi:
    • File di dati
      Specifica il file dei dati di origine da importare.
      Se il file è disponibile sul server applicazioni di CA APM, cercare il file di dati e selezionarlo. Se invece non è disponibile sul server applicazioni, caricarlo.
    • Carica file
      Individuare sul server locale il file dei dati di origine da importare o il file di mapping di legacy da utilizzare per i mapping. Il file viene caricato sul server applicazioni di CA APM.
      Le impostazioni di ambiente del prodotto comportano dei limiti per le dimensioni dei file. Per ulteriori informazioni, contattare l'amministratore.
    • Oggetto di destinazione principale
      Specifica l'oggetto principale per l'importazione.
      Gli oggetti Asset e Modello sono elencati insieme alle rispettive famiglie. È inoltre possibile specificare tutte le famiglie. Gli oggetti Documento legale sono elencati in base al modello legale. È inoltre possibile specificare tutti i modelli. Negli oggetti sono inclusi tutti quelli che è possibile importare.
      Per gli asset o i modelli che comprendono più tipi di famiglia di asset o per i documenti legali che comprendono più modelli legali, selezionare le opzioni seguenti. Indicare la famiglia o il modello specifico per ciascun record nel file dei dati di origine.
      • Per un asset, selezionare Asset (tutte le famiglie).
      • Per un modello, selezionare Modello (tutte le famiglie).
      • Per un documento legale, selezionare Documento legale (tutti i modelli).
      Verificare che sia selezionato l'oggetto di destinazione principale corretto per l'importazione. Non è possibile modificare l'oggetto di destinazione principale una volta salvata o copiata un'importazione.
    • Nomi della colonna nella prima riga
      Specifica se la prima riga nel file dei dati di origine contiene i nomi di colonna. Se la prima riga non contiene i nomi di colonna, i nomi visualizzati sono generici, ad esempio Campo 1 e Campo 2.
    • Tenant
      Specifica il tenant applicabile all'importazione (se è attiva l'opzione multi-tenancy).
      È possibile selezionare un tenant solo quando l'opzione multi-tenancy è abilitata in CA APM e si dispone dell'autorizzazione per accedere a diversi tenant. Se si dispone dell'accesso ai dati pubblici e sono disponibili più tenant, è possibile selezionarli tutti.
      Se si specificano tutti i tenant, il file dei dati di origine deve includere una colonna contenente i nomi di tenant da mappare sul campo Nome tenant.
      Se si specifica un tenant, verificare che tutti i dati nel file dei dati di origine appartengano al tenant selezionato. Se sono disponibili dati di più tenant, i dati di tutti i tenant verranno applicati al tenant selezionato.
    • Delimitatore dati
      Consente di specificare il delimitatore (ad esempio, virgola o tabulazione) utilizzato nel file dei dati di origine.
      Se un valore nel file dei dati di origine contiene il delimitatore selezionato, è necessario racchiuderlo tra virgolette doppie. Ad esempio, selezionare la virgola come delimitatore per importare aziende. Si desidera includere il valore Document Management Company, Inc. nel file dei dati di origine. Specificare questo valore racchiuso tra virgolette:
      "Document Management Company, Inc"
    • Impostazioni locali del file di dati
      Consente di specificare le impostazioni locali per il file dei dati di origine. Questa impostazione determina il formato di data e ora.
  5. Immettere le informazioni obbligatorie nell'area Impostazioni avanzate e fornire altri dettagli se necessario. Di seguito si riporta la definizione di alcuni campi:
    • Limite massimo di errori (in %)
      Definisce il numero di errori oltre il quale si interrompe l'importazione. La soglia si basa sulla percentuale di record elaborati. Si consiglia una soglia minima del 15%.
      L'utilità di importazione dati elabora il numero di record specificati in Amministrazione, Configurazione di sistema, Utilità di importazione dati, campo Dimensioni massime record batch, prima di calcolare se è stata raggiunta la soglia di errore.
    • Tipo di elaborazione oggetto di ricerca primaria
      Specifica il tipo di attività di importazione, ad esempio inserimento o aggiornamento.
    • Crea oggetti di ricerca secondari
      Crea nuovi oggetti di ricerca secondaria durante il processo di importazione. Se questa opzione è deselezionata e non esiste un oggetto secondario, si verifica un errore.
    • Aggiorna oggetti di ricerca secondari
      Aggiorna gli oggetti di ricerca secondaria esistenti durante il processo di importazione. Se non esiste un oggetto secondario, si verifica un errore.
    • Errore a livello di errori dell'oggetto di ricerca secondaria
      Indica che l'utilità di importazione dati non inserisce né aggiorna l'oggetto principale quando l'elaborazione dell'oggetto secondario non riesce. Se l'inserimento o l'aggiornamento dell'oggetto secondario non riesce e questa casella di controllo è selezionata, neanche l'oggetto principale viene inserito né aggiornato. Se invece è deselezionata, l'oggetto principale viene creato o aggiornato, purché non dipenda dall'oggetto secondario. Tuttavia, il valore dell'oggetto secondario non viene creato né modificato. In entrambi casi, l'errore dell'oggetto secondario viene registrato nel file di registro dell'importazione.
      Esempio:
      Importare una posizione che presenta un Paese. Se l'importazione non riesce durante l'aggiornamento dell'oggetto Paese e questa casella di controllo è selezionata, il record di posizione non viene creato. Se invece è deselezionata, il record di posizione viene creato mentre le informazioni sul Paese non vengono aggiornate.
    • Comportamento normalizzazione
      Specifica se normalizzare i dati o scrivere un messaggio di errore nel file di registro senza normalizzare i dati.
      Questo campo viene visualizzato solo se sono state definite regole di normalizzazione.
      • Errore di normalizzazione
        Consente di scrivere un messaggio di errore nel file di registro dell'utilità di importazione dati quando vengono rilevati dati che è possibile normalizzare in quelli da importare. I dati interessati non vengono importati. Il messaggio di errore nel file di registro include i dettagli sui dati.
        Ad esempio, nei dati è incluso il nome di azienda Microsoft. Le regole di normalizzazione azienda create identificano Microsoft come valore rilevato (non autorevole) e specificano Microsoft Corporation come valore normalizzato (autorevole). Se si seleziona questa opzione quando si importano i dati, l'oggetto con il nome di azienda Microsoft non viene importato e viene scritto un messaggio di errore nel file di registro.
      • Applica normalizzazione senza errori
        Utilizza le regole di normalizzazione per normalizzare i dati sottoposti a importazione. Se si riscontrano dati che è possibile normalizzare, questi vengono normalizzati e poi importati. Non viene scritto alcun messaggio di errore sui dati nel file di registro.
        Ad esempio, nei dati è incluso il nome di azienda Microsoft. Le regole di normalizzazione azienda create identificano Microsoft come valore rilevato (non autorevole) e specificano Microsoft Corporation come valore normalizzato (autorevole). Se si seleziona questa opzione quando si importano i dati, l'oggetto con il nome di azienda Microsoft viene normalizzato. In questo esempio, il nome di azienda viene modificato in Microsoft Corporation e l'oggetto associato viene importato.
  6. Fare clic su Salva.
    L'importazione viene salvata. Ora è possibile inserire dati nelle aree Mapping, Filtro di esclusione e Pianificazione della pagina.
Esempio: Creazione di un'importazione dei dati relativi a nuovi dipendenti dal file di dati
Sam, amministratore di sistema di CA APM, compie le azioni seguenti per creare l'importazione dei dati:
  1. Accede ad Amministrazione, Utilità di importazione dati e fa clic su Nuova importazione.
  2. Immette New Employees.csv nel campo File di dati.
    Si tratta del file dei dati di origine in formato .csv ricevuto dal reparto Risorse umane e contenente le informazioni sui nuovi dipendenti.
  3. Seleziona Contatto come oggetto di destinazione principale e la virgola come delimitatore dei dati.
  4. Seleziona Inserisci o Aggiorna nel campo Tipo di elaborazione oggetto di ricerca principale e fa clic su Salva.
Creazione di un'importazione dei dati da un file di mapping di legacy
È possibile creare un'importazione dei dati utilizzando un file di mapping di legacy tratto da una release precedente di CA APM. Il file di mapping definisce il file di dati corrispondente e le impostazioni del parametro di importazione.
Si consiglia di copiare i file di mapping di legacy e i file di dati corrispondenti nel server applicazioni di CA APM prima di creare le importazioni dei dati. Tuttavia, se necessario, è possibile completare i passaggi facoltativi per caricare il file di mapping di legacy.
È inoltre possibile creare un'importazione dei dati soltanto con il file di dati. Per ulteriori informazioni, consultare l'articolo Creazione di un'importazione dei dati da un file di dati.
Attenersi alla procedura seguente:
  1. Fare clic su Amministrazione, Utilità di importazione dati, Nuova importazione.
  2. Fare clic su Cerca e carica mapping per selezionare il file di mapping di legacy già disponibile sul server applicazioni di CA APM.
    Anche il file di dati corrispondente deve essere disponibile sul server applicazioni di CA APM.
    Se il file di mapping di legacy non è disponibile sul server applicazioni di CA APM, caricarlo dal campo Carica file.
  3. (Facoltativo) Per caricare un file di mapping di legacy non disponibile sul server applicazioni di CA APM, procedere come segue:
    1. Dal campo Carica file, cercare e selezionare un file di mapping di legacy presente sul server locale.
      Il file di mapping di legacy viene caricato e visualizzato nel campo Carica file.
    2. Fare clic su Cerca e carica mapping e selezionare il file di mapping di legacy caricato.
      Il file di mapping di legacy viene visualizzato nel campo File di mapping di legacy.
      Vengono caricate le informazioni di base.
    Se viene restituito un avviso sul file dei dati di origine, caricare il file di dati dal campo Carica file.
  4. Specificare le impostazioni avanzate e fare clic su Salva.
    Vengono caricati i mapping di dati delle aree Filtro di esclusione e Mapping. Ora è possibile inserire dati nelle aree Mapping, Filtro di esclusione e Pianificazione della pagina. Le aree Mapping e Filtro di esclusione contengono i dati tratti dal file di mapping di legacy.
    Per informazioni sulla procedura per indicare le impostazioni avanzate, consultare la sezione Creazione di un'importazione dei dati da un file di dati.
Mapping delle colonne del file di dati sui campi di dati
È possibile eseguire il mapping delle colonne presenti nel file dei dati di origine sui campi di CA APM. Eseguire il mapping delle colonne per specificare la destinazione dei dati da importare. Durante il mapping delle colonne è possibile selezionare la maggior parte degli oggetti e dei campi associati come campi di destinazione.
Se l'importazione dei dati è stata creata da un file di mapping di legacy, il mapping delle colonne esiste già. È possibile modificare le regole di mapping esistenti se si desidera modificare i valori. È inoltre possibile aggiungere regole di mapping e filtri.
Quando si accede, il ruolo utente assegnato dall'amministratore determina gli oggetti e i campi che è possibile visualizzare e utilizzare. Se, in base al ruolo svolto, non si dispone delle autorizzazioni su un campo oggetto, questo non è disponibile per il mapping. Si può soltanto creare un mapping e importare i dati relativi agli oggetti e ai campi per cui si dispone delle autorizzazioni.
Prima di eseguire il mapping dei dati, si consiglia di consultare l'interfaccia utente di CA APM per definire le informazioni necessarie per il mapping. Ad esempio, consultare la pagina Asset per verificare se il nome asset, la famiglia asset, il modello e la classe sono informazioni obbligatorie. Poiché per creare un asset è necessario un modello, consultare la pagina Modello per verificare che il nome del modello e la famiglia asset sono obbligatori. Grazie alla verifica dell'interfaccia utente prima della creazione di un mapping è possibile disporre di tutte le informazioni necessarie per creare il mapping.
Attenersi alla seguente procedura:
  1. Nella scheda Amministrazione, pagina Utilità di importazione dati, area Mapping di un'importazione selezionata, fare clic su Nuovo o su Carica campi di origine.
    • L'opzione Nuovo consente di selezionare i singoli campi di origine dal file dei dati di origine.
    • L'opzione Carica campi di origine permette di aggiungere tutti i campi di origine dal file dei dati di origine.
    In caso di mapping esistenti, l'opzione Carica campi di origine permette di sostituirli con i campi di origine tratti dal file dei dati di origine. Questa opzione consente inoltre di aggiungere i campi di origine tratti dal file dei dati di origine non ancora inseriti nei mapping.
    1. Dopo aver fatto clic su Carica campi di origine, selezionare l'icona Modifica record accanto a un campo.
  2. Fare clic sull'icona Seleziona accanto a Campo di origine, se vuoto, quindi selezionare una colonna dall'origine dati e fare clic su OK.
    Se è già presente un campo di origine perché sono stati caricati tutti i campi di origine, è possibile ignorare questo passaggio.
    I simboli di percentuale visualizzati prima e dopo i nomi di colonna identificano i nomi come intestazioni di colonna nel file dei dati di origine. È inoltre possibile specificare un valore hardcoded nel campo di origine da applicare a tutti i record nel file dei dati di origine. È quindi possibile mappare il valore hardcoded su un campo di destinazione. I valori hardcoded non sono accompagnati dai simboli di percentuale, in modo da distinguerli rispetto ai nomi di colonna nel file dei dati di origine. Per ulteriori informazioni, consultare l'articolo Valori hardcoded.
  3. Fare clic sull'icona Seleziona accanto a Campo di destinazione, selezionare un campo di destinazione per il campo di origine selezionato e fare clic su OK.
    I campi di destinazione visualizzati si basano sull'oggetto di destinazione principale selezionato.
    I campi di destinazione sono elencati in ordine gerarchico. Ad esempio, i campi elencati nella gerarchia dei tipi di asset sono Famiglia di asset, Classe e Classe secondaria. L'ordine dei campi elencati rispecchia la loro gerarchia. Attenersi alla gerarchia dei campi quando si specificano le regole di mapping. Ad esempio, per Gerarchia tipo di asset, specificare una regola per la classe prima di indicare la classe secondaria.
  4. Selezionare le caselle di controllo Ricerca principale e Ricerca secondaria in modo appropriato.
    1. Selezionare la casella di controllo Ricerca principale per ogni campo di destinazione che si desidera utilizzare per trovare l'oggetto principale. Attenersi alle seguenti linee guida quando si seleziona questa casella di controllo:
      • Selezionare almeno una casella di controllo Ricerca principale nel mapping delle colonne per un'importazione.
      • Non selezionare questa casella di controllo se il valore del campo di destinazione è Testo nota, compreso nell'oggetto Nota. Il tipo di dati del database per il campo Testo nota non permette che funzioni come un campo di ricerca.
    2. Selezionare la casella di controllo Ricerca secondaria per ogni campo di destinazione che si desidera utilizzare per trovare gli oggetti secondari. Attenersi alle seguenti linee guida quando si seleziona questa casella di controllo:
      • Non selezionare questa casella di controllo se il campo di destinazione non è compreso nei campi di ricerca per l'oggetto secondario.
      • Non selezionare questa casella di controllo se il valore del campo di destinazione è Testo nota, compreso nell'oggetto Nota. Il tipo di dati del database per il campo Testo nota non permette che funzioni come un campo di ricerca.
  5. Fare clic sull'icona Completa modifica record.
  6. Fare ancora una volta clic su Nuovo oppure sull'icona Modifica record accanto a un altro campo di origine per specificare ulteriori regole di mapping.
    Per eliminare una regola di mapping specifica dall'elenco delle colonne mappate, fare clic sull'icona di eliminazione accanto alla regola di mapping. La regola di mapping delle colonne viene rimossa dall'elenco.
  7. Fare clic su Salva.
    Il mapping delle colonne viene salvato.
Esempio: Mapping delle colonne del file di dati sui campi di dati
Sam completa i passaggi seguenti per eseguire il mapping delle colonne nel file dei dati di origine sui campi di dati in CA APM:
  1. Fa clic su Nuovo nell'area Mapping della pagina Dettagli importazione.
  2. Fa clic sull'icona Seleziona accanto a Campo di origine e seleziona
    %Login ID%
    dalla finestra di dialogo.
    Nella finestra di dialogo sono elencate le colonne tratte dal file dei dati di origine.
  3. Fa clic sull'icona Seleziona accanto a Campo di destinazione e seleziona ID utente dalla finestra di dialogo.
  4. Seleziona la casella di controllo Ricerca principale.
  5. Continua a eseguire il mapping delle colonne restanti nei file dei dati di origine sui campi di dati in CA APM e fa clic su Salva al termine.
Revisione del materiale di riferimento sul mapping
Fare riferimento alle seguenti informazioni durante l'impostazione del mapping delle colonne per l'importazione o l'eliminazione dei dati.
Combinazioni di ricerca principale e secondaria
I campi selezionati come ricerca primaria e secondaria nel mapping delle colonne vengono utilizzati per la ricerca di dati nel database del prodotto.
  • Mapping semplice
    Nel mapping semplice, specificare solo la ricerca primaria. Ad esempio, viene importata o eliminata una serie di record aziendali da un file di testo nel database del prodotto. È possibile specificare il nome dell'azienda come ricerca primaria. Se nel database non esiste un'azienda con un nome specifico, in fase di importazione dei dati viene creato un record per l'azienda. La tabella seguente mostra un esempio di ricerca per mapping semplice.
Campo di origine
Campo di destinazione
Ricerca primaria
Ricerca secondaria
%Company Name%
Company.Company Name
No
  • Mapping dei campi di riferimento
    Nel mapping dei campi di riferimento, specificare i valori di ricerca primaria e secondaria. Per cercare un oggetto univoco, specificare più ricerche primarie. Ad esempio, per cercare un'azienda, è possibile specificare il nome, l'azienda padre e il tipo di azienda come valori di ricerca primaria. In questo esempio, l'utilità di importazione dati esegue la ricerca di un'azienda con il nome, l'azienda padre e il tipo di azienda specificati. Se l'oggetto non esiste ed è in corso l'importazione dei dati, viene creato il record in base all'opzione di inserimento o aggiornamento selezionata nelle impostazioni avanzate. La tabella seguente mostra un esempio di ricerca per mapping dei campi di riferimento.
Campo di origine
Campo di destinazione
Ricerca primaria
Ricerca secondaria
%Company Name%
Company.Company Name
No
%Parent Company%
Company.Parent Company.Company Name
%Company Type%
Company.Company Type.Value
Per questo mapping sono selezionate entrambe le caselle di controllo Ricerca primaria e Ricerca secondaria per l'azienda padre e il tipo di azienda. L'utilità di importazione dati utilizza il nome dell'azienda per cercare l'azienda padre e il valore dell'azienda padre per cercare il nome dell'azienda.
  • Mapping di oggetti secondari
    Se una regola di mapping viene associata a una proprietà di oggetto secondario, i valori di ricerca primaria stabiliscono una relazione tra l'oggetto secondario e i campi di riferimento. Nella seguente tabella sono riportati alcuni esempi di ricerca per mapping di oggetti secondari.
Campo di origine
Campo di destinazione
Ricerca primaria
Ricerca secondaria
%Comment%
Legal Document.Legal Party.Comment
No
%Legal Document ID%
Legal Document.Document Identifier
No
%Company Name%
Legal Document.Legal Party.Legal Party.Company Name
%Legal Template%
Legal Document.Legal Template.Template
Nella prima regola di mapping, il documento legale è l'oggetto primario, mentre la parte legale è l'oggetto secondario. Il commento è una proprietà della parte legale.
Nella terza regola di mapping, il documento legale è l'oggetto primario, mentre la parte legale è l'oggetto secondario. Inoltre, la parte legale presenta un campo di riferimento nella tabella Azienda. La casella di controllo Ricerca secondaria indica che il nome dell'azienda viene utilizzato per cercare l'oggetto Azienda. La casella di controllo Ricerca primaria indica che l'oggetto Azienda viene utilizzato per cercare l'oggetto Parte legale.
Valori hardcoded
Nel mapping delle colonne, i simboli di percentuale visualizzati prima e dopo i nomi di colonna identificano i nomi come intestazioni di colonna nel file dei dati di origine. È inoltre possibile specificare un valore hardcoded nel campo di origine da applicare a tutti i record nel file dei dati di origine. È quindi possibile mappare il valore hardcoded su un campo di destinazione. I valori hardcoded non sono accompagnati dai simboli di percentuale, in modo da distinguerli rispetto ai nomi di colonna nel file dei dati di origine.
Hard_coded_values.PNG
  1. Intestazione di colonna del file dei dati di origine
  2. Valore hardcoded
È possibile definire un valore hardcoded nel campo di origine per espandere i dati di origine e verificare di aver incluso tutti i campi obbligatori. In genere, i valori hardcoded non sono preceduti o seguiti dal simbolo di percentuale (%). Eventuali valori hardcoded accompagnati da simboli di percentuale non corrispondono ai nomi nel file dei dati di origine.
Esempio: Utilizzo di valori hardcoded per famiglia di asset
In questo esempio, gli asset nel file dei dati di origine non comprendono la famiglia di asset, richiesta per la creazione di un asset. È possibile aggiungere un valore hardcoded al mapping. Se tutti gli asset sono hardware, è possibile immettere il valore Hardware nel campo di origine. È possibile eseguire il mapping di questo valore sul campo Famiglia asset. Se gli asset appartengono a famiglie differenti, aggiungere una colonna al file dei dati di origine con le famiglie di asset corrispondenti prima di importare o eliminare dati.
Di seguito viene illustrata la differenza tra i valori tratti dal file dei dati di origine e i valori aggiunti attraverso valori hardcoded:
  • Nel file dei dati di origine è presente la colonna Famiglia asset. La selezione nel campo di origine è %asset family%.
Nel file dei dati di origine non è presente la colonna Famiglia asset. Tuttavia, tutti gli asset sono asset hardware. È possibile specificare un valore hardcoded Hardware nel campo di origine.
Inoltre, per indicare che tutti i record nel file dei dati di origine appartengono a una famiglia o a un modello specifico, è possibile utilizzare l'oggetto di destinazione principale. Ad esempio, la selezione di Asset (Hardware) per l'oggetto di destinazione principale indica che tutti i record di origine appartengono alla famiglia di asset hardware.
Valori multipli per un singolo campo
È possibile aggiungere un mapping con più valori di campo di origine mappati su un singolo campo di destinazione.
Esempio: utilizzo di più valori per un singolo campo
Il file dei dati di origine contiene due colonne, una relativa al produttore, l'altra al nome del catalogo. Per unire le due colonne, selezionarle entrambe in Campo di origine. In questo esempio, la selezione del campo di origine è %Manufacturer% %Catalog Name%.
Inoltre, è possibile immettere più valori hardcoded nel campo di origine (ad esempio, Document Management Company %model name% Dipartimento IT).
Applicazione dei filtri ai dati da importare
È possibile identificare un sottoinsieme di record nel file dei dati di origine che si desidera escludere dall'importazione. Il filtro di esclusione dell'utilità di importazione dati consente di filtrare una parte dell'origine dati mediante regole di filtro di esclusione.
Esempio: Definizione di un filtro di esclusione per elaborare gli asset restituiti
Il file .csv ricevuto dal fornitore hardware contiene gli asset ordinati e restituiti. Si desidera elaborare solo gli asset restituiti, pertanto occorre importare i dati per aggiornare solo quei record. Definire un filtro di esclusione per escludere i record che non presentano lo stato Restituito.
Attenersi alla procedura seguente:
  1. Nella scheda Amministrazione, pagina Utilità di importazione dati, area Filtro di esclusione di un'importazione selezionata, selezionare il tipo di filtro.
    • And
      Esclude un record dal file dei dati di origine solo se tutte le regole specificate sono valide per il record.
    • Oppure
      Esclude un record dal file dei dati di origine se qualsiasi regola specificata è valida per il record.
  2. Fare clic su Nuovo.
  3. Fare clic sull'icona Seleziona accanto a Campo di origine, selezionare una colonna dal file dei dati di origine e fare clic su OK.
    I segni di percentuale prima e dopo i nomi di colonna identificano i nomi come colonne nel file dei dati di origine.
  4. Selezionare l'operatore.
    Per specificare non uguale a, selezionare l'operatore <>.
  5. Immettere un valore di filtro per la regola.
    Per il valore del filtro è possibile utilizzare caratteri speciali e caratteri jolly. Le regole possono elaborare campi di testo, numerici e di data.
  6. Fare clic sull'icona Completa modifica record.
  7. (Facoltativo) Fare clic su Nuovo e specificare ulteriori regole di filtro di esclusione.
  8. Fare clic su Salva.
    Le regole di filtro di esclusione vengono salvate e applicate quando si elabora l'importazione dei dati.
Esempio: Creazione di un filtro di esclusione
Sam completa i passaggi seguenti per creare un filtro di esclusione. Il filtro consente di eliminare dall'importazione dei dati i dipendenti non IT e quelli che non lavorano presso la sede dell'azienda.
  1. Seleziona And per Tipo di filtro e fa clic su Nuovo nell'area Filtro di esclusione della pagina Dettagli importazione.
  2. Seleziona
    %Department%
    per Campo di origine.
  3. Seleziona <> per Operatore.
  4. Immette IT in Valore di filtro.
  5. Fa clic sull'icona Completa modifica record e quindi su Nuovo.
  6. Seleziona %Location% per Campo di origine.
  7. Seleziona <> per Operatore.
  8. Immette Headquarters in Valore di filtro.
  9. Fa clic sull'icona Completa modifica record e quindi su Salva.
Esecuzione dell'importazione
Per avviare immediatamente l'importazione, fare clic su Invia nell'area Pianificazione della pagina. Vengono elaborati i record dell'origine dati dal file di dati per l'importazione selezionata.
Volendo, è possibile specificare un file di dati diverso da quello predefinito in Informazioni di base.
È inoltre possibile pianificare l'importazione per un giorno e un orario specifici. Per ulteriori informazioni, consultare l'articolo Pianificazione dell'importazione.
Per visualizzare i processi di importazione per l'importazione selezionata corrente, fare clic su Processi associati sul lato sinistro della pagina. Per visualizzare tutti i processi di importazione per tutte le importazioni, fare clic su Processi di importazione sul lato sinistro della pagina. Nell'elenco dei processi di importazione, fare clic su Messaggio di stato per visualizzare lo stato di un'importazione.
Per ulteriori informazioni sull'attività di importazione è possibile visualizzare il file di registro. Nell'elenco dei processi di importazione, fare clic su Visualizza registri per l'importazione selezionata.
Pianificazione dell'importazione
È possibile pianificare un'importazione a un orario specifico, nonché indicarne la frequenza, ad esempio giornaliera o settimanale. È possibile pianificare più importazioni da elaborare contemporaneamente.
Attenersi alla seguente procedura:
  1. Nella scheda Amministrazione, pagina Utilità di importazione dati, area Pianificazione di un'importazione selezionata, selezionare la casella di controllo Pianificato.
  2. Fornire le informazioni per la pianificazione. Di seguito si riporta la definizione di alcuni campi:
    • Ora di esecuzione
      Specifica l'ora del giorno, nel formato a 24 ore, per elaborare l'importazione. Quando si pianificano le importazioni, utilizzare il fuso orario locale sul server applicazioni di CA APM.
    • Giorni di intervallo
      Specifica il giorno in cui elaborare l'importazione nell'intervallo selezionato. Ad esempio, se il valore di Tipo di intervallo è Mese e quello di Giorni di intervallo è 1, significa che l'importazione viene elaborata il primo giorno del mese.
    • File di dati
      Specifica un nome di file di dati diverso da quello predefinito in Informazioni di base se si desidera utilizzare un file differente.
      Se il file è disponibile sul server applicazioni, è possibile selezionarlo una volta individuato. Se invece non è disponibile sul server applicazioni, è possibile caricarlo una volta individuato.
    • Carica file di dati
      Individuare il file dei dati di origine che si desidera importare. Il file viene caricato sul server applicazioni.
    • Data prima esecuzione
      Specifica la data di elaborazione per la prima importazione.
    • Tipo di intervallo
      Specifica il tipo di intervallo per l'importazione (ad esempio, giorno, mese, trimestre, settimana o anno).
    • Intervallo
      Specifica la frequenza di elaborazione per l'importazione. Questo intervallo varia in base al tipo di intervallo specificato. Ad esempio, se il valore di Tipo di intervallo è Settimanale e quello di Intervallo è 2, l'importazione viene elaborata ogni due settimane.
    • Ultimo giorno dell'intervallo
      Specifica che l'importazione viene elaborata l'ultimo giorno dell'intervallo selezionato. Quando si seleziona questa casella di controllo, qualsiasi valore precedente aggiunto al campo Giorni di intervallo viene rimosso e il campo Giorni di intervallo viene disabilitato.
  3. Fare clic su Invia.
    L'importazione dei dati viene pianificata per la data e l'ora specificate.
Esempi: Utilizzo delle impostazioni di pianificazione
Gli esempi seguenti illustrano l'utilizzo delle impostazioni di pianificazione.
  • Selezionare Giorno per Tipo di intervallo e 2 per Intervallo. L'importazione viene elaborata a giorni alterni.
  • Selezionare Settimana per Tipo di intervallo, 1 per Giorni di intervallo e 3 per Intervallo. L'importazione viene elaborata ogni tre settimane, il primo giorno (lunedì) della settimana.
  • Selezionare Mese per Tipo di intervallo, 15 per Giorni di intervallo e 2 per Intervallo. L'importazione viene elaborata ogni due mesi, il 15º giorno del mese.
  • Selezionare Trimestre per Tipo di intervallo e selezionare Ultimo giorno dell'intervallo. L'importazione viene elaborata ogni trimestre, l'ultimo giorno del mese nel trimestre.
  • Selezionare Anno per Tipo di intervallo, 1 per Giorni di intervallo e 1 per Intervallo. L'importazione viene elaborata il 1° gennaio di ogni anno.
Per visualizzare i processi di importazione per l'importazione selezionata corrente, fare clic su Processi associati sul lato sinistro della pagina. Per visualizzare tutti i processi di importazione per tutte le importazioni, fare clic su Processi di importazione sul lato sinistro della pagina. Nell'elenco dei processi di importazione, fare clic su Messaggio di stato per visualizzare lo stato di un'importazione.
Per ulteriori informazioni sull'attività di importazione è possibile visualizzare il file di registro. Nell'elenco dei processi di importazione, fare clic su Visualizza registri per l'importazione selezionata.
Visualizzazione dei dettagli di pianificazione
È possibile visualizzare i dettagli di pianificazione per un processo di importazione pianificato che è stato creato.
Innanzitutto, aprire l'elenco dei processi di importazione.
  • Per visualizzare i processi di importazione pianificati per l'importazione attualmente selezionata, fare clic su Processi associati sul lato sinistro della pagina, selezionare la casella di controllo Pianificato e fare clic su Vai.
  • Per visualizzare tutti i processi di importazione per tutte le importazioni, fare clic su Processi di importazione sul lato sinistro della pagina, selezionare la casella di controllo Pianificato e fare clic su Vai.
Nell'elenco dei processi di importazione visualizzato, fare clic su Dettagli di pianificazione per l'importazione selezionata.
Visualizzazione dei file di registro dell'importazione
È possibile visualizzare i file di registro dell'utilità di importazione dati per vedere i dettagli di tutte le importazioni fornite da CA e definite dall'utente che sono state completate. L'utilità di importazione dati crea un file di registro per ciascuna importazione eseguita, incluse le importazioni inoltrate immediatamente o pianificate per il futuro. Tutte le attività di importazione vengono salvate nei file di registro.
Per visualizzare i file di registro, aprire innanzitutto l'elenco dei processi di importazione.
  • Per visualizzare i processi di importazione per l'importazione selezionata corrente, fare clic su Processi associati sul lato sinistro della pagina.
  • Per visualizzare tutti i processi di importazione per tutte le importazioni, fare clic su Processi di importazione.
Nell'elenco dei processi di importazione, fare clic su Visualizza registri per un'importazione selezionata. Se è disponibile più di un file di registro (ad esempio, per un'importazione pianificata già completata alcune volte), vengono elencati tutti i file con le date di creazione corrispondenti.
È possibile visualizzare tutti i file di registro disponibili del servizio di sincronizzazione importazione LDAP. Se si seleziona Avvia importazione e sincronizzazione dati LDAP nella pagina Importazione e sincronizzazione dati LDAP (Amministrazione, Gestione utente/ruolo), viene visualizzato l'ID di un processo di importazione. Utilizzare questo ID di processo per individuare il processo nell'elenco dei processi di importazione dell'utilità di importazione dati. Quindi, fare clic su Visualizza registri per tale processo.
È inoltre possibile individuare e visualizzare i file di registro di importazione nella posizione seguente sul server applicazioni CA APM:
[ITAM Root Path]\Storage\Common Store\Import\Logs
Esame del file di registro dell'importazione - Procedure consigliate
Il file di registro dell'utilità di importazione dati contiene messaggi di errore e informazioni sull'elaborazione dei processi di importazione. Per capire i risultati dell'importazione e risolvere eventuali errori, utilizzare le informazioni contenute nel file di registro. In questa sezione sono illustrate alcune procedure consigliate per l'utilizzo del file di registro dell'utilità di importazione dati.
Trovare la corrispondenza tra il numero di riga nel file di dati e il messaggio di errore nel file di registro.
Il messaggio di errore del file di registro identifica il numero di riga corrispondente dal file di dati. È possibile trovare il numero di riga del file di dati anche nella riga sopra o sotto il messaggio di errore nel file di registro.
A volte il messaggio di errore nel file di registro non contiene il numero di riga del file di dati. In questo caso, i valori del file di dati effettivi vengono mostrati immediatamente dopo il messaggio di errore nel file di registro.
Contare il numero di messaggi di errore nel file di registro.
  1. Cercare le frasi seguenti nel file di registro per trovare i messaggi di errore nel file. Queste frasi sono incluse nei messaggi di errore.
    Web Service threw exception Error at record
  2. Dopo aver individuato il tipo di messaggio di errore, eseguire la ricerca dell'errore nel file di registro e contare il numero di occorrenze.
  3. Identificare e cercare più tipi di errore visualizzati nel file di registro e contare il numero di occorrenze.
  4. Confrontare il numero di tutti gli errori nel file di registro con le statistiche generate dall'utilità di importazione dati per l'importazione associata. Per visualizzare le statistiche, fare clic su Messaggio di stato nell'elenco Processi associati o Processi di importazione. Il confronto permette di considerare tutti gli errori rilevanti e identificare i messaggi di errore che non sono validi e si possono ignorare.
Verifica dei dati importati
Per verificare se l'importazione dei dati è avvenuta correttamente, visualizzare i dati di CA APM e rivedere le statistiche dell'utilità di importazione dati.
  • Consultazione delle statistiche dell'utilità di importazione dati.
    Per rivedere le statistiche per l'importazione selezionata corrente, fare clic su Processi associati sul lato sinistro della pagina. Nell'elenco dei processi di importazione, fare clic su Messaggio di stato per l'importazione in corso.
    Per ulteriori informazioni sull'attività di importazione è possibile visualizzare il file di registro. Nell'elenco dei processi di importazione, fare clic su Visualizza registri per l'importazione selezionata.
  • Visualizzazione dei dati importati in CA APM.
    Per visualizzare i dati importati, accedere alla scheda e sulla scheda secondaria, se necessario, dell'oggetto importato (ad esempio, asset, azienda o contatto). Cercare gli oggetti importati e verificare che siano disponibili.
Esempio: Verifica dell'importazione dei dati relativi a nuovi dipendenti
Dopo aver eseguito l'importazione, Sam completa i passaggi seguenti per verificare l'importazione dei dati relativi ai nuovi dipendenti:
  1. Controlla le statistiche di importazione.
    • Fa clic su Processi associati o su Processi di importazione sul lato sinistro della pagina Utilità di importazione dati.
    • Fa clic su Messaggio di stato per l'importazione e rivede le statistiche.
  2. Visualizza il file di registro dell'importazione e l'interfaccia utente.
    • Fa clic su Visualizza registri nell'elenco dei processi di importazione e rivede i contenuti del file di registro.
    • Accede a Directory, Contatto nell'interfaccia utente di CA APM. Cerca i nuovi dipendenti. Verifica che i dipendenti non IT e quelli che non lavorano presso la sede centrale dell'azienda non siano disponibili.