SamDev - Componentes

Ultima Revisão: 21/07/2021

Componentes de Software é o termo utilizado para descrever o elemento de software que encapsula uma série de funcionalidades. Os componentes abaixo listados foram desenvolvidos pela Multitec para uso exclusivo no SamDev:

1 - m-input: Campos de input para textos, com as seguintes propriedades:
1.1 - type: String - Opções válidas [text, integer, decimal].
1.2 - label: String - Label para o campo.
1.3 - help: String - Texto de ajuda para o campo.
1.4 - id: String - ID do campo.
1.5 - wrapperClass: String - Classe (css) para a DIV wrapper do input.
1.6 - showWrapper: Boolean [default true]- Indica se a DIV wrapper do componente será exibida ou não.
1.7 - required: Boolean [default false] - Indica se esse campo é requerido.
1.8 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.

2 - m-check: Exibe um CheckBox, com as seguintes propriedades:
2.1 - option: Object [default true] - Aqui se define qual o valor será enviado para o modelo quando o check estiver selecionado.
2.2 - inline: Boolean [default false] - Define se o CheckBox vai ser renderizado sem quebra de linha.
2.3 - multiple: Boolean [default false] - Define se os CheckBox com o mesmo nome podem ser enviados em um array com mais de uma seleção.
2.4 - label: String - Label para o campo.
2.5 - help: String - Texto de ajuda para o campo.
2.6 - id: String - ID do campo.
2.7 - wrapperClass: String - Classe (css) para a DIV wrapper do input.
2.8 - showWrapper: Boolean [default true]- Indica se a DIV wrapper do componente será exibida ou não.
2.9 - required: Boolean [default false] - Indica se esse campo é requerido.
2.10 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.

3 - m-radio: Exibe um componente tipo RadioButton, com as seguintes propriedades:
3.1 - inline: Boolean [default false] - Define se o RadioButton vai ser renderizado sem quebra de linha.
3.2 - label: String - Label para o campo.
3.3 - help: String - Texto de ajuda para o campo.
3.4 - id: String - ID do campo.
3.5 - wrapperClass: String - Classe (css) para a DIV wrapper do input.
3.6 - showWrapper: Boolean [default true]- Indica se a DIV wrapper do componente será exibida ou não.
3.7 - required: Boolean [default false] - Indica se esse campo é requerido.
3.8 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.

4 - m-date: Exibe um componente para digitação de datas, com as seguintes propriedades:
4.1 - format: Function - Função destinada para a formatação de datas.
4.2 - min: String (dd/MM/yyyy) - Menor data permitida para o componente.
4.3 - max: String (dd/MM/yyyy) - Maior data permitida para o componente.
4.4 - label: String - Label para o campo.
4.5 - help: String - Texto de ajuda para o campo.
4.6 - id: String - ID do campo.
4.7 - wrapperClass: String - Classe (css) para a DIV wrapper do input.
4.8 - showWrapper: Boolean [default true]- Indica se a DIV wrapper do componente será exibida ou não.
4.9 - required: Boolean [default false] - Indica se esse campo é requerido.
4.10 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.

5 - m-date-interval: Exibe um painel para informar um intervalo de datas, os valores dos parâmetros são iguais aos do m-date.

6 - m-select: Exibe um componente que pode ser renderizado como um ComboBox ou como um AutoComplete:
6.1 - multiple: Boolean [default: false] - Indica se é permitido selecionar mais de um elemento, com as seguintes propriedades:
6.2 - placeholder: String - Texto exibido quando nenhum item está selecionado.
6.3 - selectFirstOnLoad: Boolean [default: false] - Indica se o ComboBox vai selecionar o primeiro elemento quando for montado.
6.4 - showClearButton: Boolean [default: true] - Indica se um botão para limpar o componente vai ser exibido ou não.
6.5 - options: Array[Object] - Array de objetos que serão exibidos no ComboBox. O Objeto do Array pode ter 3 propriedades:
         I - value: Que será enviado para o servidor na hora de executar o relatório;
         II - label: Que será exibido no componente quando selecionado, e;
         III - option: Texto que será exibido quando a caixa do combo-box for aberta.

6.6 - adicionaWherePadrao: indica se o sistema deve adicionar o where padrão à select
6.7 - request: Object - Essa propriedade define como os dados para o AutoComplete serão obtidos no Servidor, deve ser composto por:
6.7.1 - table: Indicando qual a tabela da select;
6.7.2 - columns: Lista de colunas separadas por virgula.

6.7.3 - data (mapa de dados):  Lista de TableMap composto por:
6.7.3.1 - join : TableMap definido por chave e valor da seguinte forma:
         I - inner : String - indica que o valor referente a chave inner será implementado como um INNER JOIN.
         II - left :  String - indica que o valor referente a chave left será implementado como um LEFT JOIN.

6.7.3.2 - where: TableMap definido por chave e valor da seguinte forma:
        I - nome: String - será o nome do campo a ser constituído com o seu valor no WHERE.
        II - valor: String - será o valor a ser comparado no WHERE.

6.7.3.3 - customWhere: String contendo uma condição WHERE livre.

Exemplo:

data : {
      join : { inner : 'abc10ctaRef' , left : 'abc10ecdNatSub' }, 
     where : { abc10codigo : '10002000005' , abc10nome : 'Banco Santander' },
     customWhere : 'AND abc10id = 5000'
}

6.8 - label: String - Label para o campo;
6.9 - help: String - Texto de ajuda para o campo;
6.10 - id: String - ID do campo;
6.11 - wrapperClass: String - Classe (css) para a DIV wrapper do input;
6.12 - showWrapper: Boolean [default true] - Indica se a DIV wrapper do componente será exibida ou não;
6.13 - required: Boolean [default false] - Indica se esse campo é requerido.
6.14 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.

7 - m-panel-check-mpms: Exibe um painel com 4 Checkbox que são utilizados para filtrar os registros de um m-select por Material, Produto, Mercadoria ou Serviço.
7.1 - selectRef (obrigatório): String - indicando qual o REF do m-select que deseja controlar.
7.2 - showMaterial: Boolean [default true]Exibir o check de Material.
7.3 - showProduto: Boolean [default true]Exibir o check de Produto.
7.4  -showMercadoria: Boolean [default true]Exibir o check de Mercadoria.
7.5 - showServico: Boolean [default true]Exibir o check de Servico.
7.6 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.

8 - m-panel-criterio: Exibe um painel de critérios de seleção.
8.1 - tipo: String - Informa qual a aplicação do critério com as seguintes opções:
        I - entidade: Critérios aplicados a Entidades.
        II - item: Critérios aplicados a Itens.
        III - trabalhador - Critérios aplicados a Trabalhadores.

8.2 - v-model: String - Nome do componente, utilizado para comunicação entre o front-end com o back-end.