Gestion des documents et des modèles

Création de mots-clés de modèles de devis

Objectives

After completing this lesson, you will be able to:
  • Expliquez l'objectif des balises de modèle.
  • Décrivez les balises de modèle et la manière dont les données de devis sont saisies dans un document.
  • Décrivez les balises de génération de document couramment utilisées.
  • Ajouter de nouveaux documents et images à un modèle de document existant.

Objectif des mots-clés de modèle

Il existe plusieurs types de balises de modèle :

  • Balises de modèle de devis
  • Balises d'élément de panier (balises C)
  • Balises ST

Mots-clés du modèle de devis

Ilustration des différents types de balises de modèle de devis.

Pour que les données soient affichées dans les documents générés, des balises dédiées doivent être saisies dans le modèle. Chaque balise peut récupérer des informations spécifiques sur les détails de l'offre, la configuration, le client ou l'utilisateur qui doivent être affichées dans le document sortant. La liste des mots-clés et une explication détaillée avec des exemples sont disponibles dans la section Balises de génération de documents. Vous pouvez également utiliser les balises CTX standard au lieu des balises de modèle de devis pour récupérer des données.

Vous pouvez inclure n'importe quelle information dans le modèle de devis. Le type le plus courant à inclure est les informations client, telles que les champs Facturation, Livraison ou Utilisateur final. En outre, le modèle inclut les articles du panier. Cette option, ainsi que toute autre information, peuvent être incluses via l'utilisation des balises de modèle de devis SAP CPQ.

Les balises de modèle de devis sont utilisées pour transférer des informations de SAP CPQ vers le document Word, ce qui se fait en ajoutant ces balises au document à l'aide d'un texte normal. Par exemple, vous pouvez inclure ce qui suit dans un document Word: Le prix total du devis est: "Q_QUOTE(TOTAL)"". Ce mot-clé est utilisé comme mot-clé de modèle d'offre qui récupère le prix total du panier lors de la génération de l'offre.

Les expressions sont saisies dans un document Word dans les zones ou dans l'ordre dans lequel elles sont affichées. Pratiquement toutes les informations existantes dans CPQ peuvent être insérées dans un document de devis Word. Chaque mot-clé a un ou plusieurs caractères de préfixe qui représentent la manière dont le mot-clé est utilisé. Les balises Q représentent les informations extraites du devis.

Balises d'élément de panier

Le deuxième type de balises est les balises C ou les balises d'élément Panier. Ces balises peuvent uniquement être utilisées dans une balise de devis répétable C2.

Balises ST

Les balises ST sont des balises spéciales qui se trouvent en dehors des balises de panier ou de devis. Les balises Q et ST sont utilisées n'importe où dans le document sans être limitées aux balises de devis répétables C2.

Modèle de mots-clés et saisie de données

Les balises de devis (ou Q) sont utilisées pour récupérer les informations générales de l'offre, y compris les données de devise, d'utilisateur et de propriétaire, etc.

Une balise Q peut être ajoutée n'importe où dans le modèle de document. Les balises Q générales suivantes sont des exemples de balises Q :

  • <<Q_Quote(Comment)>>,<<Q_QUOTE(VALID_UNTIL)>>
  • Balises de l'utilisateur du devis : <<Q_User(Name)>>, <<Q_User(City)>>
  • Balises de l’entreprise : <<Q_COMP(NAME)>>, <<Q_COMP(ADDRESS1)>>
  • Mots-clés du propriétaire du devis : <<Q_OWNER(USERNAME)>>, <<Q_OWNER(EMAIL)>>
  • Autres balises : <<Q_FILE()>>, <<Q_TAG(<*CTX(Quote.Total.Amount.Display)*>)>>

Remarque

Chaque balise qui insère des fichiers prend en charge les formats .docx et .pdf. Les formats d'image incluent .bmp, .emf, .gif, .ico, .jpg, .jpeg, .pcx, .png, .tif, .tiff et .wmf.

Le lien du portail d'aide SAP CPQ qui répertorie toutes les balises Q prises en charge est : Q tags.

Balises de génération de documents couramment utilisées

Balises de boucle C2

La figure affiche les balises C2 Loop.

Les balises C2 afficheront de manière itérative les produits et les postes dans le panier en suivant ces règles :

  • La balise édite ses balises MAIN et LI une fois pour chaque produit dans le panier.
  • La section PRINCIPAL affiche le produit.
  • La section Poste individuel affiche les postes individuels sous ce produit.
  • C Les mots-clés sont utilisés dans ces sections pour afficher les attributs de produit/d'article.

Les balises C2 peuvent être ajoutées uniquement aux postes principaux et aux postes individuels. Une boucle C2 à l'intérieur d'une boucle C2 ne peut pas être ajoutée, alors qu'une condition à l'intérieur d'une boucle C2 est prise en charge. L'ajout d'un trop grand nombre de balises C2 (500 balises et plus) peut affecter négativement les performances du processus de génération de document.

Utilisez les balises de boucle C2 dans l'exemple suivant :

<<C2>> <<HEADER>> Afficher l'en-tête (généralement un en-tête de table) <<HEADER_END>> <<MAIN>> Afficher les données produit (généralement dans une ligne de table) <<C_STOP>> <<MAIN_END>> <<LI>> Afficher les données de poste individuel (généralement dans une ligne de table) <<C_STOP>> <<LI_END>> <<FOOTER>> Afficher le pied de page (normalement les totaux) <<FOOTER_END>><<C_END>>

Ilustration de la structure d'une boucle C2.

Les balises d'ouverture et de fermeture, telles que <<LI>> et <<LI_END>>, doivent être affichées dans une ligne distincte.

Une balise C2 peut éventuellement avoir quatre sections (en-tête, postes principaux, postes et pied de page) et chacune d'elles est décrite plus en détail ci-dessous.

En-tête

Un en-tête n'est affiché qu'une seule fois au début d'une balise C2. Vous pouvez ajouter uniquement des balises Q dans l’en-tête, car les autres balises ne sont pas analysées. S'il existe une table dans votre modèle, l'en-tête de la table s'affiche.

Remarque

Si vous avez un tableau qui s'affiche sur plusieurs pages, sélectionnez Répéter comme ligne d'en-tête en haut de chaque page dans Word pour afficher l'en-tête sur chaque page.
Postes principaux

Le mot-clé principal récupère tous les postes principaux d'une offre. Il existe un ensemble de balises PRINCIPALES pour chaque élément principal. Pour que le système traite correctement les éléments, vous devez ajouter la balise <<C_STOP>> avant la balise principale de fermeture. S'il existe une structure de poste supérieur/inférieur, le système traite les postes inférieurs comme des postes principaux. Si une représentation tabulaire est nécessaire, vous ajoutez des lignes de table qui contiennent des données de poste.

Postes individuels

La balise de poste récupère les postes dans un devis. Il existe un ensemble de balises LINE ITEM pour chaque poste individuel. Pour que le système traite correctement les postes, vous devez ajouter la balise <<C_STOP>> avant la balise de poste de clôture. Si vous devez représenter des postes individuels dans une table, ajoutez des lignes de table dans les balises de poste individuel.

Pied de page

Un pied de page n'est affiché qu'une seule fois à la fin d'une balise C2. Ajoutez uniquement des balises Q dans le pied de page car les autres balises ne sont pas analysées. Si le modèle inclut une table, le pied de page de la table est affiché dans les balises de pied de page.

Remarque

Il doit y avoir au moins un espace (ou une nouvelle ligne) après la balise <<C_END>> pour que le système traite correctement.

Les mots-clés des articles du panier sont les suivants :

Balises d'élément de panier

BaliseDescription
<<C_TAG(...)>>Balise C de base. Placer une balise de modélisation (CTX, table, etc.) entre les parenthèses
<<C_VALUE(RolledUpCartItem)>>ID d'éléments de devis reportés. Par exemple 3, 3.1, 3.2
<<C_PIMAGE>>Image du produit
<<C_PATTR(...)>

Évalue une balise au niveau du produit ; utilisée uniquement pour les attributs ajoutés en tant que postes.

Par exemple, <*Value(AttributeName)*>

<<C_EMPTY>>Affiche un espace vide

Les balises C récupèrent les données pour chaque élément d'un devis. Le système traite les balises C uniquement si elles se trouvent dans les balises C2. Dans la plupart des cas, utilisez un C_TAG pour accéder aux propriétés de l'élément de devis, par exemple :

<<C_TAG(<*CTX(Quote.CurrentItem.LineItemProperty)*>)>>

Pour afficher le nombre ordinal d'un poste d'offre, où les éléments inférieurs 3.1 et 3.2 apparaissent sous la forme 4 et 5, saisissez les données suivantes :

<<C_TAG(<*CTX(Quote.CurrentItem.Rank)*>)>>

Consultez le portail d'aide SAP CPQ pour obtenir une liste complète des balises C2.

La figure affiche les balises de conteneur.

Parfois, les informations d'un conteneur doivent être affichées directement dans le document de devis. Placez la balise CONTAINER à l'intérieur d'une balise C2.

Dans les sections CONTAINER, utilisez CONTAINER_TAG avec une balise CTX pour récupérer les données. Par exemple, utilisez<<CONTAINER_TAG(<*CTX(Container(Project Tasks).Row(2).Column(Total).GetFormatted))*>)>> pour renvoyer la valeur de la colonne Total pour la deuxième ligne du conteneur, en conservant le format d'origine.

Utilisez les balises de conteneur suivantes :

<<C2>> <<MAIN>> <<CONTAINER(PropContainer)>> <<CONTAINER_HEADER>> <<CONTAINER_HEADER_END>> <<CONTAINER_ITEM>> TAG: <<CONTAINER_TAG(<*CTX(Container(PropContainer).Row(3).Column(tag).GetFormatted))*>)>> <<CONTAINER_ITEM_END>> <<CONTAINER_FOOTER>> <<CONTAINER_FOOTER_END>> <<CONTAINER_END> <<MAIN_END>><<C_END>>

Balises de table de devis

La figure affiche les balises de la table de devis.

Le contenu des tables de devis peut également être inclus dans le document de devis.

Vous pouvez utiliser la balise QUOTE_TABLE dans l'en-tête ou le pied de page d'un modèle de traitement de génération de document.

Pour récupérer le contenu, utilisez les balises suivantes :

  • <<QUOTE_TABLE(TableNameHere)>>
  • <<QUOTE_TABLE_HEADER>> (Saisissez les définitions de colonnes ou ce que vous voulez afficher dans l'en-tête de la table).
  • <<QUOTE_TABLE_HEADER_END>>
  • <<QUOTE_TABLE_ROW>>
  • <<QUOTE_TABLE_COLUMN(NameOfColumnHere)>>
  • <<QUOTE_TABLE_COLUMN(AnotherColumnHere)>>
  • <<QUOTE_TABLE_ROW_END>>
  • <<QUOTE_TABLE_FOOTER>> (Saisissez les totaux de colonne ou ce que vous souhaitez afficher dans le pied de page pour le tableau).
  • <<QUOTE_TABLE_FOOTER_END>>
  • <<QUOTE_TABLE_END>>

Balises de table personnalisées

La figure affiche les balises de table personnalisée.

Vous souhaitez afficher les informations d'une table personnalisée dans le document d'offre.

Utilisez la balise CUSTOM_TABLE suivante pour effectuer les actions suivantes :

<<C2>> <<MAIN>> <<CUSTOM_TABLE(digital_devices)>> <<CUSTOM_TABLE_HEADER>> <<CUSTOM_TABLE_HEADER_END>> <<CUSTOM_TABLE_ROW>> P/N: <<CUSTOM_TABLE_COLUMN(Part_Number)>>

Nom : <<CUSTOM_TABLE_COLUMN(Component_Name)>> <<CUSTOM_TABLE_ROW_END>> <<CUSTOM_TABLE_END>> <<MAIN_END>><<C_END>>

Mots-clés pour modèles Microsoft Excel

La figure affiche les mots-clés pour les modèles Microsoft Excel.

SAP CPQ vous permet de créer des documents de devis au format Microsoft Excel. Utilisez Excel pour créer le modèle avec des mots-clés tels que des modèles Word. Cependant, les balises de génération de document dans Excel utilisent une syntaxe différente de celle de Word. Au lieu de fermer les balises, comme C_STOP et MAIN_END, la balise d'ouverture indique :

Une balise d'ouverture spécifie :

  • Nombre de lignes suivantes auxquelles il fait référence.
  • Le nombre de colonnes qu'il englobe.

Un exemple est la boucle C2 dans Word que nous avons révisée plus tôt.

Dans cet exemple, l'étiquette C2 couvre les lignes 1 à 7. L'étiquette concerne les 7 lignes. La balise HEADER concerne une ligne. MAIN et LI concernent également une ligne. Les balises englobent 4 colonnes. N'oubliez pas que les balises de génération de document n'apparaîtront pas dans le devis généré.

Certaines balises Excel sont différentes de leurs équivalents Word. Par exemple, les 4 lignes de feuille de calcul utilisées pour afficher la table personnalisée à 6 colonnes My_Custom_Table sont précédées par : <<QUOTE_CUSTOM_TABLE(4x6|My_Custom_Table)>>

Ne confondez pas cette balise avec la balise utilisée pour afficher une table de devis équivalente : <<QUOTE_TABLE(4x6|My_Quote_Table)>>.

Balises de condition autonomes

Les conditions autonomes peuvent être utilisées n'importe où dans le modèle. Ils ne dépendent pas d'autres mots-clés et sont décrits par les règles suivantes :

  • Il s'agit des dernières balises à évaluer.
  • L'utilisation d'un trop grand nombre va dégrader les performances.
  • Utilisez = pour l'égalité et ! d'inégalité.
  • Plusieurs conditions sont séparées par | et utilisent toujours la logique OU.

Par exemple : afficher du contenu uniquement si le type de produit de l'article actuel est Service :

[CONDITION,<<C_TAG([NEQ](<*CTX( Quote.CurrentItem.ProductTypeName )*>,Service))>>]static text / tables / document generation tags[CONDITION_END]

Remarque

[CONDITION,…] tags don't support table tags (<*Table(SQL query)*>). Also, [CONDITION,…] Les balises ne doivent pas être imbriquées.

Conditions des mots-clés

Les conditions de mots-clés contrôlent le mode d'affichage des mots-clés individuels. Les conditions de balise sont caractérisées par les règles suivantes :

  • Fonctionne à la fois dans les modèles Word et Excel.
  • Plusieurs balises sont séparées par ( | ).

Format : <<TAG,testvalue=condition>> si la valeur de balise est égale à la valeur test, exécuter la condition.

Conditions générales des balises :

  • D Supprimez une ligne.
  • d supprimez la valeur renvoyée par la balise.
  • P insère un saut de page après la valeur.
  • p insère un saut de page avant la valeur.
  • U convertit la valeur en majuscules.

Conditions des mots-clés dans les tableaux Word :

  • Le CD supprime le contenu de la cellule.
  • DR supprime le contenu de la ligne entière.
  • DCOL supprime le contenu de la colonne entière.
  • DELETE_TABLE supprime toute la table.

Par exemple : <<Q_BILLTO(COMPANY)=sap,U|=D|p>>

  • Si la société chargée de la facturation est sap, convertissez-la vers SAP.
  • Sinon, si aucune valeur de société n'est indiquée, supprimez toute la ligne.
  • Sinon, faites précéder la valeur de la société S/L d'un saut de page.
La figure affiche les conditions des mots-clés dans une table.

Lorsque la zone Entreprise n'est pas définie, la phrase type de code ,=DELETE_TABLE correspond à une zone vide (rien entre la virgule et le signe égal) et l'action consiste à supprimer toute la table.

Mots-clés des parties impliquées

Les balises INVOLVED_PARTIES récupèrent les détails des partenaires et des rôles partenaire. Les éléments suivants représentent la structure des balises INVOLVED_PARTIES :

<<INVOLVED_PARTIES(ALL or partner function key of a specific partner function)>>

<<INVOLVED_PARTIES_HEADER>>

<<INVOLVED_PARTIES_HEADER_END>>

<<INVOLVED_PARTIES_LOOP>>

<<C_TAG(<*CTX( Quote.InvolvedParties.CurrentInvolvedParty.PartnerFunctionName)*>)>>

<<C_TAG(<*CTX( Quote.InvolvedParties.CurrentInvolvedParty.PartnerFunctionKey)*>)>>

<<INVOLVED_PARTIES_LOOP_END>>

<<INVOLVED_PARTIES_FOOTER>>

<<INVOLVED_PARTIES_FOOTER_END>>

<<INVOLVED_PARTIES_END>>

INVOLVED_PARTIES_LOOP contient les balises CTX dans C_TAG.

Le lien suivant sur le portail d'aide SAP CPQ contient les balises CTX Parties impliquées prises en charge.

Insertion de contenu supplémentaire avec Gérer documents de contenu

Des documents ou images supplémentaires peuvent être incorporés dans le document généré. Le contenu supplémentaire doit d'abord être téléchargé sur le serveur dans la section Gérer les documents de contenu de Configuration Devis.

Le contenu supplémentaire est inclus dans le document généré uniquement si les balises suivantes se trouvent dans le modèle :

Le contenu supplémentaire doit d'abord être téléchargé sur le serveur dans la section Gérer les documents de contenu de Configuration Devis.

Intégrez des documents de contenu gérés dans le document généré à l'aide des balises suivantes :

<<INCLUDE_DOCUMENTS>>

<<INCLUDE_DOCUMENTS_END>>

Les balises doivent être utilisées dans des lignes séparées. Les fichiers sont inclus dans l'ordre dans lequel ils sont affichés pour l'utilisateur. Si la case "Ne pas inclure plusieurs fois le même fichier" est cochée côté utilisateur, SAP CPQ n'inclura pas les fichiers en double. Sinon, les fichiers en double sont inclus s'ils sont trouvés.

Pièce jointe de documents

La figure illustre la manière de joindre des documents.

Joignez des documents dans l'onglet Documents du devis.

Affichons la TVA dans un modèle de document Word dans l'exercice suivant.

Afficher la TVA dans un modèle de document Microsoft Word

Scénario de gestion

Supertech souhaite que l'offre envoyée aux clients affiche le montant de la taxe sur la valeur ajoutée facturé sur chaque produit de l'offre.

Flux de tâches

Dans cet exercice, vous allez apprendre à afficher un champ personnalisé d'élément de devis sur un document d'offre à l'aide d'un modèle Microsoft Word.

Options d'exercice

Pour effectuer cet exercice, vous pouvez sélectionner l'option Simulation de plate-forme : suivez les instructions étape par étape dans la simulation.

Pour lancer la simulation, sélectionnez Commencer l'exercice dans la figure ci-dessous.