NO-ISSUE: add form-generation-tool README.md

[pefernan]

Adding missing README.md

[yesamer]

Thank you @pefernan

[jomarko]

Thank you for this readme, very helpful.

Question to issues I spot, maybe they are already reported as one of bellow?

• Fix @kogito-apps/form-details: The embedded monaco-editor doesn't show the proper syntax highlighting incubator-kie-issues#527
• Fix @kogito-apps/process-form: doesn't display custom forms. incubator-kie-issues#526
• Fix @kogito-apps/form-displayer issues displaying HTML forms incubator-kie-issues#525
• Fix @kogito-apps/form-displayer issues when establishing the envelope connection incubator-kie-issues#524

[jomarko]

I was not able to use patternfly for the basic process-quarkus-example is that expected, known issues or new issue?

log

Project path: /home/jomarko/github/kogito-examples/kogito-quarkus-examples/process-quarkus-example
Form type: patternfly

? Do you want to continue? Yes

Starting Form generation:

Found 5 schemas

Generating form "demo#orderItems"
Cannot generate form "demo#orderItems":  ',' expected. (3:17)
  1 | import React, { useCallback, useEffect, useState }  from "react";
  2 |     import { TextInput, FormGroup, Card, CardBody, Checkbox } from "@patternfly/react-core";
> 3 | const Form__demo#orderItems: React.FC<any> = ( props:any ) => {
    |                 ^
  4 |   const [formApi, setFormApi] = useState<any>();
  5 |   const [ item, set__item ] = useState<string>("");
  6 | const [ order__orderNumber, set__order__orderNumber ] = useState<string>("");

Generating form "demo#orderItems_Verify_order"
Cannot generate form "demo#orderItems_Verify_order":  ',' expected. (3:17)
  1 | import React, { useCallback, useEffect, useState }  from "react";
  2 |     import { Card, CardBody, TextInput, FormGroup, Checkbox } from "@patternfly/react-core";
> 3 | const Form__demo#orderItems_Verify_order: React.FC<any> = ( props:any ) => {
    |                 ^
  4 |   const [formApi, setFormApi] = useState<any>();
  5 |   const [ input1__orderNumber, set__input1__orderNumber ] = useState<string>("");
  6 | const [ input1__shipped, set__input1__shipped ] = useState<boolean>(false);

Generating form "demo#orders"
Cannot generate form "demo#orders":  ',' expected. (3:17)
  1 | import React, { useCallback, useEffect, useState }  from "react";
  2 |     import { TextInput, FormGroup, Card, CardBody, Checkbox } from "@patternfly/react-core";
> 3 | const Form__demo#orders: React.FC<any> = ( props:any ) => {
    |                 ^
  4 |   const [formApi, setFormApi] = useState<any>();
  5 |   const [ approver, set__approver ] = useState<string>("");
  6 | const [ order__orderNumber, set__order__orderNumber ] = useState<string>("");

Generating form "persons"
Successfully generated form "persons.tsx"

Generating form "persons_ChildrenHandling"
Successfully generated form "persons_ChildrenHandling.tsx"

Good bye!

[pefernan]

@jomarko ok, I think this is a new issue. Looks like the problem is because some processes in the example have an id like demo.order and that generates a schema file with a name like demo#orders.json... the tool uses the schema file name as a formId when building the react forms, probably sanityze the id to avoid that issue (at least to generate the form code)

[jomarko]

@pefernan please report a separate issue, or let me know I should do it, then I can approve this PR.

[pefernan]

@jomarko creating it now:

• Fix @kie-tools/form-generation-tool: Problems generating forms for schemas that have # in the filename. incubator-kie-issues#528

[jomarko]

I was able to start and open runtime tools quarkus extension for process-quarkus-example, however when I try to open a form, I got this error, is that expected, known

issue or new issue please?

[pefernan]

@jomarko this one is related to apache/incubator-kie-issues#525

[jomarko]

Thank you