Utiliser des marqueurs intelligents
Introduction
Tableur Designer et marqueurs intelligents
Les feuilles de calcul Designer sont des fichiers Excel standard qui contiennent une mise en forme visuelle, des formules et des marqueurs intelligents. Ils peuvent contenir des marqueurs intelligents qui font référence à une ou plusieurs sources de données, telles que des informations d’un projet et des informations sur des contacts associés. Des marqueurs intelligents sont écrits dans les cellules où vous souhaitez des informations.
Tous les marqueurs intelligents commencent par &=. Un exemple de marqueur de données est &=Party.FullName. Si le marqueur de données génère plusieurs éléments, par exemple une ligne complète, les lignes suivantes sont automatiquement déplacées vers le bas pour faire de la place aux nouvelles informations. Ainsi, les sous-totaux et les totaux peuvent être placés sur la ligne immédiatement après le marqueur de données pour effectuer des calculs basés sur les données insérées. Pour effectuer des calculs sur les lignes insérées, utilisezformules dynamiques.
Les marqueurs intelligents consistent enla source de données etnom de domainepièces pour la plupart des informations. Des informations spéciales peuvent également être transmises avec des variables et des tableaux de variables. Les variables remplissent toujours une seule cellule alors que les tableaux de variables peuvent en remplir plusieurs. N’utilisez qu’un marqueur de données par cellule. Les marqueurs intelligents inutilisés sont supprimés.
Un marqueur intelligent peut également contenir des paramètres. Les paramètres permettent de modifier la présentation des informations. Ils sont ajoutés à la fin du marqueur intelligent entre parenthèses sous forme de liste séparée par des virgules.
Options de marqueur intelligent
&=DataSource.FieldName &=[Source de données].[Nom du champ]&=$NomVariable &=$VariableArray &==Formule Dynamique &=&=RépéterDynamicFormula
Paramètres
Les paramètres suivants sont autorisés :
- pas d’ajout - N’ajoutez pas de lignes supplémentaires pour ajuster les données.
- sauter :n - Sauter n nombre de lignes pour chaque ligne de données.
- *croissant : n ou décroissant : n - Trier les données dans des marqueurs intelligents. Si n vaut 1, alors la colonne est la première clé du trieur. Les données sont triées après le traitement de la source de données. Par exemple : &=Table1.Field3(croissant : 1).
- horizontal - Écrivez les données de gauche à droite, au lieu de haut en bas.
- numérique - Convertissez le texte en nombre si possible.
- changement - Maj vers le bas ou vers la droite, créant des lignes ou des colonnes supplémentaires pour s’adapter aux données. Le paramètre de décalage fonctionne de la même manière que dans Microsoft Excel. Par exemple, dans Microsoft Excel, lorsque vous sélectionnez une plage de cellules, cliquez avec le bouton droit et sélectionnezInsérer et précisezdécaler les cellules vers le bas, décaler les cellules vers la droite et d’autres options. En bref, le paramètre de décalage remplit la même fonction pour les marqueurs intelligents verticaux/normaux (de haut en bas) ou horizontaux (de gauche à droite).
- haricot - Indique que la source de données est un simple POJO. Uniquement pris en charge dans le Java API.
Les paramètres noadd et skip peuvent être combinés pour insérer des données sur des lignes alternées. Étant donné que le modèle est traité de bas en haut, vous devez ajouter noadd sur la première ligne pour éviter que des lignes supplémentaires ne soient insérées avant l’autre ligne.
Si vous avez plusieurs paramètres, séparez-les par une virgule, mais sans espace : paramètreA, paramètreB, paramètreC
Les captures d’écran suivantes montrent comment insérer des données sur une ligne sur deux.
devient…
Formules dynamiques
Les formules dynamiques vous permettent d’insérer des formules Excel dans des cellules même lorsque la formule fait référence à des lignes qui seront insérées lors du processus d’exportation. Les formules dynamiques peuvent se répéter pour chaque ligne insérée ou utiliser uniquement la cellule dans laquelle le marqueur de données est placé.
Les formules dynamiques permettent les options supplémentaires suivantes :
- r - Numéro de ligne actuel.
- 2, -1 - Décalage par rapport au numéro de ligne actuel.
L’exemple suivant illustre une formule dynamique répétitive et la feuille de calcul Excel qui en résulte.
devient…
Cell C1 contient la formule =A1B1, C2 contient = A2B2 et C3 = A3*B3.
Il est très facile de traiter les marqueurs intelligents. L’extrait de code suivant montre comment procéder.
Utilisation de tableaux variables
L’exemple de code suivant montre comment utiliser des tableaux de variables dans Smart Markers. Nous plaçons dynamiquement un marqueur de tableau variable dans la cellule A1 de la première feuille de calcul du classeur qui contient une chaîne de valeurs que nous avons définie pour le marqueur, traitons les marqueurs pour remplir les données dans les cellules contre le marqueur. Enfin, nous sauvegardons le fichier Excel.
Regroupement de données
Dans certains rapports Excel, vous devrez peut-être diviser les données en groupes pour en faciliter la lecture et l’analyse. L’un des principaux objectifs de la répartition des données en groupes est d’exécuter des calculs (effectuer des opérations récapitulatives) sur chaque groupe d’enregistrements.
Les marqueurs intelligents Aspose.Cells vous permettent de regrouper les données par ensemble de champs et de placer des lignes récapitulatives entre les ensembles de données ou les groupes de données. Par exemple, si vous regroupez des données par Customers.CustomerID, vous pouvez ajouter un enregistrement récapitulatif chaque fois que le groupe change.
Paramètres
Voici quelques paramètres de marqueur intelligent utilisés pour regrouper les données.
groupe : normal/fusionner/répéter
Nous prenons en charge trois types de groupes parmi lesquels vous pouvez choisir.
- Ordinaire - La valeur de regroupement par champ(s) n’est pas répétée pour les enregistrements correspondants dans la colonne ; au lieu de cela, ils sont imprimés une fois par groupe de données.
- fusionner - Le même comportement que pour le paramètre normal, sauf qu’il fusionne les cellules dans le(s) champ(s) grouper par pour chaque ensemble de groupe.
- répéter - La valeur de regroupement par champ(s) est répétée pour les enregistrements correspondants.
Par exemple : &=Customers.CustomerID(group:merge)
sauter
Ignore un nombre spécifique de lignes après chaque groupe.
Par exemple &=Employees.EmployeeID(group:normal,skip:1)
sous-totalN
Effectue une opération récapitulative pour les données d’un champ spécifié liées à un groupe par champ. Le N représente des nombres entre 1 et 11 qui spécifient la fonction utilisée lors du calcul des sous-totaux dans une liste de données. (1=AVERAGE, 2=COUNT, 3=COUNTA, 4=MAX, 5=MIN,…9=SUM etc.) Reportez-vous à la référence de sous-total dans l’aide d’Excel Microsoft pour plus de détails.
Le format indique en fait que : subtotalN:Ref où Ref fait référence à la colonne group by.
Par exemple,
- &=Products.Units(subtotal9:Products.ProductID) spécifie la fonction récapitulative lorsUnités domaine par rapport à laID produit champ dans leDes produits table.
- &=Tabx.Col3(subtotal9:Tabx.Col1) spécifie la fonction récapitulative sur leCol3 groupe de champs parCol1 dans la tableTabx.
- &=Table1.ColumnD(subtotal9:Table1.ColumnA&Table1.ColumnB) spécifie la fonction récapitulative surColonneD groupe de champs parColonneA etColonneB dans le tableauTableau 1.
Utilisation d’objets imbriqués
Aspose.Cells prend en charge les objets imbriqués dans les marqueurs intelligents, les objets imbriqués doivent être simples.
Nous utilisons un simple fichier modèle. Consultez la feuille de calcul du concepteur qui contient des marqueurs intelligents imbriqués.
La première feuille de calcul du fichier de concepteur montrant les marqueurs intelligents imbriqués.
L’exemple qui suit montre comment cela fonctionne. L’exécution du code ci-dessous donne la sortie ci-dessous.
La première feuille de calcul du fichier de sortie montrant les données résultantes.
Utilisation de la liste générique comme objet imbriqué
Aspose.Cells prend désormais également en charge l’utilisation d’une liste générique en tant qu’objet imbriqué. Veuillez vérifier la capture d’écran du fichier Excel de sortie généré avec le code suivant. Comme vous pouvez le voir dans la capture d’écran, un objet Enseignant contient plusieurs objets élèves imbriqués.
Utilisation de la propriété HTML des marqueurs intelligents
L’exemple de code suivant explique l’utilisation de la propriété HTML des marqueurs intelligents. Lorsqu’il sera traité, il affichera “Monde” dans “Hello World” en gras à cause de HTML <b> étiquette.
Obtenir des notifications lors de la fusion de données avec des marqueurs intelligents
Parfois, il peut être nécessaire d’obtenir les notifications concernant la référence de cellule ou le marqueur intelligent particulier en cours de traitement avant l’achèvement. Ceci peut être réalisé en utilisant leWorkbookDesigner.CallBackWorkbookDesigner.CallBackpropriété etISmartMarkerCallBack
Pour un exemple de code et une explication détaillée, veuillez consulter cet article.