Comment : utiliser le suivi de documents
Important
Les versions du Kit de développement logiciel (SDK) du service Microsoft Rights Management publiées avant mars 2020 sont déconseillées ; les applications utilisant des versions antérieures doivent être mises à jour pour utiliser la version de mars 2020. Pour plus d’informations, consultez l’avis de dépréciation.
Aucune autre amélioration n’est prévue pour le Kit de développement logiciel (SDK) du service Microsoft Rights Management. Nous vous recommandons vivement d’adopter le KIT de développement logiciel (SDK) Protection des données Microsoft pour les services de classification, d’étiquetage et de protection.
L’utilisation de la fonctionnalité de suivi des documents nécessite une connaissance de base de la gestion des métadonnées associées et de l’inscription auprès du service.
Gestion des métadonnées de suivi des documents
Chacun des systèmes d’exploitation prenant en charge le suivi des documents a des implémentations similaires. Elles comprennent notamment un ensemble de propriétés qui représentent les métadonnées, un nouveau paramètre ajouté aux méthodes de création de stratégie utilisateur, et une méthode pour inscrire la stratégie afin de la suivre avec le service de suivi des documents.
Du point de vue opérationnel, seules les propriétés nom du contenu et type de notification sont nécessaires pour le suivi des documents.
La séquence d’étapes que vous utiliserez pour configurer le suivi des documents pour un élément de contenu donné est la suivante :
- Créez un objet de métadonnées de licence, puis définissez le nom du contenu et le type de notification. Ce sont les seules propriétés requises.
- Android - LicenseMetadata
- iOS - MSLicenseMetadata
Choisissez un type de stratégie, modèle ou ad hoc :
Pour le suivi des document en fonction du modèle, créez un objet stratégie utilisateur qui passe les métadonnées de licence en tant que paramètre.
- Android - UserPolicy.create
- iOS - MSUserPolicy.userPolicyWithTemplateDescriptor
Pour le suivi des document ad hoc, définissez la propriété métadonnées de licence sur l’objet descripteur de stratégie.
Android - PolicyDescriptor.setLicenseMetadata
iOS - MSPolicyDescriptor.licenseMetadata.
Note L’objet de métadonnées de licence n’est accessible que directement pendant le processus de configuration du suivi des documents pour la stratégie utilisateur donnée. Une fois l’objet de stratégie utilisateur créé, les métadonnées de licence associées ne sont plus accessibles. Par conséquent, la modification des valeurs des métadonnées de licence n’aura aucun effet.
Enfin, appelez la méthode d’inscription de plateforme pour le suivi des documents.