Ajustes nos enumeradores dos provedores

[Italo Giurizzato Junior]

Olá pessoal,

Gostaria da opinião de vocês com relação a nomenclatura dos enumeradores dos provedores.

O componente ACBrNFSeX atende por volta 110 provedores dentre deles temos provedores que seguem a versão 1 do layout da ABRASF outros seguem a versão 2 e temos os que possuem o seu layout próprio.

No inicio fomos definindo os enumeradores em função do seu nome e depois acabamos descobrindo que existem provedores que tem webservice tanto na versão 1 quanto na versão 2 do layout da ABRASF e outros que tem um webservice para o layout próprio e outro para o layout da ABRASF.

Sem contar com alguns provedores que tem variações na mesma versão como é o caso do Provedor Pronim que tem na versão 2 a varia~]ao 2 e 3, ou seja, proPronim_202, proPronim_203.

A minha sugestão é padronizar a nomenclatura.

Todos os provedores que seguem a versão 1 do layout da ABRASF passariam a ter no final do seu nome "_100a", por exemplo: proGinfes_100a

Isso deixa claro que o provedor Ginfes segue a versão 1 do layout da ABRASF.

Os que seguem a versão 2 passariam a ter no final do seu nome "_200a", ou "_202a" ou "_204a" dependendo da variação.

Já os provedores que tem layout próprio passariam a ter no final do nome "_100p", pro exemplo o provedor Equiplano passaria ter o enumerador: proEquiplano_100p.

Note que se tratando de provedor que possui um layout próprio tem no final do seu nome a letra "P" em minúscula que significa Próprio.

Já os provedores que seguem a ABRASF passariam a ter no final do seu nome a letra "A" em minúscula que significa ABRASF.

 

O que vai ocorrer com as aplicações caso venhamos a tomar essa medida:

As aplicações que usam os enumeradores como tomada de decisão vai ocorrer quebra de código, consequentemente seja necessário fazer o ajuste necessário para voltar a compilar.

Por exemplo:

If Provedor = proGinfes then

Ocorreria erro de compilação uma vez que o enumerador foi alterado.

Correção:

If Provedor = proGinfes_100a then

 

Quero deixar claro que essa alteração não foi feita, estou apenas compartilhando com vocês a minha intensão de realizar essa padronização na nomenclatura dos enumeradores dos provedores.

Quero a opinião de vocês.

[Valdir Dill]

Boa tarde,

Acho bem positiva a ideia. Ficaria bem mais transparente.

Temos essa situação de usar os enumeradores (If Provedor = proGinfes then), mas acho seria muito simples adaptar o código à nova nomenclatura.

Obrigado!

[leandroaoa]

A favor tambem vai dar um trabalho mas ficara muito mais claro pra manutencoes futuras

[foleyjf]

Italo do jeito que você propos fica excelente.

[Renato Rubinho]

É uma boa melhoria.

Pensando a longo prazo, considere também implementar com um zero a esquerda, para a formatação ficar a mesma caso eventualmente tenhamos versão 10 em diante.

"_0203a" 2.03

"_1001a" 10.01

 

[Victor H. Gonzales - Panda]

20 horas atrás, Italo Giurizzato Junior disse:

Olá pessoal,

Gostaria da opinião de vocês com relação a nomenclatura dos enumeradores dos provedores.

O componente ACBrNFSeX atende por volta 110 provedores dentre deles temos provedores que seguem a versão 1 do layout da ABRASF outros seguem a versão 2 e temos os que possuem o seu layout próprio.

No inicio fomos definindo os enumeradores em função do seu nome e depois acabamos descobrindo que existem provedores que tem webservice tanto na versão 1 quanto na versão 2 do layout da ABRASF e outros que tem um webservice para o layout próprio e outro para o layout da ABRASF.

Sem contar com alguns provedores que tem variações na mesma versão como é o caso do Provedor Pronim que tem na versão 2 a varia~]ao 2 e 3, ou seja, proPronim_202, proPronim_203.

A minha sugestão é padronizar a nomenclatura.

Todos os provedores que seguem a versão 1 do layout da ABRASF passariam a ter no final do seu nome "_100a", por exemplo: proGinfes_100a

Isso deixa claro que o provedor Ginfes segue a versão 1 do layout da ABRASF.

Os que seguem a versão 2 passariam a ter no final do seu nome "_200a", ou "_202a" ou "_204a" dependendo da variação.

Já os provedores que tem layout próprio passariam a ter no final do nome "_100p", pro exemplo o provedor Equiplano passaria ter o enumerador: proEquiplano_100p.

Note que se tratando de provedor que possui um layout próprio tem no final do seu nome a letra "P" em minúscula que significa Próprio.

Já os provedores que seguem a ABRASF passariam a ter no final do seu nome a letra "A" em minúscula que significa ABRASF.

 

O que vai ocorrer com as aplicações caso venhamos a tomar essa medida:

As aplicações que usam os enumeradores como tomada de decisão vai ocorrer quebra de código, consequentemente seja necessário fazer o ajuste necessário para voltar a compilar.

Por exemplo:

If Provedor = proGinfes then

Ocorreria erro de compilação uma vez que o enumerador foi alterado.

Correção:

If Provedor = proGinfes_100a then

 

Quero deixar claro que essa alteração não foi feita, estou apenas compartilhando com vocês a minha intensão de realizar essa padronização na nomenclatura dos enumeradores dos provedores.

Quero a opinião de vocês.

se quiser podemos conversar após a reunião de hoje.

mas acho que poderia ter apenas o enumerador de provedor, e um sub de controle de versão do DFe. viso que um provedor pode ter os 3 casos versão 1 e 2 e próprio por exemplo, ai teria 3 enumerados de provedor;

 

[Italo Giurizzato Junior]

Bom dia a todos,

Em vez de criar um enumerador para cada versão do layout pelo provedor como eu estava idealizando, depois de uma reunião e alguns testes resolvemos trabalhar com dois enumeradores, um fazendo referencia ao provedor e outro a versão do layout.

Como é no arquivo ACBrNFSeXServicos.ini que informamos qual é o provedor que atende uma terminada cidade, é nesse mesmo arquivo que vai constar a versão do layout utilizado.

Como esta hoje:

[3131307]
Nome=Ipatinga
UF=MG
Provedor=Actcon_202

Como vai ficar:

[3131307]
Nome=Ipatinga
UF=MG
Provedor=Actcon
Versao=2.02

Esse é um exemplo.

Caso não seja informado o campo Versao o componente vai assumir a versão 1.00

Para deixar a versão somente com dígitos a minha proposta é definir as seguintes faixas de versões.

De 1.00 até 1.99 serão utilizados para definir a versão dos provedores que seguem a versão 1.xx do layout da ABRASF.

De 2.00 até 2.99 serão utilizados para definir a versão dos provedores que seguem a versão 2.xx do layout da ABRASF.

De 9.00 até 9.99 serão utilizados para definir a versão do layout de um provedor que tem o seu layout próprio.