Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Build & run

Run yarn on ./taskana/web directory

Run taskana-rest-spring-example [Standalone mode] with Login screen

  1. Build taskana-web application in production mode 

    code

    languagebashtitle

    path: /taskana/web

    Code Block
    languagebash
    yarn build:prod
  2. Build taskana-web dependency

    Code Blocklanguagebashtitle

    path: /taskana/web

    Code Block
    languagebash
    ../mvnw clean install -pl :taskana-web
  3. taskana\web\src\environments\data-sources\environment-information.json contains the definition of the external configuration needed for taskana web application, currently exists next options:

    • "taskanaRestUrl": empty string by default, if you have to change it, just modify with the corresponding REST api url.

       if taskanaRestUrl is empty string, web application will use the same machine where it's running as REST url, for instance if you are running the application at http://localhost:8080 the requests will point to http://localhost:8080/v1/...

    • "taskanaLogoutUrl": empty string by default, if you have to change it, just modify with the corresponding REST api url. This property should point to the logout url desired.

  4. [Optional]: Modify ./rest\taskana-rest-spring-example-boot\src\main\resources\application.properties  enableCsrf=false if you're planning to use the REST Service without the Frontend. 

  5. Build taskana project

    path: /taskana

    Code Block
    title
    languagebashpath: /taskana
    ./mvnw clean install
  6. Run taskana-rest-spring-example-boot

    Code Blocklanguagebashtitle

    [Optional]: You can add some (exemplary) SPI implementations into our demo app by activating the following profiles:

Profile

Dependency

Description

history.plugin

  • pro.taskana.history:taskana-simplehistory-rest-spring

simple history + REST Service for retrieving history events

historyLogging.plugin

  • pro.taskana.history:taskana-loghistory-provider

History events will be logged out

dmn-routing.plugin

  • pro.taskana:taskana-spi-routing-dmn-router

  • pro.taskana:taskana-routing-rest

DMN-TaskRouter Implementation + REST Service to upload DMN-Excel file

path: /taskana

Code Block
languagebash
./mvnw spring-boot:run -pl :taskana-rest-spring-example-boot

Run taskana-rest-spring-example-boot [Developer mode] without Login screen, user is: admin/admin

  1. Run web application in developer mode

    Code Blocklanguagebash


    title

    path: /taskana/web

    Code Block
    languagebash
    yarn start


  2. Modify ./rest\taskana-rest-spring-example-boot\src\main\resources\application.properties  devMode=true

  3. Build taskana-rest-spring-example-boot


    path: /taskana

    Code Block
    languagebashtitlepath: /taskana
    ./mvnw install -pl :taskana-rest-spring-example-boot -am


  4. Run taskana-rest-spring-example-boot

    path: /taskana

    Code Block
    languagebash
    titlepath: /taskana
    ./mvnw spring-boot:run -pl :taskana-rest-spring-example-boot


Before creating a Pull request

  • Taskana web application runs Jslint, tests and production bundling before deployment, to make sure that your code is 100% functional run next commands before creating a PR.


    • Linting and create production code.

      Code Blocklanguagebash

      title

      path: /taskana/web

      Code Block
      languagebash
      yarn build:prod


    • Run linting

      Code Blocklanguagebashtitle

      path: /taskana/web

      Code Block
      languagebash
      yarn lint


    • Run tests locally.

      code

      languagebashtitle

      path: /taskana/web

      Code Block
      languagebash
      yarn test


    • Run End-to-End tests. (Taskana needs to be running)

      Code Blocklanguagebashtitle

      path: /taskana/web

      Code Block
      languagebash
      yarn e2e-dev