Caricare i dati dell'organizzazione (primo caricamento)Upload organizational data (first upload)

Gli amministratori devono prima caricare (importare) i dati dell'organizzazione prima di poter analizzare le informazioni dettagliate sull'azienda in Workplace Analytics.Administrators must first upload (import) organizational data before you can analyze insights about your company in Workplace Analytics. Completare i passaggi seguenti dopo aver preparato i dati come descritto in Preparare i dati dell'organizzazione.Complete the following steps after preparing data as described in Prepare organizational data.

Important

Usa la procedura seguente solo se questa è la prima volta che carichi i dati dell'organizzazione.Only use the following steps if this is the first time you are uploading organizational data. Se non si tratta del primo caricamento, vedere Caricare i dati dell'organizzazione (caricamenti successivi) per aggiornare i dati caricati in precedenza.If this is not your first upload, see Upload organizational data (subsequent uploads) to update previously uploaded data.

Importare attivitàImport tasks

L'attività di importazione dei dati dell'organizzazione è di tre parti:The task of importing organizational data has three parts:

  1. File uploadFile upload
  2. Mapping dei campiField mapping
  3. Convalida dei datiData validation

Dopo aver preparato i dati di origine, è possibile caricare il file CSV e i campi di mapping.After you prepare the source data, you can upload the .csv file and map fields. Dopo aver mappato i campi, Workplace Analytics convalida i dati.After you map fields, Workplace Analytics validates the data. Quando i dati vengono convalidati correttamente, l'attività di importazione dei dati complessiva è stata completata.When the data successfully validates, the overall data-import task is complete. Se la convalida dei dati non riesce, è possibile scegliere tra alcune opzioni descritte in Errore di convalida.If the data validation is not successful, you can choose from a few options that are described in Validation fails.

Video: Caricare i dati dell'organizzazioneVideo: Upload organizational data

File uploadFile upload

Al termine dell'elaborazione iniziale dei dati di collaborazione, alla successiva apertura di Workplace Analytics, la pagina verrà aggiornata automaticamente per inserire i dati dell'organizzazione come file CSV in Workplace Analytics.After the initial processing of collaboration data is complete, the next time you open Workplace Analytics, the page automatically updates to let you know it's time to upload your organizational data as a .csv file into Workplace Analytics. A tale scopo, eseguire la procedura seguente.Use the following steps to do so.

  1. In Carica seleziona Denoti il caricamento e immetti un nome.In Upload, select Name your upload and enter a name.

  2. Facoltativamente, selezionare Aggiungi una descrizione facoltativa e digitare una descrizione.Optionally, select Add an optional description and type a description.

  3. Fare clic su Seleziona un file, selezionare il file CSV da caricare e quindi selezionare Apri dopo aver esaminato le considerazioni importanti sul caricamento seguenti:Click Select a file, select the .csv file to upload, and then select Open after reviewing the following important upload considerations:

    • Il file CSV caricato deve essere codificato in formato UTF-8.The .csv file that you upload must be UTF-8 encoded.
    • Verificare che il file CSV non sia aperto in un programma diverso quando si inizia il processo di caricamento.Confirm the .csv file is not open in a different program when you begin the upload process.
    • Dopo l'inizio del processo di caricamento, il processo è irreversibile.After the upload process begins, the process is irreversible.
  1. Per completare un nuovo caricamento, selezionare Avanti.To complete a new upload, select Next. Verrà visualizzata la tabella Campi di sistema.This displays the System fields table. Vai a Mapping campi.Go to Field mapping.

Mapping campiField Mapping

È necessario mappare i campi (colonne) del file CSV di origine ai nomi dei campi riconoscibili da Workplace Analytics.You need to map the fields (columns) for the source .csv file to the field names that Workplace Analytics recognizes. Questi campi vengono mappati durante il passaggio di caricamento, come indicato nella barra di avanzamento nella pagina Installazione:You map these fields during the Upload step, as indicated in the progress bar on the Setup page:

Opzione Mapping campi dati

Questa pagina include tabelle per i campi predefiniti di sistema e i campi personalizzati per il mapping dei dati per il file di caricamento.This page includes tables for System default fields and Custom fields for mapping the data for the upload file. Questi tipi di campo sono descritti nelle sezioni seguenti.These field types are described in the following sections.

Campi predefiniti di sistemaSystem default fields

I campi predefiniti di sistema rappresentano gli attributi noti da Workplace Analytics e utilizzati in calcoli specifici oltre al raggruppamento e al filtro.System default fields represent attributes that are known by Workplace Analytics and are used in specific calculations beyond grouping and filtering. Un campo predefinito di sistema può essere obbligatorio o facoltativo.A system default field can be either required or optional.

  • I campi obbligatori sono identificati in due modi.Required fields are identified in two ways. Le righe hanno uno sfondo scuro e vengono visualizzate come "Obbligatorie" sotto l'intestazione della colonna Di origine.Their rows have dark shading and show as "Required" under the Source column header. Queste righe rappresentano i dati trovati nel file caricato.These rows represent data that was found in the uploaded file. Per l'esito positivo del caricamento, è necessario mappare i campi obbligatori a una colonna del file CSV che rappresenta il tipo di dati corretto.For the upload to succeed, you must map the required fields with a column in your .csv file that is the correct data type.

    Important

    Ogni campo obbligatorio deve avere un valore valido non Null in ogni riga.Every required field must have a valid, non-null value in every row. Ciò significa che, anche se i nomi di questi attributi non sono presenti nel file CSV caricato, nel file CSV devono essere presenti altre colonne mappate a questi attributi.This means that, even if the names of these attributes are not present in the uploaded .csv file, other columns must be present in the .csv file that are mapped to these attributes.

  • I campi facoltativi vengono visualizzati sotto i campi obbligatori nelle righe con un'ombreggiatura più chiara.Optional fields appear below the required fields in rows that have lighter shading. Queste righe vengono comunemente incontrate nei campi di sistema suggeriti da Workplace Analytics per l'uso.These rows are commonly encountered system fields that Workplace Analytics suggests for use. Non è necessario eseguire il mapping di questi campi se l'organizzazione non dispone di dati per tali campi.You don't need to map these fields if your organization doesn't have data for them.

Campi personalizzatiCustom fields

  • I campi personalizzati vengono visualizzati in questa pagina sotto i campi facoltativi.Custom fields are displayed on this page below the optional fields. I campi personalizzati sono attributi facoltativi che è possibile creare.Custom fields are optional attributes you can create. Selezionare una colonna dal source.csv file.Select a column from your source.csv file. Assegnare un nome alla colonna, selezionare il tipo di dati e quindi selezionare l'opzione del report.Name the column, select the data type, and then select the report option.

Dettagli colonna campoField column details

  • La colonna di origine corrisponde a ognuno dei campi nel file caricato.Source column corresponds to each of the fields in the uploaded file.

  • Il nome di Workplace Analytics è il nome di questo attributo nei dati di Workplace Analytics dell'organizzazione.Workplace Analytics name is the name of this attribute in your organization's Workplace Analytics data.

  • Il tipo di dati è il tipo di dati dei campi, ad esempio Posta elettronica o DateTime.Data type is the data type of the fields, such as Email or DateTime.

    Note

    Se il tipo di dati è Boolean, il valore del campo Boolean deve essere VERO o FALSO.If the data type is Boolean, the value for the Boolean field must be TRUE or FALSE.

  • Includi nel report consente di decidere come trattare i dati sensibili nel report che verrà generato sull'operazione di importazione.Include in report lets you decide how to treat sensitive data in the report that will be generated about the import operation. Se sono disponibili le opzioni seguenti per ognuna delle colonne nei dati di origine:If offers the following options for each of the columns in your source data:

    Mappare le colonne dei campi dati da includere

    • Mostra nel report: consente di visualizzare il valore dei dati effettivi nel report esattamente come è stato importato nel file di dati dell'organizzazione.Show in report - Lets the actual data value display in the report just as it was imported in the organizational data file.
    • Escludi dal report: impedisce la visualizzazione del valore dei dati nel report.Exclude from report - Prevents the data value from appearing in the report. Per motivi di privacy dei dati, ad alcuni attributi (ad esempio ManagerID) viene assegnato automaticamente il valore "Escludi dal rapporto" e questo valore non può essere modificato.For data-privacy reasons, some attributes (such as ManagerID) are automatically assigned the value "Exclude from report" and this value cannot be changed.
    • Hash nel report: consente di de-identificare i dati sensibili.Hash in report - De-identifies sensitive data. Questa opzione include i dati del report generati sull'operazione di importazione, ma invece di visualizzare il valore effettivo che è stato preso dal file di origine, mostra una versione con hash del valore, un formato che non può essere letto.This option includes the data in the report that it generates about the import operation, but instead of displaying the actual value that was taken from the source file, it shows a hashed version of the value – a format that cannot be read.

Per mappare i campiTo map fields

Dopo aver completato i passaggi in Caricamento file,eseguire le operazioni seguenti per mappare i campi:After you complete the steps in File upload, do the following to map the fields:

  1. In Carica mappare i campi obbligatori.In Upload, map the required fields.

    Tabella Campi di sistema

    1. Determinare quali colonne del file CSV corrispondono alla seconda colonna della tabella (nome Workplace Analytics).Determine which of the columns in your .csv file correspond to the second column in the table (Workplace Analytics name).
    2. In Colonna di origine (la prima colonna della tabella) selezionare il nome corrispondente al nome dell'attributo workplace analytics applicabile.In Source column (the first column in the table), select the name that corresponds with the applicable Workplace Analytics attribute name.
    3. Selezionare o immettere i valori applicabili per le altre colonne, incluse le opzioni Tipo di dati e Report.Select or enter the applicable values for the other columns, including the Data type and Report options.
    4. Ripetere questi passaggi per tutti i campi di sistema obbligatori.Repeat these steps for all the required system fields.
  2. Eseguire il mapping dei campi facoltativi e personalizzati, se applicabile.Map the optional and custom fields, as applicable. È necessario eseguire solo il mapping delle colonne nel file di dati di origine (csv) che l'organizzazione considera importanti per l'analisi.You only need to map the columns in the source data (.csv) file that your organization considers important for analysis. Ad esempio, se StartDate è importante e i dati contengono questo campo, mapparlo.For example, if StartDate is important and your data contains this field, map it.

    1. Nella colonna Source (la prima colonna della tabella) selezionare i nomi applicabili per i dati che si desidera caricare.In Source column (the first column in the table), select the applicable names for the data you want to upload.
    2. Selezionare o immettere i valori per le altre colonne della tabella, ad esempio il tipo di dati e le opzioni del report.Select or enter the values for the other columns in the table, such as the data type and report options.
    3. Ripetere questi passaggi per tutti i campi personalizzati importanti per l'organizzazione.Repeat these steps for all custom fields that are important to your organization.
    Custom fields table
  3. In Invia per convalida selezionare la casella di controllo per Confermare che i mapping siano corretti e quindi selezionare Avanti.In Submit for validation, select the check box for I confirm that these mappings are correct, and then select Next. Verrà visualizzato un avviso che indica che il file è in caricamento.You'll then see a notice about "your file is uploading."

Important

È necessario rimanere connessi durante il caricamento del file oppure il caricamento verrà annullato.You must stay logged in while the file is uploading or the upload will be canceled. Il caricamento richiede che questa pagina sia aperta nel Web browser durante il caricamento.The upload requires this page to be open in your web browser during the upload. Se si chiude il browser (o questa pagina del browser), il caricamento avrà esito negativo.If you close the browser (or this browser page), the upload will fail.

  1. Il passaggio successivo è convalida dei dati.The next step is Data validation.

Convalida datiData validation

Dopo aver completato i passaggi descritti in Mapping dei campi,nella pagina Caricamento viene visualizzato il messaggio seguente:After you complete the steps in Field mapping, the Upload page shows the following message:

Caricamento del file in esecuzione

Dopo il caricamento corretto del file, viene avviata la convalida dei file:After the file has successfully uploaded, file validation starts:

Convalida in questo momento

Nella maggior parte dei casi, la convalida dei file deve essere completata molto rapidamente.In most cases, file validation should complete very quickly. Se il file di dati dell'organizzazione è molto grande, la convalida potrebbe richiedere fino a uno o due minuti.If your organizational data file is very large, validation could take up to one or two minutes.

Durante questo passaggio, se si decide che i dati che si stanno caricando non sono i dati corretti e si desidera caricare un file di dati diverso, selezionare Annulla.During this step, if you decide that the data you are uploading is not the correct data and that you want to upload a different data file instead, select Cancel.

Al termine di questa fase, il file ha superato o non è riuscita la convalida.After this phase completes, the file has either passed or failed validation. Passare alla sezione appropriata:Go to the appropriate section:

Convalida completataValidation succeeds

Convalida non riuscitaValidation fails

Convalida completataValidation succeeds

Se la convalida ha esito positivo, nella sezione Risultati di convalida verrà visualizzata la notifica Esito positivo, in cui sono riportate informazioni sui dati caricati e convalidati correttamente:If validation succeeds, in the Validation results section, the page displays the Succeeded notification, which reports information about the data that was successfully uploaded and validated:

Convalida completata

Dopo la convalida, Workplace Analytics elabora i nuovi dati.After successful validation, Workplace Analytics processes your new data.

È possibile selezionare Impostazioni > carica dati > dell'organizzazione per visualizzare la pagina Carica cronologia.You can select Settings > Upload > Organizational data to show the Upload history page. È quindi possibile selezionare Operazioni riuscite per visualizzare i flussi di lavoro convalidati e caricati correttamente.You can then select Successes to see the workflows that were successfully validated (and uploaded).

In questa pagina sono disponibili le opzioni seguenti:On this page, you have the following options:

  • Selezionare l'icona Visualizza (occhio) per visualizzare un riepilogo dei risultati della convalida.Select the View (eye) icon to see a summary of the validation results.
  • Selezionare l'icona Mapping per visualizzare le impostazioni di mapping per il flusso di lavoro.Select the Mapping icon to see the mapping settings for the workflow.
  • Selezionare l'icona Di convalida (download) per visualizzare un elenco di avvisi di convalida.Select the Validation (download) icon to see a list of validation warnings.

Note

Ogni tenant può avere un solo caricamento in corso alla volta.Each tenant can have only one upload in progress at a time. È pertanto necessario completare il flusso di lavoro di un file di dati, ovvero guidarlo a una convalida corretta o abbandonarlo, prima di iniziare il flusso di lavoro del file di dati successivo.Therefore you need to complete the workflow of one data file, which means you either guide it to a successful validation or abandon it, before you begin the workflow of the next data file. Lo stato o la fase del flusso di lavoro di caricamento viene visualizzato sulla barra di avanzamento nella parte superiore della pagina Caricamento.The status or stage of the upload workflow is shown on the progress bar across the top of the Upload page.

Convalida non riuscitaValidation fails

Se la convalida dei dati ha esito negativo, nella pagina di installazione viene visualizzata una notifica "Impossibile convalidare" nell'area Dettagli caricamento.If data validation fails, the Setup page shows a "could not be validated" notification in the Upload details area. In questa pagina vengono inoltre presentate le opzioni per procedere.This page also presents you with options of how to proceed.

Convalida non riuscita

Prima di risolvere il problema, è possibile selezionare Scarica registro errori.Before you address the problem, you can select Download error log. Questo file di registro descrive i problemi nei dati che potrebbero aver causato gli errori di convalida.This log file describes the problems in your data that might have caused the validation errors. Utilizzare queste informazioni per decidere cosa fare successivamente per correggere i dati — di origine o modificare le impostazioni di mapping.Use this information to decide what to do next — fix the source data or change your mapping settings. Nella sezione seguente vengono descritte queste opzioni:The following section describes these options:

Opzioni dopo la convalida non riuscitaOptions upon failed validation

Natura degli erroriNature of errors Selezione consigliataRecommended selection DescrizioneDescription
Errori secondari, di piccole dimensioniMinor errors, small in number Selezionare Modifica mappingSelect Edit mapping Viene visualizzata la pagina mapping campi , in cui è possibile modificare il modo in cui si esegue il mapping dei campi dei file di origine agli attributi di analisi sul posto di lavoro e quindi ripetere il tentativo di convalida.This displays the Field Mapping page, on which you can change how you map source-file fields to Workplace Analytics attributes and then re-attempt validation. È possibile eseguire questa operazione senza modificare e caricare di nuovo il file di origine.You can do this without changing and re-uploading the source file. Questo è il metodo migliore per gli errori secondari, ad esempio il mapping della colonna errata nel file di origine a un attributo specifico.This is best for minor errors such as having mapped the wrong column in the source file to a particular attribute.
Errori principaliMajor errors Selezionare il file di caricamentoSelect Upload file Viene visualizzata la prima pagina di caricamento dei file .This displays the first File upload page. Si consideri questa opzione nel caso di errori principali nei dati caricati originariamente.Consider this option in the case of major errors in the originally uploaded data. In primo luogo, modificare il file di dati di origine per correggere tali errori e quindi ritentare il processo di caricamento e convalida con il file corretto.First, edit the source-data file to fix those errors and then re-attempt the upload and validation process with the corrected file.

Note

  • L'analisi dei luoghi di lavoro non modifica o inserisce dati mancanti dai caricamenti delle risorse umane, anche per EffectiveDate o TimeZone.Workplace Analytics does not modify or fill in data that is missing from HR uploads, even for EffectiveDate or TimeZone. L'amministratore è responsabile della correzione di tali errori o omissioni.The administrator is responsible for correcting such errors or omissions.

Linee guida per la correzione degli errori nei datiGuidelines for correcting errors in data

In questa sezione viene fornita una guida per la correzione dei dati in un file di origine caricato che causa errori di convalida.This section contains help for correcting data in an uploaded source file that is causing validation errors.

Quando una riga o una colonna di dati ha un valore non valido per qualsiasi attributo, l'intero caricamento avrà esito negativo fino a quando il file di origine non sarà fisso (o il mapping modificherà il tipo di convalida dell'attributo in modo da rendere valido il valore).When any data row or column has an invalid value for any attribute, the entire upload will fail until the source file is fixed (or the mapping changes the validation type of the attribute in a way that makes the value valid).

Regole per le intestazioni dei campiRules for field headers

Tutti i nomi di colonna o di intestazione di campo devono:All field header or column names must:

  • Iniziare con una lettera (non con un numero)Begin with a letter (not a number)
  • Contiene solo caratteri alfanumerici (lettere e numeri, ad esempio Data1)Only contain alphanumeric characters (letters and numbers, for example Date1)
  • Disporre di almeno una lettera minuscola (Hrbp); tutti i caratteri maiuscoli non funzionano (HRBP)Have at least one lower-case letter (Hrbp); all uppercase won’t work (HRBP)
  • Corrisponde esattamente come indicato per gli attributi facoltativi Obbligatori e Riservati di Workplace Analytics, inclusa la distinzione tra maiuscole e minuscole (ad esempio PersonId e HireDate)Match exactly as listed for Workplace Analytics’ Required and Reserved optional attributes, including for case sensitivity (for example PersonId and HireDate)
  • Non contenere spazi o caratteri speciali iniziali o finali (non alfanumerici, ad esempio @, #, %, &); se sono inclusi spazi o caratteri speciali, Workplace Analytics li rimuoverà dal nomeHave no leading or trailing blank spaces or special characters (non-alphanumeric, such as @, #, %, &); if spaces or special characters are included, Workplace Analytics will remove them from the name

Regole per i valori dei campiRules for field values

I valori dei campi nelle righe di dati devono essere conformi alle regole di formattazione seguenti:The field values in data rows must comply with the following formatting rules:

  • I valori dei campi EffectiveDate e HireDate obbligatori devono essere nel formato MM/GG/AAAA.The required EffectiveDate and HireDate field values must be in the MM/DD/YYYY format.
  • I valori dei campi PersonId e ManagerId obbligatori devono essere un indirizzo di posta elettronica valido (ad esempio, gc@contoso.com).The required PersonId and ManagerId field values must be a valid email address (for example, gc@contoso.com).
  • I valori del campo TimeZone obbligatori devono essere in un formato windows supportato.The required TimeZone field values must be in a supported Windows format.
  • I valori del campo Layer obbligatorio devono contenere solo numeri.The required Layer field values must contain numbers only.
  • I valori del campo HourlyRate obbligatori devono contenere solo numeri, che Workplace Analytics presuppone sia in dollari USA per i calcoli e l'analisi dei dati.The required HourlyRate field values must contain numbers only, which Workplace Analytics assumes is in US dollars for calculations and data analysis.
  • Limitare la lunghezza dei caratteri dei valori di campo nelle righe a un massimo di 128 KB, ovvero circa 1024 x 128 caratteri.Limit the character length of field values in rows to a maximum of 128 KB, which is about 1024 x 128 characters.

Note

Workplace Analytics attualmente non esegue conversioni di valuta per i dati HourlyRate.Workplace Analytics does not currently perform currency conversions for HourlyRate data. Tutti i calcoli e l'analisi dei dati in Workplace Analytics presuppongono che i dati siano in dollari STATUNITENSI.All calculations and data analysis in Workplace Analytics assume the data to be in US dollars.

Regole per i caratteri nei valori dei campiRules for characters in field values
  • I valori del campo sono consentiti caratteri a byte doppio, ad esempio i caratteri giapponesi.Double-byte characters, such as Japanese characters, are permitted in the field values.

  • I caratteri seguenti non sono consentiti nei valori dei campi:The following characters are not permitted in field values:

    • tilde (~)tilde (~)
    • "nuova riga" (\n)"new line" (\n)
    • Virgolette doppie (" ")Double quotes (" ")
    • Virgolette singole (' ')Single quotes (' ')