# CreateMedicalDataSourceRequest.Builder

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)

# Builder

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/health/connect/CreateMedicalDataSourceRequest.Builder "View this page in Java")  

```
class Builder
```

|---|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                                                 ||
| ↳ | [android.health.connect.CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) |

Builder class for[CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest).

## Summary

|                                                                                                                                                                                                                                                                                                                                                          Public constructors                                                                                                                                                                                                                                                                                                                                                          ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#Builder(android.health.connect.CreateMedicalDataSourceRequest))`(`other:` `[CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest)`)` Constructs a clone of the other[CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest)instance.                                                                                                                                                                                                         |
| [Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#Builder(android.health.connect.CreateMedicalDataSourceRequest.Builder))`(`other:` `[CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#)`)` Constructs a clone of the other[CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#).                                                                                                                                                                       |
| [Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#Builder(android.net.Uri,%20kotlin.String,%20android.health.connect.datatypes.FhirVersion))`(`fhirBaseUri:` `[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)`, `displayName:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`, `fhirVersion:` `[FhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/datatypes/FhirVersion)`)` Constructs a new[CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#)instance. |

|                                                                                                                                                                                                                                                              Public methods                                                                                                                                                                                                                                                              ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest)                  | [build](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#build())`()` Returns a new instance of[CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest)with the specified parameters.                                                 |
| [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) | [setDisplayName](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#setDisplayName(kotlin.String))`(`displayName:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)`)` Sets the display name.                                                                                        |
| [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) | [setFhirBaseUri](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#setFhirBaseUri(android.net.Uri))`(`fhirBaseUri:` `[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)`)` Sets the FHIR base URI.                                                                                          |
| [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) | [setFhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#setFhirVersion(android.health.connect.datatypes.FhirVersion))`(`fhirVersion:` `[FhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/datatypes/FhirVersion)`)` Sets the FHIR version of data from this data source. |

## Public constructors

### Builder

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
Builder(other: CreateMedicalDataSourceRequest)
```

Constructs a clone of the other[CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest)instance.

|                                                                                 Parameters                                                                                  ||
|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `other` | [CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest):This value cannot be`null`. |

### Builder

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
Builder(other: CreateMedicalDataSourceRequest.Builder)
```

Constructs a clone of the other[CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#).

|                                                                                          Parameters                                                                                          ||
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `other` | [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#):This value cannot be`null`. |

### Builder

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
Builder(
    fhirBaseUri: Uri, 
    displayName: String, 
    fhirVersion: FhirVersion)
```

Constructs a new[CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#)instance.

|                                                                                                                                                                                                                                                                                                                                                                                      Parameters                                                                                                                                                                                                                                                                                                                                                                                       ||
|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `fhirBaseUri` | [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#):The FHIR base URI of the data source. For data coming from a FHIR server this should be the[FHIR base URL](https://hl7.org/fhir/R4/http.html#root)(e.g. \`https://example.com/fhir\`). If the data is generated by an app without a FHIR URL, this can be populated by a unique and understandable URI defined by the app (e.g. \`myapp://..\`) that points to the source of the data. We recommend not to use a domain name that you don't control. If your app supports[app deep linking](https://developer.android.com/training/app-links/deep-linking), this URI would ideally link to the source data. The maximum length for the URI is 2000 characters. This value cannot be`null`. |
| `displayName` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):The display name that describes the data source. The maximum length for the display name is 90 characters. This must be unique per app. This value cannot be`null`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `fhirVersion` | [FhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/datatypes/FhirVersion):The FHIR version of the medical data that will be linked to this data source. This has to be a version supported by Health Connect, as documented on the[FhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/datatypes/FhirVersion). This value cannot be`null`.                                                                                                                                                                                                                                                                                                                                                             |

## Public methods

### build

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
fun build(): CreateMedicalDataSourceRequest
```

Returns a new instance of[CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest)with the specified parameters.

|                                                                               Return                                                                                ||
|----------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [CreateMedicalDataSourceRequest](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest) | This value cannot be`null`. |

|                                                                            Exceptions                                                                            ||
|--------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
| `java.lang.IllegalArgumentException` | if the`mFhirBaseUri`or`mDisplayName`exceed the character limits or if the`mFhirVersion`is not supported by Health Connect. |

### setDisplayName

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
fun setDisplayName(displayName: String): CreateMedicalDataSourceRequest.Builder
```

Sets the display name. For the request to succeed this must be unique per app.

The display name may not exceed 90 characters.

|                                                         Parameters                                                          ||
|---------------|--------------------------------------------------------------------------------------------------------------|
| `displayName` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html):This value cannot be`null`. |

|                                                                                        Return                                                                                        ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) | This value cannot be`null`. |

### setFhirBaseUri

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
fun setFhirBaseUri(fhirBaseUri: Uri): CreateMedicalDataSourceRequest.Builder
```

Sets the FHIR base URI. For data coming from a FHIR server this should be the[FHIR base URL](https://hl7.org/fhir/R4/http.html#root)(e.g. \`https://example.com/fhir\`).

If the data is generated by an app without a FHIR base URL, this can be populated by a URI defined by the app (e.g. \`myapp://..\`) that should:

- Be a unique and understandable URI.
- Point to the source of the data. We recommend not to use a domain name that you don't control.
- Ideally allow linking to the data source if your app supports[app deep linking](https://developer.android.com/training/app-links/deep-linking)to the data.

The URI may not exceed 2000 characters.

|                                                       Parameters                                                       ||
|---------------|---------------------------------------------------------------------------------------------------------|
| `fhirBaseUri` | [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#):This value cannot be`null`. |

|                                                                                        Return                                                                                        ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) | This value cannot be`null`. |

### setFhirVersion

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in[U Extensions 16](https://developer.android.com/sdkExtensions)  

```
fun setFhirVersion(fhirVersion: FhirVersion): CreateMedicalDataSourceRequest.Builder
```

Sets the FHIR version of data from this data source.

This has to be a version supported by Health Connect, as documented on the[FhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/datatypes/FhirVersion).

|                                                                      Parameters                                                                       ||
|---------------|----------------------------------------------------------------------------------------------------------------------------------------|
| `fhirVersion` | [FhirVersion](https://developer.android.com/reference/kotlin/android/health/connect/datatypes/FhirVersion):This value cannot be`null`. |

|                                                                                        Return                                                                                        ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [CreateMedicalDataSourceRequest.Builder](https://developer.android.com/reference/kotlin/android/health/connect/CreateMedicalDataSourceRequest.Builder#) | This value cannot be`null`. |