Entwickler Tutorial (Legacy)
Event auslösen mit .NET

Event auslösen mit .NET

Message- und Signal Events können nicht nur im Studio, sondern auch im .NET Code ausgelöst werden. In diesem Kapitel folgen einige Beispiele dazu. Um dies zu veranschaulichen muss der Example Prozess wie folgt angepasst werden:

Als erstes muss ein Intermediate Event vor dem External Task Worker auf dem Sequence Flow platziert und zu einem Message Intermediate Catch Event abgeändert werden. Als nächstes kann im Property-Panel eine Message eingegeben werden.

Event-Client

Um weiterarbeiten zu können, müssen wir zuerst die Program.cs Datei aufräumen. Die Datei sollte nun so aussehen:

Program.cs
1using AtlasEngine; 2using AtlasEngine.ApiClient; 3 4using Template.ProcessCube.Project.Worker.Example; 5 6var builder = WebApplication.CreateBuilder(args); 7 8builder.Services.AddSpaYarp(); 9 10// Add services to the container. 11builder.Host.UseExternalTaskWorkers(); 12builder.Services.AddControllers(); 13builder.Services.Configure<ApiClientSettings>(builder.Configuration.GetSection("AtlasEngine")); 14builder.Services.AddScoped<ExampleHandler>(); 15 16// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle 17builder.Services.AddEndpointsApiExplorer(); 18builder.Services.AddSwaggerGen(); 19 20var app = builder.Build(); 21 22if (app.Environment.IsDevelopment()) 23{ 24 app.UseSwagger(); 25 app.UseSwaggerUI(); 26} 27// Configure the HTTP request pipeline. 28if (!app.Environment.IsDevelopment()) 29{ 30 // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. 31 app.UseHsts(); 32} 33 34app.UseHttpsRedirection(); 35 36app.UseCors(x => x 37 .AllowAnyOrigin() 38 .AllowAnyMethod() 39 .AllowAnyHeader()); 40 41app.UseStaticFiles(); 42app.UseRouting(); 43 44app.MapControllerRoute( 45 name: "default", 46 pattern: "{controller}/{action=Index}/{id?}"); 47 48app.UseSpaYarp(); 49 50app.UseWebSockets(); 51 52app.MapFallbackToFile("index.html"); 53 54var engineUri = new Uri("http://engine:8000"); 55var processDefinitionClient = ClientFactory.CreateProcessDefinitionsClient(engineUri); 56var processModelId = "ProzessId"; 57var startResponse = await processDefinitionClient.StartProcessInstanceAsync(processModelId); 58 59app.Run(); 60
Program.cs
1using AtlasEngine; 2using AtlasEngine.ApiClient; 3 4using Template.ProcessCube.Project.Worker.Example; 5 6var builder = WebApplication.CreateBuilder(args); 7 8builder.Services.AddSpaYarp(); 9 10// Add services to the container. 11builder.Host.UseExternalTaskWorkers(); 12builder.Services.AddControllers(); 13builder.Services.Configure<ApiClientSettings>(builder.Configuration.GetSection("AtlasEngine")); 14builder.Services.AddScoped<ExampleHandler>(); 15 16// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle 17builder.Services.AddEndpointsApiExplorer(); 18builder.Services.AddSwaggerGen(); 19 20var app = builder.Build(); 21 22if (app.Environment.IsDevelopment()) 23{ 24 app.UseSwagger(); 25 app.UseSwaggerUI(); 26} 27// Configure the HTTP request pipeline. 28if (!app.Environment.IsDevelopment()) 29{ 30 // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. 31 app.UseHsts(); 32} 33 34app.UseHttpsRedirection(); 35 36app.UseCors(x => x 37 .AllowAnyOrigin() 38 .AllowAnyMethod() 39 .AllowAnyHeader()); 40 41app.UseStaticFiles(); 42app.UseRouting(); 43 44app.MapControllerRoute( 45 name: "default", 46 pattern: "{controller}/{action=Index}/{id?}"); 47 48app.UseSpaYarp(); 49 50app.UseWebSockets(); 51 52app.MapFallbackToFile("index.html"); 53 54var engineUri = new Uri("http://engine:8000"); 55var processDefinitionClient = ClientFactory.CreateProcessDefinitionsClient(engineUri); 56var processModelId = "ProzessId"; 57var startResponse = await processDefinitionClient.StartProcessInstanceAsync(processModelId); 58 59app.Run(); 60

Um ein Event mit .NET auslösen zu können, wird eine Instanz des Event-Clients benötigt. Diese kann wie folgt in der Program.cs Datei unterhalb der anderen Variablen initialisiert werden:

Program.cs
var eventClient = ClientFactory.CreateEventClient(engineUri);

Unterstützte Event-Typen

Es gibt zwei Event-Typen, die mit dem Client ausgelöst werden können:

⚠️

In unserem Beispiel verwenden wir beim Example Prozess ein Message Event. Der Implementierungsablauf ist jedoch für beide Arten ähnlich.

Message Event

Um ein Message Event auszulösen, stellt der Event-Client die Methode TriggerMessageAsync bereit. Die Methode erfordert einen Message-Namen, eine Process Instance ID und eine Payload.

Program.cs
await eventClient.TriggerMessageAsync("MyMessage", startResponse.ProcessInstanceId, new object());
⚠️

Der erste Parameter der Funktion MyMessage muss identisch mit der oben konfigurierten Message sein.

Signal Event

Das Auslösen eines Signal Events funktioniert ähnlich wie beim Message Event. Die Methode dafür heißt TriggerSignalAsync und benötigt, anders als beim Auslösen eines Message Events, keine Process Instance ID, sondern nur einen Signalnamen und eine Payload.

Program.cs
await eventClient.TriggerSignalAsync("TestSignal", new object());

Downloads

Prozesse