Migration from 0.18.0 to 0.19.0

Operation form data change

Operation form data has changed to reflect the need to separate operation summary from greeting message. Previously only a ‘message’ attribute was used for both purposes. This attribute is now split into ‘greeting’ and ‘summary’.

The ‘greeting’ is displayed in the web user interface above payment data. The ‘summary’ text is sent in the push messages and contains all operation data and it is also displayed in offline mode for Mobile Token.

Previous form data structure:

{
  "formData" : {
    "title" : {
      "id" : "operation.title",
      "value" : "Confirm Payment"
    },
    "message" : {
      "id" : "operation.greeting",
      "value" : "Hello,\n please confirm following payment:"
    }
  }
}

New form data structure:

{
  "formData" : {
    "title" : {
      "id" : "operation.title",
      "value" : "Confirm Payment"
    },
    "greeting" : {
      "id" : "operation.greeting",
      "value" : "Hello,\n please confirm following payment:"
    },
    "summary" : {
      "id" : "operation.summary",
      "value" : "Hello, please confirm payment 100 CZK to account 238400856/0300."
    }
  }
}

Following messages are required in resources for all locales:

login.greeting=Dobrý den,\n přihlaste se, prosím.
login.summary=Potvrďte prosím přihlášení uživatele.
operation.greeting=Hello,\n please confirm following payment:
operation.summary=Hello, please confirm payment {operation.amount} {operation.currency} to account {operation.account}.

The previously used messages ‘login.message’ and ‘operation.message’ are obsolete.

For clients using the API, the change is also reflected in the client API.

Previously used ‘message’ attribute:

        OperationFormData formData = new OperationFormData();
        formData.addMessage("operation.message");

New ‘greeting’ and ‘summary’ attributes:

        OperationFormData formData = new OperationFormData();
        formData.addGreeting("operation.greeting");
        formData.addSummary("operation.summary");

CSS resources change

Previously there was one main CSS file used in Web Flow:

  • main.css - used for all CSS styles, updated using the customization project

We split this file into two CSS files in order to make CSS customization easier:

  • base.css - CSS styles used by Web Flow in default page design
  • customization.css - customized CSS styles for custom page design

The CSS files are be updated using the ext-resources folder.

The migration steps are following:

  • Identify CSS differences in current main.css file vs. default CSS in Web Flow.
  • Place base.css in your ext-resources folder.
  • Move identified CSS differences into file customization.css in your ext-resources folder.
  • Delete the original main.css file in your ext-resources folder.

Form data value formatting

Web Flow now supports value formatting. Following formats can be specified when creating operation for individual fields:

  • TEXT - value is not formatted
  • LOCALIZED_TEXT - value is localized using localization key from message resources
  • DATE - value is formatted as date using current locale
  • NUMBER - value is formatted as number using current locale
  • AMOUNT - value is formatted as amount with currency using current locale
  • ACCOUNT - value is not formatted (reserved for future use)

Previous initialization of operation form data (still supported):

formData.addKeyValue("operation.dueDate", paymentForm.getDueDate());

New initialization of operation form data:

formData.addKeyValue("operation.dueDate", paymentForm.getDueDate(), OperationFormFieldAttributeFormatted.ValueFormatType.DATE);

Bank account choice attribute configuration

Bank account choice field attribute can be configured when creating the operation:

  • ID - identified of the form field, label is localized based on this ID
  • enabled - true = value can be changed, false = value is not changeable
  • defaultValue - default account ID value (preselected value)
OperationFormFieldConfig bankAccountConfig = new OperationFormFieldConfig();
bankAccountConfig.setId("operation.bankAccountChoice");
bankAccountConfig.setEnabled(true);
bankAccountConfig.setDefaultValue("CZ4043210000000087654321");
formData.getConfig().add(bankAccountConfig);
Last updated on Jul 08, 2019 (18:40) Edit on Github Send Feedback
Search

1.8.x

PowerAuth Web Flow