Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Index 

Índice
outlinetrue
exclude.*ndice
stylenone

 


Speaking of datasets...

This feature allows creating datasets and defining which ones will be offline on mobile devices, which ones should be synchronized with the external data provider, and the synchronization frequency, among other options.

...

Datasets are components that allow standardizing access to information from locations external to the platform, such as applications and databases. High-performance datasets have a data storage cache obtained externally, which aims to reduce the number of accesses to external data services, that is, it creates a copy of the data structure within the platform for query, enhancing the performance of the datasets developed on the platform. Therefore, the data is queried on the platform itself, preventing access to data in the external provider system in every request.

In order to update the data of the copy created on the platform, go to Task scheduler and define the synchronization frequency.

 

Basic Path

This feature allows creating datasets and defining which ones will be offline on mobile devices, which ones should be synchronized with the external data provider, and the synchronization frequency, disable those that are no longer used, among other options.

Active datasets are highlighted with a stronger font color to stand out among datasets that are no longer being used.

Informações
titleStay tuned for more info!

Refer to the technical documentation to learn more about dataset development.


Displaying datasets

...

...

01. In the main menu, click Control Panel.02. In the General tab, , then check Development container and click Datasets.

0302. View all internal, generated or encodeddatasets View all datasets shown in the list.

Learn more
Painel
Expandir
title

It is possible to search for a specific dataset through the Search field located in on the upper right corner of the window.

 

Alternative Paths

 

Displaying datasets

, or use the Filter button to select datasets that will be returned.


Filtering datasets

...

...

01. In Click the Display field Filter button located at the top left side of the screen, select the type of dataset to viewon the upper right corner of the window.

02. Select the type of dataset to view: Encoded, Generated or Internal.03. datasets to be shown on screen. Filter by status (active, inactive and/or under editing) and type (internal, simple and/or advanced).

Painel

The selected types of datasets will be listed

...

.


New

...

simple dataset

 

...

01. Click New Dataset, and click Simple.

02. In the Code field, enter a code for the dataset.

Painel

To avoid inconsistencies, the dataset code and description must not contain special characters (except for “_” and “-”).

03. In the Description field, enter a description for the dataset.

04. In the Service field, select a service for the dataset.

Expandir
titleLearn more

If no service is listed, simply register a new one, by clicking the Register button.

In the Name field, add a name for the service to be registered.

In the Description field, add a description for the service.

In the URL field, add the URL of the Webservice to be used.

Click Save.

When creating a service in fluig, pointing to a webservice, a .jar file is created in the volume, which is used to access that webservice. The classes within the .jar file are called stubs. That is why, when creating a service, some conflicts may occur and prevent the generation of stubs. Thus it will be necessary to use a JAXB bind file.

The binding file will only be used for services created using the CXF API.

To add it, simply click Choose file in the Binding file field and add it.

For more details about binding, see our technical documentation on Integration with External Applications.

05. In the Operation field, select an operation for the dataset.

...

It is possible to configure an operation by clicking the Configure field.

...

02. In the User field, define a user.

03. In the Password field, define a password.

04. To disable chunking, select the Disable chunking option.

05. If you want to enable the soap message list, select the List SOAP messages option.

06. In the Response Time field, define the response time.

07. Click Save.

Painel

If you do not have any registered services, simply go to the Services menu in the General tab of the Control Panel to create a new one.

05. When you select the SOAP, REST, or JDBC services, the fill-in options will appear differently from one to the other. Fill in the fields according to the selected service.

Painel
Deck of Cards
historyfalse
idservicos
Card
ids
labelSOAP

When selecting the SOAP service type, complete the following fields:

Operation
Selecting the magnifying glass icon will allow you to select one of the available operations. The operations will be listed by Name and PortType (ColleagueService).

To set up
In the settings of the selected operation, Properties, SOAP Headers and Return Processing can be configured.

Painel

Properties

  • Basic Authentication - Select whether or not to authenticate. You can define a user name and password.
  • SSL - enable when soap service requires use of ssl.
  • Disable Chunking - disable sending the entire soap envelope.
  • List SOAP messages - enable to show the sending and receiving messages in the log.


Dataset keys


Allows setting the keys to be used during offline synchronization, in order to avoid duplicate records from each synchronization.

SOAP Headers

Allows you to add a header.

Treatment Return

  • Extract Result: Allows you to select this option to extract a report in xml format and include a tag.

Parameters:
Fill in the parameters as required:

Assignment
-Null or Variable (When Null is selected, the Value field is automatically dispensed).

Value
-WKCompany or WKUser (Will be displayed when the assignment field is selected as Variable).

Card
idr
labelREST

When selecting the REST service type, complete the following fields:

Operation
Selecting the magnifying glass icon will allow you to select one of the available operations. The operations will be listed by Name, Method (GET), and API.

To set up
In the settings of the selected operation, the Properties, Headers and Return.

Painel

Properties

  • SSL - enable when soap service requires use of ssl.
  • List messages - enable to show the sending and receiving messages in the log.
  • Response time - enable to display the time the request waits for the response.

Dataset keys

Allows setting the keys to be used during offline synchronization, in order to avoid duplicate records from each synchronization.

Headers
Allows you to add a header.

Treatment Return

  • Extract Result: Allows you to select this option to extract a report in JSON format and include a path

Click Save to complete the configuration.

Parameters:
Fill in the parameters as required:

Assignment
-Null or Variable (When Null is selected, the Value field is automatically dispensed).

Value
-WKCompany or WKUser (Will be displayed when the assignment field is selected as Variable).

Card
idj
labelJDBC

When selecting the JDBC service type, complete the following fields:

Table
Selecting the magnifying glass icon will allow you to select one of the available tables. The operations will be listed by Name and Type (Table, VIew or Synonym).

To set up
In the selected table settings, you can configure some properties such as:


  • Limit Result - Enable to limit the number of records returned.
  • Key field for the table - Allows to select a key field for the table, being: limit or offset.

Click Save to complete the creation.

Fields
Fill in the fields as requested:


Filters - Allows you to add filters to the fields.

Painel

To create filters, you need to configure some information. Are they:

Operation
Lets you select one of the available operations: AND, OR or NOT.

Initial value
Set an initial value. Ex: 1

Final value
Define an end value. Ex: 3

Use Like
Search for content, not exact, but that contains part of the value informed. Just select Yes or No.

  • Return - Allow or not to return a value. Just press Yes or No.
  • Sort - allows you to sort the fields in ascending or descending order.

06. Click Save.


New advanced dataset

...

01. Click New Dataset, and click Advanced.

02. In the Code field, enter a code for the dataset.

Painel

To avoid inconsistencies, the dataset code and description must not contain special characters (except for “_” and “-”).

03. In the Description field, enter a description for the dataset.

Painel

This adds a new advanced dataset record and opens the screen to edit the dataset source code. The source code will be saved as draft before the authenticated user clicks Save. Changes to the source code are only applied to the dataset after the user completes all changes and clicks the Post button. Refer to the technical documentation available here to learn more about building advanced datasets.


Enable offline dataset on mobile

06. In the Parameters field, define the assignment and value for each parameter.

07. Click Save.

 

Enable offline dataset on mobile

...

...

01. Click the edit icon in the Offline mobile column, represented by the pencil symbol.

...

Painel

The default setting is No (Off).

Required information:

Use cache on mobile devices?

When enabled, the data in the dataset is stored in cache when used on mobile devices. In this case, the button ON (yes) is displayed, indicating that the feature is active. When set to disable the feature, the button OFF  (no) is displayed, indicating that the feature is disabled.

Mobile cache expiration time

Time in which the stored data is considered valid and remains in the cache of mobile devices before being updated.

Not use cache when the mobile device is online?

When enabled, the data in cache is not queried when the mobile device is online, that is, it is required from the external system.

03. Click Save.

Nota
titleAttencion

New data created on mobile devices when using the offline mode is only available for query on other forms after the mobile application is synchronized with the fluig Fluig server. For more information about this process, go to the step Configuring dataset synchronization on this page.

Painel

For Internal datasets, this option is not editable. They are only viewed as default, Internal.

 


...

Import dataset

...

 

...

01. Click the edit icon, represented by the pencil symbol, located in the Synchronization column Import.

02.   Click On to enable it.

03. Click Synchronize now

Painel

When clicking this option, the dataset data written on the platform are synchronized with the corresponding data from the external system.

It is only possible to enable data synchronization for datasets developed on the platform. When enabling synchronization, it is carried out according to the schedule created in Task Scheduler. For information on how to define the synchronization frequency, see the alternative path Edit scheduling

04. Click Off to disable it.

05. Click Save.

06. Click Close.

Painel

This option can only be edited for Generated Datasets. Internal Datasets are viewed as default.

 

View synchronization information

 

01. Click the information icon in the Last synchronization column.

02. View the information on the last data synchronization of the dataset.

03. Click Close to go back to the main window

Painel

This option can only be edited for Generated Datasets.

 

Edit synchronization scheduling

 

01. Click the horizontal bars icon, located in the Options column.

02. Click Edit scheduling.

03. In the Scheduling settings window, change the information of your choosing

Painel

For additional information on the fields, see Task Scheduler.

04. Click Confirm.

Painel

To view the next scheduled synchronization, simply keep an eye on the Next synchronization column, which shows the exact date and time of the next synchronization.

This option can only be edited for Generated Datasets.

 

Display code

 

01. Click the horizontal bars icon, located in the Options column.

02. Click Display code.

03. View the javascript source code of the developed dataset.

04. Click Close

 

Delete dataset

 

01. Click the horizontal bars icon, located in the Options column.

02. Click Delete dataset.

03. In the pop-up message, click Delete

Painel

When clicking this option, all data contained in the dataset is deleted.

This option can only be edited for Generated Datasets

 

Querying dataset

 

01. Click Query, represented by the magnifying glass icon, located in the Options column.

02. View dataset data.

03. Click Close.

 

Edit dataset

...

Select the server to which the dataset will be imported.

Painel

The server must be properly registered as detailed in the Servers item. The dataset will only be successfully imported if the selected server has a update 1.6.5 (Liquid) or higher.

If there is already a dataset with the same code imported from another server, the platform will show a warning message, and the user must confirm in order to create a new version with the deployment of the imported dataset.

03. Click Import.


Export dataset

...

01. Select the datasets to be exported.

02. Click Export.

03. Select the server to which the dataset will be exported.

Painel

The server must be properly registered as detailed in the Servers item. The dataset will only be successfully imported if the selected server has a update 1.6.5 (Liquid) or higher.

04. Click Export.


Configure access permission in the dataset

...

The Control Panel Permissions feature allows you to define users, roles, or groups that will have access to Internal datasets. For more details, go to Permission features in APIs, datasets and webservices.


Dataset synchronization

...

Synchronization features are available in a specific screen, which can be accessed by clicking the link in the Synchronization column. Refer to the Dataset synchronization page to learn more about this feature.


More dataset actions

...

Datasets contain several specific actions, which may be checked by clicking the Horizontal bars icon in the More actions column. Refer to the More dataset actions page to learn more about these features.

02. Make the necessary changes.

03. Click Save.

 

 



Informações
titlePlease note!

This documentation is valid from the Liquid (1.6.2 5) update. If you use a previous update, it may contain information different from what you see on your platform.

 

...