thomasduft/microwf

A simple finite state machine (FSM) with workflow character where you define your workflows in code.

microwf

A simple finite state machine (FSM) with workflow character where you define your workflows in code.

Holiday approval sample

In code it looks like:

public class HolidayApprovalWorkflow : WorkflowDefinitionBase
{
  public override string Type => nameof(HolidayApprovalWorkflow);

  public override List<Transition> Transitions
  {
    get
    {
      return new List<Transition>
      {
        new Transition {
          State = "New",
          Trigger = "Apply",
          TargetState ="Applied",
          CanMakeTransition = MeApplyingForHolidays
        },
        new Transition {
          State = "Applied",
          Trigger = "Approve",
          TargetState ="Approved",
          CanMakeTransition = BossIsApproving,
          AfterTransition = ThankBossForApproving
        },
        new Transition {
          State = "Applied",
          Trigger = "Reject",
          TargetState ="Rejected"
        }
      };
    }
  }

  private bool MeApplyingForHolidays(TransitionContext context)
  {
    var holiday = context.GetInstance<Holiday>();

    return holiday.Me == "Me";
  }

  private bool BossIsApproving(TransitionContext context)
  {
    var holiday = context.GetInstance<Holiday>();
    
    return holiday.Boss == "NiceBoss";
  }
  
  private void ThankBossForApproving(TransitionContext context)
  {
    // SendMail("Thank you!!!");
  }
}

Running the samples

Assuming you downloaded the sources and opened the directory with VS Code you should be good to go! Ahh and of course you need .NET Core and node.js installed on your development environment.

Running the WebApi backend

1. Open the integrated terminal in VS Code and type

dotnet build

That ensures you are able to build the dotnet related stuff!

2. Hit F5 or go to the VS Code Debug tab (Ctrl+Shift+D) and run the WebApi project.

3. Once the project has started head over to your browser of choice and type in https://localhost:5001.

You should see now the login screen.

For developing purpose there exists a compound task named dev:be-fe 🚀 that spins up the WebApi project with the dotnet watch run command as well as the Angular based WebClient project with the npm run start command.

Administrator Web UI

A web interface allows an administrator to search for workflow instances and have a look into the current state.

Happy poking!!

microwf's Issues

Dynamic Users from database.

Hello Thomas!
I want to know how i can create dynamic mapping users form database and context. Thank you. And how i can change it to dynamic

Feature Request - Support for Child Tasks

Scenario:

1. Trainee Creates record (Parent Record#1 - Action: New; Status: New)
2. Trainee Completes work and submits (Parent Record#1 - Action: Submit; Status: Pending for Review)
3. Floor Manager Review Task gets created automatically. (Child Record#11 - Status: New)
4. Branch Manager Review Task gets created automatically. (Child Record#12 - Status: New)
5. Floor Manager approves the review task. (Child Record#11 - Action: Approve; Status: Approved)
6. Branch Manager approves the review task. As all the tasks are approved the parent case status changes to Approved (Child Record#12 - Action: Approve; Status: Approved; Parent Record#1 - Status: Approved)

Ef not generating

Hello.
I forked your project, to test it (and eventually add some PRs if needed).
I'm trying to add a complete new Workflow, it seams really easy to do. But when I was almost finished i got stuck because I can't generate the migration.
I get the error

Unable to create an object of type 'DomainContext'. For the different patterns supported at
design time, see...
...
System.MissingMethodException: No parameterless constructor defined for this object. ....
....
at Microsoft.EntityFrameworkCore.Design.Internal.DbContextOperations.<>c__DisplayClass12_3.b__13()

Whenever I execute
dotnet ef migrations add SoftwareRequest001 -c DomainContext

Im executing it under microwf/samples/WebApi
Am I doing something wrong, or have you any clue what this might be?

BTW: Nice work!
I'm not using the docker, because sadly my company doesn't allow us yet to install docker. I will thou try your solution on my ubunto private PC

enable see history from others

how enable to see your workflow, after dispacthing to others, and control all process? it might be seen or not? thank you

how to use formdef for file

How to use formdef for input type="file" ? so i cannot ound this. I define in model File type, and add input type=file, but i cannot see file in form? hwo i do this?

WebClient not working anymore

After merging your fix for #11 (which did solve the problem) in my fork, my WebClient stopped working.
I then cloned your repo again, and I see that the WebClient form your repo isn't working either,
Since I'm a Vue.Js guy and not an angular expert, I don't now where to fix the error, but I see that the request are done to http://localhost:4200 (The url of the Webclient, not the one of the WebAPI)

http://localhost:4200/api/workflow/definitions

It should go to

https://localhost:5001/api/workflow/definitions

I hardcoded the url in the

microwf/samples/WebClient/src/app/shared/services/api.service.ts

because I don't know where the API base url is saved in angular, but then i get tls errors. (I suppose it's because you removed the certification entry in the settings files.)

Login And Password

Hi Thomas,
How can I authenticate from the login page ?
Thank you.