metasfresh/metasfresh-e2e-legacy

metasfresh End-2-End Testing project.

metasfresh is a responsive, Free and Open Source ERP System. Our aim is to create fast and easy-to-use enterprise software with an outstanding user experience.

We do Open Source ERP

Equipped with wide and detailed functionality, metasfresh fits for companies from industry and trade that are searching business software that provides high scalability and flexibility.

It has a 3-tier architecture with Rest-API and a Web User Frontend developed in HTML5/ ReactJS/ Redux.

Installation

We publish a stable Release of metasfresh every Friday - ok, we skip 1 week at the end of the year ;-) . You can download it here.

metasfresh can be installed via Docker or Ubuntu Installer.

Docker How do I setup the metasfresh stack using Docker?

Ubuntu How do I install metasfresh using the Installation package?

First steps:

• How do I log on?
• How do I change the Interface Language?
• How do I Setup my Company?
• How do I create my first Sales Order?
• How do I create my first Shipment?
• How do I create my first Invoice?

Documentationbadge

If you are new to metasfresh and would like to learn more, then you can find our documentation here:

• Admins
• Users
• Developers
• Tester

Discussion

Come visit us in our Community Forum for questions, discussions and exchange of new insights. We look forward to meeting you!

Contributing

Do you want to help improving documentation, contribute some code or participate in functional requirements. That's great, you're welcome! Please read our Code of Conduct and Contributor Guidelines first.

"Monorepo"

To check out only certain parts of this repository, we recommend getting git version 2.25.0 or later and use the git-sparse-checkout feature. Examples:

• to get started, do git sparse-checkout init --clone
  • this will leave you with just the files in the repo's root folder, such as the file you are reading
• to get the frontend code, do git sparse-checkout set frontend
• to go back to having everything checked out, do git sparse-checkout disable

What's new in metasfresh ERP?

If you are interested in latest improvements or bug fixes of metasfresh ERP, feel free to check out our Release Notes.

metasfresh-e2e-legacy's Issues

Use fixtures for attributes

Custom command for read-only checkbox

we don't have a custom commend yet to check read-only checkboxes: e.g. IsValid in PaymentTerm

Add plugins

• snapshots plugin https://github.com/meinaart/cypress-plugin-snapshots
• skip/only plugin https://github.com/bahmutov/cypress-skip-and-only-ui

Fix sales order test

Enable checking for user notifications

Allow a cypress test author to wait for a particular user notification, e.g. when they started the invoicing process

Store user session for all tests

Instead of having to add the code for saving cookies before all tests, we should add it once before all the suites run. We can do the same with login as right now we don't need to flush any stored state and can easily get away with just one login per test session.

Dedicated Machine for Cypress E2E tests

• Sometimes the Cypress E2E Tests fail because of timeouts (waiting for a Layout 20000 ms)
• For the Developer, this does not feel good when test worked on local and fails in CI.
• Need a solution that provided a performant Testing environment for automatic Cypress Tests via CI.

Create Product Masterdata for Automatic End2End Tests with cypress

Create Test: sales orderline

Test for adding an orderline in a sales order:

• existing product
• existing packing item
• existing price
  => all shall be set correctly, as set in masterdata

implement sales order to invoice

This issue is related to

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• run your test in jenkins e2e
  • https://dashboard.cypress.io/#/projects/5yp4q1/runs/118/specs
  • note that the sales-order and sales-order-to-invoice specs succeeded; for the failed tests, i assumed they are due to temporary low performance on the instance (timeout waiting for window layout)
• get it integrated into master
  • #61

All Flags are ticked? Congratulations, you have delivered!

Verify BOM

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Test shall include:
=> needs #71

http://recordit.co/xWKxlu7iRv

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #149
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Create new Packing Material

This issue is related to
https://github.com/metasfresh/me03/issues/2039

Test shall include:

1. Create a new product, "Test Packmittel", Kategorie: Gebinde
2. Create a new entry in packing material
3. In product, select Test Packmittel

http://recordit.co/eGk8eyxKsj

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #138)
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Create Test: product price in product window

Test for adding a new price in product window (product already existing). Sales & Purchase.

Create Test: product price in product prices window

Test for adding a new price in product prices window (product already existing). Sales & Purchase.

Use fixtures for sales order

Export json from metasfresh WebUI for fixture

First idea: Have an action in WebUI windows single view, that allows exporting the JSON for that record (including subtab data). This would allow users to create the test data configuration as easy as recording via ui.

Move existing cypress tests into metasfresh-e2e repo

@siemiatj this repo's gh7-e2e branch now contains

• the cypress folder
• the cypress.json

from metasfresh-webui-frontend.

It also still contains the things it used to contain, e.g. the Jenkinsfile that builds an e2e docker image by cloning metasfresh-webui-frontend.
Please make cypress work in here. Feel free to edit, move around, rename etc whatever you need to

Create new Tax Rate/Tax Category

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Test shall include:

1. Create new Tax Category and Tax Rate "Steuersatz 10 %"
2. New Tax Category can be selected in a product price

• create new price for e.g. Convenience Salat
• select "Steuersatz 10 %"

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #364

All Flags are ticked? Congratulations, you have delivered!

Use fixtures for prices

Set Tax Category inactive/active

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

=> can be done together with #74 (not necessarily in the same test!)
Test shall include:

1. Set Tax Category inactive
2. Inactive Tax Category cannot be selected in pricelist
3. Set Tax Category active again
4. Tax Category can be selected in pricelist

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #364

All Flags are ticked? Congratulations, you have delivered!

Create Test sales order using existing bpartner

• existing bpartner, no creation on-the-fly
• make sure bpartner is set correctly in order (location, contact, warehouse, pricing system)

(sales_order_spec test needs existing orders)

Create test: warehouse

warehouse to set in bpartner / order etc.

test-runs: https://github.com/metasfresh/me03/issues/1488#issuecomment-510429635

Create Test: set packing item in product window

Test for adding a packing item in product window (product already existing, packing item already existing).

Create Pricing Masterdata for Automatic End2End Tests with cypress

Fix Test purchase_create_vendor

Fix Test purchase_create_vendor and move from integration desfunct back to integration.

Fix Test: Sysconfig

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • (pull request URL)
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Create new bpartner group

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Test shall include:

1. Have a bpartner as customer (use customer specific fixtures)
2. create new bpartner group
3. add bpartner (customer) to the group:

• group can be selected in bpartner window
• group shows bpartner in assigned partners

4. add accounts: ??

Fixture to be used

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #103
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Add repeatable actions for working with filters

Create Attribute Masterdata for Automatic End2End Tests with cypress

Extend build system to forward (e2e-)version info

Fix Test: Discountschema with breaks

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • (pull request URL)
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Set currency USD active/inactive

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Test shall include:

1. Set currency USD inactive
2. Set currency USD active again

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • (pull request URL)
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Create Test sales order creating bpartner on-the-fly

• don't use existing bpartner, but create on-the-fly
• make sure bpartner is set correctly in order (location, contact, warehouse, pricing system)

(sales_order_spec test needs existing one)

Create BPartner Masterdata for Automatic End2End Tests with cypress

Overview / Documentation cypress test coverage for sp80

Create new BOM

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Test shall include:
http://recordit.co/4tW9y91Wna

stopped the video too early, sry: this is the result of the test, for the product for which the BOM was created:

Note:

1. the doc no. is not set automatically, which shall be fixed, pls set X for now
2. pls create random products to use beforehand, using the resp. fixture
3. make sure that the product you set in BOM has Stocked:Y and Sold:Y, while the products used as components have Stocked:Y and Purchased:Y

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #149
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Create test: payment term

payment term to use in bpartner / order

Use fixtures for business objects

Fix isChecked command

Fix command for checking if checkbox is checked.

Decide on best practice in creating metasfresh testing DSL

Currently we have a few builders to create e.g. business partners or refund contracts via cypress.
As of creating this issue, they are here: https://github.com/metasfresh/metasfresh-webui-frontend/tree/5.93/cypress/support/utils

They were inspired by https://medium.com/@axelhadfeg/builder-pattern-using-javascript-and-es6-ec1539182e24 and first introduced into metasfresh in this PR: metasfresh/metasfresh-webui-frontend-legacy#2123

Goal of this task: research and figure out if this is a good patter to use going forward, or if there is a better way of creating a userfriendly DSL to write easily understandable cypress tests.

Fix bpartner object: location

This issue is related to

• https://github.com/metasfresh/me03/issues/1570

=> adding a location in bpartner object is not working:

• either field "city" is not found
• or the country is not set: it gets selected but it looks like it does not get patched

when running i get

CypressError: Timed out retrying: cy.wait() timed out waiting 5000ms for the 1st request to the route: 'writeIntoLookupListField-1556265910609'. No request ever occurred.

Create test: bpartner relation

Reorganize and further integrate e2e into CI process

Use fixtures for products

eslint delete CR error in project

eslint reports an error "delete cr". shall not.

Fix Test: Product set documentnote

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • (pull request URL)
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Setup and document IDE for cypress test developers

Note

• very probably it's going to be VS Code
• list plugins and how to install them
• document how to enable Intellisense (or link to the documentation)
• go over the "cypress" part of https://github.com/metasfresh/metasfresh-webui-frontend/blob/master/README.md, see if things can be simplified
• probably have a workshop with everyone to get them started

Open and close Calendar Period

This issue is related to
https://github.com/metasfresh/me03/issues/2035

Test shall include:

1. Open Calendar Period
2. Close Calendar Period

http://recordit.co/DliJVDNylm

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #119
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!

Make our custom input commands more stable

Actually, the idea here is to make sure that input commands which cause the frontend to do a PATCH actually wait for the respective PATCH response.

The approach to achieve this is to inspect the PATCH's xhr response body and look for the field name and value that was just typed into the respective field.

We do this as was outlined in this comment: cypress-io/cypress#387 (comment)

Create new bank

This issue is related to

• (e.g. a metasfresh-issue)
• (e.g. a customer issue)

Test shall include:

1. Create new bank "Raiffeisen"
2. New bank can be selected in bpartner, bank account tab:

• open bpartner, e.g. Customer1
• in bank account tab, select new bank "Raiffeisen"

http://recordit.co/Dbfxjb5kwV

Todo for developer (besides coding)

• Always make sure the issue is in the correct project lane
• make your estimation and label (customer:..., est:..., release:... ) this issue accordingly
• run your test in jenkins e2e
• get it integrated into master
  • #144
• add the label of your developer effort in sum (effort: ...)

All Flags are ticked? Congratulations, you have delivered!