How to apply validation on excel sheet fields

RE: How to apply validation on excel sheet fields

deviratnamv — Tue, 18 Dec 2018 12:19:28 GMT

Thank you Thasneem Nisa, It's working fine.

RE: How to apply validation on excel sheet fields

mohamedt808 — Tue, 18 Dec 2018 09:11:07 GMT

Hi,

you can perform a certain amount of validation on file properties within the upload interface using fv!file.(properties). Refer here for some examples. For validation on data, you can perform the validation on file submission and display them back on the same interface with relevant validation messages, passing them as an input to the interface,

Regards,

Thoufiq.

RE: How to apply validation on excel sheet fields

Thasneem Nisa — Tue, 18 Dec 2018 09:10:06 GMT

Hi,

Once the excel is uploaded and form been submitted, call the main rule provided above in a script task and store the o/p in a variable ( For Ex: validations[List of Text]). Next to script task have an XOR and check whether the variable is empty. If empty, then proceed with other operations. If there are some errors, then re-direct to UIT. In the interface, add a rule input for validations and insert below field

a!richTextDisplayField(
  showWhen: not(
    isnull(
      ri!validations
    )
  ),
  value: a!richTextBulletedList(
    items: a!forEach(
      items: ri!validations,
      expression: a!richTextListItem(
        text: a!richTextItem(
          text: fv!item,
          color: "NEGATIVE"
        )
      )
    )
  )
)

Hope this helps!!

RE: How to apply validation on excel sheet fields

deviratnamv — Tue, 18 Dec 2018 08:55:44 GMT

How to display validation message at the time of uploading excel document?

RE: How to apply validation on excel sheet fields

deviratnamv — Fri, 14 Dec 2018 11:51:38 GMT

Thank you Thasneem Nisa, I will try.......

RE: How to apply validation on excel sheet fields

Thasneem Nisa — Fri, 14 Dec 2018 11:37:34 GMT

Hi deviratnamv

Following rules will help you to validate data retrieved from readexcelsheet(). Please note that I have handled most possible cases of excel validation. You might have to add logic to handle your application-specific use cases for each cell data.

Code for TEST_getExcelValidations() <Master Rule>

with(
  local!excelData: rule!TEST_readExcelSheet(
    document: ri!document,
    sheetNumber: 0,
    startRow: 1,
    numberOfColumns: 17
  ),
  rule!TEST_checkIfExcelDocumentHasValidData(
    excelData: local!excelData
  )
)

Code for TEST_readExcelSheet()

with(
  local!excelData: readexcelsheet(
    ri!document,
    ri!sheetNumber,
    ri!startRow,
    ri!numberOfColumns
  ),
  if(
    toboolean(
      local!excelData.success
    ) = false(),
    null,
    remove(
      local!excelData.result,
      where(
        a!forEach(
          items: local!excelData.result.values,
          expression: length(
            fv!item
          ) = 0
        )
      )
    )
  )
)

Code for TEST_checkIfExcelDocumentHasValidData()

if(
  isnull(
    ri!excelData
  ),
  {},
  with(
  /*Removing header row from the retrieved data. Write separate rule to validate header row if needed*/
    local!dataFromExcel: index(
      remove(
        ri!excelData,
        1
      ),
      "values",
      null
    ),
    if(
      isnull(
        local!dataFromExcel
      ),
      "All the cells cannot be empty.",
      reject(
        fn!isnull,
        rule!TEST_validateEachRow(
          dataFromExcel: local!dataFromExcel,
          userName: ri!userName
        )
      )
    )
  )
)

Code for TEST_validateEachRow()

a!flatten(
    a!foreach(
        items:ri!dataFromExcel,
        expression:{
        /**Add Validation rules as per your need and call those here**/
        /*I have passed rowNumber, cellName as inputs to construct the error message to user*/
            rule!TEST_validateTextCell(
                isRequired:true(), 
                cellName:"First Column Name", 
                rowNumber:fv!index+1,
                cellData:index(
                    fv!item,
                    1,/*1 specifies column number to validate*/
                    null
                )
            ),
            rule!TEST_validateIntegerCell(
                isRequired:true(), 
                cellName:"Second Column Name", 
                rowNumber:fv!index+1,
                cellData:index(
                    fv!item,
                    2,/*Passing 2nd column data to validate*/
                    null
                )
            )
        }
    )
)

Logic behind TEST_validateTextCell() or TEST_validateIntegerCell()

if(
    ri!isRequired,
    if(
        isnull(
            ri!cellData
        ),
        "Row Number: "&ri!rowNumber&" has no data for "&ri!columnName&" column",
        if(
            ri!cellData<=0,
            "Row Number: "&ri!rowNumber&" has 0 or lesser than 0 for "&ri!columnName&" column. Only positive values allowed.",
            {} /*I have validated for positive number*/
        )
    )
)

RE: How to apply validation on excel sheet fields

mohamedt808 — Fri, 14 Dec 2018 11:16:56 GMT

Hi,

I am guessing you would like to vlaidate certain fields in your excel, lets say want to ensure certain headers are present . You can achieve this by using Read Excel Cell by Name() or Read Excel Cell by Number() function and extract the value first, validate the data in Appian and proceed with reading the entire file using readExcelSheet.

RE: How to apply validation on excel sheet fields

vijay — Fri, 14 Dec 2018 11:15:53 GMT

Hi Devi Ratnam,

Please check the option Data Validation under the Data menu in excel file. By using this we can restrict the user from entering inappropriate data as per our need. Hope may help this.

Regards,
Vijay