Procedura: Utilizzare le impostazioni di Information Rights Management

In Microsoft Office InfoPath 2007 sono disponibili due tipi di impostazioni di Information Rights Management (IRM)): un tipo per la protezione dell'accesso ai modelli di modulo di InfoPath e un tipo per il controllo dell'accesso e delle azioni nei dati contenuti nei moduli completati. Per utilizzare tali impostazioni nella progettazione di un modello di modulo, scegliere Gestisci credenziali dal menu File. Per utilizzare tali impostazioni nella compilazione di un modulo, scegliere Autorizzazioni dal menu File e quindi Gestisci credenziali. Per ulteriori informazioni sull'utilizzo della finestra di dialogo Autorizzazioni in InfoPath, vedere l'argomento "Creare un modello di modulo con autorizzazioni limitate" nella Guida di InfoPath.

Nota:
La limitazione delle autorizzazioni è disponibile solo per i modelli di modulo compatibili con InfoPath. I modelli di modulo compatibili con browser non supportano IRM. Se la voce Gestisci credenziali non è disponibile nel menu File durante la progettazione di un modello di modulo, controllare le impostazioni di compatibilità.

Modello a oggetti di IRM

Utilizzare la classe Permission per accedere alla classe UserPermissionCollection e alle impostazioni di autorizzazione di IRM che è possibile applicare a un modulo. Per accedere all'oggetto Permission associato a un modello di modulo, utilizzare la proprietà Permission della classe XmlForm. L'oggetto Permission restituito consente di accedere all'insieme di oggetti UserPermission associati al modello di modulo e a ogni istanza di modulo creata con tale modello.

L'oggetto Permission e i metodi e le proprietà corrispondenti sono disponibili indipendentemente dal fatto che le autorizzazioni sul modello di modulo attivo siano limitate o meno. Utilizzare la proprietà Enabled per determinare se un modulo dispone di autorizzazioni limitate.

Le autorizzazioni su un modulo vengono attivate in uno dei modi seguenti utilizzando proprietà e metodi della classe Permission:

Tramite l'impostazione della proprietà Enabled su true

Tramite l'impostazione della proprietà DocumentAuthor

Tramite l'impostazione della proprietà RequestPermissionUrl

Tramite l'impostazione della proprietà StoreLicenses su true o su false

Tramite la chiamata al metodo ApplyPolicy.

Nota:
Se nel computer dell'utente non è installato il client Windows Rights Management, l'utilizzo della classe Permission genera un'eccezione.

Per utilizzare a livello di programmazione le impostazioni di IRM per singoli utenti nei moduli, utilizzare le classi UserPermissionCollection e UserPermission.

Un oggetto UserPermission associa un set di autorizzazioni per il modulo corrente a un singolo utente e a una data di scadenza facoltativa. Utilizzare il metodo Add della classe UserPermissionCollection per aggiungere e concedere a un utente un set di autorizzazioni sul modulo corrente. Utilizzare il metodo Remove della classe UserPermissionCollection per rimuovere un utente e le relative autorizzazioni. Mentre alcune autorizzazioni concesse tramite l'interfaccia utente vengono applicate a tutti gli utenti, è possibile utilizzare le classi UserPermission e UserPermissionCollection per assegnare tali autorizzazioni a singoli utenti con date di scadenza diverse per ognuno. Il modello a oggetti consente agli sviluppatori di enumerare le impostazioni delle autorizzazioni in un modulo e di garantire agli utenti di tale modulo le funzionalità necessarie per aggiungere autorizzazioni senza utilizzare il riquadro attività Autorizzazione modulo o la finestra di dialogo Autorizzazioni.

Nota:

Non è possibile applicare le autorizzazioni quando il modulo è in modalità anteprima. Per tale motivo, quando un modulo viene visualizzato in anteprima, tutte le proprietà della classe Permission sono di sola lettura. In modalità anteprima, la proprietà Enabled restituirà sempre il valore false e, se il codice tenta di modificare questa impostazione, verrà generato un oggetto System.Runtime.InteropServices.COMException e verrà restituito l'errore "Proprietà/metodo non disponibile in modalità anteprima". Analogamente, anche i metodi associati alle classi UserPermission e UserPermissionCollection restituiranno questo messaggio di errore se utilizzati in modalità anteprima.

Informazioni generali sulla classe Permission

La classe UserPermissionCollection include le proprietà e il metodo seguenti.

Informazioni generali sulla classe UserPermissionCollection

La classe UserPermissionCollection include le proprietà e i metodi seguenti.

Informazioni generali sulla classe UserPermission

La classe UserPermission include le proprietà e il metodo seguenti.

Enumerazione PermissionType

Le autorizzazioni di un utente vengono impostate o lette utilizzando valori di enumerazione PermissionType.

Esempio

Nell'esempio seguente viene ottenuto l'insieme UserPermissionsCollection per il modulo corrente facendo clic sul controllo Pulsante, viene aggiunto e assegnato un utente al livello di accesso Change+++ e viene impostata una data di scadenza di due giorni dalla data corrente.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.Change, dtExpirationDate);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.Change, dtExpirationDate)
End Sub