Configurazione iniziale — URL di base dell'API, distribuzione/aggiornamento di Azure, notifiche e-mail e Teams, e la sequenza di primo avvio

Last updated: July 12, 2026 by Steve

Configurazione iniziale

Impostazioni > Configurazione è la prima schermata da configurare dopo la distribuzione. Collega la web part di SharePoint al backend Azure, avvia il flusso di distribuzione/aggiornamento di Azure e controlla il modo in cui le notifiche raggiungono gli utenti. È necessario disporre del ruolo Administrator per aprirla.

Pannello di configurazione

URL di base dell'API

L'URL di base dell'API è l'indirizzo del servizio API di AccessPoint in Azure: la web part non può caricare i dati finché non viene impostato.

  1. URL API — Inserire l'URL dell'App Service dell'API di AccessPoint (ad esempio, https://app-accesspoint-contoso.azurewebsites.net). Deve utilizzare HTTPS.
  2. ID client — Inserire l'ID client (ID applicazione) della registrazione dell'app Entra ID dell'API. Deve essere un GUID valido.
  3. Fare clic su Salva. AccessPoint verifica che l'URL utilizzi HTTPS e che l'ID client sia un GUID valido prima di memorizzare la connessione.

Distribuzione e aggiornamento di Azure

La schermata di configurazione è anche il punto di accesso per il provisioning e l'aggiornamento del backend Azure:

  • Distribuisci su Azure avvia il modello ARM/Bicep nel portale di Azure, precaricato in modo da poter effettuare il provisioning di App Service, database SQL e archiviazione nella propria sottoscrizione.
  • Il flusso di aggiornamento riesegue lo stesso modello su una distribuzione esistente per applicare le nuove versioni.

Entrambi i processi sono descritti in dettaglio nella Guida alla distribuzione; consultarla per la procedura completa, inclusa l'installazione dell'app SPFx e Teams.

Impostazioni di notifica

Configurazione delle notifiche

Notifiche e-mail

  • Abilita/disabilita notifiche e-mail — Attiva o disattiva le notifiche e-mail per l'intero sistema.
  • Casella di posta mittente delle notifiche — Imposta l'indirizzo da cui vengono inviate le notifiche. Deve essere una cassetta postale condivisa o una cassetta postale utente nel tenant Microsoft 365 (ad esempio, noreply@contoso.com).
  • Fare clic su Convalida cassetta postale per verificare in tempo reale, tramite Microsoft Graph, che il service principal dell'API possa inviare messaggi dalla cassetta postale specificata.

Notifiche del feed attività di Teams

Le notifiche del feed attività di Teams sono attive per impostazione predefinita. Quando sono abilitate, gli utenti ricevono avvisi nel proprio feed attività di Microsoft Teams, in aggiunta (o in sostituzione) all'e-mail. Disattivarle in questo pannello se non sono desiderate.

Eseguire il controllo Convalida configurazione Teams per verificare che l'app sia registrata, che l'autorizzazione di invio delle attività sia concessa, che l'API dell'editore sia raggiungibile e che l'app sia presente nel catalogo.

Autorizzazioni necessarie

Queste autorizzazioni di Microsoft Graph devono essere concesse ai service principal pertinenti affinché le notifiche funzionino.

Service principal API

Autorizzazione Finalità
Mail.Send Invio delle notifiche e-mail
User.Read.All Risoluzione delle informazioni utente
TeamsAppInstallation.ReadForUser.All Verifica dello stato di installazione dell'app Teams
Application.Read.All Lettura delle registrazioni delle applicazioni
AppCatalog.Read.All Lettura del catalogo app di Teams

Applicazione aziendale multi-tenant Realizer

Autorizzazione Finalità
TeamsActivity.Send Invio delle notifiche del feed attività di Teams
AppCatalog.Read.All Lettura del catalogo app di Teams
User.Read Lettura del profilo utente di base

Queste autorizzazioni vengono configurate durante il processo di distribuzione.

Sequenza di primo avvio

Una volta salvata la configurazione, completare questi passaggi per rendere AccessPoint utilizzabile:

  1. Importare un pacchetto di configurazione. Accedere a Pacchetti di configurazione, scegliere il pacchetto per la propria giurisdizione (ad esempio, Canada ATIA, US FOIA o EU GDPR) e fare clic su Importa. Questa operazione popola in un unico passaggio i tipi di richiesta, gli stati, le esenzioni, le autorità legali, i modelli di notifica e corrispondenza, i calendari e le traduzioni.
  2. Assegnare i ruoli utente. Il primo utente che apre AccessPoint viene inizializzato con i ruoli Administrator e SAO. In Gestione utenti, aggiungere utenti dalla propria directory e assegnare i ruoli — almeno un altro Administrator per garantire la continuità, almeno un coordinatore/SAO per elaborare le richieste, e custodi, collaboratori, revisori o personale addetto alla privacy secondo necessità.
  3. Verificare calendari e lingue. Confermare che i Calendari abbiano i giorni del fine settimana, la giurisdizione e le festività previste dalla legge corretti, elementi che determinano il calcolo delle scadenze, e che l'elenco delle Lingue di sistema contenga le lingue attive corrette e quella predefinita. Il pacchetto imposta valori predefiniti ragionevoli, ma questi determinano le scadenze e ogni campo traducibile, quindi verificarli prima di andare in produzione.

AccessPoint è ora pronto per l'uso.