Está viendo la ayuda para la versión:
| This tutorial is a step in the Create Your First Adaptive Form series. It is recommended to follow the series in chronological sequence to understand, perform, and demonstrate the complete tutorial use case. |
AEM Forms data integration module allows you to create a form data model from disparate backend data sources such as AEM user profile, RESTful web services, SOAP-based web services, OData services, and relational databases. You can configure data model objects and services in a form data model and associate it with an adaptive form. Adaptive form fields are bound to data model object properties. The services enable you to prefill the adaptive form and write submitted form data back to the data model object.
For more information about form data integration and form data model, see AEM Forms Data Integration.
This tutorial walks you through the steps to prepare, create, configure, and associate a form data model with an adaptive form. At the end of this tutorial, you will be able to:
- Configure MySQL database as data source
- Create form data model using MySQL database
- Configure form data model
- Test form data model
The form data model will look similar to the following:
Before you begin, ensure that you have the following:
- MySQL database with sample data as stated in the Prerequisites section of Create your first adaptive form
- OSGi bundle for MySQL JDBC driver as explained in Bundling the JDBC Database Driver
- Adaptive form as explained in the first tutorial Create an adaptive form
You can configure different types of data sources to create a form data model. For this tutorial, we will configure the MySQL database that you configured and populated with sample data. For information about other supported data sources and how to configure them, see AEM Forms Data Integration.
Do the following to configure your MySQL database:
-
-
Log in to AEM Forms Author Instance as an administrator and go to AEM web console bundles. The default URL is http://localhost:4502/system/console/bundles.
-
-
-
Go to AEM web console at http://localhost:4502/system/console/configMgr.
-
In the configuration dialog, specify the following details:
- Datasource name: You can specify any name. For example, specify WeRetailMySQL.
- DataSource service property name: Specify name of the service property containing the DataSource name. It is specified while registering the data source instance as OSGi service. For example, datasource.name.
- JDBC driver class: Specify Java class name of the JDBC driver. For MySQL database, specify com.mysql.jdbc.Driver.
- JDBC connection URI: Specify connection URL of the database. For MySQL database running on port 3306 and schema weretail, the URL is: jdbc:mysql://[server]:3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
- Username: Username of the database. It is required to enable JDBC driver to establish a connection with the database.
- Password: Password of the database. It is required to enable JDBC driver to establish a connection with the database.
- Test on Borrow: Enable the Test on Borrow option.
- Test on Return: Enable the Test on Return option.
- Validation Query: Specify a SQL SELECT query to validate connections from the pool. The query must return at least one row. For example, select * from customerdetails.
- Transaction Isolation: Set the value to READ_COMMITTED.
Leave other properties with default values and tap Save.
-
AEM Forms provides an intuitive user interface to create a form data model from configured data sources. You can use multiple data sources in a form data model. For our use case, we will use the configured MySQL data source.
Do the following to create form data model:
Configuring form data model involves:
- adding data model object and services
- configuring read and write services for data model objects
Do the following to configure the form data model:
-
On AEM author instance, navigate to Forms > Data Integrations. The default URL is http://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
-
Expand the WeRailMySQL data source tree. Select the following data model objects and services from weretail > customerdetails schema to form data model:
- Data model objects:
- id
- name
- shippingAddress
- city
- state
- zipcode
- Services:
- get
- update
Tap Add Selected to add selected data model objects and services to the form data model.
Nota:
The default get, update, and insert services for JDBC datasources are provided out-of-the-box with form data model .
- Data model objects:
-
-
-
Specify the following in the Edit Properties dialog:
- Title: Specify title of the service. For example: Retrieve Shipping Address.
- Description: Specify description containing detailed functioning of the service. For example:
This service retrieves shipping address and other customer details from MySQL database - Output Model Object: Select schema containing customer data. For example:
customerdetail schema - Return array: Disable the Return array option.
- Arguments: Select argument named ID.
Tap Done. Service to retrieve customer details from the MySQL database is configured.
-
Specify the following in the Edit Properties dialog:
- Title: Specify title of the service. For example, Update Shipping Address.
- Description: Specify description containing detailed functioning of the service. For example:
This service updates shipping address and related fields in MySQL database - Input Model Object: Select schema containing customer data. For example:
customerdetail schema - Output type: Select BOOLEAN.
- Arguments: Select argument named ID and customerdetails.
Tap Done. The update service to update customer details in the MySQL database is configured.
-
and configure the argument as follows.
The data model object and services in the form data model are configured. You can now test the form data model.
You can test the data model object and services to verify that the form data model is configured properly.
Do the following to run the test:
-
Similarly, you can test the Write model object and services.
In the following example, the update service successfully updates the address details for the id 7102715 in the database.
Now, if you test the read model service again for the id 7107215, it will fetch and display the updated customer details as shown below.
Los términos de Creative Commons no cubren las publicaciones en Twitter™ y Facebook.