Skip to main content

Data pages enregistrables

Data pages enregistrables

Vous pouvez utiliser des data pages enregistrables (savable data pages) pour sauvegarder une page ou une liste de pages de données spécifiées dans une data page dans son système d'enregistrement (System of Record, SOR), que le SOR soit Pega Platform™ ou un autre système comme une base de données externe. En utilisant une data page enregistrable, vous pouvez configurer une application pour actualiser le SOR en temps réel avec des données de dossier. La data page enregistrable peut gérer la transaction afin que les deux systèmes restent synchronisés, même si une erreur, telle qu'une panne de réseau, devait se produire.

Par exemple, une entreprise nommée TGB utilise une base de données externe comme SOR pour conserver les données des ressources humaines (RH), y compris un tableau de base de données qui stocke des données sur les places occupées par les employés. Lors de l’intégration des employés, un représentant des RH leur attribue un bureau inoccupé. Après que le représentant des RH a soumis les données sur les places attribuées aux employés, l’application actualise l'enregistrement à l’aide de l’ID employé dans le SOR afin qu’aucun autre utilisateur ne puisse sélectionner la même place lors de l’intégration d’un nouvel employé.

Savable data page and save data page step

Plan de sauvegarde des données

Le data save plan d'une data page enregistrable détaille comment les enregistrements sont effectués. Vous spécifiez le plan de sauvegarde des données dans la section data save options de la data page enregistrable. Vous pouvez spécifier plusieurs options d’enregistrement, qui sont chacune associées à une règle When qui détermine quand cette option d’enregistrement est utilisée. Les options permettant d’enregistrer des données sont : Database save, Activity, Connector, Robotic automation et Robotic desktop automation.

Note: Pour valider plusieurs tables de données à la fois, utilisez les conditions When dans le plan de sauvegarde des données. Lorsque la condition When renvoie une valeur vraie, les données ont été validées. Si toutes les conditions When renvoient une valeur fausse, alors la condition Otherwise est exécutée.

Dans l’image suivante, cliquez sur les icônes + pour en savoir plus sur les options d’enregistrement des données.

Traitement des transactions

En utilisant des data pages enregistrables, vous pouvez écrire des données dans le SOR à l'aide de la solution de traitement des transactions intégrée à Pega Platform. 

Prenons un exemple qui n’utilise pas le traitement des transactions. Vous achetez un article en ligne et payez avec votre carte de crédit. La banque traite votre paiement par carte de crédit, mais en raison d'un problème de réseau, la boutique en ligne ne reçoit jamais de notification concernant votre paiement. Avec le traitement des transactions, le paiement et la notification de paiement sont effectués dans la même transaction. Si une partie de la transaction échoue, les modifications apportées aux deux systèmes reviennent à l’état précédant la tentative de mise à jour de l’un ou l’autre système. Votre carte de crédit n’est pas débitée et votre commande n’est pas traitée.

Vous pouvez déclencher le plan de sauvegarde d’une data page enregistrable de trois manières.

  1. Ajouter une étape d’automatisation Save data page à une règle de flux.
  2. Ajouter une étape de post-traitement à une règle de flow action.
  3. Appeler la méthode Save-DataPage dans une règle d’activité.

Lors du déclenchement de l’enregistrement depuis un flux ou un flow action, Pega Platform gère automatiquement la transaction. Si vous déclenchez l’enregistrement depuis une règle d’activité, vous pouvez choisir d’enregistrer les données avec le reste de la transaction ou de manière indépendante en tant que transaction distincte.

Vérifiez vos connaissances avec l’interaction suivante.

Créer et mettre à jour une instance de données

Les propriétés à saisie automatique font référence aux propriétés d’une page ou d’une liste de pages qui obtiennent de façon directe et automatique les données de data pages spécifiques. Ces propriétés facilitent la gestion et le maintien des applications que vous développez, empêchant l'application d'avoir à surveiller constamment les changements de paramètres clés, qui ne sont pas toujours nécessaires et qui peuvent ralentir les performances. Vous pouvez remplir automatiquement une propriété d’une page ou d’une liste de pages soit en référençant une data page soit en copiant les données d’une data page.

Vous pouvez faire d’une data page enregistrable la source d’une propriété à saisie automatique. Dans cette situation, Pega Platform utilise la section Data source de l'enregistrement de data page pour saisir les données de la propriété et la section Data save options pour actualiser la source des données.

Caution:  Lorsque vous faites d’une data page enregistrable la source des données d’une propriété à saisie automatique, reportez-vous à la propriété avec l’option Copy data from a data page plutôt qu’avec l’option Refer to a data page. Utiliser l’option Refer to a data page pourrait entraîner l’écrasement accidentel des données avant que vous ne déclenchiez l’enregistrement.

Les cas d'usage des data pages enregistrables impliquent principalement d’accepter une valeur utilisée pour identifier de manière unique un enregistrement (record) en utilisant Lookup comme source. Cette valeur est généralement une valeur clé configurée manuellement ou une autre chaîne unique, comme une adresse e-mail. Le Data Transform de réponse traite toute erreur « failed to find » en supprimant l’erreur et en appliquant les données par défaut à la page (généralement en appelant le data transform pyDefault de la classe). L'enregistrement est alors configuré comme étant nouveau. Toutefois, lorsque la valeur n’est pas configurée manuellement, comme dans le cas des clés générées automatiquement, une data page enregistrable peut utiliser une data page enregistrable comme source de données.

Tâche data page Une valeur clé est-elle présente ? Source
Mettre à jour l’instance de données Oui  Recherche (lookup)
Créer l’instance de données Non Data transform

Plans de sauvegarde des données

Vous pouvez configurer une data page enregistrable avec plusieurs sources de données et plans de sauvegarde des données pour faciliter la création et la mise à jour des enregistrements de données. Par exemple, une propriété à saisie automatique contient des informations sur le compte d’un utilisateur ayant été sourcées à l’aide d’une data page enregistrable. L’utilisateur peut être un client régulier dont le dossier figure dans le SOR, ou un client nouveau souhaitant s’enregistrer et créer un enregistrement de compte. Le plan de sauvegarde des données évolue en fonction de la présence ou non d'un enregistrement : 

  • Si un enregistrement a déjà été créé pour le client dans le SOR, la data page peut effectuer une recherche pour sourcer les valeurs de la propriété à saisie automatique, en transformant la valeur clé de l’enregistrement en un paramètre. La data page met à jour le SOR en utilisant l’opération Database save, ici encore en transformant la valeur clé de l’enregistrement en un paramètre.
     
  • En l’absence d'enregistrement dans le SOR, la data page alimente les valeurs de la propriété à saisie automatique en utilisant un data transform et aucun paramètre n’est repris. Le paramètre est également omis de l’opération Database save.

Si la data page peut prendre en charge des opérations de création et de mise à jour, vous devrez peut-être vous assurer que les paramètres de spécification d’une valeur clé ne sont pas obligatoires mais facultatifs. Si la source de données utilise une clé générée automatiquement reprise par un paramètre obligatoire, l’opération Database save permettant de créer le dossier nécessite la valeur clé. Cela entraîne une erreur qui empêche de sauvegarder l’enregistrement de la data page.

Tip: Mieux vaut alors ajouter un paramètre Index à une data page enregistrable utilisée pour créer des enregistrements, sauf si vous avez l’intention d’utiliser une propriété autopopulate by copy. Vous empêcherez ainsi la violation des seuils (guardrail) et permettrez l’utilisation multiple de la data page sur le même écran.

Vérifiez vos connaissances avec l’interaction suivante.


This Topic is available in the following Modules:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

29% found this content useful

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice