A raw usage entry: a quantity of an item, and optionally one of its features, consumed by an account or asset. It is a record-keeping entity only. It is in no app, so no menu opens it, and no screen, action, job or service reads it. Usage entries are never totalled, priced or invoiced. Usage-based billing works from Subscription Usage Summary records instead, and nothing builds those summaries from these entries. The shipped create form has no Subscription field, so an entry typed on the form is not linked to a subscription. To use the entity as a manual usage log, an administrator adds it to an app (Setup, Design Studio, Apps, Manage Items) and adds Subscription to its layouts.
Fields
| Field | Label | Type | Required | What it does |
|---|
AccountId | Account | Lookup → Account | | The customer account that consumed the usage. Optional, and for reference only. Nothing reads it. |
AssetId | Asset | Lookup → Asset | | The asset (for example an installed machine or meter) on which the usage was recorded. Optional, and for reference only. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
Id | Id | Guid | Yes | |
ItemFeatureId | Item Feature | Lookup → ItemFeature | | One feature of the item, when usage is metered per feature. Optional, and for reference only. |
ItemId | Item | Lookup → Item | | The item whose usage is recorded. Optional. It is not checked against the subscription's item. |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Usage Name | Text | Yes | The entry's name, typed by you. It is required and is not numbered automatically. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
Quantity | Quantity | Decimal | | The quantity consumed. It defaults to 0. It is not added to any summary or invoice. |
RecordTypeId | Record Type | Guid, hidden | | |
SubscriptionId | Subscription | Lookup → Subscription | | The subscription the usage belongs to. It is not on the shipped create form, so only an import, the API or a layout an administrator has edited can set it. |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
UsageDateTime | Usage Date Time | DateAndTime | | Not stored. The field is on the form, but it has no database column, so a date you enter is dropped on save. Use the record's Created Date or the entry name to record when the usage happened. |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Edit | Edit | Edit | Edit |
New | New | New | New |
