Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Informações Gerais
Especificação | |||
Produto | RM | Módulo | servicos_globais |
Requisito | R_FRW_INOVBH-28 | ||
País | ( x ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. |
Objetivo
Possibilitar a validação dos dados inseridos na planilha. Destaca-se a possibilidade de criar listas suspensas nas células em que a validação de dados está ativada.
Definição da Regra de Negócio
A API da PlanilhaRM dá suporte à validação dos dados inseridos nas células da planilha eletrônica. A validação de dados está disponível somente através da API, não sendo possível o usuário configurar a validação utilizando a visão (formulário).
A validação dos dados pode ser configurada utilizando a propriedade Validation da classe PlanRMRange. Essa propriedade expõe os membros e métodos da classe PlanRMValidation que são descritos na tabela abaixo:
Propriedades | |
Nome | Descrição |
AlertStyle | Recupera o estilo de alerta utilizado quando uma validação falha. O estilo do alerta é representado pelo enumerável "PlanRMValidationAlertStyle". |
ErrorMessage | Define a mensagem de erro a ser exibida quando uma validação falha. |
ErrorTitle | Define o título da mensagem de erro configurada na propriedade "ErrorMessage". |
Formula1 | Retorna a primeira fórmula de validação. |
Formula2 | Retorna a segunda fórmula de validação. |
IgnoreBlank | Define se a validação deve ser ignorada caso a fórmula de validação se refere à uma célula em branco. |
InCellDropdown | Define se uma lista suspensa será utilizada para fazer a validação do dado da célula. |
InputMessage | Define a mensagem mostrada quando uma das células representadas está ativa. |
InputTitle | Define o título da mensagem da propriedade configurada na propriedade "InputMessage". |
Operator | Retornar o operador de validação. O operador é representado pelo enumerável "PlanRMValidationOperator". |
ShowError | Define se erros serão mostrados caso uma validação falhe. |
ShowInputMessage | Define se uma mensagem de entrada deve ser exibida quando uma das células representadas está ativada. |
Type | Retorna o tipo de validação. O tipo da validação é representado pelo enumerável "PlanRMValidationType". |
Value | Retorna verdadeiro se todas as células representadas coincidem com seu critério de validação. |
Métodos | |
Nome | Descrição |
Add(PlanRMValidationType type, PlanRMValidationAlertStyle alertStyle, PlanRMValidationOperator validationOperator, string formula1, string formula2) | Adiciona uma validação de dados existente no grupo de células selecionadas. |
Delete() | Remove a validação de dados do grupo de células selecionadas. |
Modify(PlanRMValidationType type, PlanRMValidationAlertStyle alertStyle, PlanRMValidationOperator validationOperator, string formula1, string formula2) | Modifica uma validação de dados existente no grupo de células selecionadas. |
Exemplo de Aplicação:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
PlanRMWorkbook wb; wb = PlanRMFactory.OpenFromDataBase(1, 16, "T"); wb = PlanRMFactory.CreateEmpty(CultureInfo.GetCultureInfo("en-US")); PlanRMRange cells = wb.Worksheets[0].Cells; // Cria valores randômicos para usar na lista de validação cells["A1:A5"].Value = "=ROUND(RAND()*100, 0)"; // Cria uma lista de validação na coluna B com os valores gerados nas células "A1:A5" cells["B:B"].Validation.Add(PlanRMValidationType.List, PlanRMValidationAlertStyle.Information, PlanRMValidationOperator.Default, "=$A$1:$A$5", ""); // Cria uma lista de validação na coluna C com os valores "a, b e c" cells["C:C"].Validation.Add(PlanRMValidationType.List, PlanRMValidationAlertStyle.Information, PlanRMValidationOperator.Default, "a,b,c", ""); wb.SaveAs("DataValidation.xlsx"); wb.Close(); |
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|