ApplyPreferences

Une étape basée sur ce modèle d'étape utilise un objet de mappage de propriétés pour interpréter un fichier de préférences. Les informations figurant dans le fichier de préférences sont utilisées pour ajouter ou mettre à jour une ou plusieurs valeurs de propriété de document dans le fichier des propriétés de document (DPF).

Lors de son exécution, l'étape utilise les paramètres de l'objet de mappage de propriétés pour déterminer :

  • À quelle propriété correspond chacune des colonnes du fichier de préférences.
  • Les propriétés utilisées pour identifier spécifiquement chaque document, dans le fichier de préférences et dans le fichier DPF. La valeur d'utilisation de ces propriétés est définie sur Identifier le document dans la section Mappage des propriétés.
  • Les valeurs de propriété à mettre à jour avec les informations du fichier de préférences. La valeur d'utilisation de ces propriétés est définie sur Mise à jour de propriétés dans la section Mappage des propriétés.

L'étape utilise alors les valeurs des propriétés Identifiant de document pour mettre en correspondance chacune des entrées du fichier de préférences avec un document dans le fichier DPF. Pour chaque ligne mise en correspondance, les valeurs des Propriétés de document à définir sont mises à jour.

Valeurs par défaut des propriétés du travail

  • Fichier de préférences :
  • Mappage des propriétés : Non défini

Remarques

  • Cette étape doit s'exécuter après une étape basée sur le modèle d'étape IdentifyDocuments ou IdentifyPDFDocuments.
  • Le fichier de préférences peut contenir des colonnes qui ne sont pas mappées aux propriétés de document. Les colonnes qui ne sont pas mappées sont ignorées.
  • Si plusieurs documents du fichier DPF correspondent à l'Identifiant de document, les modifications apportées aux propriétés de document sont répercutées sur tous les documents correspondants dans le fichier DPF.
  • Chaque entrée du fichier de préférences doit être associée à une combinaison de valeurs unique pour ses propriétés Identifiant de document. Si plusieurs lignes ont la même combinaison de valeurs, le travail est placé à l'état Erreur et un message est consigné dans le journal du travail. L'étape cesse de lire le fichier de préférences dès la première occurrence de cette erreur.
  • Si une entrée du fichier de préférences ne correspond à aucun document du fichier DPF, l'entrée est ignorée et aucun message n'est consigné.
  • Si le fichier DPF contient des documents qui ne sont associés à aucune entrée du fichier de préférences, toutes les propriétés ajoutées par l'étape ApplyPreferences sont également ajoutées à ces documents avec la valeur Null.
  • Si l'étape n'apporte aucune modification au fichier DPF associé à un travail, elle consigne un message d'avertissement dans le journal du travail.
  • La fonction de cette étape est semblable au modèle d'étape SetDocPropsFromList. L'étape ApplyPreferences peut définir plusieurs propriétés de document, tandis que le modèle d'étape SetDocPropsFromList ne peut en définir qu'une seule.