Environment variables

ERP Connectivity containers must be configured using environment variables. Second option to configure ERP Connectivity is to use HELM charts. ERP Connectivity is already providing a HELM chart. Reading thorugh the environment variables you always find a column "HELM deployment configuration" with information on how to configure these values via HELM chart.

In the HELM chart used and in this operator documentation mentioned variables are listed below. However, there are more variables available than documented, if you are missing something, please reach out to us via the applicable support channels for your case.

Note that some environment variables use single _ and double __ underscores!

Feature flags

You must add the prefix NEXEED_ERPCONNECTIVITY_FeatureFlags__ to core variables e.g. NEXEED_ERPCONNECTIVITY_FeatureFlags__ConnectorPackageCreationEnabled

Variable Description Required Default

Variable	Description	Required	Default
`ConnectorPackageCreationEnabled`	Flag to enable the Connector Package creation wizard in the WebUI	No	false

ConnectorPackageCreationEnabled

Flag to enable the Connector Package creation wizard in the WebUI

false

Core

You must add the prefix NEXEED_ERPCONNECTIVITY_ to core variables e.g. NEXEED_ERPCONNECTIVITY_Encryption__AESEncryption__EncryptionKey

Variable Description Required Default

Variable	Description	Required	Default
`Application__ShutdownTimeoutSeconds`	Number of seconds to allow ongoing processes for completion upon shutdown request.	No	30
`Encryption__AESEncryption__EncryptionKey`	Key used to encrypt passwords stored in the database. Requirements: at least 1 lowercase character, one uppercase character, one number, one special character and at least 100 characters in total.	Yes	-
`CorsOptions__AllowedOrigins__0`	Nexeed Web Portal base URL	Yes	-
`CorsOptions__AllowedOrigins__1`	ERP Connectivity base URL	No	-
`Swagger__EnableUI`	Enables Swagger UI for public API of ERP Connectivity	No	false
`Swagger__Servers__0`	ERP Connectivity base URL	No	-

Application__ShutdownTimeoutSeconds

Number of seconds to allow ongoing processes for completion upon shutdown request.

Encryption__AESEncryption__EncryptionKey

Key used to encrypt passwords stored in the database. Requirements: at least 1 lowercase character, one uppercase character, one number, one special character and at least 100 characters in total.

Yes

CorsOptions__AllowedOrigins__0

Nexeed Web Portal base URL

Yes

CorsOptions__AllowedOrigins__1

ERP Connectivity base URL

Swagger__EnableUI

Enables Swagger UI for public API of ERP Connectivity

false

Swagger__Servers__0

ERP Connectivity base URL

Logging

You must add the prefix NEXEED_ERPCONNECTIVITY_Logging__LogLevel__ to logging variables e.g. NEXEED_ERPCONNECTIVITY_Logging__LogLevel__Default

Variable Description Required Default

Variable	Description	Required	Default
`Default`	Default log level	No	Warning
`Bosch`	Log level for all Bosch implementations	No	Warning
`Bosch.Nexeed.ErpConnectivity`	Log level for ERP Connectivity	No	Warning
`Microsoft`	Log level for all dotnet namespaces starting with Microsoft	No	Warning
`Microsoft.EntityFrameworkCore.Database.Command`	Log level for Microsoft.EntityFrameworkCore.Database.Command namespace	No	Warning
`Microsoft.EntityFrameworkCore.ChangeTracking`	Log level for Microsoft.EntityFrameworkCore.ChangeTracking namespace	No	Warning
`System.Net.Http`	Log level for System.Net.Http namespace	No	Warning
`Bosch.Nexeed.ErpConnectivity.Common.Components.Stores`	Log level for Bosch.Nexeed.ErpConnectivity.Common.Components.Stores namespace	No	Warning

Default

Default log level

Warning

Bosch

Log level for all Bosch implementations

Warning

Bosch.Nexeed.ErpConnectivity

Log level for ERP Connectivity

Warning

Microsoft

Log level for all dotnet namespaces starting with Microsoft

Warning

Microsoft.EntityFrameworkCore.Database.Command

Log level for Microsoft.EntityFrameworkCore.Database.Command namespace

Warning

Microsoft.EntityFrameworkCore.ChangeTracking

Log level for Microsoft.EntityFrameworkCore.ChangeTracking namespace

Warning

System.Net.Http

Log level for System.Net.Http namespace

Warning

Bosch.Nexeed.ErpConnectivity.Common.Components.Stores

Log level for Bosch.Nexeed.ErpConnectivity.Common.Components.Stores namespace

Warning

Database

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__Database__ to database variables e.g. NEXEED_ERPCONNECTIVITY_Components__Database__Provider

Variable Description Required Default

Variable	Description	Required	Default
`Provider`	MSSQL or ORACLE. Depends on which database should be used. MSSQL Collation setting: SQL_Latin1_General_CP1_CI_AS	Yes	MSSQL
`ConnectionString`	dotnet connection string to connect to database	Yes	-
`Jobs__Cleanup__RunEvery`	Defines at which interval the automatic database cleanup is performed. This fully removes soft-deleted Connector and Orchestration Packages as well as expired Message Logs and Orchestrator Logs. Note that higher values make the user-configured Log Retention Period less accurate and can lead to confusing results, therefore it is recommended to use a value under 1 hour and tune performance with the following parameters. Default interval is 15 minutes. Format: hh:mm:ss	No	00:15:00
`Jobs__Cleanup__FetchBatchSize`	Tunes how many deletable Message-/Orchestrator Logs respectively to fetch from the database per cleanup run. This defines the maximum number of entries that can be deleted each interval. A value of zero disables cleanup-batching, but can put heavy load on the database when there is a high number of pending deletions.	no	1000
`Jobs__Cleanup__PurgeBatchSize`	Tunes how many of the fetched Message-/Orchestrator Logs to delete at once. A value of zero disables delete-batching, which is equivalent to setting it to the value of fetchBatchSize, but can put heavy load on the database when there is a high number of pending deletions.	no	100
`Jobs__Cleanup__PurgeIntervalMs`	How long to wait between submitting individual delete-batches to the database. The maximum total duration of the cleanup job in seconds can be approximated with the formula (fetchBatchSize/purgeBatchSize)*(purgeIntervalMs/1000). A value of zero disables delete-batching, like for purgeBatchSize. Format: milliseconds	no	2000
`Jobs__Cleanup__LogRetentionPeriod`	The time span that defines how long logs should be retained before they are deleted. When set with an integer value, it is treated as the number of days. For non-integer values, use the TimeSpan format to specify the exact duration. Format: d.hh:mm:ss	no	30.00:00:00

Provider

MSSQL or ORACLE. Depends on which database should be used. MSSQL Collation setting: SQL_Latin1_General_CP1_CI_AS

Yes

MSSQL

ConnectionString

dotnet connection string to connect to database

Yes

Jobs__Cleanup__RunEvery

Defines at which interval the automatic database cleanup is performed. This fully removes soft-deleted Connector and Orchestration Packages as well as expired Message Logs and Orchestrator Logs. Note that higher values make the user-configured Log Retention Period less accurate and can lead to confusing results, therefore it is recommended to use a value under 1 hour and tune performance with the following parameters. Default interval is 15 minutes. Format: hh:mm:ss

00:15:00

Jobs__Cleanup__FetchBatchSize

Tunes how many deletable Message-/Orchestrator Logs respectively to fetch from the database per cleanup run. This defines the maximum number of entries that can be deleted each interval. A value of zero disables cleanup-batching, but can put heavy load on the database when there is a high number of pending deletions.

1000

Jobs__Cleanup__PurgeBatchSize

Tunes how many of the fetched Message-/Orchestrator Logs to delete at once. A value of zero disables delete-batching, which is equivalent to setting it to the value of fetchBatchSize, but can put heavy load on the database when there is a high number of pending deletions.

100

Jobs__Cleanup__PurgeIntervalMs

How long to wait between submitting individual delete-batches to the database. The maximum total duration of the cleanup job in seconds can be approximated with the formula (fetchBatchSize/purgeBatchSize)*(purgeIntervalMs/1000). A value of zero disables delete-batching, like for purgeBatchSize. Format: milliseconds

2000

Jobs__Cleanup__LogRetentionPeriod

The time span that defines how long logs should be retained before they are deleted. When set with an integer value, it is treated as the number of days. For non-integer values, use the TimeSpan format to specify the exact duration. Format: d.hh:mm:ss

30.00:00:00

Messaging

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__Messaging__ to messaging variables e.g. NEXEED_ERPCONNECTIVITY_Components__Messaging__NexeedAccessUrl__UrlPattern

Variable Description Required Default

Variable	Description	Required	Default
`DirectAsyncResponse__Exchange__Name`	Exchange name where information about new execution results (including payload) of ConnectorPackages should be published to	No	direct-responses.tx
`NexeedAccessUrl__UrlPattern`	URL pattern on how to access execution results from ConnectorPackages and OrchestratorPackages	Yes	https://localhost:8001/api/v1/{tenantId}/{packageType}/{businessArea}/{operation}/result/{resultId}

DirectAsyncResponse__Exchange__Name

Exchange name where information about new execution results (including payload) of ConnectorPackages should be published to

direct-responses.tx

NexeedAccessUrl__UrlPattern

URL pattern on how to access execution results from ConnectorPackages and OrchestratorPackages

Yes

https://localhost:8001/api/v1/{tenantId}/{packageType}/{businessArea}/{operation}/result/{resultId}

Internal broker connection

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__Communication__InternalAmqpOptions__ to internal broker variables e.g. NEXEED_ERPCONNECTIVITY_Components__Communication__InternalAmqpOptions__Hostname

Variable Description Required Default

Variable	Description	Required	Default
`Hostname`	Hostname of RabbitMQ instance (for ERP Connectivity internal usage)	Yes	-
`Port`	Port of RabbitMQ instance that should be connected to (for ERP Connectivity internal usage)	No	5672
`VirtualHost`	Virtual host of RabbitMQ instance that should be used (for ERP Connectivity internal usage)	No	/
`UserName`	Username for RabbitMQ instance needed for authentication (for ERP Connectivity internal usage)	Yes	-
`Password`	Password for RabbitMQ instance needed for authentication (for ERP Connectivity internal usage)	Yes	-
`SslEnabled`	True if SSL should be enabled (for ERP Connectivity internal usage)	No	false
`SslVersion`	SSL Versions to use (only if SSL is enabled) Setting needs to be given in dotnet format - see the Microsoft documentation	No	15360
`Name`	A readable name for the connection to identify it in logs	No	InternalRabbit
`RetryCount`	Number of retries for connecting to RabbitMQ (for ERP Connectivity internal usage)	No	300
`Interval`	Interval in milliseconds that should be waited before next connection retry attempt (for ERP Connectivity internal usage)	No	1000
`ConsumerConcurrency`	How many internal AMQP 0.9.1 messages from the same queue can be processed in parallel (for ERP Connectivity internal usage)	No	20

Hostname

Hostname of RabbitMQ instance (for ERP Connectivity internal usage)

Yes

Port

Port of RabbitMQ instance that should be connected to (for ERP Connectivity internal usage)

5672

VirtualHost

Virtual host of RabbitMQ instance that should be used (for ERP Connectivity internal usage)

UserName

Username for RabbitMQ instance needed for authentication (for ERP Connectivity internal usage)

Yes

Password

Password for RabbitMQ instance needed for authentication (for ERP Connectivity internal usage)

Yes

SslEnabled

True if SSL should be enabled (for ERP Connectivity internal usage)

false

SslVersion

SSL Versions to use (only if SSL is enabled) Setting needs to be given in dotnet format - see the Microsoft documentation

15360

Name

A readable name for the connection to identify it in logs

InternalRabbit

RetryCount

Number of retries for connecting to RabbitMQ (for ERP Connectivity internal usage)

300

Interval

Interval in milliseconds that should be waited before next connection retry attempt (for ERP Connectivity internal usage)

1000

ConsumerConcurrency

How many internal AMQP 0.9.1 messages from the same queue can be processed in parallel (for ERP Connectivity internal usage)

External broker connection

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__Communication__ExternalAmqpOptions__ to external broker variables e.g. NEXEED_ERPCONNECTIVITY_Components__Communication__ExternalAmqpOptions__Hostname

Variable Description Required Default

Variable	Description	Required	Default
`Hostname`	Hostname of RabbitMQ instance	Yes	-
`Port`	Port of RabbitMQ instance that should be connected to	no	5672
`VirtualHost`	Virtual host of RabbitMQ instance that should be used	Yes	-
`UserName`	Username for RabbitMQ instance needed for authentication	Yes	-
`Password`	Password for RabbitMQ instance needed for authentication	Yes	-
`SslEnabled`	True if SSL should be enabled	No	false
`SslVersion`	SSL Versions to use (only if SSL is enabled) Setting needs to be given in dotnet format - see the Microsoft documentation	No	15360
`Name`	A readable name for the connection to identify it in logs	No	ExternalRabbit
`ClientId`	Client Id of ERP Connectivity	No	-
`IsAutoRecovered`	True if connection losses should be automatically recovered	No	true

Hostname

Hostname of RabbitMQ instance

Yes

Port

Port of RabbitMQ instance that should be connected to

5672

VirtualHost

Virtual host of RabbitMQ instance that should be used

Yes

UserName

Username for RabbitMQ instance needed for authentication

Yes

Password

Password for RabbitMQ instance needed for authentication

Yes

SslEnabled

True if SSL should be enabled

false

SslVersion

SSL Versions to use (only if SSL is enabled) Setting needs to be given in dotnet format - see the Microsoft documentation

15360

Name

A readable name for the connection to identify it in logs

ExternalRabbit

ClientId

Client Id of ERP Connectivity

IsAutoRecovered

True if connection losses should be automatically recovered

true

External broker connection for business events including payload

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__Communication__DirectAsyncResponseAmqpOptions__ to external broker variables e.g. NEXEED_ERPCONNECTIVITY_Components__Communication__DirectAsyncResponseAmqpOptions__Hostname

Variable Description Required Default

Variable	Description	Required	Default
`Hostname`	Hostname of RabbitMQ instance	Yes	-
`Port`	Port of RabbitMQ instance that should be connected to	no	5672
`VirtualHost`	Virtual host of RabbitMQ instance that should be used	Yes	-
`UserName`	Username for RabbitMQ instance needed for authentication	Yes	-
`Password`	Password for RabbitMQ instance needed for authentication	Yes	-
`SslEnabled`	True if SSL should be enabled	No	false
`SslVersion`	SSL Versions to use (only if SSL is enabled) Setting needs to be given in dotnet format - see https://learn.microsoft.com/de-de/dotnet/api/system.security.authentication.sslprotocols?view=net-6.0	No	15360
`Name`	A readable name for the connection to identify it in logs	No	DirectAsyncResponseRabbit
`ClientId`	Client Id of ERP Connectivity	No	-
`IsAutoRecovered`	True if connection losses should be automatically recovered	No	true

Hostname

Hostname of RabbitMQ instance

Yes

Port

Port of RabbitMQ instance that should be connected to

5672

VirtualHost

Virtual host of RabbitMQ instance that should be used

Yes

UserName

Username for RabbitMQ instance needed for authentication

Yes

Password

Password for RabbitMQ instance needed for authentication

Yes

SslEnabled

True if SSL should be enabled

false

SslVersion

SSL Versions to use (only if SSL is enabled) Setting needs to be given in dotnet format - see https://learn.microsoft.com/de-de/dotnet/api/system.security.authentication.sslprotocols?view=net-6.0

15360

Name

A readable name for the connection to identify it in logs

DirectAsyncResponseRabbit

ClientId

Client Id of ERP Connectivity

IsAutoRecovered

True if connection losses should be automatically recovered

true

Core

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__CodeCompilation__ to package compilation variables e.g. NEXEED_ERPCONNECTIVITY_Components__CodeCompilation__ConcurrencyLimit

Variable Description Required Default

Variable	Description	Required	Default
`ConcurrencyLimit`	How many Connector Packages and Orchestrator Packages can be compiled simultaneously. Increasing this number can speed up application startup at the expense of higher system resource usage. A value of 0 or less defaults to 1	No	5
`ConcurrencyWaitLimitSeconds`	How long a package can wait to be compiled, in seconds, before ignoring the configured ConcurrencyLimit and commencing compilation regardless. A lower value prefers startup speed, a higher value prefers strictly limiting resource usage. A value of 0 or less defaults to 1	No	10

ConcurrencyLimit

How many Connector Packages and Orchestrator Packages can be compiled simultaneously. Increasing this number can speed up application startup at the expense of higher system resource usage. A value of 0 or less defaults to 1

ConcurrencyWaitLimitSeconds

How long a package can wait to be compiled, in seconds, before ignoring the configured ConcurrencyLimit and commencing compilation regardless. A lower value prefers startup speed, a higher value prefers strictly limiting resource usage. A value of 0 or less defaults to 1

Core

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__Connectors__ to connector variables e.g. NEXEED_ERPCONNECTIVITY_Components__Connectors__SolaceAmqpConnector__FailoverOptions__MaxReconnectAttempts

Variable Description Required Default

Variable	Description	Required	Default
`SolaceAmqpConnector__FailoverOptions__MaxReconnectAttempts`	The maximum number of failover/reconnect attempts the Amqp1Connector can perform before the package is disabled with an unrecoverable failure. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.	No	5
`SolaceAmqpConnector__Amqp1Options__FailoverInterval`	The time that the Amqp1Connector should wait between failover/reconnect attempts. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.	No	00:00:15
`SolaceAmqpConnector__Amqp1Options__ConnectionTimeout`	How long to allow for a connection-related operations of the Amqp1Connector to take before considering the attempt failed. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.	No	00:00:10
`SolaceAmqpConnector__Amqp1Options__UseConnectionPooling`	Whether multiple Amqp1Connector instances should communicate through shared network connections if the target system and credentials are identical. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.	No	true

SolaceAmqpConnector__FailoverOptions__MaxReconnectAttempts

The maximum number of failover/reconnect attempts the Amqp1Connector can perform before the package is disabled with an unrecoverable failure. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.

SolaceAmqpConnector__Amqp1Options__FailoverInterval

The time that the Amqp1Connector should wait between failover/reconnect attempts. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.

00:00:15

SolaceAmqpConnector__Amqp1Options__ConnectionTimeout

How long to allow for a connection-related operations of the Amqp1Connector to take before considering the attempt failed. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.

00:00:10

SolaceAmqpConnector__Amqp1Options__UseConnectionPooling

Whether multiple Amqp1Connector instances should communicate through shared network connections if the target system and credentials are identical. Applies to all Connector and Orchestrator Packages using the Amqp1Connector.

true

MACMA

You must add the prefix NEXEED_ERPCONNECTIVITY_ to MACMA variables e.g. NEXEED_ERPCONNECTIVITY_OIDC__ServiceUrl

Variable Description Required Default

Variable	Description	Required	Default
`OIDC__ServiceUrl`	MACMA URL with base tenant (e.g. https://domain.com/iam/auth/realms/7311ea8c-5d48-43fe-acf9-980eedf24b6c)	Yes	-
`OIDC__RequireHttps`	Is HTTPS required to fetch the token	No	true
`OIDC__PublicClientId`	ERP Connectivity Public Client Id	Yes	-
`OIDC__ClientId`	ERP Connectivity Client Id	Yes	-
`OIDC__ClientSecret`	ERP Connectivity Client Secret	Yes	-
`OIDC__ApplicationName`	ERP Connectivity OIDC Application Name	No	Nexeed ERPConnectivity
`OIDC__TenantId`	ERP Connectivity OIDC Tenant Id	Yes	-
`OIDC__SYSTEMID`	BCI Tenant Id of deployed system	Yes	-
`OIDC__Acl__ServiceScope`	MACMA audience scope	No	aud:macma
`OIDC__Acl__ClientId`	ERP Connectivity Client Id	Yes	-
`OIDC__Acl__ClientSecret`	ERP Connectivity Client Secret	Yes	-
`OIDC__Acl__ApplicationName`	ERP Connectivity OIDC Application Name	Yes	-
`OIDC__NamedHttpClients__DefaultTokenEndpoint`	Default token endpoint of MACMA	Yes	-
`OIDC__OIDC__Introspection__EnableCaching`	Whether or not caching should be enabled for results returned by the introspection endpoint.	Yes	true
`OIDC__Introspection__CachingDuration`	How long introspection results should be cached (in seconds). It should be less than 1 minute.	Yes	30
`AclConfigurations__ApplicationInfo__0__ApplicationName`	ERP Connectivity OIDC Application Name	Yes	-
`AclConfigurations__ApplicationInfo__0__SystemId`	BCI Tenant Id of deployed system	Yes	-
`_TenantConfig__Tenant0`	BCI Tenant Id of deployed system	Yes	-

OIDC__ServiceUrl

MACMA URL with base tenant (e.g. https://domain.com/iam/auth/realms/7311ea8c-5d48-43fe-acf9-980eedf24b6c)

Yes

OIDC__RequireHttps

Is HTTPS required to fetch the token

true

OIDC__PublicClientId

ERP Connectivity Public Client Id

Yes

OIDC__ClientId

ERP Connectivity Client Id

Yes

OIDC__ClientSecret

ERP Connectivity Client Secret

Yes

OIDC__ApplicationName

ERP Connectivity OIDC Application Name

Nexeed ERPConnectivity

OIDC__TenantId

ERP Connectivity OIDC Tenant Id

Yes

OIDC__SYSTEMID

BCI Tenant Id of deployed system

Yes

OIDC__Acl__ServiceScope

MACMA audience scope

aud:macma

OIDC__Acl__ClientId

ERP Connectivity Client Id

Yes

OIDC__Acl__ClientSecret

ERP Connectivity Client Secret

Yes

OIDC__Acl__ApplicationName

ERP Connectivity OIDC Application Name

Yes

OIDC__NamedHttpClients__DefaultTokenEndpoint

Default token endpoint of MACMA

Yes

OIDC__OIDC__Introspection__EnableCaching

Whether or not caching should be enabled for results returned by the introspection endpoint.

Yes

true

OIDC__Introspection__CachingDuration

How long introspection results should be cached (in seconds). It should be less than 1 minute.

Yes

AclConfigurations__ApplicationInfo__0__ApplicationName

ERP Connectivity OIDC Application Name

Yes

AclConfigurations__ApplicationInfo__0__SystemId

BCI Tenant Id of deployed system

Yes

_TenantConfig__Tenant0

BCI Tenant Id of deployed system

Yes

Portal

You must add the prefix NEXEED_ERPCONNECTIVITY_ to core variables e.g. NEXEED_ERPCONNECTIVITY_Portal__Info__version

Variable Description Required Default

Variable	Description	Required	Default
`Portal__Url`	Url of Nexeed Portal	Yes	-
`Portal__Info__version`	version of ERP Connectivity that should be shown in Nexeed Portal	Yes	-
`Portal__Info__id`	ERP Connectivity Client Id	Yes	-
`Portal__Info__baseUrl`	ERP Connectivity base Url	Yes	-
`Portal__Info__AuthProviderClientId`	ERP Connectivity Client Id	Yes	-
`Portal__SCSREGISTRY__SERVICEURL`	Portal registration Url	Yes	-
`Portal__InitialDelayInSeconds`	Initial delay for the portal registration in seconds (ideal value: 20)	Yes	-
`Portal__RetryDelayInSeconds`	Retry delay (interval) in seconds for the portal registration retry (ideal value: 30)	Yes	-
`OIDC__NamedHttpClients__Clients__PortalClient__TokenEndpoint`	Token endpoint of MACMA used by ERP Connectivity to register in Nexeed Portal	Yes	-
`OIDC__NamedHttpClients__Clients__PortalClient__Scopes__0`	Scope that needs to be used to register in Nexeed Portal	Yes	-

Portal__Url

Url of Nexeed Portal

Yes

Portal__Info__version

version of ERP Connectivity that should be shown in Nexeed Portal

Yes

Portal__Info__id

ERP Connectivity Client Id

Yes

Portal__Info__baseUrl

ERP Connectivity base Url

Yes

Portal__Info__AuthProviderClientId

ERP Connectivity Client Id

Yes

Portal__SCSREGISTRY__SERVICEURL

Portal registration Url

Yes

Portal__InitialDelayInSeconds

Initial delay for the portal registration in seconds (ideal value: 20)

Yes

Portal__RetryDelayInSeconds

Retry delay (interval) in seconds for the portal registration retry (ideal value: 30)

Yes

OIDC__NamedHttpClients__Clients__PortalClient__TokenEndpoint

Token endpoint of MACMA used by ERP Connectivity to register in Nexeed Portal

Yes

OIDC__NamedHttpClients__Clients__PortalClient__Scopes__0

Scope that needs to be used to register in Nexeed Portal

Yes

Named clients

You must add the prefix NEXEED_ERPCONNECTIVITY_OIDC__NamedHttpClients__Clients__ to core variables e.g. NEXEED_ERPCONNECTIVITY_OIDC__NamedHttpClients__Clients__ProductSetupManagement__TokenEndpoint

Variable Description Required Default

Variable	Description	Required	Default
`ProductSetupManagement__BaseAddress`	Base address of Product Setup Management used by ERP Connectivity to call Product Setup Management	Yes	-
`ProductSetupManagement__Scopes__0`	Scope that needs to be used to call Product Setup Management	Yes	-
`MaterialManagement__BaseAddress`	Base address of Material Management used by ERP Connectivity to call Material Management	Yes	-
`MaterialManagement__Scopes__0`	Scope that needs to be used to call Material Management	Yes	-
`OrderManagement__BaseAddress`	Base address of Order Management used by ERP Connectivity to call Order Management	Yes	-
`OrderManagement__Scopes__0`	Scope that needs to be used to call Order Management	Yes	-

ProductSetupManagement__BaseAddress

Base address of Product Setup Management used by ERP Connectivity to call Product Setup Management

Yes

ProductSetupManagement__Scopes__0

Scope that needs to be used to call Product Setup Management

Yes

MaterialManagement__BaseAddress

Base address of Material Management used by ERP Connectivity to call Material Management

Yes

MaterialManagement__Scopes__0

Scope that needs to be used to call Material Management

Yes

OrderManagement__BaseAddress

Base address of Order Management used by ERP Connectivity to call Order Management

Yes

OrderManagement__Scopes__0

Scope that needs to be used to call Order Management

Yes

Orchestrator

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__OrchestrationEngine__ to orchestrator engine variables e.g. NEXEED_ERPCONNECTIVITY_Components__OrchestrationEngine__Interpreter__MaxExecutionDepth

Variable Description Required Default

Variable	Description	Required	Default
`Interpreter__MaxExecutionDepth`	Maximum allowed number of transitions between activities in the workflow, after which the workflow execution is forcefully aborted to prevent infinite loops.	no	250

Interpreter__MaxExecutionDepth

Maximum allowed number of transitions between activities in the workflow, after which the workflow execution is forcefully aborted to prevent infinite loops.

250

Orchestrator internal communication

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__OrchestratorCommunication__ to orchestrator communication variables e.g. NEXEED_ERPCONNECTIVITY_Components__OrchestratorCommunication__ResponseWaitTimeout

Variable Description Required Default

Variable	Description	Required	Default
`ResponseWaitTimeout`	Maximum execution time of Connector Packages that were triggered from an Orchestrator Package. Should be less than `WorkflowEngineTimeout`. Format is HH:MM:SS	no	"00:05:00"
`WorkflowEngineTimeout`	Maximum execution time of Orchestrator Package workflows. Format is HH:MM:SS	no	"00:10:00"

ResponseWaitTimeout

Maximum execution time of Connector Packages that were triggered from an Orchestrator Package. Should be less than WorkflowEngineTimeout. Format is HH:MM:SS

"00:05:00"

WorkflowEngineTimeout

Maximum execution time of Orchestrator Package workflows. Format is HH:MM:SS

"00:10:00"

Orchestrator client provider

You must add the prefix NEXEED_ERPCONNECTIVITY_Components__OrchestrationEngine__ClientProviderSettings__ to orchestrator client provider variables e.g. NEXEED_ERPCONNECTIVITY_Components__OrchestrationEngine__ClientProviderSettings__Macma__BaseAddress

Variable Description Required Default

Variable	Description	Required	Default
`Macma__BaseAddress`	Url of MACMA	Only for workflows that communicate with MACMA	-
`Macma__ClientId`	S2S Client ID to use for requests to MACMA	Only for workflows that communicate with MACMA	-
`MaintenanceManagement__BaseAddress`	Url of Maintenance Management	Only for workflows that communicate with Maintenance Management	-
`MaintenanceManagement__ClientId`	S2S Client ID to use for requests to Maintenance Management	Only for workflows that communicate with Maintenance Management	-
`MasterDataManagement__BaseAddress`	Url of Master Data Management	Only for workflows that communicate with Master Data Management	-
`MasterDataManagement__ClientId`	S2S Client ID to use for requests to Master Data Management	Only for workflows that communicate with Master Data Management	-
`ToolManagement__BaseAddress`	Url of Tool Management	Only for workflows that communicate with Tool Management	-
`ToolManagement__ClientId`	S2S Client ID to use for requests to Tool Management	Only for workflows that communicate with Tool Management	-

Macma__BaseAddress

Url of MACMA

Only for workflows that communicate with MACMA

Macma__ClientId

S2S Client ID to use for requests to MACMA

Only for workflows that communicate with MACMA

MaintenanceManagement__BaseAddress

Url of Maintenance Management

Only for workflows that communicate with Maintenance Management

MaintenanceManagement__ClientId

S2S Client ID to use for requests to Maintenance Management

Only for workflows that communicate with Maintenance Management

MasterDataManagement__BaseAddress

Url of Master Data Management

Only for workflows that communicate with Master Data Management

MasterDataManagement__ClientId

S2S Client ID to use for requests to Master Data Management

Only for workflows that communicate with Master Data Management

ToolManagement__BaseAddress

Url of Tool Management

Only for workflows that communicate with Tool Management

ToolManagement__ClientId

S2S Client ID to use for requests to Tool Management

Only for workflows that communicate with Tool Management

Application Performance Monitoring

You must add the prefix NEXEED_ERPCONNECTIVITY_OpenTelemetry__ to OpenTelemetry variables e.g. NEXEED_ERPCONNECTIVITY_OpenTelemetry__Enabled

Variable Description Required Default

Variable	Description	Required	Default
`Enabled`	Enables collection of Metrics and Traces within ERP Connectivity	No	false
`AddOtlpExporter`	Enables the export of collected Metrics and Traces with the OpenTelemetryProtocol	No	false
`ServiceName`	Service Name to be shown in Metrics/Traces	Yes - if `Enabled` is set to `true`	-
`ServiceNamespace`	Service Namespace to be shown in Metrics/Traces	Yes - if `Enabled` is set to `true`	-
`ServiceVersion`	Service Version to be shown in Metrics/Traces	Yes - if `Enabled` is set to `true`	-
`DeploymentEnvironment`	Deployment Environment to be shown in Metrics/Traces	Yes - if `Enabled` is set to `true`	-
`Otlp__endpoint`	Endpoint of Metrics/Traces collector that supports OpenTelemetryProtocol	Yes - if `AddOtlpExporter` is set to `true`	-
`Otlp__headers`	HTTP Headers that shall be used when calling the `Otlp__endpoint`. Example: `"Authorization=Bearer …, X-Header=…"`	Yes - if `AddOtlpExporter` is set to `true`	-

Enabled

Enables collection of Metrics and Traces within ERP Connectivity

false

AddOtlpExporter

Enables the export of collected Metrics and Traces with the OpenTelemetryProtocol

false

ServiceName

Service Name to be shown in Metrics/Traces

Yes - if Enabled is set to true

ServiceNamespace

Service Namespace to be shown in Metrics/Traces

Yes - if Enabled is set to true

ServiceVersion

Service Version to be shown in Metrics/Traces

Yes - if Enabled is set to true

DeploymentEnvironment

Deployment Environment to be shown in Metrics/Traces

Yes - if Enabled is set to true

Otlp__endpoint

Endpoint of Metrics/Traces collector that supports OpenTelemetryProtocol

Yes - if AddOtlpExporter is set to true

Otlp__headers

HTTP Headers that shall be used when calling the Otlp__endpoint. Example: "Authorization=Bearer …, X-Header=…"

Yes - if AddOtlpExporter is set to true

Observability

You must add the prefix NEXEED_ERPCONNECTIVITY_Observability__ to observability variables e.g. NEXEED_ERPCONNECTIVITY_Observability__EnableTracing

Variable Description Required Default

Variable	Description	Required	Default
`EnableTracing`	Whether or not to collect performance traces during runtime. Disabling this can lead to slightly lower resource usage, but would make it impossible to get dedicated support in case of performance issues and is therefore recommended to keep enabled.	no	true

EnableTracing

Whether or not to collect performance traces during runtime. Disabling this can lead to slightly lower resource usage, but would make it impossible to get dedicated support in case of performance issues and is therefore recommended to keep enabled.

true