Addition, remplacement et transaction
La partie basse des propriétés de destination IBM : valeurs vides, doublons, taille des lots, effacement du cube et méthode d’écriture.
- Dans la capture, l’effacement est désactivé et le remplacement des valeurs visées est sélectionné.
- Les paramètres appartiennent à un flux pédagogique ; aucun cube réel n’a été modifié.
« Remplacer » définit la valeur fournie dans la cellule visée. « Ajouter » additionne le nombre d’entrée à la valeur actuelle. Une nouvelle destination utilise l’addition par défaut ; examinez donc explicitement le mode. Pour une cellule contenant 100 et une entrée de 25, le remplacement donne 25 et l’addition 125. Utilisez le remplacement pour le texte. « Addition transactionnelle des données » applique la différence produite par l’enregistrement d’une fiche de formulaire UBC Analytics.
Effacement préalable
Une destination peut effacer le cube entier ou certaines tranches avant l’écriture. Lorsque l’effacement est activé, les données sont écrites en mode remplacement ; une méthode distincte d’addition ou de transaction ne s’applique pas.
| Source des limites de tranche | Comportement |
|---|---|
| Éléments sélectionnés | Un ensemble explicite de noms principaux ; une consolidation représente ses éléments feuilles |
| Depuis les données | Éléments renseignés par le mappage actuel à partir d’une colonne source |
| Paramètre d’exécution | Valeur du champ de formulaire sélectionné |
Une dimension qui ne limite pas la tranche est incluse en totalité. Lorsque les limites d’année et de mois proviennent des données, les combinaisons réellement présentes dans les lignes sont effacées, plutôt que toutes les combinaisons possibles année/mois.
Ce qui est effacé et comment cela est validé
L’adaptateur repère les cellules feuilles stockées non vides dans les tranches définies. Les valeurs calculées par des règles et les cellules consolidées ne sont pas effacées comme données saisies. Une cellule numérique est effacée par écriture de 0 ; une cellule textuelle par écriture d’une chaîne vide.
Toutes les cellules cibles identifiées sont validées avant la première opération d’effacement. Un dépassement de limite ou une cellule inaccessible arrête la préparation. L’effacement réel utilise des lots de 500 cellules ; une défaillance en cours d’exécution peut malgré tout laisser des modifications partielles.
Avant l’exécution, vérifiez la limite de chaque dimension. Pour un rechargement mensuel, par exemple, limitez Version=Actual et Month=2026-10 plutôt que le cube entier.
Addition transactionnelle depuis l’enregistrement d’un formulaire
Sélectionnez cube_write.mode=transaction pour un flux lancé par un bouton de formulaire UBC Analytics avec une action d’enregistrement. La source doit lire « L’enregistrement du formulaire qui a lancé le flux ». Les valeurs avant et après enregistrement suivent les mêmes transformations ; chaque cellule reçoit « nouvelle − précédente ». Lorsque plusieurs fiches contribuent à une cellule, seule la contribution de la fiche enregistrée change.
- Une nouvelle fiche ajoute uniquement sa contribution. Une fiche exclue par le filtre retire sa contribution précédente. Une cellule inchangée n’est pas écrite.
- Le contexte contient l’événement d’enregistrement. Répéter le même événement pour la même destination n’ajoute pas le montant deux fois.
- Une exécution sans enregistrement produit TRANSACTION_SAVE_REQUIRED ; une exécution sans la source correspondante produit TRANSACTION_RECORD_REQUIRED.
- Activez dans la connexion la journalisation des données retirées et ajoutées.
- Avant la production, testez la création d’une fiche, les changements de montant et de coordonnées et une fiche qui ne passe plus le filtre.
Vérifier l’opération
Étapes d’écriture IBM Planning Analytics et différence entre replace et add. Les lots précédents confirmés peuvent rester appliqués si un lot ultérieur échoue.
Pour l’effacement, vérifiez une cellule de la tranche avec de nouvelles données, une cellule de la tranche sans nouvelle ligne et une cellule extérieure. Pour l’addition transactionnelle, rapprochez les contributions avant et après enregistrement, le total du cube et l’identifiant d’événement. Répéter une addition ordinaire ajoute de nouveau le montant ; un événement transactionnel confirmé répété est reconnu séparément. Après une écriture partielle ou non confirmée, rapprochez d’abord l’état de la destination.