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:
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();
601using 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();
60Um 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:
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.
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.
await eventClient.TriggerSignalAsync("TestSignal", new object());