> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/navigation/service-documentation.md).

# Service Documentation

From the [Folder overview](/navigation/folder-overview.md), selecting a service opens the **Service Documentation** page. This includes the processed metadata about the Excel file and the associated Spark service version. The information is split into multiple tabs.

After choosing a specific service from the [Folder overview](/navigation/folder-overview.md), select the ![Service documentation](https://2714190325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc7fek1ZgAUH5MA3m5pH8%2Fuploads%2FqTfng99IaaA3tLAq2IJJ%2Fimage.png?alt=media\&token=a75a85b9-d8a2-4f5d-b9c1-ad2a78890c8b) icon from the service sidebar.

## Overview

The overview screen presents a summary of key details about the Spark service.

* High level statistics from the Excel workbook.
* The number of **Calls**, **API users**, and **Test cases run**.
* The number of calls made by user.
* The number of calls made by a particular **Call purpose**. **Call purpose** is an additional [Execute API (v3)](/spark-apis/execute-api/execute-api-v3.md#request_meta) that can be provided with the API call.
* By default, the call figures include all API calls. To view only calls that are from Spark [SHELL](/assistant/shell/what-is-shell.md), select the **By calls logged** dropdown and select **By Shell submissions**.

## Upload details

Information about the Excel file and the [Neuron](/build-spark-services/neuron.md) conversion to code.

| Key                              | Value                                                                                                                                        |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Version**                      | Spark semantic version number.                                                                                                               |
| **Filename**                     | Filename of the uploaded file.                                                                                                               |
| **File size**                    | File size of the uploaded file.                                                                                                              |
| **Number of sheets**             | Number of worksheets in the Excel workbook.                                                                                                  |
| **Cells with data**              | **Cells with data** corresponds with Excel's **Workbook Statistics** feature that counts the number of used cells and formulas.              |
| **LAMBDA functions in workbook** | Indicator for the presence of any Excel `LAMBDA()` functions in the workbook.                                                                |
| **Date added**                   | The time the file was uploaded to Spark.                                                                                                     |
| **Added by**                     | User account of the user who uploaded the service version.                                                                                   |
| **Spark environment URL**        | This is the base URL that is used to invoke [Spark APIs](/spark-apis/getting-started.md).                                                    |
| **File UUID**                    | A generated universally unique identifier (UUID) for the uploaded file.                                                                      |
| **File hash**                    | `MD5` hash generated for the uploaded file.                                                                                                  |
| **Conversion time**              | The time to process the conversion of the Excel file.                                                                                        |
| **OriginalServiceHash**          | `SHA-256` hash of the originally uploaded Excel file, i.e. Original Service. Can be used to confirm if the files used are the same.          |
| **CompiledOutputHash**           | `SHA-256` hash of the compiled Neuron Wasm. Can be used to confirm whether the distributed code is the same as what was originally compiled. |
| **Upload log**                   | View the **Upload log** that is shown during the upload.                                                                                     |

## Version details

Properties specific to the service version.

| Key                                                               | Value                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Version**                                                       | Spark [semantic version](https://semver.org/) number.                                                                                                                                                                                                                        |
| **Version label**                                                 | Text field that attaches to version numbers across the Spark user interface. This can be provided as part of the upload journey.                                                                                                                                             |
| **Release notes**                                                 | Text field to describe the purpose of the upload. This can be provided as part of the upload journey.                                                                                                                                                                        |
| **Description**                                                   | This is another field that can be used to describe the service. This can be provided as part of the upload journey.                                                                                                                                                          |
| **Tags**                                                          | Tags that were added to the service.                                                                                                                                                                                                                                         |
| **Date modified**                                                 | Date the service was updated.                                                                                                                                                                                                                                                |
| **Modified by**                                                   | User account of the user who uploaded the service version.                                                                                                                                                                                                                   |
| **Effective from**                                                | See [Manage service versions and effective dates](/build-spark-services/manage-service-versions-and-effective-dates.md) for more information about how this is used. This is entered as part of the upload journey.                                                          |
| **Effective until**                                               | See [Manage service versions and effective dates](/build-spark-services/manage-service-versions-and-effective-dates.md) for more information about how this is used. This is entered as part of the upload journey.                                                          |
| **Default service type**                                          | Defines the default service type used as a default for this Spark service. Service type relates to the Spark `compiler_type` used (e.g. `Neuron` or `XConnector`).                                                                                                           |
| **Compiler version**                                              | Compiler version used for this service version.                                                                                                                                                                                                                              |
| **Enable API Call History**                                       | This setting determines whether the [API Call History](/navigation/api-call-history.md) is enabled.                                                                                                                                                                          |
| **Direct addressing outputs enabled (Neuron 1.16.0 and earlier)** | See [Execute API (v3)](/spark-apis/execute-api/execute-api-v3.md) [Execute API (v3)](/spark-apis/execute-api/execute-api-v3.md#request_meta) `requested_outputs`for more details. For [Neuron](/build-spark-services/neuron.md) `1.17.0` and later this property is ignored. |
| **Batch size override**                                           | Sets the number of records that are processed at a time in the [Testing Center](/navigation/testing-center.md).                                                                                                                                                              |
| **Parameterset compatibility group**                              | This is only applicable to services that contain `Xparameter`. Every Service version is tied to a parameter set compatibility group.                                                                                                                                         |
| **Version ID**                                                    | A generated universally unique identifier (UUID) for this service version. This can be used to identify a service as part of the [Execute API](/spark-apis/execute-api.md).                                                                                                  |

## Service details

Properties that apply across service versions.

| Key                                 | Value                                                                                                                                                                                                                                         |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Initial version author**          | User account of the user who uploaded the service version.                                                                                                                                                                                    |
| **Compiler version service update** | Define which Neuron version to use for a service update. Learn more about how to configure this in [Tenant configuration](/tenant-administration/tenant-configuration.md#choose-the-neuron-compiler-version-for-additional-service-versions). |
| **Public API enabled**              | This determines whether this version of a service can be accessed without authentication. Read more: [Authorization - Public APIs](/spark-apis/public-apis.md)                                                                                |
| **Public API URI**                  | This is one of the endpoints that can be used to access the Public API endpoint.                                                                                                                                                              |
| **XConnector URL**                  | If API call the `compiler_type` is `XConnector`, the API call will be sent to this URL.                                                                                                                                                       |
| **Service ID**                      | A generated universally unique identifier (UUID) for this particular service. This can be used to identify a service as part of the [Execute API](/spark-apis/execute-api.md).                                                                |

## Inputs and Outputs

List of the mapped Spark inputs and outputs.

| Key               | Value                                                                                                     |
| ----------------- | --------------------------------------------------------------------------------------------------------- |
| **Name**          | The name of the input/output.                                                                             |
| **Sheet**         | The Excel worksheet where the input/output was defined.                                                   |
| **Address**       | Within the Excel worksheet, the range address where the input/output was defined.                         |
| **Data type**     | `Date`, `NUMBER`, or `TEXT`.                                                                              |
| **Initial value** | For **Inputs**, any value that exists in the cell or evaluated from a formula from an input/output range. |
| **Description**   | This is read from Excel's **New Name Comment** field.                                                     |

## **Edit a service property**

A number of the **Service Documentation** properties can be modified.

1. Change any of the editable fields on the **Service Documentation** screens.
2. Click **Update**.
3. Choose between making a new version of the service or editing the same service version.
4. Follow the prompts to proceed with the change.
