Procedura: Usare il rilevamento dei documenti
Importante
Le versioni di Microsoft Rights Management Service SDK rilasciate prima di marzo 2020 sono deprecate; le applicazioni che usano versioni precedenti devono essere aggiornate per usare la versione di marzo 2020. Per informazioni dettagliate, vedere l'avviso di deprecazione.
Non sono previsti ulteriori miglioramenti per Microsoft Rights Management Service SDK. È consigliabile adottare l'SDK di Microsoft Information Protection per la classificazione, l'etichettatura e i servizi di protezione.
L'uso della funzionalità di rilevamento dei documenti richiede la comprensione di alcuni aspetti semplici relativi alla gestione dei metadati associati e alla registrazione con il servizio.
Gestione dei metadati associati al rilevamento dei documenti
Tutti i sistemi operativi che supportano il rilevamento dei documenti presentano implementazioni simili, tra cui un set di proprietà che rappresentano i metadati, un nuovo parametro aggiunto ai metodi di creazione dei criteri utente e un metodo per la registrazione dei criteri di cui tenere traccia con il servizio di rilevamento dei documenti.
Dal punto di vista operativo, solo le proprietà relative al nome contenuto e al tipo di notifica sono necessarie per rilevamento dei documenti.
La sequenza di passaggi da usare per configurare il rilevamento dei documenti per un dato contenuto è la seguente:
- Creare un oggetto metadati di licenza e impostare il nome contenuto e il tipo di notifica. Queste sono le uniche proprietà necessarie.
- LicenseMetadata per Android
- MSLicenseMetadata per iOS
Scegliere il tipo di criterio: modello o ad hoc:
Per il rilevamento dei documenti basato su modello, creare un oggetto criteri utente passando i metadati di licenza come parametro.
- UserPolicy.create per Android
- MSUserPolicy.userPolicyWithTemplateDescriptor per iOS
Per il rilevamento dei documenti su base ad hoc, impostare la proprietà metadati di licenza sull’oggetto descrittore criteri.
Android - PolicyDescriptor.setLicenseMetadata
iOS - MSPolicyDescriptor.licenseMetadata.
Nota L'oggetto metadati della licenza è accessibile direttamente durante il processo di configurazione del rilevamento dei documenti per i criteri utente specificati. Dopo la creazione dell'oggetto criteri utente, i metadati di licenza associati non sono accessibili, ad esempio la modifica dei valori dei metadati di licenza non produce alcun effetto.
Chiamare alla fine il metodo di registrazione alla piattaforma per il rilevamento dei documenti.