# Services

The *services* screen gives a user the ability to view and change the available services in the service catalogue of the Exivity deployment. When creating new services, it is required to use a **Transformer** with the [*service*](https://github.com/exivity/docs/tree/4455d34021b8c3e12ce1b09914544d96f4a3b270/transform/language/service/README.md) or [*services*](https://github.com/exivity/docs/tree/4455d34021b8c3e12ce1b09914544d96f4a3b270/transform/language/services/README.md) statement.

## Obtaining details for a Service

To view the details of a service that has already been created, click on one of the services listed in the '*Catalogue*' > '*Services*' screen:

![service definition](/files/-LHF0O68NJuAvuppsqHq)

The numbered items from above screenshot refer to the following list:

1. The ***description*** or friendly name for this service
2. The unique key value of this service (see [*service*](https://github.com/exivity/docs/tree/4455d34021b8c3e12ce1b09914544d96f4a3b270/transform/language/service/README.md))
3. The time stamp when the service was created
4. The time stamp when the service was updated
5. The **DataSet** where this service relates to
6. Where to obtain the ***service name*** from  *(in header or in data)*. The value will be used for the service ***description*** (see **1**)
7. The ***source column*** that has the consumed quantity
8. The ***Instance column*** refers to the chargeable instance column value (i.e. VM ID) which is required for *automatic* Services
9. The ***interval*** that defeines the frequency of how often this service is being charged. Meaning: **automatic** *(every occurrence/record/hour)*, **daily** or **monthly**
10. When using ***proration***, this checkbox will be enabled. Proration takes into account whether to charge for a portion of a consumption interval. *For example: when having 10 days of consumption for a monthly service with a rate configured of € 90 per unit that has proration enabled, will result in a line item of € 30 for that services monthly charge*
11. The ***Billing Type*** provides information whether this is a service that has ***manual*** *(using manually provided, adjustable rate value)* or ***automatic*** *(using rate column)* rates configured
12. ***COGS*** *(Cost of Goods)* of a service will have its own rate configuration, which can be either manual/automatic per unit or manual/automatic per interval
13. Exivity will in a future release allow the user to change and create services through the web interface. At this time, this feature is disabled.

## Changing or Deleting a Service

In case you need to change the configuration of an already populated service, the GUI enables you to do so. To change an existing service you will need to make sure that you have first selected the appropriate report from the Report Selector and the left top of the screen. To change the configuration or delete a service, you will then need to follow these steps:

![Changing or deleting a service](/files/-LaLl58ni-JVQ1dfeItT)

1.  Navigate to the ***Catalogue** > **Services***  menu and click the white ***Edit*** button at the top of service list. The system will warn you that any changes made to existing service, may require you to *re-Prepare* the currently selected ***Report Definition.*** 
2. If you have confirmed the warning message, you will be able to select one, multiple or all of the services within the currently selected ***Report Definition***. You can then select the ***Delete*** button next to the ***Edit*** button, to delete all selected services. 
3. If you want to change the configuration of one of the services, you should first select the service which you'd like to change.
4. When you have the service that you want to change selected, you can change any of the available parameters such as the *Instance Column*, *Interval*, etc. Once you are satisfied with your changes, you may press the ***Update*** button.
5. Ensure to *re-Prepare* your report in the ***Report Definitions*** in case you have made any changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://olddocs.exivity.io/2.3.1/getting-started/configuration/catalogue/services.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.