Esportare i dati degli utenti da Microsoft Planner
Importante
Questo articolo si applica a:
- Piani di base nell'app Planner in Teams
- Tutti i piani in altri endpoint di Planner (inclusi Planner connettori Web, Planner per dispositivi mobili e Planner)
Non si applica agli elenchi Attività o ai piani Premium nell'app Planner in Teams. Altre informazioni sull'app Planner in Teams
L'articolo descrive in che modo un amministratore globale può esportare i dati per uno specifico utente da Microsoft Planner. I dati esportati includono i dati sull'utente contenuti in Planner e anche i dati contenuti nei piani di cui l'utente faceva parte. Il processo di esportazione si esegue tramite Windows PowerShell.
Nota
Un amministratore globale può esportare i dati di telemetria degli utenti di Microsoft Planner tramite lo strumento di esportazione di log di dati in Microsoft Service Trust Portal.
Prerequisiti per apportare modifiche a Planner in Windows PowerShell
Seguire la procedura descritta in Prerequisiti per apportare modifiche a Planner in Windows PowerShell per apportare modifiche a Planner in Windows PowerShell.
Per esportare il contenuto utente da Planner
Da Windows PowerShell, usare il cmdlet Export-PlannerUserContent per esportare il contenuto utente da Planner.
Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>Parametro Descrizione UserAadIdOrPrincipalName Usare il Microsoft Entra ID o l'UPN dell'utente per cui si vuole esportare il contenuto. ExportDirectory Posizione in cui archiviare i file di output. La cartella deve esistere già. HostName È necessario usare questo parametro solo se si accede a Planner tramite un nome host diverso dall'attività.Ufficio.com. Ad esempio, se si accede a Planner tramite attività.office365.us, includere le attività -HostName.office365.us nel comando. Ad esempio, il comando seguente consente di esportare le informazioni utente di Adam Barr da Planner usando il suo UPN e scaricare i file di esportazione nel percorso C:\PlannerExportAdamBarr.
Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarrVerrà richiesto di eseguire l'autenticazione. Accedere come utente (amministratore globale) e non come utente da esportare.
Dopo l'esecuzione corretta del cmdlet di PowerShell, passare al percorso di esportazione per visualizzare i file di dati dell'utente esportati.
Dati che vengono esportati e come leggerli
Dopo aver eseguito il cmdlet di PowerShell per esportare i dati dell'utente da Planner, si riceveranno due tipi di file nella cartella del percorso di download:
- Un singolo file utente in formato JSON con informazioni sull'utente.
- Un file JSON per ogni piano in cui l'utente:
- Ha un'attività assegnata.
- Ha creato un'attività.
Come leggere i file esportati
È possibile usare le informazioni in questa sezione per comprendere le proprietà che verranno visualizzate nei file json ricevuti sia dall'utente che dal piano.
File utente
Il nome file dell'utente inizierà con il prefisso "User" e l'ID di Microsoft Planner dell'utente. Avrà le proprietà seguenti:
| Proprietà | Descrizione |
|---|---|
| User.Id | ID di Microsoft Planner dell'utente. |
| User.ExternalId | Microsoft Entra ID dell'utente. |
| User.DisplayName | Nome visualizzato dell'utente. |
| User.InternalDisplayName | Nome visualizzato di Microsoft Planner dell'utente. |
| User.UserPrincipalName | Nome dell'entità utente (UPN) dell'utente. |
| User.PrincipalType | Il valore è sempre "Utente". |
| User.UserDetailsId | Identificatore univoco dell'oggetto dettagli per l'utente. |
| User.ICalendarPublishEnabled | Se è True, la condivisione ICalendar è abilitata per il piano. Per altre informazioni, vedere Visualizzare il calendario di Planner in Outlook. |
| User.OptedInNotifications | Notifiche per cui l'utente ha dato il consenso esplicito. |
| User.OptedOutNotifications | Notifiche per cui l'utente ha rifiutato esplicitamente il consenso. |
| User.FavoritePlans | Segnalibro per i piani che l'utente ha incluso tra i preferiti. |
| User.FavoritePlans.Id | ID di Microsoft Planner del piano. |
| User.FavoritePlans.BookmarkName | Nome assegnato al segnalibro. |
| User.FavoritePlans.OrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| User.RecentPlans | Piani aperti di recente dall'utente. |
| User.RecentPlans.Id | ID di Microsoft Planner del piano. |
| User.RecentPlans.BookmarkName | Nome assegnato al segnalibro. |
| User.RecentPlans.LastAccess | Data dell'ultima apertura del piano. |
| User.UserData | Dati personalizzati del client Web di Planner. |
| User.UserData.Key | Chiave dati personalizzata. |
| User.UserData.Value | Valore dati personalizzato. |
| User.AssignedTaskOrdering | Ordinamento per le attività assegnate all'utente. |
| User.AssignedTaskOrdering.PlanId | ID di Microsoft Planner del piano che contiene l'attività. |
| User.AssignedTaskOrdering.Id | ID di Microsoft Planner dell'attività. |
| User.AssignedTaskOrdering.Order | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| User.AssignedTaskOrdering.Title | Titolo dell'attività. |
File dei piani
Il nome file di ogni piano inizierà con il prefisso "Plan" e l'ID di Microsoft Planner del piano. Ogni file avrà le proprietà seguenti:
| Proprietà | Descrizione |
|---|---|
| Plan.Id | ID di Microsoft Planner del piano. |
| Plan.Title | Titolo del piano. Nota: i piani con il titolo RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} indicano che il file corrente rappresenta un elenco creato ma al suo interno non è ancora stato creato un piano. |
| Plan.Owner | Proprietario del piano (un'entità gruppo o utente). |
| Plan.Owner.Id | ID di Microsoft Planner dell'entità (gruppo o utente). |
| Plan.Owner.ExternalId | Microsoft Entra ID dell'entità (gruppo o utente). |
| Plan.Owner.DisplayName | Nome visualizzato del proprietario (gruppo o utente). |
| Plan.Owner.UserPrincipalName | Nome dell'entità utente (UPN) se il proprietario è un utente. |
| Plan.Owner.PrincipalType | Tipo di entità (gruppo o utente). |
| Plan.Container | Contenitore per il piano. |
| Plan.Container.ContainerType | Tipo di contenitore (gruppo, elenco partecipanti). |
| Plan.Container.ExternalId | Microsoft Entra ID del gruppo. |
| Plan.Container.Description | Nome visualizzato del gruppo. |
| Plan.CreatedDate | Data e ora di creazione del piano. |
| Plan.CreatedBy | Utente che ha creato il piano. Per altre informazioni, vedere Proprietà utente. |
| Plan.ModifiedDate | Data e ora dell'ultimo aggiornamento del piano. |
| Plan.ModifiedBy | Nome dell'ultimo utente che ha aggiornato il piano. Per altre informazioni, vedere Proprietà utente. |
| Plan.PlanDetailsId | Identificatore univoco dell'oggetto dettagli del piano. |
| Plan.ICalendarPublishEnabled | Se è True, la condivisione ICalendar è abilitata per il piano. Per altre informazioni, vedere le attività in un calendario . |
| Plan.CreateTaskCommentWhen | Eventi che comporteranno la creazione di un commento per un'attività nel piano. |
| Plan.ReferencesToPlan | Sistemi esterni collegati al piano. Ad esempio, se si incorpora un piano di Microsoft Planner nel client desktop di Project Online. |
| Plan.ReferencesToPlan.ExternalId | ID del sistema esterno per il piano. |
| Plan.ReferencesToPlan.AssociationType | Tipo di collegamento al piano, specificato dall'app esterna. |
| Plan.ReferencesToPlan.CreatedDate | Data e ora di creazione dell'oggetto riferimento. |
| Plan.ReferencesToPlan.CustomLinkText | Testo utilizzabile per la visualizzazione dell'URL. |
| Plan.ReferencesToPlan.DisplayAs | Specifica come presentare in un'esperienza utente i dati di riferimento come l'URL. |
| Plan.ReferencesToPlan.IsCreationContext | È impostato su true se il riferimento è stato impostato durante la creazione del piano. |
| Plan.ReferencesToPlan.OwnerAppId | ID dell'app che ha creato il riferimento. |
| Plan.ReferencesToPlan.DisplayNameSegments | Percorsi di navigazione della posizione che descrive cosa fa riferimento al piano. |
| Plan.ReferencesToPlan.Url | Collegamento diretto all'app che fa riferimento al piano. |
| Plan.CategoryDescriptions | Set completo di categorie per il piano. |
| Plan.CategoryDescriptions.Index | Indice della descrizione categoria. |
| Plan.CategoryDescriptions.Description | Testo dell'etichetta per il valore di indice della descrizione categoria corrispondente. |
| Plan.PlanFollowers | Se Plan.Container.ContainerType è impostato su Group, questo campo indica gli utenti che seguono il piano. Se Plan.Container.ContainerType è impostato su Roster, questo campo indica gli utenti inclusi nell'elenco partecipanti. |
| Plan.TimelineId | Questa funzionalità è stata deprecata. |
| Plan.TimelineDisplaySettings | Questa funzionalità è stata deprecata. |
| Plan.TimelineLockedWidth | Questa funzionalità è stata deprecata. |
| Plan.Tasks | Oggetti attività per il piano. |
| Plan.Tasks.Id | Identificatore univoco dell'attività. |
| Plan.Tasks.Title | Nome dell'attività. |
| Plan.Tasks.BucketId | ID di Microsoft Planner del contenitore in cui si trova l'attività. |
| Plan.Tasks.BucketName | Nome del contenitore. |
| Plan.Tasks.PercentComplete | Stato di completamento dell'attività, da 0 a 100. |
| Plan.Tasks.StartDate | Data pianificata per l'inizio dell'attività. |
| Plan.Tasks.DueDate | Data pianificata per il completamento dell'attività. |
| Plan.Tasks.ConversationThreadId | Identificatore univoco della conversazione da Microsoft Exchange. |
| Plan.Tasks.PreviewType | Anteprima visualizzata nella scheda attività. |
| Plan.Tasks.OrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| Plan.Tasks.CreatedBy | Utente che ha creato l'attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.CreatedDate | Data di creazione dell'attività. |
| Plan.Tasks.CompletedBy | Utente che ha completato l'attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.CompletedDate | Data di completamento dell'attività. |
| Plan.Tasks.ModifiedBy | Ultimo utente che ha aggiornato l'attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.ModifiedDate | Data dell'ultimo aggiornamento dell'attività. |
| Plan.Tasks.AppliedCategories | Etichette selezionate dall'indice CategoryDescriptions per il piano. |
| Plan.Tasks.Recurrence | Definisce la ricorrenza attiva o inattiva per l'attività. null quando la ricorrenza non è mai stata definita per l'attività. |
| Plan.Tasks.Recurrence.SeriesId | La serie di ricorrenza a cui appartiene questa attività. Valore basato su GUID che funge da identificatore univoco per una serie. |
| Plan.Tasks.Recurrence.OccurrenceIndex | Indice basato su 1 di questa attività all'interno della serie di ricorrenza. La prima attività di una serie ha il valore 1, l'attività successiva della serie ha il valore 2e così via. |
| Plan.Tasks.Recurrence.PreviousInSeriesTaskId | ID attività dell'attività precedente in questa serie. null per la prima attività di una serie perché non ha predecessori. Ogni attività successiva della serie ha un valore corrispondente al predecessore. |
| Plan.Tasks.Recurrence.NextInSeriesTaskId | ID attività dell'attività successiva in questa serie. Questo valore viene assegnato al momento della creazione dell'attività successiva nella serie ed è null precedente a tale data. |
| Plan.Tasks.Recurrence.RecurrenceStartDate | Data e ora di inizio della serie di ricorrenza. Per la prima attività di una serie (OccurrenceIndex = 1) questo valore corrisponde a Schedule.Range.StartDate. Per le attività successive della serie (OccurrenceIndex>= 2) questo valore viene copiato dall'attività precedente e non viene mai modificato. Mantiene la data di inizio della serie ricorrente. |
| Plan.Tasks.Recurrence.Schedule | Pianificazione per la ricorrenza. null indica che la ricorrenza è stata annullata. Si noti che se viene assegnato NextInSeriesTaskId , questo valore di pianificazione verrà mantenuto come snapshot dell'aspetto della pianificazione al momento del completamento dell'attività. |
| Plan.Tasks.Recurrence.Schedule.Pattern | Modello per la ricorrenza. Il modello, insieme a Schedule.Range, viene usato per calcolare Schedule.NextOccurrenceDate. |
| Plan.Tasks.Recurrence.Schedule.Pattern.IsDailyCadence | True per la cadenza giornaliera (nel qual caso DaysOrDates è vuoto). False in caso contrario ,ovvero per cadenza settimanale, mensile o annuale. |
| Plan.Tasks.Recurrence.Schedule.Pattern.Interval | Intervallo applicato al tipo di cadenza. I valori maggiori di 1 indicano che un punto verrà ignorato. Esempi: per un modello Daily, un intervallo di 2 indica che le attività si ripeteranno ogni due giorni (o ogni altro giorno). Per un modello mensile, un intervallo di 3 indica che le attività si ripeteranno ogni tre mesi (noto anche come trimestrale). |
| Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates | Ogni voce in questa raccolta rappresenta la definizione esattamente di un giorno o di una data. Esempio: "FixedYearly,August,15" indica il 15 agosto dell'anno. "FloatingMonthly,Second,Monday" significa il secondo lunedì del mese. "Weekly,Wednesday","Weekly,Friday" indica ogni settimana il mercoledì e il venerdì. |
| Plan.Tasks.Recurrence.Schedule.Pattern.FirstDayOfWeek | Il primo giorno della settimana (in genere domenica); questo viene usato solo dai modelli settimanali ed è null per modelli non settimanali. |
| Plan.Tasks.Recurrence.Schedule.Range | Specifica quando viene avviata e terminata la ricorrenza. |
| Plan.Tasks.Recurrence.Schedule.Range.StartDate | Data da cui deve iniziare l'oggetto Recurrence.Schedule . Questo valore può essere aggiornato dagli utenti quando si apportano modifiche a Recurrence.Schedule.Pattern. |
| Plan.Tasks.Recurrence.Schedule.Range.Kind | Attualmente l'unico valore supportato è NoEnd, che indica che la serie non terminerà automaticamente. |
| Plan.Tasks.Recurrence.Schedule.NextOccurrenceDate | Data successiva per questo oggetto Recurrence.Schedule. Quando viene creata un'istanza di una nuova attività per continuare la serie di ricorrenza, questa data viene usata per duedate della nuova attività. |
| Plan.Tasks.TaskDetailsId | Identificatore univoco dell'oggetto dettagli per l'attività. |
| Plan.Tasks.Description | Descrizione dell'attività. |
| Plan.Tasks.AssignedToTaskBoardFormatId | Identificatore univoco per l'oggetto che rappresenta il formato della bacheca delle attività. |
| Plan.Tasks.AssignedToTaskBoardFormatUnassignedOrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee | Suggerimento per l'ordinamento per ogni assegnatario. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo: | Utente a cui è assegnata l'attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.Order | Ordinamento delle attività specificato dall'assegnatario nella visualizzazione Assegnata a. |
| Plan.Tasks.BucketTaskBoardFormatId | Identificatore univoco per l'oggetto che rappresenta il formato della bacheca delle attività del contenitore. |
| Plan.Tasks.BucketTaskBoardFormatOrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| Plan.Tasks.ProgressTaskBoardFormatId | Identificatore univoco per l'oggetto, se raggruppato in base allo stato di avanzamento anziché al formato del contenitore. |
| Plan.Tasks.ProgressTaskBoardFormatOrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| Plan.Tasks.TimelineFormatId | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatShowOnTimeline | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatAnchorPosition | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatCalloutHeight | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatColor | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatDrawingStyle | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatLabelOffsetX | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatLabelOffsetY | Questa funzionalità è stata deprecata. |
| Plan.Tasks.TimelineFormatSwimlane | Questa funzionalità è stata deprecata. |
| Plan.Tasks.References | Collegamenti esterni. |
| Plan.Tasks.References.Url | URL del collegamento. |
| Plan.Tasks.References.Alias | Descrizione testuale del collegamento. |
| Plan.Tasks.References.Type | Tipo di file collegato. |
| Plan.Tasks.References.ModifiedBy | Ultimo utente che ha aggiornato il collegamento. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.References.ModifiedDate | Data dell'ultimo aggiornamento del collegamento. |
| Plan.Tasks.References.PreviewPriority | Rappresenta la priorità di un riferimento da mostrare come anteprima dell'attività nell'interfaccia utente. Microsoft Planner mostra solo l'elemento con la priorità più alta. |
| Plan.Tasks.Assignments | Assegnazioni di attività. |
| Plan.Tasks.Assignments.AssignedTo | Utente a cui è assegnata quell'attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.Assignments.AssignedBy | Utente che ha assegnato l'attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.Assignments.Order | Ordine delle assegnazioni se l'attività è assegnata a più entità. |
| Plan.Tasks.Checklist | Elenco di controllo per l'attività. |
| Plan.Tasks.Checklist.Id | Identificatore univoco di una voce dell'elenco di controllo. |
| Plan.Tasks.Checklist.Title | Nome della voce dell'elenco di controllo. |
| Plan.Tasks.Checklist.OrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| Plan.Tasks.Checklist.IsChecked | Se è True, la voce dell'elenco di controllo è stata completata. |
| Plan.Tasks.Checklist.ModifiedBy | Ultimo utente che ha aggiornato l'elenco di controllo. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.Checklist.ModifiedDate | Data dell'ultimo aggiornamento dell'elenco di controllo. |
| Plan.Tasks.UserContentLastModifiedBy | Ultimo utente che ha aggiornato l'attività o i dettagli attività. Per altre informazioni, vedere Proprietà utente. |
| Plan.Tasks.UserContentLastModifiedDate | Data dell'ultimo aggiornamento dell'attività o dei dettagli attività. |
| Plan.Buckets | Oggetti contenitore per il piano. |
| Plan.Buckets.Id | Identificatore univoco del contenitore. |
| Plan.Buckets.Title | Nome del contenitore. |
| Plan.Buckets.OrderHint | Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner. |
| Plan.Buckets.Createdby | Utente che ha creato il contenitore. Per altre informazioni, vedere Proprietà utente. |
| Plan.Buckets.CreatedDate | Data di creazione del contenitore. |
| Plan.Buckets.ModifiedBy | Ultimo utente che ha aggiornato il contenitore. Per altre informazioni, vedere Proprietà utente. |
| Plan.Buckets.ModifiedDate | Data dell'ultimo aggiornamento del contenitore. |
Proprietà utente nel file Plans.json
Esistono molti oggetti nei dati Plans.json che rappresentano un utente Microsoft Planner e avranno proprietà simili. Questi oggetti includono:
- Plan.CreatedBy
- Plan.ModifiedBy
- Plan.PlanFollowers
- Plan.Tasks.CreatedBy
- Plan.Tasks.CompletedBy
- Plan.Tasks.ModifiedBy
- Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo
- Plan.Tasks.References.ModifiedBy
- Plan.Tasks.Assignments.AssignedTo
- Plan.Tasks.Assignments.AssignedBy
- Plan.Tasks.Checklists.ModifiedBy
- Plan.Bucket.Createdby
- Plan.Bucket.Modifiedby
Ognuno degli oggetti elencati avrà le proprietà seguenti:
| Proprietà | Descrizione |
|---|---|
| ID | ID di Microsoft Planner dell'utente. |
| ExternalId | Microsoft Entra ID dell'utente. |
| DisplayName | Nome visualizzato dell'utente. |
| UserPrincipalName | Nome dell'entità utente (UPN) dell'utente. |
| PrincipalType | Tipo di entità (utente o gruppo). |