application settings

Application Settings

The following settings can be set in your application's app.config file or via environment variables through the Azure portal.

Connection strings

Each storage account used to store the event stream for the entities needs to have a connection string set in the application settings.

By convention these are named by the domain but you can choose whatever name you wish and the actual mapping between an entity and a storage account is performed by the Entity storage mapping as below

Entity storage mapping

For each entity type you need a mapping that specifies the implementation to use to store the event stream and the name of the connection string to use to access the storage into which the event stream is written.

The naming convention for this is Domain.Entity Type - for example in the Worked Example : Bank Account, the name of the setting to store the bank accounts in is Bank.Account.

The value of the setting is the implementation type (Table or AppendBlob) followed by a semi colon separator followed by the connection string name used to find the connection string to save events with.

So to store events in a table in the storage account with the connection string named RetailBank the value would be Table;RetailBank.

Notification settings

RaiseEntityCreationNotification

If set to 'true' then when a new entity (event stream) is created then a notification will be sent via Event Grid

RaiseEventNotification

If set to 'true' then whenever a new event is appended to an existing event stream then a notification will be sent via Event Grid

EventGridHubName

This contains the name of the event grid hub to which notification messages will be sent.

EventGridTopicEndpoint

This is set to the URL of the endpoint of the above named b=hub to which notification messages are posted.

EventGridKeyValue

This is the access key used to authorise the application to post notification messages to the event hub.

EventGridPublishRetryCount

This is the number of times to retry sending an event grid notification if it fails.

EventGridPublishRetryInterval

This is the timespan to wait before retrying a failed notification. This is in the format hh:mm:ss (i.e. one minute retry interval would be '00:01:00')