Linha RM

Atalhos

Páginas filhas
  • ER_R_FRW_INOVBH-28_Validacao_Dados_Planilha_RM

 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

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".

Formula1Retorna a primeira fórmula de validação.
Formula2Retorna a segunda fórmula de validação.
IgnoreBlankDefine se a validação deve ser ignorada caso a fórmula de validação se refere à uma célula em branco.
InCellDropdownDefine se uma lista suspensa será utilizada para fazer a validação do dado da célula.
InputMessageDefine a mensagem mostrada quando uma das células representadas está ativa.
InputTitleDefine o título da mensagem da propriedade configurada na propriedade "InputMessage".
OperatorRetornar o operador de validação. O operador é representado pelo enumerável "PlanRMValidationOperator".
ShowErrorDefine se erros serão mostrados caso uma validação falhe.
ShowInputMessageDefine se uma mensagem de entrada deve ser exibida quando uma das células representadas está ativada.
TypeRetorna o tipo de validação. O tipo da validação é representado pelo enumerável "PlanRMValidationType".
ValueRetorna 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:

Validação de Dados
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.