Configuration de l'exécution de l'utilitaire de ligne de commande UpdateSecurityLabels

L'activation de l'événement d'audit "Modifier les étiquettes de sécurité" allonge considérablement le temps d'exécution de l'utilitaire de ligne de commande UpdateSecurityLabels. Pour plus d'informations, consultez la section Activer l'événement Modifier les étiquettes de sécurité pour les audits.

Propriété

Description

wt.access.UpdateSecurityLabels.authorizedParticipant

Facultatif, mais recommandé pour limiter l'accès

Définissez cette propriété sur l'UFID de l'utilisateur, du groupe défini par l'utilisateur ou de l'organisation autorisé à exécuter l'utilitaire.

Par défaut, cette propriété est définie sur le groupe d'administrateurs de site.

wt.access.UpdateSecurityLabels.chunkSize

Facultatif

Définissez cette propriété pour indiquer le plus grand nombre d'objets mis à jour dans un fragment avant d'en commencer un autre. La définition de cette propriété peut améliorer les performances en cas de traitement d'un grand nombre de mises à jour. Par exemple, si vous exécutez l'utilitaire sur 100 000 objets, vous pourriez définir la taille de fragment sur 5 000 et 20 fragments seraient traités. En cas d'échec dans l'un des fragments, seul ce dernier doit être retraité : le traitement de tous les fragments n'ayant pas rencontré d'erreur peut continuer.

Par défaut, cette propriété est définie sur 1 000.

wt.access.UpdateSecurityLabels.noChangeValue

Facultatif

Définissez cette propriété pour indiquer la chaîne à utiliser pour garder certaines valeurs d'étiquette de sécurité inchangées, plutôt que de les définir sur une valeur spécifique.

Définissez la chaîne sur une valeur ne correspondant pas à une valeur valide d'étiquette de sécurité configurée. Pour les étiquettes de sécurité personnalisées, il peut s'agir d'une chaîne vide. Si vous définissez la propriété sur une valeur qui correspond à une valeur d'étiquette de sécurité, cette valeur n'est pas modifiée.

Par défaut, cette propriété n'est pas définie.

Propriété	Description
log4j.appender.UpdateSecurityLabelsReport	Obligatoire Cette propriété doit être définie sur wt.access.UpdateSLsReportAppender. Elle détermine le format du fichier de sortie généré par l'utilitaire.
log4j.appender.UpdateSecurityLabelsReport.File	Obligatoire Après l'exécution de l'utilitaire de ligne de commande UpdateSecurityLabels, un fichier de sortie de type TSV est généré. Cette propriété détermine l'emplacement d'enregistrement et le nom du fichier. Au nom de fichier, peuvent être ajoutés l'identificateur de machine virtuelle Java (%jid), l'identificateur de fil (%tid) et le temps en millisecondes (%time). PTC vous recommande d'ajouter au moins l'une de ces valeurs afin que chaque fichier de sortie porte un nom de fichier unique.
log4j.appender.UpdateSecurityLabelsReport.MaximumNumberOfRecords	Facultatif Définissez cette propriété pour indiquer le nombre maximal d'enregistrements pouvant apparaître dans le fichier de sortie. Lorsque ce nombre est atteint, le fichier de sortie est renommé avec un suffixe "_x", où "x" est le numéro du fichier, et un nouveau fichier de sortie est créé. Par exemple, si la propriété est définie sur 60 et qu'il existe 100 enregistrements, deux fichiers sont générés : Report_1, qui contient 60 enregistrements et Report, qui en contient 40. Si cette propriété n'est pas définie, sa valeur par défaut est 20 000.
log4j.appender.UpdateSecurityLabelsReport.MaximumFileSizeInBytes	Facultatif Définissez cette propriété pour indiquer la taille maximale du fichier de sortie en octets. Lorsque ce nombre est atteint, un nouveau fichier de sortie est généré. Il porte le suffixe "_x", où "x" est le numéro du fichier. Si cette propriété n'est pas définie, sa valeur par défaut est 10 Mo.
log4j.additivity.wt.access.UpdateSecurityLabelsReport	Facultatif Définissez cette propriété pour déterminer si les informations doivent être écrites dans le journal du serveur de méthodes en plus de leur consignation dans le fichier de sortie. Cette propriété est définie sur la valeur True par défaut.
log4j.logger.wt.access.UpdateSecurityLabelsReport	Obligatoire Définissez cette propriété pour déterminer le degré de détail du fichier de sortie. Les valeurs suivantes sont disponibles : • TRACE : affiche l'emplacement du fichier d'entrée, une ligne de résumé et le statut de chaque objet traité. • INFO : affiche l'emplacement du fichier d'entrée, une ligne de résumé et l'ensemble des échecs ou erreurs au niveau des objets individuels. • ERROR : affiche l'emplacement du fichier d'entrée et l'ensemble des échecs ou erreurs au niveau des objets individuels.