Usage Data
Un Usage Data permet de gérer les données variables d'un Contract Item.
Introduction
Dans Cn, les "Usage Data" désignent les données de consommation utilisées pour la Facturation des éléments variables d’une période à travers des Contract Item de type:
Usage Based Recurring Pricing / Tarification Récurrente basée sur les Usages
Usage Triggered Invoicing / Facturation déclenchée par les Usages
Ces Contract Item sont dits de type "variable".
A la fin de chaque période de facturation d'un Contrat Item de type variable, Cn :
collecte tous les Usage Data associés
utilise le Usage Data Calculator défini au niveau du Contract Item pour calculer la quantité à facturer sur la période.
Plus précisément une Usage Data est une valeur horodatée liée à un Contract ou un Contract Item.
Les Usages Data peuvent être créées et mises à jour au travers de plusieurs mécanismes:
via l'interface Web de Cn
via l'API
par des imports CSV
Ce document décrit l'utilisation de l'interface Web de Cn et les règles métiers valables pour tous les mécanismes de saisie.
Menu et Accès
Les Usage Data sont accessibles via le menu Cn / Usage Data / Usage Data
Structure des Usage Data
L'écran des Usage Data est structuré en plusieurs parties:
Statut
Contract Reference
Timestamp
Value
Notes
Invoicing
Statut
Le cycle de vie d'une Donnée de Consommation (DC) est le suivant:
Draft :
La Donnée (DC) est en cours de saisie
Tous les champs sont modifiables
Pending
la Donnée (DC) est confirmée; elle est en attente de facturation
Tous les champs sont bloqués sauf "Notes"
Collected
La Donnée (DC) est utilisée dans une facture. Le champ "Invoicing Schedule" permet d'y accéder.
Excluded : Donnée non prise en compte
Contract Reference
Les Usage Data doivent être associées à :
Contract : Lorsque que les Usage data sont affectées à un contract seulement, le champ ContractItem restant vide, les usage data seront associées à tous les contractitems et pourront être traitées par le Usage Data Calculator de chacun d'entre eux. La saisie du champ Contract est donc obligatoire.
Les Usage Data peuvent être associées à un ContractItem unique :
ContactItem : Il est possible d'associer les usages data à un seul ContractItem. Le champ External Reference permet à un système distant de définir une clef d'accès qui lui est propre. Cn permet de retrouver des Données de Consommation à partir des "External Reference".
Value
Start permet d'horodater la "Donnée de Consommation".
End permet de gérer les données de consommation correspondantes à des périodes.
Value : valeur de la donnée d'usage saisie
Usage Data Simple
Usage Data Agrégée
Il existe 2 types de données agrégées :
Données agrégées Custom : Ces données ont pour vocation à être manipulées par les utilisateurs Cn285. Elles doivent donc être présentées dans l'interface de façon intelligibles à travers des champs Custom Exemple de données agrégées custom "muppy.io" : le modèle ci-dessous permet de facturer des services d'une solution Devops en fonction de plusieurs critères : nb de CPU, GB de RAM et typologie (Core, LxC, PostgreSQL)
Données agrégées de type JSON : Ces données de type complexes, sont issues d'un autre système et n'ont pas vocation à utiliser, visualiser ou interpréter par un utilisateur. Elles sont intégrées dans un JSON
Qualifier : permet de définir la donnée d'usage (kg, Km, Mo, GigaOctet, hits, clics, minutes, ...)
Description : en cas de besoin
Analytics
permet d'affecter aux usage data des axes analytiques en vue de traitements BI futurs
Axis1 : Axe analytics
Axis2 : Axe analytics
Invoicing
Do not Invoice : bloque la facturation de l'entrée de Usage Data
Invoicing Schedule : Lorsqu'une Donnée de Consommation a été "collectée", ce champ indique l 'IS dont la quantité inclut la Donnée de Consommation
Invoicing Notes : En cas de besoin
Cas d'utilisations
Saisie d'une donnée de Consommation Simple
Le cas le plus simple correspond à la saisie d'une Donnée de Consommation liée à un Contract Item de type variable.
Pour cela, il faut saisir:
Contract
Contract Item (optionnel)
Start
Value : valeurs simples qui permettent de gérer les données de consommation et qui peuvent être exprimées sous forme de quantités numérique.
Par exemple:
des kilo octets
des minutes
des kilowattheures
Les valeurs simples sont transmises sous forme de listes de nombres à un Usage Data Calculator dont le rôle est de les transformer en quantité (à facturer).
State = Pending
Rappel la Donnée sera ignorée tant que le State sera Draft
Saisie de données de Consommation Agrégées
Les valeurs agrégées permettent de gérer les cas suivants:
facturation de plusieurs Contract Items d'un même Contract dont les quantités proviennent du même Usage Data.
Dans ce cas, les valeurs agrégées sont liées au Contract.
Ce cas correspond à la saisie d'une Donnée de Consommation composite utilisée pour calculer les quantités à facturer de plusieurs Contract Item de type variable.
Dans ce cas, il faut saisir les valeurs des champs:
Contract
Start
JSON Data Ensemble de données (JSON) agrégées permettant de facturer sur la base de modèle plus complexe
Les valeurs agrégées sont des objets JSON qui permettent de stocker des données composites ou complexes.
State = Pending
Rappel la Donnée sera ignorée tant que le State sera Draft
Exemple:
{
"espace_disque_go": 15,
"cpu": 8,
"espace_disque_backup": 13
}
facturation d'un Contract Item dont la quantité dépend de plusieurs paramètres.
Dans ce cas les valeurs agrégées sont liées au Contract Item
Exemple:
{
"espace_disque_utilisee_go": 1599,
"espace_disque_inclu_go": 800,
"tarif_go_supplementaire_euro": 1,27
}
Dans ce magine que le Usage Data Calculator doit calculer le coût des Go en dépassement (espace_disque_utilisee_go - espace_disque_inclu_go) * tarif_go_supplementaire_euro
Actuellement, un Usage Data Calculator ne peut pas accéder en même temps aux valeurs des champs Values et aux valeurs des champs JSON Data.
Notes
Il s'agit d'un champ texte dont le contenu est disponible pour impression sur les "Relevés de consommations" joints aux factures dans le cas de facturation détaillées.
Last updated
