Manual de Instalação - primaverabss.com · Windows XP SP2 Windows Vista 32/64 bit Windows 7 32/64 bit Recomendado ... Será necessário instalar o Microsoft SQL Server Compact 3.5

Manual de Instalação PRIMAVERA MOBILE BUSINESS V3.0

Versão 1.0.2

Setembro 2010

Pg 2

Índice Índice ................................................................................................................................. 2

Introdução ......................................................................................................................... 4

Instalação .......................................................................................................................... 5

Servidor ...........................................................................................................................5

Pré-Requisitos ................................................................................................................. 5

Configuração do IIS 7 ......................................................................................................7

Bases de dados ................................................................................................................9

Anexar bases de dados ..................................................................................................... 9

Manutenção das bases de dados ........................................................................................ 9

BackOffice e WebServices ................................................................................................9

Instalação ....................................................................................................................... 9

Pastas temporárias ........................................................................................................... 9

Aplicação para importação de dados .............................................................................. 10

m2uDataInterface .......................................................................................................... 10

Aplicação para integração de dados ............................................................................... 10

Versões do PRIMAVERA ................................................................................................... 10

Instalação ..................................................................................................................... 10

Aplicação para impressão automática de documentos .................................................... 10

m2uImpressao .............................................................................................................. 10

Página para instalação remota de PDAs ......................................................................... 10

InstallPDA ..................................................................................................................... 10

PDA ............................................................................................................................... 11

Requisitos de hardware e Sistema Operativo ...................................................................... 11

Considerações sobre os ecrãs .......................................................................................... 11

Leitura óptica ................................................................................................................ 12

Impressão .................................................................................................................... 12

Pré-Requisitos software para a instalação .......................................................................... 13

Troubleshooting............................................................................................................. 14

Configuração Inicial.......................................................................................................... 15

Licenciamento ............................................................................................................... 15

Back-office e WebServices ............................................................................................. 15

SQL Server ..................................................................................................................... 22

Aplicação para importação de dados .............................................................................. 34

Parâmetros gerais relativos à aplicação (m2uDataInterface.exe.Config) ................................. 34

Ficheiro XML de ligação ao ERP PRIMAVERA ....................................................................... 34

Pg 3

Tabelas de origem com chaves compostas ......................................................................... 37

Tabelas destino que recebem mais de uma tabela de origem ................................................ 38

Criação do atalho ........................................................................................................... 39

Logs gerados ................................................................................................................. 40

Aplicação para integração de dados ............................................................................... 41

Parâmetros gerais relativos à aplicação (m2uIntegracaoPrimavera7xx.exe.Config) .................. 41

Ficheiro XML de ligação ao ERP PRIMAVERA ....................................................................... 43

Criação do atalho ........................................................................................................... 47

Logs gerados ................................................................................................................. 47

Aplicação para impressão automática de documentos .................................................... 48

Configuração de agendamentos ..................................................................................... 48

Configuração para os equipamentos............................................................................... 49

Parametrização ................................................................................................................ 58

Parâmetros Gerais ......................................................................................................... 59

Parâmetros de documentos ........................................................................................... 60

Funcionalidades ............................................................................................................. 63

Ecovalor ....................................................................................................................... 64

Gestão de Caixa ............................................................................................................ 65

Rotas ............................................................................................................................. 68

Rotas semanais ............................................................................................................. 69

Parametrização de contas correntes suplementares ............................................................. 71

Controlo de emissão de documentos ................................................................................. 72

Auto-Venda ................................................................................................................... 73

Cargas & Descargas ....................................................................................................... 73

Tratamento de Lotes ...................................................................................................... 75

Devoluções de produtos .................................................................................................. 76

Regras e Descontos Comerciais ...................................................................................... 77

Descontos Unitários ........................................................................................................ 77

Descontos a partir de lista ............................................................................................... 77

Identificação de clientes nos documentos ...................................................................... 78

Aceder mais de uma base de dados numa instalação num PDA ....................................... 79

Funcionalidade Caixa/peças/kg ..................................................................................... 80

Impressão ..................................................................................................................... 81

Documentos com cabeçalhos com dados diferentes ............................................................. 81

Impressão de informação suplementar por linha de documento ............................................ 82

Impressão de logotipos nos documentos ........................................................................... 83

Extender o Relatório de Visita com informação suplementar .......................................... 84

Pg 4

Introdução

Neste manual são apresentadas informações técnicas relativas ao produto PRIMAVERA Mobile Business

(PMB), nomeadamente requisitos de Software/Hardware, configurações, entre outros.

PKB

Na PRIMAVERA KnowledgeBase, na categoria “PRIMAVERA Mobile Business”, pode ser consultada em qualquer

momento a última versão do manual

http://www.primaverabss.com/pkb/PortalRender.aspx?PageID=e42fbca7-fea6-4a84-a9c2-9a346bdd7433&KBCategoryID=93a0acce-17f5-11df-b45c-00155d060881

Pg 5

Instalação

Servidor

A instalação da solução compreende uma série de componentes que exigem que a máquina onde serão instalados obedeça a uma série de requisitos. O exemplo aqui apresentado é para o caso onde o SQL Server da solução e o IIS são instalados na mesma máquina, sendo no entanto possível tê-los em máquinas diferentes.

Pré-Requisitos

O computador que for designado para hospedar as ferramentas e bases de dados da solução deve ter as

caracterísitcas-base em termos de CPU, memória e disco para servir de modo satisfatório o sistema

operativo, IIS e SQL Server instalados.

Sistema Operativo

Pequenas instalações (até 3 PDA)

Windows XP SP2

Windows Vista 32/64 bit

Windows 7 32/64 bit

Recomendado

Windows Server 2003 32/64 bit

Windows Server 2008 32/64 bit

Componentes do Sistema Operativo

É exigido que o IIS esteja instalado, com suporte a aplicações ASP.net, bem como a .NET Framework 3.5 ou

posterior.

Software Adicional

Motor de base de dados

A máquina designada como servidor terá de ter instalado o SQL Server 2005 ou posterior, seja em versão

32, seja 64 bit, em edição Workgroup, Standard ou Enterprise.

As edições Express não são suportadas actualmente.

Pg 6

Ferramentas para publicação da replicação no IIS

Será necessário instalar o Microsoft SQL Server Compact 3.5 Service Pack 1 Server Tools que está

disponível em duas edições, 32 bit e 64 bit, na máquina onde residir o IIS. A instalação é linear caso o

servidor cumpra os requisitos, bastando ir clicando no botão Next. No ecrã de selecção da versão do SQL

Server com a qual queremos sincronizar, se estiverem disponíveis as versões 2005 e 2008, assegurar-se

que selecciona a versão onde colocará a base de dados da solução:

Sincronização Local

Caso se pretenda ligar os PDA ao servidor para efeitos de sincronização local, terá de ser instalado o

Windows Mobile Device Center ou o ActiveSync 4.5, consoante o sistema operativo seja Windows

7/Vista/2008 ou seja o Windows XP/2003. A mesma ferramenta terá de ser instalada nos computadores a

partir dos quais se pretenda poder ligar o PDA para sincronizar localmente.

Rede

Para que os PDA possam sincronizar remotamente, é necessário preparar a infraestrutura (router, ISA, ...)

para encaminhar os pedidos do exterior numa determinada porta TCP/IP para a porta em que o back-office e

os web services sejam publicados no IIS.

Rede Wifi

Caso a empresa disponha de infraestrutura wifi e os PDA tenham essa opção, poder-se-á usar a rede wifi da

empresa para os PDA sincronizarem.

Considerações Adicionais

É recomendável que este computador não seja desligado à noite, de modo a que o SQL Server possa correr

uma série de processos agendados para esse período de menor actividade.

Pg 7

Configuração do IIS 7

Exemplo para Windows Server 2008 R2 em Inglês:

1. Adicionar o 'role' a partir do Server Manager:

2. Escolher da lista as opções Application Server e Web Server (IIS), validando os diálogos de confirmção exibidos:

Pg 8

3. Clicar em Seguinte/Next até aparecer o seguinte ecrã e assegurar que as opções .NET Compact Framework 3.5.1 e Web Server (IIS) Support estão seleccionadas, confirmando as acções nos diálogos que surjam:

4. Clicar em Seguinte/Next até aparecer o seguinte ecrã e assegurar que o nó IIS 6 Management

Compatibility e respectivas sub-opções estão seleccionadas

5. Clicar em Seguinte/Next até ao último passo do assistente e finalmente no botão Instalar/Install

Pg 9

Bases de dados

Anexar bases de dados

O PRIMAVERA Mobile Business exige uma base de dados para operar, a qual deverá ser copiada para a

localização pretendida no Servidor, que tanto poderá ser na pasta pré-definida da instância do SQL Server

como noutra, num disco que tenha espaço livre. Depois de copiada a base de dados, deverá ser feito o

ATTACH à instância do SQL Server, podendo a base de dados ter o nome que entedermos, sendo sugerido

o nome m2uSalesXXX, em que XXX é uma abreviatura para o nome do cliente.

Manutenção das bases de dados

É importante definir um plano de manutenção para a base de dados que preveja o backup dos dados e do Transaction Log, bem como o SHRINK aos ficheiros MDF e LDF, dado principalmente este último ser propenso a crescer.

BackOffice e WebServices

Instalação

Instalado o IIS (ver Pré-requisitos) é necessário instalar o back-office m2uMobileSalesV3BO, bem como os web-services (WCF) m2uDeviceConfigManager e m2uMobileSalesService. Para tal, basta executar os respectivos Setup.exe, e quando interrogados sobre a application pool e nome da pasta virtual a criar, alterar a informação se necessário. Sugere-se que as pastas virtuais sejam publicadas com autenticação anónima para facilitar as comunicações a partir dos PDA, dado que os mesmo não têm uma autenticação Windows associada. Após a 1ª instalação de cada uma das aplicações, o ficheiro de configuração web.setup.config deverá ser renomeado para web.config antes de passar à sua configuração. Nas reinstalações das aplicações, o ficheiro volta a ser criado com o nome “web.setup.config” para evitar sobrescrever o “web.config” já configurado, sendo boa prática copiar do ficheiro web.config as informações personalizadas para o “web.setup.config”, salvaguardando uma cópia do “web.config” e renomeando o web.setup.config para web.config. Uma ferramenta de comparação de ficheiros texto, como o WinMerge, pode ser útil para o efeito.

Pastas temporárias

Para alguns processos, como a geração de reports, é necessário que as aplicações a correr sobre o IIS criem ficheiros temporários, pelo que será necessário criar uma pasta para esse efeito, na qual o utilizador anónimo do IIS (IUSR) deverá ter direitos de escrita.

Pg 10

Aplicação para importação de dados

m2uDataInterface

Esta aplicação permite que a base de dados da solução seja mantida actualizada com as alterações ocorridas na base de dados do sistema de gestão. A sua instalação requer apenas que seja copiada para uma pasta no servidor

Aplicação para integração de dados

Versões do PRIMAVERA

Consoante a versão do ERP PRIMAVERA instalada, terá de ser instalada a versão correspondente da ferramenta de integração:

PRIMAVERA V7 - m2uIntegracaoPrimavera7

PRIMAVERA V7.50 - m2uIntegracaoPrimavera750

PRIMAVERA V7.55 - m2uIntegracaoPrimavera755

Instalação

A instalação desta ferramenta apenas exige a cópia da pasta respectiva para o servidor do cliente ou outra máquina onde esteja instalado o Primavera

Aplicação para impressão automática de documentos

m2uImpressao

Esta aplicação, de instalação opcional, permite que a impressão de determinados tipos de documento em determinado estado sejam impressos automaticamente numa impressora instalada no mesmo PC onde correrá, ou disponível na rede. A sua isntalação apenas requer que a pasta respectiva seja copiada para um PC que consiga contactar o SQL Server e a impressora em causa.

Página para instalação remota de PDAs

InstallPDA

Esta é uma pasta com uma página HTML que permite que ao ser acedida por um PDA o mesmo possa

instalar os requisitos e a aplicação. Esta pasta pode ser colocada no servidor interno da empresa ou num

servidor público ao qual os PDA possam aceder, não tendo que ser hospedada no IIS.

Pg 11

É importante ir mantendo o CAB da aplicação PDA (na subpasta files) actualizado, de modo a que os

utilizadores ao acederem à pasta tenham a versão apropriada.

PDA

Requisitos de hardware e Sistema Operativo

Sistema operativo

Os sistemas operativos previstos são os seguintes:

Windows Mobile 5.0, 6, 6.1 e 6.5 Classic (equipamentos sem telefone) Windows Mobile 5.0, 6, 6.1 e 6.5 Professional (equipamentos com telefone) Não são suportados equipamentos com:

Pocket PC 2000 e Pocket PC 2002 Windows Mobile 2003 e Windows Mobile 2003 Second Edition Windows Mobile 5.0, 6, 6.1 e 6.5 Standard (equipamentos sem ecrã táctil) Windows CE (qualquer versão) Symbian Android iPhone

Características

Os equipamentos deverão ter como especificações recomendadas (mínimas entre parentesis):

Ecrã táctil 128MB RAM (64MB) 256MB ROM (128MB) 400Mhz CPU (200Mhz) Outras caracterísitcas a considerar:

Bluetooth para comunicação com impressoras Wifi para comunicações locais / hotspots públicos Cartão de memória externo para armazenar a base de dados

Considerações sobre os ecrãs

Tamanho

Na escolha do equipamento, muitas vezes é negligenciado o tamanho do ecrã (medido em polegadas na

diagonal), o que pode nalguns casos comprometer a correcta visualização da informação aí exibida por parte

de quem tenha menos acuidade visual. O tamanho de ecrã 'ideal' serão as 3.5" em equipamentos com

formato de ecrã 4:3, tamanho que tem vindo a caír em desuso, sendo hoje frequentes tamanhos abaixo das

3", nomeadamente 2.6" (ex. TMN Bluebelt) e 2.8" da maior parte dos equipamentos à venda com formato de

ecrã 4:3. No caso dos equipamentos com ecrã 'wide', as 3.8" do HTC Touch HD e 4.3" do HTC Touch HD2

permitem uma confortável utilização do equipamento.

Formato

Pg 12

A aplicação no PDA suporta ecrãs na posição retrato (portrait), paisagem (landscape) e quadrado,

suportando igualmente a rotação de ecrã com a aplicação em execução. Nos modos paisagem e quadrado, o

utilizador deverá utilizar o teclado físico do equipamento.

Leitura óptica

Actualmente para efeitos de identificação de artigos são suportados os seguintes modelos de PDA:

Symbol/Motorola

Bluebird Pideon

MobileCompia M3

Intermec

Socketcom (placas SD/CF com leitor óptico)

Para reconhecimento dos códigos lidos a aplicação controla directamente o leitor, não suportando a

emulação de teclado, que deverá ser desligada.

A leitura óptica terá de ser configurada, como detalhado aqui.

Impressão

As impressoras suportadas incluem as listadas nesta página, sendo desaconselhadas impressoras de

agulhas. A aplicação não prevê templates de impressão para todas elas, sendo necessário customizar os

layouts de impressão a partir dos layouts fornecidos.

As opções de comunicação mais frequentes são o infravermelhos e bluetooth, que terão de ser previstos

quer no PDA, quer na impressora, alertando-se para o facto da generalidade dos PDA de consumo já não

incluír comunicações por infravermelhos.

Pg 13

Pré-Requisitos software para a instalação

Os requisitos de software para a aplicação ser instalada e executada no PDA são os seguintes:

.NET Compact Framework 3.5

SQL Server Compact 3.5 SP1

SQL Server Compact 3.5 SP1 Replication

SQL Server Compact 3.5 SP1 Developer

Sempre que algum destes componentes não esteja já instalado no equipamento, terão de ser instalados

antes da aplicação.

Instalação dos requisitos

A instalação dos requisitos poderá ser feita a partir da página HTML se disponível, ou executando os seguintes ficheiros no PDA depois de os copiar para o mesmo ou a partir de um cartão de memória:

.NET Compact Framework 3.5 - NETCFv35.wm.armv4i.cab SQL Server Compact 3.5 SP1 - sqlce.ppc.wce5.armv4i.cab SQL Server Compact 3.5 SP1 Replication - sqlce.repl.ppc.wce5.armv4i.cab SQL Server Compact 3.5 SP1 Developer - sqlce.dev.ENU.ppc.wce5.armv4i.CAB Os componentes devem ser instalados na memória principal do dispositivo, e caso os respectivos CAB tenham sido copiados para o PDA, não esquecer de os eliminar.

Instalação da aplicação

A aplicação pode ser instalada a partir do link na página HTML se disponível, ou copiando o respectivo ficheiro CAB para o PDA ou um cartão de memória. Pode ainda enviar-se um SMS para os equipamentos com um link directo para o download do ficheiro CAB, que será automaticamente instalado no PDA. O ficheiro CAB da aplicação terá regra geral o nome m2uMobileSalesV3.cab, mas poderá nalgumas circunstâncias incluír o nome da build, como por ex. m2uMobileSalesV3.0.0.1.cab

Sugere-se que a aplicação seja sempre instalada na memória principal do equipamento em

detrimento do cartão de memória.

Pg 14

Troubleshooting

SQL Server

1. Ao instalar as Server Tools não é detectado o IIS Verificar na lista de componentes do Windows se o Internet Information Services (IIS) se encontra instalado e se os serviços associados se encontram iniciados. 2. Ao instalar as SQL Server Compact Server Tools não é detectado o SQL Server 2005/2008 Confirmar que se encontra instalado no servidor o SQL Server 2005 ou 2008 numa edição que não seja Express.

Pg 15

Configuração Inicial

Terminada a instalação dos diversos componentes é necessária uma configuração inicial, que permitirá que

os diversos componentes passem a comunicar entre si, não dispensando de todo a customização da solução

às necessiadades do cliente. Nos pontos seguintes encontrará informação sobre os componentes que

carecem dessa configuração inicial.

Licenciamento

Antes de passar à configuração inicial do Back-Office e WebServices deverá ter em sua posse o ficheiro .xml respeitante à instalação em curso, cujo nome é formado pelo nome do produto e nome da empresa a que se destina. É também necessário ter à mão o nº da licença back-office, que também pode ser encontrado no 1º nó do ficheiro XML

Back-office e WebServices

Pg 16

WebService m2uDeviceConfigManager

Configuração via ficheiro web.config

NOTA: Para a edição dos ficheiros .Config e .Xml, sugere-se o Notepad++

Abrir o ficheiro web.config e...

- na secção appSettings, mudar o valor da chave AuthenticationPassword para outra senha, que será

configurada. A chave UserListSqlSelectInstruction deverá manter-se inalterada.

... <appSettings>

<add key="AuthenticationPassword" value="1234"/>

<add key ="UserListSqlSelectInstruction" value ="SELECT CHECKSUM(vend_Nr), vend_Nome + ' (' + vend_Nr + ')'

FROM Vendedores ORDER BY vend_Nome"/>

</appSettings>

...

- na secção connectionstring criar ou actualizar a informação aí constante, substituíndo as informações

abaixo realçadas pelos valores apropriados, em que '201090001' corresponde ao nº de série da licença back-

office e os restantes valores à identificação da instância onde se encontra a base de dados, nome da base

de dados e autenticação.

Caso o mesmo servidor contemple diferentes bases de dados pode criar-se uma connection string para cada

licença, duplicando o nó "<add ... />". ...

<connectionStrings>

<add name="201090001" connectionString="Data Source=servidor\instancia;Initial Catalog=m2uSalesPRI; persist

security info=True;User=utilizador;Password=senha" providerName="System.Data.SqlClient"/>



</connectionStrings>

<system.web>

...

Pg 17

WebService m2uMobileSalesService

Configuração via ficheiro web.config


- na secção connectionstring criar ou actualizar a informação aí constante, seguindo as mesmas instruções

do ponto anterior: ...

<connectionStrings>






<system.web>

...

Back-office m2uMobileSalesV3Bo

Configuração inicial via web.config


- na secção appSettings, editar as keys necessárias de acordo com os comentários que as precedem: ...

<appSettings>



<add key="m2uDeviceConfigManagerPassword" value="1234"/>



<add key="BindingConfigurationName" value="BasicHttpWindowsBinding_IConfiguration"/>



<add key="LogReplicacao" value=""C:\Program Files\Microsoft SQL Server Compact

Edition\v3.5\sync\SQL\m2uRepl\SQLCESALOG.TXT""/>



<add key="LocalizacaoExportacaoExcel" value="C:\Temp\SalesBO\"/>



<add key="TempDir" value="C:\Temp\SalesBO\"/>



<add key="TiposDocSituacaoValidar" value="1,2"/>



<add key="DocCamposNrErroIntegracao" value="7"/>



<add key="TipoEncomenda" value="1"/>



<add key="ImprimirResumoDocumentosValidacao" value="0"/>

Pg 18

<add key="PermitirExportacaoExcel" value="0"/>

<add key="ModeloCaixaIta" value="0"/>

<add key="RecibosPAN" value="0"/>

</appSettings>

...

- na secção connectionstring criar ou actualizar a informação que aí se encontra, seguindo as mesmas

instruções do ponto anterior:

...

<connectionStrings>

<add name="connString" connectionString="server=servidor\instancia;database=m2uSalesPRI;User

ID=utilizador;Password=senha"/>


...

- no final do documento, procurar a secção client e corrigir os endereços para aquele em que o serviço

m2uDeviceConfigManager está a correr. Se estiver a correr na mesma máquina, deixar o localhost:

... <client>

<endpoint address="http://localhost/m2uDeviceConfigManager/Configuration.svc"

binding="basicHttpBinding" bindingConfiguration="BasicHttpWindowsBinding_IConfiguration"

contract="WcfReferences.Configuration.IConfiguration" name="BasicHttpWindowsBinding_IConfiguration" />

<endpoint address="http://localhost/m2uDeviceConfigManager/Configuration.svc/compressed"

binding="customBinding" bindingConfiguration="gzipCustomBinding_IConfiguration"

contract="WcfReferences.Configuration.IConfiguration" name="gzipCustomBinding_IConfiguration" />

</client>

...

Pg 19

Criação de grupos de utilizadores, utilizadores e acessos

Os utilizadores do back-office encontram-se agrupados em Grupos de Utilizadores, tendo cada utilizador de

pertence a um e apenas um grupo. Todos os utilizadores de um grupo partilham os mesmos acessos em

termos de back-office.

Grupos de Utilizadores

Depois de fazer login no back-office, clicar na opção "Gestão de Grupos de Utilizadores" que é exibida ao

manter o cursos sobre a opção Administração. Caso a opção não surja, fazer login com utilizador com os

direitos apropriados.

No ecrã de gestão de grupos de utilizadores pode criar novos grupos ou editar o nome dos grupos actuais:

Gestão de Utilizadores

A partir do menu Administração, escolher a opção Gestão de Utilizadores. Caso a opção não surja, fazer

login com utilizador com os direitos apropriados.

Pg 20

No ecrã de gestão de utilizadores pode criar, editar e eliminar utilizadores:

Para cada utilizador pode definir um nome, um login, o respectivo grupo de utilizador, modificar a password,

associar uma abreviatura e definir se está ou não activo. Pode ainda restringir a informação dos vendedores

a que têm acesso indicando os respectivos códigos, separados por vírgula e cada código entre plicas, no

mesmo formato que se utiliza no operador IN do SQL, mas sem os parentesis. Caso deixe essa caixa de

texto vazia, o utilizador pode visualizar a informação de todos os vendedores (predefinição). A password é

editada numa janela popup.

Gestão de Acessos

Ao escolher a opção Gestão de Acessos no menu Administração, são exibidos os grupos de utilizadores

criados:

Pg 21

Clicando sobre o nome de um grupo, obtem as àreas de acesso parametrizáveis:

Clique sobre a check-box de uma àrea para conceder ou retirar o acesso à mesma ao grupo seleccionado.

Importação do ficheiro de Licença

Fazer login no back-office com um utilizador que tenha acesso à àrea Licenciamento (na opção do Menu

“Administração m2u”) de modo a poder escolhê-la. No ecrã do licenciamento, clicar no botão Browse para

procurar o ficheiro XML de licença e de seguida clicar no botão Importar para transferir a licença para a base

de dados:

Pg 22

SQL Server

A sincronização da informação da solução de mobilidade assenta no SQL Server Merge Replication sobre

IIS, que dando algum trabalho a configurar, permite uma eficência e fiabilidade que o tornam a melhor opção

para aplicações deste tipo.

Sem a pretensão de apresentar definições exaustivas, importa reter os seguintes conceitos:

Distributor: é a instância de SQL Server responsável pela gestão dos diversos componentes do Merge

Replication. Tipicamente é a mesma instância do Publisher.

Publisher: é a instância SQL Server onde se encontra a base de dados a ser publicada

Publication/Publicação: é a forma sob a qual uma dada base de dados é publicada ou exposta pela

tecnologia Merge Replication. A uma publicação estão associadas um conjunto de tabelas e definições, que

permitem filtrar alguma da informação a ser publicada e regras a implementar

Subscriber/Subscritor: no nosso caso é o PDA que vai sincronizar com a publicação

Subscription/Subscrição: é o conjunto de dados que o subscritor mantem sincronizados com o servidor.

Sempre que se 'despublica' uma publicação, toda a informação presente nas subscrições que não tenha sido

ainda sincronizada encontra-se perdida definitivamente.

Download de informação: é o sentido da transferência de informação do servidor para o subscritor

Upload de informação: é o sentido da transferência de informação do subscritor para o servidor

Primeira Subscrição ou Reinicialização da Subscrição: é o conjunto total de informação obtida pelo

subscritor sempre que cria ou reinicializa uma subscrição, sendo uma operação unidireccional de download

de informação

Sincronização: é o processo em que o subscritor contacta o servidor no sentido de proceder à troca de

informações. A ordem pela qual a sincronização se processa é:

1. Upload de informação criada/alterada/apagada no subscritor para o servidor

2. Download de informação criada/alterada/apagada no servidor para o subscritor

Pg 23

Configurar replicação

Para poder publicar bases de dados no SQL Server é necessário previamente tê-lo configurado de modo a

permitir essa funcionalidade. As instruções aqui descritas reflectem o nível de configuração mais elementar,

pelo que é passível de ser melhorado em termos de segurança e performance.

1. Criação da pasta para o snapshot

Criar uma pasta no servidor do SQL Server, com o nome Snapshot, partilhá-la, e configurar a Partilha e a

Segurança da pasta de modo a que o utilizador anónimo associado ao IIS (IUSR_nomedoservidor ou apenas

IUSR, consoante a versão do IIS) a ela tenha acesso em termos de leitura e escrita. Se utilizar o assistente

de parilha, definir o utilizador referido atrás como Contributor.

2. Configuração do SQL Server

Abrir a instância do SQL Server do Publisher com o SQL Server Management Studio (SSMS) e com o botão

direito do rato sobre o nó Replication abaixo da instância e escolher Configure Distribution:

Pg 24

No assistente de configuração do Distributor, avançar para o 2º ecrã com Next e assegurar-se que a primeira

opção se encontra sleccionada:

Clicar em Next e no ecrã seguinte digitar o caminho para a pasta do snapshot criada no ponto anterior na

forma \\nomedoservidor\nomedapasta.

Nos 2 ecrãs seguintes validar a informação e clicar em Next:

Pg 25

Neste ecrã pode seleccionar criar um script com os passos necessários para configurar a distribuição, o que não é exigido:

Pg 26

No último ecrã do assistente, escolher a opção Finish para configurar a distribuição:

Se o assistente for terminado com sucesso, terá o SQL Server configurado para o Merge Replication.

Pg 27

Personalização A criação da publicação para a base de dados da solução encontra-se automatizada sob a forma de uma Stored Procedure, mas antes de a correr é necessário configurar algumas extended properties. Para tal, no SSMS clique com o botão direito do rato sobre a base de dados da solução e escolha Properties, e na janela de propriedades escolha Extended Properties:

Se não surgirem as 4 extended properties que vemos na imagem de exemplo, é necessário criá-las executando o seguinte script sobre a base de dados da solução, neste caso chamada m2uSalesPRI: USE [m2uSalesPRI]; EXEC sp_addextendedproperty @name=N'm2u.Commom.RetentionPeriod', @value=N'14' ; EXEC sp_addextendedproperty @name=N'm2u.Common.PublicationName', @value=N'm2uSalesRepl' ; EXEC sp_addextendedproperty @name=N'm2u.Common.ServerAgentPassword', @value=N'sa???' ; EXEC sp_addextendedproperty @name=N'm2u.Common.ServerAgentUser', @value=N'sa' ;

Depois de as criar, voltar à janela das propriedades e editar as extended properties, definindo um utilizador SQL existente na propriedade ServerAgentUser e a respectiva password na propriedade ServerAgentPassword. Não é recomendável usar o utilizador sa, pelo que se sugere a criação de um utilizador específico para o efeito, com direitos de leitura e escrita sobre a base de dados.

Pg 28

Criação da publicação A criação da publicação restringe-se a executar a stored procedure m2uActivaReplicacao sobre a base de dados da solução: USE m2uSalesPRI; EXEC m2uActivaReplicacao;

A publicação é criada em segundos, mas a criação do primeiro snapshot pode durar minutos, durante os quais os subscritores ainda não poderão sincronizar. Para acompanhar o progresso da criação do snapshot, ir na àrvores do SSMS ao nó Replication abaixo do nome da instância, abrir o nó Local Publications e com o botão direito do rato sobre a publicação da nossa base de dados (formato [nomedabasededados]: nomedapublicacao ) e escolher a opção View Snapshot Agent Status:

Quando a criação do snapshot tiver sido concluída, o respectivo estado encontrar-se-á nos 100%, como no exemplo abaixo (o nº de artigos publicados pode variar):

Pg 29

Configuração das Server Tools

1. No menu Iniciar do servidor, escolher da lista de Programas > Microsoft SQL Server Compact 3.5 > Configure Web Synchronization Wizard. No 2º ecrã assegurar-se que selecciona a opção SQL Server Compact:

2. No passo seguinte, clicar na opção Create a New Virtual Directory e depois expandir a àrvore com os websites configurados no IIS e escolher o apropriado:

Pg 30

3. No passo seguinte, dar um nome à pasta virtual a criar no IIS e onde deve ser criada no disco. Sugerimos sqlrepl e que escolha um caminho abaixo do C:\inetpub\wwwroot:

4. Depois de carregar em Next, o instalador pedirá confirmação para criar a pasta e copiar os componentes necessários para a mesma, devendo validar ambas as acções afirmativamente. No passo seguinte, caso não sejam detectados certificados no servidor a única opção será a de não usar SSL:

Pg 31

5. Neste modelo de instalação simplificado optaremos por escolher a autenticação pelo utilizador anónimo do IIS:

6. Em seguida, confirmar ou alterar a identidade do utilizador anónimo do IIS, assegurando-se que selecciona a checkbox:

Pg 32

7. No passo seguinte, digitar o caminho para a pasta partilhada criada no 1º ponto 'Configurar Replicação' no início deste documento:

8. A partir daqui, clicar em Next até ao fim do Assistente e no último passo em Finish para desencadear a configuração da pasta virtual.

9. No Windows 7 e Windows Server 2008 R2 é preciso um passo suplementar. Clicar Iniciar/Start > Administrative Tools > Internet Information Services (IIS) Manager, abrir o nó correspondente ao nosso servidor, clicar em Application Pools, depois com o botão da direita sobre DefaultAppPool e Advanced Settings. No diálogo exibido, no grupo Process Model, na propriedade Identity, mudar o valor ApplicationPoolIdentity para NetworkSevice:

Pg 33

Confirmar a alteração e de novo sobre a DefaultAppPool, com o botão direito do rato escolher Recycle.

Testes Ligação local Para verificar que o SQL Server Compact 3.5 Server Tools configurou correctamente a pasta virtual através de onde será exposta a publicação, digitar num browser no servidor o seguinte caminho: http://localhost/sqlrepl/sqlcesa35.dll em que sqlrepl corresponde ao nome da pasta virtual definido no passo 3 do ponto “Configuração da Server Tools” (secção anterior). O resultado deverá ser o seguinte:

Pg 34

Aplicação para importação de dados

Parâmetros gerais relativos à aplicação (m2uDataInterface.exe.Config)

Editar o ficheiro m2uDataInterface.exe.config seguindo as instruções nele presentes sob a forma de comentários: <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings>  <add key="MailFrom" value=""/>  <add key="MailToOk" value=""/>  <add key="MailToErro" value=""/>  <add key="SMTPserver" value=""/>  <add key="SMTPuser" value=""/>  <add key="SMTPpwd" value=""/> </appSettings> <system.diagnostics> <switches>  <add name="ControloErros" value="1"/>  <add name="FluxoImportacao" value="4"/> <add name="FluxoExportacao" value="4"/> </switches> </system.diagnostics> </configuration>

(Para a edição dos ficheiros .Config e .Xml, sugere-se o Notepad++ )

Ficheiro XML de ligação ao ERP PRIMAVERA

A aplicação m2uDataInterface depende da presença de um ficheiro XML que indique a informação a importar da base de dados do sistema de gestão e os respectivos mapeamentos com a base de dados da solução. No topo do ficheiro encontramos a connection string para ligação à base de dados do m2uMobileSales, que deve ser ajustada às definições do servidor: <?xml version="1.0" encoding="utf-8" ?> <m2uSalesInterface> <m2uSalesDB connectionstring="Password=1234;Persist Security Info=True;User ID=sa;Initial Catalog=m2uSalesPRI;Data Source=SERVIDOR" /> <importacao> <origem tipo="sqlserver" auxiliar="Password=1234;Persist Security Info=True;User ID=sa;Initial Catalog=PriDemoM2U;Data Source=SERVIDOR"> ...

Pg 35

Abaixo do nó <importacao>, temos as origens de dados, tipicamente apenas uma, mas com a possibilidade de recolher informação de diferentes origens. Para cada <origem... é necessário indicar o tipo de origem (Odbc, OleDB, SQLServer, Firebird ou Oracle) e a respeciva connection string de acordo com o providers ADO.net em causa: ... <importacao> <origem tipo="sqlserver" auxiliar="Password=1234;Persist Security Info=True;User ID=sa;Initial Catalog=PriDemoM2U;Data Source=SERVIDOR"> <tabela descr="Taxas de IVA" sqlOrigem="SELECT IVA AS qCod, Descricao AS qDescr, Taxa AS qTaxa FROM IVA WHERE (IVA IS NOT NULL)" ...

Abaixo do nó da “<origem...”, encontramos a lista de elementos do tipo “<tabela...” a tratar. Apesar do nome tabela podemos ter como origem instruções SQL que aglomerem mais de uma tabela na origem. Cada um dos elementos <tabela... encontra-se organizado da seguinte forma: ... <tabela descr="Taxas de IVA" sqlOrigem="SELECT IVA, Descricao, Taxa FROM IVA WHERE (IVA IS NOT NULL)" destino="TiposDocTxIva" filtrodestino=""> <campos> <campo tipo="id" ordemselect="1" destino="docTxIVA_Cod" origem="IVA" tipodadosDest="NVarChar" tipodados="str" oper="" /> <campo tipo="importar" ordemselect="1" destino="docTxIVA_Cod" origem="IVA" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="2" destino="docTxIVA_Design" origem="Descricao" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="3" destino="docTxIVA_Taxa" origem="Taxa" tipodados="real" tipodadosDest="Decimal" oper="" /> </campos> </tabela> ...

No nó “<tabela…” temos... descr="... - descrição para o conjunto de dados representado, útil para efeitos de logging. Esta descrição não pode surgir duplicada no mesmo XML, sob risco de criar inconsistências na informação importada sqlOrigem="... - instrução SQL que permite recuperar a informação da origem. Ainda que a origem seja uma VIEW, sugere-se que seja usada sempre uma instrução do tipo SELECT ... para melhor controlo da ordem pela qual os campos se apresentam destino="... - nome da tabela na base de dados destino que receberá a informação filtrodestino="... - no caso das tabelas no destino que permitem ter dados de tabelas-origem diferentes, uma cláusula idêntica às usadas no WHERE que permita filtrar inequivocamente apenas os dados desta origem de dados

Pg 36

Abaixo do nó da “<tabela...”, temos a caracterização da chave única desta origem de dados e o mapeamento entre os campos que resultam da instrução SQL em elementos do tipo <campo.... Assim temos necessariamente sempre um elemento <campo tipo="id"... (o tipo é case sensitive) , em que ordemselect indica qual a respectiva ordem no output da intrução SQL (ao 1º elemento corresponde o nº 1), no atributo destino temos o nome do campo no destino que irá ser comparado com a coluna indicada da origem para change tracking e no atributo origem o nome da coluna origem. Neste exemplo, indicamos que a chave desta origem é a 1ª coluna do resultado do SELECT, ou seja a coluna IVA, que deverá ser comparada com o campo docTxIva_Cod no destino para detecção de alterações. Em seguida, temos outros elementos <campo... responsáveis pelo mapeamento entre a informação resultante da instrução SELECT e a tabela destino. O atributo destes elementos pode ter um dos seguintes valores: tipo="importar" - neste caso a informação é recuperada do SELECT da origem, correspondendo ao

atributo ordemselect a respectiva ordem no SELECT e podendo o atributo origem ser ou não preenchido. Sugere-se que seja preenchido para ajudar a perceber qual a informação em causa, mas a informação deste atributo neste tipo de campo é ignorada

tipo="fixo" - neste caso a informação não é recuperada do SELECT da origem, utilizando-se o valor do

atributo origem para o preenchimento deste campo no destino. Nestes casos, o atributo ordemselect é ignorado

NOTA: Em qualquer um destes dois tipos de campo, o atributo destino designa o nome do campo no destino que receberá essa informação.

Para todos os tipo de campo, importa referir: atributo tipodados deve conter um dos seguintes valores em função do tipo de dados da informação na

origem:

tipodados="bool" -> dados do tipo lógico

tipodados="date" -> dados do tipo data

tipodados="str" -> dados do tipo texto

tipodados="real" -> dados do tipo decimal

tipodados="int" -> dados do tipo inteiro atributo tipodadosDest deve conter o tipo de dados SQL Server de acordo com o campo no destino.

Esta informação é case sensitive. atributo oper deve ser deixado vazio.

Importante! Os campos indicados no elemento <campo tipo="id"... também têm de constar nos elemntos de tipo="importar" para poderem ser importados.Pegando neste exemplo, o campo IVA que é comparado com o campo docTxIva_Cod no <campo tipo="id" tem de constar forçosamente na lista de campos a importar, <campo tipo="importar".

Pg 37

Tabelas de origem com chaves compostas

Cada registo devolvido pela instrução SELECT tem de ter uma coluna cujo output seja único entre os registos devolvidos por esse SELECT. No exemplo acima das Taxas de IVA, a coluna IVA satisfaz essa condição, mas caso a chave única tenha de ser composta por diferentes campos de origem, teremos de os concatenar, com um separador pelo meio. Supondo uma tabela orgiem para recuperar a lista de preços com a seguinte instrução...

SELECT artigo, tipopreco, preco FROM ArtigosListaPrecos

...nenhum dos campos é 'único' entre os resulatdos que produz, pois um artigo pode ter múltiplos tipos de preço e um tipo de preço pode ser usado por múltiplos artigos, pelo que temos necessidade de criar uma chave composta a partir do artigo e do tipo de preço:

SELECT artigo, tipopreco, preco, artigo + '.' + tipopreco AS meuID FROM ArtigosListaPrecos

ou caso o campo tipopreco fosse do tipo inteiro:

SELECT artigo, tipopreco, preco, artigo + '.' + CAST(tipopreco AS NVarchar) AS meuID FROM ArtigosListaPrecos

Em qualquer uma destas duas instruções SELECT, adicionámos uma nova coluna que dinamicamente cria uma chave que sabemos ser única entre os resultados que produz. Para poder tratá-la no nosso XML teríamos uma secção similar a : <tabela descr="Artigos - Preços" sqlOrigem="SELECT artigo, tipopreco, preco, artigo + '.' + tipopreco AS meuID FROM ArtigosListaPrecos" destino="ProdutosListaPrecos" filtrodestino=""> <campos> <campo tipo="id" ordemselect="4" destino="prodlPrc_CodProduto + '.' + prodlPrc_idTipoPreco" origem="meuID" tipodadosDest"NVarChar" tipodados="str" oper="" /> <campo tipo="importar" ordemselect="1" destino="prodlPrc_CodProduto" origem="artigo" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="2" destino="prodlPrc_idTipoPreco" origem="tipopreco" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="3" destino="prodlPrc_Preco" origem="preco" tipodados="real" tipodadosDest="Decimal" oper="" /> ...

Pg 38

Tabelas destino que recebem mais de uma tabela de origem

No caso das tabelas no destino que podem receber informação de mais de uma <tabela..., é preciso indicar qual o elemento comum entre os registos relacionados nessa tabela. Pegando como exemplo a tabela destino ProdutosClassificacoes que pode conter diferentes atributos dos artigos, como família, marca, cor, país de origem, ... para um exmplo em que queremos preenchher os atributos Família e Marca, respectivamente com os códigos de atributo 1 e 2: <tabela descr="Artigos - Famílias" sqlOrigem="SELECT artigo, Familia FROM Artigo" destino="ProdutosClassificacoes" filtrodestino="prodClass_idClass=1"> <campos> <campo tipo="id" ordemselect="1" destino="prodClass_codProduto" origem="artigo" tipodadosDest="NVarChar" tipodados="str" oper="" /> <campo tipo="fixo" ordemselect="0" destino="prodClass_idClass" origem="1" tipodados="int" tipodadosDest="TinyInt" oper="" /> <campo tipo="fixo" ordemselect="0" destino="prodClass_codValorPai" origem="" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="1" destino="prodClass_codProduto" origem="artigo" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="2" destino="prodClass_codValor" origem="familia" tipodados="str" tipodadosDest="NVarChar" oper="" /> </campos> </tabela> <tabela descr="Artigos - Marcas" sqlOrigem="SELECT artigo, Marca FROM Artigo" destino="ProdutosClassificacoes" filtrodestino="prodClass_idClass=2"> <campos> <campo tipo="id" ordemselect="1" destino="prodClass_codProduto" origem="artigo" tipodadosDest="NVarChar" tipodados="str" oper="" /> <campo tipo="fixo" ordemselect="0" destino="prodClass_idClass" origem="2" tipodados="int" tipodadosDest="TinyInt" oper="" /> <campo tipo="fixo" ordemselect="0" destino="prodClass_codValorPai" origem="" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="1" destino="prodClass_codProduto" origem="artigo" tipodados="str" tipodadosDest="NVarChar" oper="" /> <campo tipo="importar" ordemselect="2" destino="prodClass_codValor" origem="Marca" tipodados="str" tipodadosDest="NVarChar" oper="" /> </campos> </tabela>

Podemos observar que as duas diferentes origens têm como destino a mesma tabela, ProdutosClassificacoes. Para podermos distinguir para efeito de sincronismo com a origem cada uma dessas origens, temos de no elemento <tabela indicar o filtrodestino, que neste caso é filtrodestino="prodClass_idClass=1" ou "prodClass_idClass=2" consoante se trate de uma família ou de uma marca. Adicionalmente é preciso prever elementos <campo tipo="fixo" que preencham o campo em causa, neste caso prodClass_idClass, com o valor apropriado Outras considerações Caso numa instrução SELECT queiramos limitar os registos com uma cláusula WHERE e tenhamos e utilizar os caracteres < e/ou >, que têm significados especiais para o XML, teremos de usar a seguinte notação do HTML, < e > . O mesmo se aplicará a outros símbolos ou caracteres especiais que invalidem a estrutura do ficheiro. Um teste importante a fazer é, gravado o XML, tentar abri-lo num browser, como o Internet Explorer, que de imediato detectará se o XML estiver mal formado e indicará o nº da linha onde se encontra o problema.

Pg 39

Criação do atalho

O m2uDataInterface.exe não pode ser executado directamente pois requer que sejam passados alguns parâmetros para a sua execução Atalho para modo interactivo Este atalho apenas deverá ser utilizado para os testes iniciais, pois se o utilizador inadveridamente clica na opção irá forçar uma importação total da informação a partir da base de dados do sistema. m2uDataInterface.exe /def:caminhoparaficheiroXML /descr:descricaoparaficheirolog

Ao criar o atalho, substitua o caminhoparaficheiroXML pelo caminho completo para o ficheiro XML de definição de importação e em descricaoparaficheirolog coloque algo como "Empresa Fictícia - Importação". Ao executar o atalho, deverá obter o seguinte ecrã:

A opção Sincronização total deverá ser marcada a 1ª vez que corre a importação, ou sempre que queira forçar uma importação integral da informação definida no XML. Ter em conta que caso se marque esta opção depois de os PDA já terem informação, a sincronização seguinte dos PDA levará muito mais tempo e poderá originar erros de sincronização. Para desencadear a importação, clicar no botão Importar. O botão Exportar não tem utilidade neste contexto. Atalho para modo silencioso O modo silencioso corre sem requerer o input do utilizador, e é indicado para ser configurado para correr automaticamente: m2uDataInterface.exe /def:caminhoparaficheiroXML /descr:descricaoparaficheirolog /modo:SILENT /accao:IMPORT

Pg 40

Logs gerados

A cada execução da aplicação, quer em modo interactivo, quer silencioso, são criados 2 logs: um log geral na pasta do executável, com o nome m2uDataInterface.log, ao qual a cada execução vai

sendo adicionada a informação de log no seu final. Este log é útil quando não é criado o log detalhado e pode ser apagado periodicamente

um log mais detalhado, na subpasta Logs, com o nome do ficheiro XML que foi passado como

parâmetro seguido de um timestamp à hora que foi executado. Por ex., um log com o nome PriDemo-20100304123404.log corresponde a uma importação do ficheiro PriDemo.XML desencadeada no dia 4 de Março de 2010 às 12:34:04. Este log tem uma primeira parte onde pode indicar eventuais problemas na ligação às bases de dados, e depois, para cada secção do ficheiro XML executada, indica o nº de linhas criadas, actualizadas e apagadas, bem como informação sobre eventuais erros. No final, o log indica sempre se foi terminado com sucesso, se foi terminado mas com erros ou se foi interrompido pela gravidade dos erros. Estes logs não são apagados automaticamente e recomenda-se que periodicamente sejam apagados.

Caso o ficheiro m2uDataInterface.exe.config referido acima esteja devidamente configurado, a aplicação poderá enviar o log detalhado e o ficheiro XML para os mails designados quando ocorrem erros, de modo ao destinatário ser alertado para o facto de uma importação não ter sido feita com sucesso, e com os ficheiros anexos se tentar perceber a razão de tal acontecer. A notificação de importação com sucesso pode ser útil numa primeira fase para perceber se o processo está a correr de acordo com o agendamento respectivo.

Estrutura típica para uma base de dados Primavera Um mesmo ficheiro XML para importação de dados de uma base de dados Primavera pode servir de base para diferentes instalações, sobre o qual serão posteriormente feitas as customizações necessárias. O ficheiro base para Primavera tem implicitamente as seguintes secções: - informação de referência para produtos/clientes/documentos - informação sobre produtos - informação sobre clientes

Pg 41

Aplicação para integração de dados

A integração de dados é o processo pelo qual a informação recolhida no PDA, por ex., documentos, é integrada no ERP Primavera . A aplicação de integração de dados, à semelhança da aplicação de importação de dados, depende de um ficheiro XML que, neste caso, permite fazer mapeamentos entre as tabelas onde reside a informação a integrar na base de dados da solução, e os objectos expostos pelo sistema de gestão, de modo a prever a flexibilidade de necessidades diferentes de integração entre clientes, por ex. de lotes ou campos de utilizador. Na definição da aplicação de integração são limitados os estados em que podem estar os documentos a aguardar integração, bem como os estados em que devem ficar consoante sejam integrados com ou sem sucesso, bem como nalguns casos os campos onde deve ser guardada a mensagem de erro a uma integração sem sucesso ou o nº com que o documento tiver sido integrado com sucesso.

Parâmetros gerais relativos à aplicação (m2uIntegracaoPrimavera7xx.exe.Config)

Configuração da ligação ao Primavera Na pasta do executável, o ficheiro com o mesmo nome do executável mas com o sufixo .config permite a definição de alguns parâmetros da aplicação de integração: <?xml version="1.0"?> <configuration> © 2010 Alberto Silva - www.moving2u.pt - para a PrimaveraBSS 55 Configuração Inicial <appSettings>  <add key="priInstancia" value="default"/> <add key="priBaseDados" value=“Demo"/> <add key="priUsername" value="user1"/> <add key="priPassword" value=""/> <add key="priTipoPlataforma" value="0"/>  (...) </appSettings> A chave priInstancia regra geral deverá ter o valor acima apresentado, default, correspondendo à instância do Primavera no PC onde se encontra a aplicação, e não a instância do SQL Server onde seencontra a base de dados. As chaves priBaseDados, priUsername e priPassword deverão ser preenchidas respectivamente com o nome da empresa parametrizada no Administrador do Primavera, com o nome de um utilizador com direitos para se ligar a essa empresa e a respectiva password. A última chave, priTipoPlataforma deverá ter o valor 0 ou 1 consoante o Primavera seja da linha Executive ou Profissional.

Pg 42

Configuração de logging e alertas Estas secções permitem configurar o envio automático de notificações decorrentes da invocação da aplicação e devem ser preenchidas de acordo com os comentários no XML: <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> (...)  <add key="MailFrom" value=""/>  <add key="MailToOk" value=""/>  <add key="MailToErro" value=""/>  <add key="SMTPserver" value=""/>  <add key="SMTPuser" value=""/>  <add key="SMTPpwd" value=""/> </appSettings> <system.diagnostics> <switches>  <add name="ControloErros" value="1"/>  <add name="FluxoImportacao" value="4"/> <add name="FluxoExportacao" value="4"/> </switches> </system.diagnostics> </configuration> Configuração de constantes e campos/classificações usadas no XML A aplicação prevê a possibilidade de o ficheiro XML vir beber ao ficheiro .config algumas das definições ou valores de que depende. Sendo a utilização desta possibilidade completamente opcional, dado que a informação aqui representada pode ser incluída directamente no ficheiro .XML, consideramos que a sistematização da colocação de algumas constantes, como por ex. a moeda EUR, e os ID de campos de classificações onde o XML deve ir buscar a informação, facilita a manutenção dessa informação e a partilha de ficheiros .XML entre clientes em cujas bases de dados à mesma informação, ex. classificação de documento onde são guardadas as condições de pagamento, podem ter ID diferentes. <?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> (...)  <add key="DocCampoPrevEntrega" value="10"/> <add key="DocCampoDtDescarga" value="1"/> <add key="DocCampoHrDescarga" value="7"/>

Pg 43

<add key="DocCampoLocalDescarga" value="8"/> <add key="DocClassMatricula" value="4"/> <add key="DocClassModoExpedição" value="1"/> <add key="DocClassModoPagamento" value="2"/> <add key="DocClassCondPag" value="3"/> <add key="CodigoMoeda" value="EUR"/> <add key="CodigoSerie" value="41"/> <add key="CampoDocNrERP" value="11"/> <add key="CampoDocErro" value="12"/> <add key="CodArmazem" value="A1"/> (...) </appSettings>

As constantes e IDs acima representados são meros exemplos, e não têm qualquer utilidade ou impacto a não ser que delas dependa o ficheiro .XML. Podem criar-se mais chave livremente e apagar as que não sejam necessárias.

Ficheiro XML de ligação ao ERP PRIMAVERA

A aplicação depende de um ficheiro XML para saber que informação deve integrar no sistema, podendo prever-se mais de um XML de modo a que por ex. tipos de documentos diferentes tenham agendamentos de integração diferentes. Os ficheiros .XML para a integração de documentos têm a seguinte estrutura: Ligação à base de dados da solução No topo do ficheiro encontramos a informação pertinente à ligação à base de dados da solução: <?xml version="1.0" encoding="utf-8" ?> <m2uSalesInterface> <m2uSalesDB connectionstring="Password=sa???;Persist Security Info=True;User ID= sa;Initial Catalog=m2uSalesPRI;Data Source=servidor\instancia" /> <importacao /> <exportacao> (...) Separação dos tipos de documento como tarefas A cada tarefa definida corresponde apenas uma classe de documento no Primavera, podendo noentanto haver tarefas diferentes para a mesma classe de documento mas tipos de documento diferentes. No exemplo abaixo do esqueleto de um XML, as Facturas e Vendas a Dinheiro estão agrupados na mesma tarefa, correspondendo ambos a documentos da classe de Vendas, tal como a tarefa das Encomendas mais abaixo. A razão das facturas e VD estarem agrupadas, deixando as Encomendas para outra tarefa, tem a ver com as Facturas e VD partilharem em si a generalidade da informação de que necessitam, sendo necessário ao preencher os respectivos campos indicar o tipo de documento no Primavera. <exportacao> <destino> <tarefa descr="Facturas e Vendas a Dinheiro" ... classDoc="Vendas" ... <campos> <campo ...

Pg 44

(...) </campos> <subtarefas> <subtarefa descr="Facturas e Vendas a Dinheiro - Linhas" ... <campos> (...) </campos> </subtarefa> </subtarefas> <posprocess /> </tarefa> <tarefa descr="Encomendas" ... classDoc="Vendas" ... <tarefa descr="Cargas e Descargas" ... <tarefa descr="Recibos" ...

Classes de documentos a integrar

A cada tarefa de integração é necessário associar uma classe de documento no Primavera, estando neste momento contempladas as seguintes, Stocks, Vendas, e C. Correntes (Liquidações):

STOCKS VENDAS C. CORRENTES

Cargas (Entrada de Stock)

Encomendas

Recibos

Descargas (Saída de Stock)

Vendas a Dinheiro

Facturas

A cada classe de documento está associado um objecto da API do Primavera Por exemplo, para os documentos de Venda o objecto da API é o GcpBEDocumentoVenda. Organização de cada tarefa

Para cada tarefa temos de definir: 1) a origem da informação através de uma instrução SELECT que filtre os tipos de documento a integrar nesta tarefa e o respectivo estado 2) a classe do documento de acordo com o ponto anterior 3) a lista de campos (propriedades) a preencher 4) a origem da informação para as respectivas linhas através de uma instrução SELECT, filtrando o tipo de documento e o nº do documento de acordo com o cabeçalho que estiver a ser processado

Pg 45

<tarefa descr="Cargas e Descargas" sqlOrigem="SELECT * FROM _m2uPri_View_IntegracaoDocsCargaDescarga WHERE (doc_idSituacao IN (2, 9)) AND doc_idtipodoc IN (16, 17) ORDER BY doc_Numero “ classeDoc="Stocks" > <campos> <campo destino = "Tipodoc" tipo = "query" origem = "qTipoDoc" oper = "" tipodadosDest = "string" /> <campo destino = "Serie" tipo = "documento" origem = "doc_nrVendedor" oper = "" tipodadosDest = "string" /> <campo destino = "DataDoc" tipo = "documento" origem = "doc_data" oper = "" tipodadosDest = "DateTime" /> <campo destino = "NumDoc" tipo = "documento" origem = "doc_numero" oper = "mid(2,5)" tipodadosDest = "int" /> <campo destino = "Entidade" tipo = "fixo" origem = "0" oper = "" tipodadosDest = " string" /> <campo destino = "ArmazemOrigem" tipo = "query" origem = "qArmazemOrigem" oper = "" tipodadosDest = "string" /> <campo destino = "Modulo" tipo = "fixo" origem = "S" oper = "" tipodadosDest = " string" /> </campos> <subtarefas> <subtarefa descr="Cargas e Descargas - Linhas" sqlOrigem="SELECT * FROM _m2uPri_View_IntegracaoDocsCargaDescargaLinhas WHERE (doc_idTipoDoc =@tipoDocID) AND (doc_Numero = @docID) ORDER BY docLin_Linha"> <campos> <campo destino = "Armazem" tipo = "doclinha" origem = "qArmazemDestino" oper = "" tipodadosDest = "string" /> <campo destino = "Artigo" tipo = "doclinha" origem = "doclin_ref" oper = "" tipodadosDest = "string" /> <campo destino = "DataStock" tipo = "doclinha" origem = "doc_data" oper = "" tipodadosDest = "DateTime" /> <campo destino = "Descricao" tipo = "doclinha" origem = "doclin_descr" oper = "" tipodadosDest = "string" /> <campo destino = "Devolucao" tipo = "fixo" origem = "0" oper = "" tipodadosDest = "bool" /> <campo destino = "EntradaSaida" tipo = "fixo" origem = "E" oper = "" tipodadosDest = "string" /> <campo destino = "FactorConv" tipo = "fixo" origem = "1" oper = "" tipodadosDest = "double" /> <campo destino = "Lote" tipo = "doclinha" origem = "doclin_loteNr" oper = "" tipodadosDest = "string" /> <campo destino = "Modulo" tipo = "fixo" origem = "S" oper = "" tipodadosDest = " string" /> <campo destino = "PCM" tipo = "priArtigo" origem = "doclin_ref, PCMedio" oper = "" tipodadosDest = "double" /> <campo destino = "PrecUnit" tipo = "priArtigo" origem = "doclin_ref, PCMedio" oper = "" tipodadosDest = "double" /> <campo destino = "Quantidade" tipo = "doclinha" origem = "doclin_qtd" oper = "" tipodadosDest = "double" /> <campo destino = "Seccao" tipo = "fixo" origem = "1" oper = "" tipodadosDest = " string" /> <campo destino = "TipoLinha" tipo = "query" origem = "qTipoLinha" oper = "" tipodadosDest = "string" /> <campo destino = "Unidade" tipo = "doclinha" origem = "doclin_unVda" oper = "" tipodadosDest = "string" />

Pg 46

</campos> </subtarefa> </subtarefas> <posprocess /> </tarefa>

Organização dos Campos

Para cada campo é necessário definir: 1) destino: é o nome da propriedade do objecto destino, de acordo com a documentação da API do Primavera (ficheiro ERP750.chm no CD de instalação do Primavera), respeitando maiúsculas e minúsculas. No caso de se pretender ter como destino um campo de utilizador, colocar como destino o respectivo nome como se encontra na tabela, ex., CDU_CorProduto 2) tipo e origem: define como deve ser recuperado o valor que será preenchido no destino:

Documento, doclinha, cliente, climorada, artigo, artigocd ou query

o atributo origem define o nome da coluna do query a recuperar

appSettings

recupera o valor a partir da key definoda no ficheiro .config com o nome indicado no atributo origem

docCampo, docClass, docClassDescr, doclinCampo, doclinClass, artCamp, artClass, cliCamp, cliClass, vndCampo, vndClass

origem = “código, id”

recupera o valor a partir do campo ou classificaçãododo tipo de item indicado a partir do código recebido e do id do campo/classificaçºao indicado

o id pode ser indicado como @chave, em que chave é uma key no ficheiro .config

default ou ignorar

ignora o processamento do campo

fixo

recupera o valor a partir do atributo origem

priArtigo

origem = “doclin_ref, PCMedio”

recupera o valor a partr da propriedade indicada do artigo

priVendedor

origem = “doc_nrvendedor, Comissao”

recupera o valor a partir da propriedade indicada do artigo

Pg 47

3) oper: deixar em branco

4) tipodadosDest: tipo de dados da propriedade de acordo com o definido no ficheiro ERP750.chm

Criação do atalho

O m2uIntegracaoPrimavera7xx.exe não pode ser executado directamente pois requer que sejam passados alguns parâmetros para a sua execução. Atalho para modo interactivo Este atalho apenas deverá ser utilizado para os testes iniciais:

m2uIntegracaoPrimavera7xx.exe /def:caminhoparaficheiroXML /descr:descricaoparaficheirolog Ao criar o atalho, substitua o caminhoparaficheiroXML pelo caminho completo para o ficheiro XML de definição de importação e em descricaoparaficheirolog coloque algo como "Empresa Fictícia - Integração". 010 Alberto Silva - www.moving2u.pt - para a PrimaveraBSS Após executar o atalho, para efectuar a integração dos dados no ERP PRIMAVERA, clicar no botão Exportar. Atalho para modo silencioso O modo silencioso é executado sem necessitar do input do utilizador pelo que pode ser configurado para correr automaticamente de acordo com um agendamento:

m2uIntegracaoPrimavera7xx.exe /def:caminhoparaficheiroXML /descr: descricaoparaficheirolog /modo:SILENT /accao:IMPORT

Logs gerados

A cada execução da aplicação, quer em modo interactivo, quer silencioso, são criados 2 logs:

um log geral na pasta do executável, com o nome M2UINTEGRACAOPRIMAVERA7xx.log, ao qual a cada execução vai sendo adicionada a informação de log no seu final. Este log é útil quando não é criado o log detalhado e pode ser apagado periodicamente

um log mais detalhado, na subpasta Logs, com o nome do ficheiro XML que foi passado como parâmetro seguido de um timestamp à hora que foi executado. Por ex., um log com o nome PriDemo- 20100304123404.log corresponde a uma integração do ficheiro PriDemo.XML desencadeada no dia 4 de Março de 2010 às 12:34:04. Este log contem para cada documento e para cada linha do documento os detalhes sobre a informação a ser processada, indicando para cada documento se foi integrado com sucesso ou eventual mensagem de erro devolvida pelo Primavera na integração. No final, o log indica sempre se foi terminado com sucesso, se foi terminado mas com erros ou se foi interrompido pela gravidade dos erros. Estes logs não são apagados automaticamente pelo que se recomenda que periodicamente sejam apagados.

Caso o ficheiro m2uIntegracaoPrimavera7xx.exe.config referido acima esteja devidamente configurado, a aplicação poderá enviar o log detalhado e o ficheiro XML para os mails designados quando ocorrem erros, de modo ao destinatário ser alertado para o facto de uma importação não ter sido feita com sucesso, e com os ficheiros anexos se tentar perceber a razão de tal acontecer. A notificação de importação com sucesso pode ser útil numa primeira fase para perceber se o processoestá a correr de acordo com o agendamento respectivo.

Pg 48

Aplicação para impressão automática de documentos

Esta aplicação permite desencadear peridocamente a impressão de documentos num determinado estado numa impressora local ou de rede, sem intervenção humana, podendo ser útil por ex. para que as encomendas criadas pelos vendedores e integradas no sistema de gestão sejam automaticamente enviadas para uma impressora de rede no armazém. Na sua versão actual (2.1.x), esta aplicação encontra-se mais indicada para a impressão de documentos do tipo Encomenda, e assume que o código do tipo de documento associado à encomendas é o tipo 1. Versões futuras permitirão uma maior flexibilidade na impressão e o envio de documentos em formato PDF por correio electrónico. Parâmetros gerais relativos à aplicação (m2uImpressao.exe.Config) Os seguintes parâmetros permitem configurar esta aplicação: <appSettings>  <add key="ConnectionString" value="server=m2udevas1;database=m2uSalesDCR;User ID=sa;Password=saM2Uas"/>  <add key="TempDir" value="c:\m2uTemp\m2uSales\" />  <add key="TipoSituacaoImprimir" value="1,2" />  <add key="TipoSituacaoImpresso" value="11" />  <add key="TipoDocumentoImprimir" value="1" />  <add key="TipoOutput" value="4" />  <add key="NomeImpressora" value="\\m2usvr1\Brother @ Servidor" /> </appSettings>

Se pretender imprimir tipos de documentos diferentes, nesta versão da aplicação terá de ter múltiplas cópias da mesma em pastas diferentes.

Configuração de agendamentos

As aplicações de importação de dados e de integração de dados, bem como a de impressão automática se requerida, devem ser configuradas para correrem periodicamente, sem intervenção dos utilizadores. Para tal

Pg 49

sugere-se que seja utilizado o mecanismo de gestão de tarefas agendadas do Windows para a sua configuração Aplicação de importação de dados Recomenda-se que este processo corra pelo menos uma vez por dia, e que seja agendado para correr a horas de menor actividade, dado ser exigente do ponto de vista do CPU e disco do servidor, e de menor probabilidade de um utilizador sincronizar o seu PDA. Não se recomenda que corra mais de duas vezes por dia (ex., 5:00 e 13:30), excepto em casos em que tal seja efectivamente necessário. O atalho a utilizar para a criação da tarefa agendada deverá ser o do modo silencioso. Aplicação de integração de dados Consoante os utilizadores vão sincronizando os seus PDA ao longo do dia, os documentos criados por eles vêm parar à base de dados da solução no SQL Server. Para que os documentos 'entrem' automaticamente no sistema de gestão, é necessário correr a aplicação de integração de dados periodicamente, dependendo da necessidade em ter essa informação o mais actualizada possível do lado do sistema de gestão, sugere-se que sejam definidos intervalos não mais pequenos que 15 minutos entre integrações. Ao criar a tarefa agendada, definir uma hora início e outra fim, bem como um intervalo entre chamadas, ex., das 9:00 às 19:30 de 30 em 30 minutos, e usar o atalho do modo silencioso para o desencadeamento da tarefa. Impressão automática Caso seja requerida a impressão automática, a mesma deverá ser programada na gestão de tarefas agendada em função das definições da integração de dados e da sequência entre elas. Por ex., se a impressão for feita após a integração de informação, colocar este processo a correr desfasado 5 minutos da integração.

Configuração para os equipamentos

Pg 50

Com a aplicação instalada nos PDA e a base de dados no servidor com a respectiva publicação criada, são

ainda necessários alguns passos para que cada um dos equipamentos possa sincronizar com o servidor.

Configurações no back-office

Configuração das ligações

Para que um PDA possa sincronizar, é preciso previamente definir os parâmetros que irá usar para o efeito.

Para tal, aceder no back-office à opção de Gestão de Ligações:

Para criar uma nova ligação, digite a informação requerida na última linha e clique na disquete para gravar.

Para editar uma ligação, modifique a informação permitida e clique na disquete para gravar, ou refresque a

página para cancelar. O X vermelho permite remover definitivamente uma ligação.

Em muitos cenários bastará configurar uma ligação, no entanto sempre que os utilizadores devam poder

sincronizar localmente ou remotamente, a forma como a pasta virtual do IIS da replicação é endereçada pode

ser diferente, por ex. http://www.minhaempresa.com:81/sqlrepl/sqlcesa35.dll quando remotamente e

http://meuservidor/sqlrepl/sqlcesa35.dll quando localmente.

Para configurar uma ligação, clicar no link Ver Atributos na linha respectiva:

Preencher os atributos de acordo com as instruções:

Pg 51

Atributo Descrição

Nunca traduzir nomes em IP

Tipicamente a aplicação resolve o nome do servidor num endereço IP e daí em diante usa o endereço IP para minimizar a latência associada à resolução DNS. Caso a ligação em causa rejeite pedidos por IP, colocar um valor diferente de zero neste atributo

InternetURL Caminho completo para a localização do ficheiro sqlcesa35.dll na pasta virtual do IIS. Ter em conta que o caminho deverá ser acessível pelo PDA no contexto onde deve ser utilizado. Não usar http://localhost... ou http://127.0.0.1...

Publication Nome da publicação, no nosso exemplo,

Publisher Instância onde se encontra a base de dados

PubAddress Endereço IP local do servidor onde se encontra a base de dados publicada.

Publisher Name Nome da base de dados publicada

Utilizador SQL Nome do utilizador SQL a utilizar para autenticação

Password Password do utilizador SQL

URL para serviço de config URL completo para o web service m2uDeviceConfigManager, incluíndo o texto /compressed

URL webservice sales URL completo para o web service m2uMobileSalesService

URL para testar ligação URL para testar ligação. Sugere-se o caminho do serviço de configuração mas sem o /compressed no final

Configuração dos Grupos de Equipamentos

A execução da aplicação nos PDA toma em consideração algumas definições que podem ser comuns a todos os PDA ao serviço da empresa, comuns apenas a um grupo ou específicos de um PDA. A funcionalidade Grupos de Equipamentos permite gerir os grupos (criar, editar ou eliminar):

Pg 52

Ao clicar sobre o link Ver Detalhes de um grupo, pode definir para cada grupo os atributos que são comuns

aos PDA que lhe estão associados:

Preencha os atributos que quiser definir para cada grupo de acordo com as instruções:

Atributo Descrição

BarcodeReaderDLL Nome da dll de controlo do leitor de código de barras

BarcodeReaderTrigger Keyscan do botão no terminal que despoleta o feixe do leitor óptico

DatabasePath Caminho para a base de dados no PDA, incluíndo o nome do SDF. Ter em conta que a pasta associada ao cartão de memória pode ter nomes diferentes em PDA diferentes ou com idiomas diferentes

DbPassword Password a associar à base de dados no PDA para evitar que possa ser aberta por terceiros

DbStorageCard Digitar 1 caso a base de dados esteja num cartão de memória. Esta informação é importante para controlo se o cartão se encontra devidamente inserido ou não

Locale Opção a utilizar na versão multi-idioma da aplicação

PrinterConnection Ver Configuração da Impressão

PrinterModel Ver Configuração da Impressão

ShowAlphaKeyboard Digitar 1 caso a aplicação deva exibir o teclado virtual nos campos de input alfanumérico, zero caso tenha um teclado alfanumérico físico na orientação principal

ShowNumericKeyboard Digitar 1 caso a aplicação deva exibir o teclado virtual nos campos de input numérico, zero caso tenha um teclado numérico físico na

Pg 53

orientação principal

TempDir Caminho para uma pasta para ficheiros temporários.

Configuração dos Ficheiros

A Gestão de Ficheiros permite gerir os ficheiros que devem ser mantidos em cada PDA, seja no caso de (re)instalação do PDA de raíz, seja para actualização de ficheiros específicos do PDA. Incluem-se como exemplos de ficheiros a gerir por este mecanismo os layouts de impressão, logotipos a utilizar nos layouts de impressão, dlls para controlo do leitor de códigos de barras, etc.

Para cada ficheiro é necessário definir uma ou mais variantes do mesmo, sendo que para associar um ficheiro a um PDA é necessário especificar uma variante.

Consoante um ficheiro seja do tipo Content ou File, ao definirem-se os respectivos detalhes nas variantes teremos de respectivamente introduzir o conteúdo a gravar no ficheiro destino ou o caminho completo para o ficheiro em causa no servidor. Os ID a associar aos ficheiros são geridos livremente.

Na definição do destino para um ficheiro podem usar-se os seguintes placeholders:

Placeholder Descrição

%appfolder% Caminho onde a aplicação se encontra instalada

%assemblyname% Nome do assembly

%appexename% Nome do executável

Pg 54

%programfiles% Caminho da pasta Program Files, tendo em conta a localização do PDA

%mydocuments% Caminho da pasta My Documents, tendo em conta a localização do PDA

%appdata% Caminho para a pasta application data

Neste ecrã pode criar-se, editar-se ou remover ficheiros:

Clicando na opção Ver Variantes são exibidas as variantes associadas ao fichheiro, podendo-se criar, editar

ou eliminar variantes:

A cada variante deve ser atribuído um nº de versão (sugere-se 100 para a versão inicial) e sempre que seja

necessário propagar um novo conteúdo ou ficheiro para os PDA que têm associada a variante em causa,

basta incrementar o nº da versão. Ao gravar-se uma variante de um ficheiro do tipo File, o back-office

certifica-se que o caminho introiduzido é válido.

Configuração dos Equipamentos

A opção Gestão de Equipamentos permite manter a lista de equipamentos configurados, permitindo criar,

editar ou eliminar equipamentos:

Pg 55

A informação presente no ecrã permite atribuír um ID, uma designação amigável e um Grupo ao

equipamento, permitindo de relance saber se o PDA está associado a algum utilizador e se se encontra com

uma licença válida. A opção Ver Info permite definir o resto da informação necessária para cada

equipamento:

A primeira grelha, Atributos, permite visualizar se existe alguma definição para cada um dos atributos ditada

pelo grupo a que o equipamento pertence, permitindo que seja definido para o equipamento um valor

específico que prevalecerá sobre a definição do grupo.

A grelha Ficheiros permite que se associem ficheiros ao equipamento, sendo obrigatório seleccionar uma

variante. As colunas Versão e Data de Actualização indicam respectivamente qual a versão do ficheiro

presente no equipamento e em que data foi para lá copiado.

A última grelha, Ligações, permite definir quais as ligações que estão disponíveis para o equipamento,

podendo definir-se uma delas como predefinida.

Pg 56

Configuração de Vendedores

A manutenção da tabela de vendedores é feita no ecrã Gestão de Vendedores:

Pg 57

Para cada vendedor é atribuído um nº, um nome, uma abreviatura e uma identificação a incluír nos nrs. dos

documentos por ele emitidos. Define-se ainda um login e uma password a utilizar para entrar na aplicação

PDA e o armazém com que trabalha.

Preparação da informação para os equipamentos

Após a configuração dos pontos anteriores, aceder à opção “Administração m2u” -> “Licenciamento” para

obter os PIN para relativo às licenças, equipamentos e vendedores, clicando em cada botão “Ver” :

Pg 58

NOTA: deverá ter o browser configurado para aceitar popups deste site e ter o Adobe Acrobat Reader

instalado para ver os documentos com os PIN (poderão ser guardados, impressos ou reencaminhar por

correio electrónico):

Parametrização

Pg 59

Parâmetros Gerais

85 - Permite criação de recebimento a partir da conta corrente

Valor: x[, descrição] x: 0 - não permite criação de documento de regularização / > 0 - id do tipo de documento a criar

descrição: descrição a associar à conta corrente (opcional)

102 - Exibir opção de restrição de pesquisa de artigos a artigos com stock

Consoante o valor deste parâmetro, é ou não exibida a check-box na pesquisa de artigos que permite indicar que apenas deverão ser exibidos artigos cujo stock seja superior a zero no armazém parametrizado para o vendedor. Valor: x x: 0 - não exibe / 1 - exibe

103 - Definição de contas correntes suplementares

Este parâmetro encontra associado à Parametrização de contas correntes suplementares, de modo a permitir disponibilizar mais do que uma conta corrente. Valor: [descricao1, x1, y1[|descricao2, x2, y2]]

descricaon: descrição a associar à conta corrente

xn: tipo de registos na HistoricoDoc a exibir

yn: tipo de documento a gerar para regularização, ou 0 caso não se permita regularização.

104 - Caixa - Preenchimento automático de valores a entregar

Este parâmetro controla se nos movimentos de caixa, na entrega a aplicação deve perguntar ao utilizador se pretende que a entrega de valores seja preenchida com o saldo de meios de pagamento, e caso contrário, o comportamento a tomar. Valor: x x: 0 - pergunta / 1 - preenche automaticamente / 2 - força preenchimento manual

105 - Ordem de apresentação da Rota

Com este parâmetro pode escolher-se a ordem de apresentação dos cliente a visitar no ecrã das rotas. Valor: x x: 0 - ordena por nome / 1 - ordena pela ordem planeada

110 - Nº de casas decimais a gravar nos documentos

Este parâmetro define o nº de casas decimais que devem sert tidas em conta ao guardar o documento e respectivas linhas.Este valor deverá ser ajustado de acordo com a configuração do ERP.

Pg 60

Valor: [x] x: nº de casas decimais (de 0 a 4), se não definido assume

125 - Tipo de pesquisa de artigo a efectuar nos códigos de barras com peso ou preço variável Quando se lêem códigos de barras com peso ou preço variável, começados por 26/27/28/29, parte do código permite identificar o artigo correspondente. Se a codificação dos artigos tiver 5 dígitos numéricos, o relacionamento entre o código de barras lido e o artigo correspondente pode ser feito deste modo, caso contrário, se não for possível representar o código do artigo associado nos 5 dígitos previstos para o efeito no código EAN13, seja porque tem um número diferente de dígitos, seja porque é um código alfanumérico, o relacionamento deverá ser feito criando um código de barras igual ao que se pretende que seja lido, mas com a parte variável a zeros e o check-digit calculado para esse código.

Valor: [x]

x: se 0, faz pesquisa por artigos com o mesmo código que o compreendido entre os 3º e 7º dígito do código lido, se 1, faz pesquisa pelo artigo com o código de barras equivalente ao lido, mas com a parte variável a zeros e o check-digit recalculado

Parâmetros de documentos

21 - Preenchimento de descrições e notas a partir de frases-tipo

Pg 61

Permite definir a categoria de frases tipo associada a cada tipo de linha

Valor: x1:y1[,x2:y2[xn:yn]]

xn: tipo de linha

yn: tipo de frase tipo associado

58 - Tipo de caixa a movimentar e respectivo sentido

59 - Tipo de origem de movimento de caixa a gerar

Estes 2 parâmetros permitem definir para os tipos de documento pertinente, o tipo de caixa a movimentar e respectivo sentido, dependendo do valor preenchido ser maior ou menor que zero, bem como o tipo de origem de movimentos a associar aos movimentos de caixa gerados. Parâmetro 58 Valor: [-]i [-]i: id do tipo de caixa a movimentar. Caso i seja precedido do sinal -, indica que o movimento abate à caixa respectiva, caso contrário adicionará. Parâmetro 59 Valor: i i: id do tipo de origem de movimento de caixa a associar. Ver Gestão de Caixa

60 - Controlo de exibição do botão de acesso a informação acessória a partir do ecrã da linha de documento

Este parâmetro permite definir em que tipos de linha do tipo de documento em causa deve ser exibido o botão de acesso à informação acessória. Caso não exista informação acessória definida, ou a mesma não seja pertinente ao utilizador, não há necessidade de o preencher. Valor: t1[, t2[,tn]] tn: id(s) dos tipos de linha em que deve aparecer o botão, separados por vírgula

61 - ID da empresa a utilizar na impressão do documento

Esta funcionalidade permite que alguns documentos sejam impressos com uma identificação no respectivo cabeçalho diferente da pré-definida. Valor: n n: id da empresa cujos dados queremos imprimir Ver Documentos com cabeçalhos com dados diferentes para mais informação sobre como configurar empresas adicionais.

62 - Ecovalor - Campos a utilizar na sua aplicação

Para a aplicação do modelo simplificado de Ecovalor, é necessário definir onde ir buscar o valor a aplicar e onde armazená-lo.

Pg 62

Valor: x, y, z x: id do campo acessório da linha com o valor unitário do Ecovalor aplicado y: id do campo acessório da linha com o valor da linha do Ecovalor aplicado z: id do campo acessório do documento com o valor total do Ecovalor aplicado Ver Ecovalor

63 - Código do cliente fixo a usar nos documentos internos

Sempre que se pretenda que documentos internos como a Guia de Transporte, Carga de Viatura ou Descargar de Viatura seja associados a um cliente específico, o código desse cliente deve ser guardado neste parâmetro. Valor: c[,m] c: Código do cliente m: índice da morada do cliente c Nota

No caso de clientes com códigos compostos, deve colocar-se o código completo

O código de cliente seleccionado deve exisitr na base de dados de todos os vendedores

66 - Nº máximo de documentos em aberto

Valor: x[, y] x: Indica o nº máximo de documentos em aberto. Se for um inteiro indica o nº de documentos, se for precedido de C indica o ID do campo de cliente que inclui essa informação. Caso o valor do campo de cliente seja vazio ou inferior a zero, assume que não há limite y: indica o ID da TipoHistoricoDoc a controlar, 1 se nada for indicado Ver Controlo de emissão de documentos

67 - Controlo de data de vencimento de documentos vencidos

Valor: x[, y] x: se 0 indica que não há tolerância em relação à data de vencimento de documentos vencidos, se maior que zero indica a tolerância em dias. Se for precedido de C indica o ID do campo de cliente que contem essa informação. Caso o campo de cliente seja vazio ou inferior a zero, assume que não controla a data de vencimento, se zero, indica que não há tolerância, se maior que zero, indica tolerância em dias y: indica o ID da TipoHistoricoDoc a controlar, 1 se nada for indicado Ver Controlo de emissão de documentos

68 - Controlo de plafond do cliente

Valor: x,y[, z][, c1[, c2]] x: indica campo do cliente que contem o respectivo plafond. Pode ser precedido de C. y: indica o tipo de controlo de plafond: 1: confronta o saldo actual no ERP com o plafond, sem ter em conta documentos emitidos no PDA 2: confronta o saldo da tabela HistoricoDoc com o plafond, considerando documentos emitidos no PDA z: consoante y=1 ou y=2, indica o ID do campo de cliente com o valor do saldo ou o ID da TipoHistoricoDoc a controlar, respectivamente c1: indica campo do cliente que contem a soma dos documentos a crédito emitidos no PDA (ex. recebimentos). Se 0, não considera documentos emitidos a crédito. c2: indica campo do cliente que contem a soma dos documentos a débito emitidos no PDA (ex. facturas). Se 0, não considera documentos emitidos a débito.

Pg 63

Ver Controlo de emissão de documentos

69 - Campo de cliente a actualizar

Valor: [-]x x: indica campo do cliente ao qual deve ser somado o total do documento com IVA, caso o valor seja precedido de um hífen, o valor será descontado. Tipicamente, prever-se-ão quando necessário 2 campos de somatório por cliente, um para o total dos documentos a débito, e outro para o total dos documentos a crédito, campos esses que devem ser repostos a zero a cada importação do ERP. Estes campos serão tidos em conta no apuramento da situação do cliente face ao respcectivo plafond. Ver Controlo de emissão de documentos 80 - Edição de notas na linha Valor: x x: Quando 1 indica que podem ser preenchidas observações nas próprias linhas de artigos, que serão guardadas no campo doclin_nota

Funcionalidades

Pg 64

Abaixo encontra uma lista de funcionalidades implementáveis na aplicação, que sintetizam as configurações necessárias à sua implementação.

Ecovalor

Parametrização da aplicação PDA

A implementação do Ecovalor pressupõe que por artigo se importe o valor unitário de Ecovalor a aplicar por unidade para um campo acessório de produto. Há que criar também campos acessórios de documento para o total do Ecovalor, bem como campos acessórios de linha para o valor unitário e valor da linha do Ecovalor aplicado. O valor default do campo do valor unitário da linha deve ser definido como #CAMPOARTnnn, em que nnn é o id do campo acessório de artigo com essa informação. O parâmetro de documento nº 62 deve ser preenchido da seguinte forma: Valor: x, y, z x: id do campo acessório da linha com o valor unitário do Ecovalor aplicado y: id do campo acessório da linha com o valor da linha do Ecovalor aplicado z: id do campo acessório do documento com o valor total do Ecovalor aplicado

Resumo:

- Criar campo acessório para o produto - Alterar interface de importação de modo a recuperar o valor unitário de Ecovalor de cada artigo - Criar campo acessório na lista de campos do documento para o total do Ecovalor e campos acessórios na lista de campos da linha para o Ecovalor unitário e da linha - Parametrizar os campos criados para os tipos de documento e linha pretendidos, definindo os campos como de leitura apenas, e definindo o valor default do valor unitário da linha de modo a recuperar o respectivo valor a partir do campo respectivo do produto - Modificar o parâmetro 62 dos tipos de documento pertinentes de acordo com instruções acima

Integração dos valores no ERP

Para a integração no ERP, deve ser tido em conta que os valores relativos ao Ecovalor se encontram em campos acessórios do documento e das respectivas linhas.

Pg 65

Gestão de Caixa

Introdução

A gestão de caixa permite que os movimentos feitos ao longo do dia de trabalho que impliquem a transcação de meios de pagamento sejam registados de modo a poder-se com facilidade saber os meios de pagamento movimentados e respectivo saldo. A Gestão de Caixa no m2uMobileSales permite que as seguintes operações sejam registadas de forma transparente: - emissão de documentos que geram fluxos de caixa, como por ex. recebimentos - registo de despesas Para além disso, a Gestão de Caixa permite... - registar entregas e reforço de caixa - controlo de abertura e fecho de caixa - troca de meios de pagamento - controlo de até 4 caixas, uma para os documentos, outra para as despesas, outra para as importâncias que o utilizador disponibiliza por ex. para trocos e ainda outra para o 'arquivo' das importâncias recebidas nos dias anteriores e ainda não entregues. - transferências entre caixas A cada transacção que implique um movimento de caixa é forçada a descriminação dos montantes recebidos ou pagos pelos meios de pagamento definidos.

Implementação

Tabelas 'de sistema'

A Gestão de Caixa depende de algumas tabelas-base que não devem ser modificadas. Tipos de caixa A tabela TiposCaixa não deve ser modificada, contando com os seguintes 3 tipos de caixa:

Geral Despesas Pessoal Arquivo Tipos de origem de movimentos Esta tabela, TiposCaixaOrigemMovimentos, que não deve ser modificada, define os tipos de origem possível para cada movimento de caixa, de acordo com a seguinte tabela: Nesta tabela, a coluna _atributos permite caracterizar alguns comportamentos por tipo de origem.

Os atributos são definidos como 2^(k-1), de acordo com a seguinte tabela:

K Atributo

1 Indica que não se podem repetir meios de pagamento no mesmo movimento. Útil quando a informação tem de ser integrada no ERP.

Tipos de movimento

Pg 66

A tabela TiposCaixaTMovimento define os tipos de movimento possíveis de acordo com a seguinte tabela:

K Atributo

1 Mais

2 Menos

3 Transferência

Tabelas de apoio

Há um conjunto de tabelas de apoio que têm de ser preenchidas. A sua manutenção pode ser feita directamente nas respectivas tabelas, prevendo-se o desenvolvimento da sua manutenção a partir do back-office futuramente. Na tabela TiposCaixaMeiosPagamento definem-se os meios de pagamento a disponibilizar. Na sua definição associa-se um código, uma descrição e abreviatura, ordem pela qual deve aparecer no PDA, e atributos que permitem caracterizar cada meio.

Os atributos são definidos como 2^(k-1), de acordo com a seguinte tabela:

K Atributo

1 Indica que o montante não pode ser fraccionado, e que deve ser 'descriminado', em vez de 'somado'. Exemplo, cheques.

2 Indica que o meio de pagamento pode ser usado para trocos.

3 Indica que o montante pode ser editado nas trocas de meio de pagamento.

4 Indica que o meio de pagamento não pode ser usado para entregas.

Para cada meio de pagamento, poderá definir-se a necessidade de preenchimento de informação adicional, por ex., forçar que no preenchimento de um chque seja preenchido o respectivo banco emissor, número e data. Os campos a recolher por tipo de meio de pagamento são definidos na tabela TiposCaixaMeioPagamentoCampos, onde é definida uma legenda, uma descrição, o tipo de dados, informação auxiliar (não utilizado de momento), atributos e ordem pela qual o campo deve ser exibido. Para os tipos de dados aplica-se a seguinte tabela:

Tipo de dados Descrição

1 Texto

2 Numérico

3 Data

10 Selecção a partir de CombBox

Os atributos são definidos de acordo com esta tabela:

K Atributo

1 Indica que o preenchimento do campo é requerido

2 Indica que o texto digitado pelo utilizador deverá ser

Pg 67

convertido em maiúsculas

Para cada campo, podem definir-se opções adicionais no campo _InfoAux:

InfoAux Descrição

MAX:n Indica que o valor máximo admitido para o campo é de n. Só está implementado para datas e este valor corresponde ao valor máximo admitido para uma data.

OPC:x,y Indica a origem dos dados quando o tipo de dados do campo é 10. x indica o tipo de informação complementar, e y o id da classificação onde podemos encontrar as opções.

Para indicar mais de uma opção, separar com “|”. A tabela TiposCaixaMeiosPagamentoOrigemMov define os tipos de meio de pagamento aceites para cada origem. No seu preenchimento cruza-se o id da origem com o id to tipo de meio de pagamento para criar os pares com as combinações suportadas.

Parâmetros

Parâmetros Gerais O parâmetro 96 controla se o botão de gestão de caixa deve ou não ser exibido no ecrã de relatórios. Relativamente às despesas, o parâmetro 97 define se as despesas devem ser abatidas à caixa, e caso afirmativo, qual a caixa a movimentar. Durante o dia, pode ocorrer que um vendedor tenha de utilizar importâncias suas para fazer face a algumas situações, nomeadamente trocos, sendo estes valores geridos como uma caixa específica, a caixa 'pessoal'. O parâmetro 98 indica se estes movimentos podem ser registados e caso afirmativo, qual a caixa associada. Consoante os casos, pode ocorrer que um vendedor que vai recebendo importâncias possa passar alguns dias sem entregar as importâncias que vai recebendo, não fazendo sentido que o PDA assuma que o vendedor transporta consigo todas as importâncias recebidas. Nestes casos, se o vendedor deixar em casa as importâncias já recebidas, poderá transferir para a caixa 'Arquivo' essas importâncias. O controlo de utilização da caixa arquivo é feito através do parâmetro 99, se zero não é permitida a sua utilização, caso contrário define o ID do tipo de caixa respectivo. Em relação à entrega de valores, pode ser perguntado ou não ao utilizador se pretende preencher automaticamente a relação de meios de pagamento a entregar.O parâmetro 104 controla se a pergunta deve ser feita ao utilizador ou se assume um determinado comporatmento (0 - pergunta, 1 - preenche automaticamente, 2 - preenchimento manual). Parâmetros de documento

Pg 68

Os parâmetros 58 e 59 indicam se a criação de um documento de um detemrinado tipo deve ou não gerar um movimento de caixa pelo seu valor total. O parâmetro 58 define o tipo de caixa a movimentar, e consoante o seu valor seja ou não precedido do sinal menos, determina respectivamente se o movimento abate ou adiciona à caixa identificada, enquanto o parâmetro 59 indica o tipo de origem a associar ao movimento. Caso se pretenda que o registo do movimento de caixa possa ser feito por um valor diferente do valor do documento, o parâmetro 58 deverá ser seguido de ,1 Poderá haver casos em que o registo em caixa de um documento deva ser feito em função de um campo ou classificação acessória do documento. Nesses casos, os parâmetros 58 e 59 devem ser preenchidos da forma habitual, enquanto o parâmetro 64 deverá ser preenchido da seguinte forma: x|y|z1,[,z2[,zn]] em que x deverá ter o caracter C ou L consoante se trate respectivamente de um campo ou de uma classificação do documento, y indica o id do campo ou classificação a observar e z1...zn a lista de valores que quando seleccionados forçam a obrigatoriedade do registo, podendo também ser preenchido com o valor NOTZERO ou NOTEMPTY, para forçar que o registo de caixa seja efectuado sempre que o campo ou classificação seja diferente de zero ou não vazio, respectivamente. Exemplos: C|4|NOTZERO C|2|VD L|5|1,3

Rotas

Pg 69

Rotas semanais

Introdução

As rotas semanais caracterizam-se pela definição de ciclos semanais de visita, sendo indicado para cada cliente a visitar o dia da visita. Baseado nessa informação, cada vendedor terá acesso à lista de clientes a visitar nesse dia, com o controlo dos clientes já visitados e dos clientes em falta, podendo aceder à lista dos outros dias de modo a poder, por ex., antecipar a visita aos clientes que coincidam com um feriado.

Parametrização

É ncessário criar na tabela TerceirosRotasDef as combinações possíveis por vendedor/dia da semana. Sugere-se a abordagem da tabela seguinte, em que para o vendedor 1 se criaram 5 rotas, uma para cada dia da semana, em que o respectivo ID é composto pelo código de vendedor seguido de um ponto e uma representação numérica do dia da semana:

tercRotaDef_id tercRotaDef_descr tercRotaDef_nrVend tercRotaDef_PeriodoInicio

1.2 2ª feira 1 01-01-2000

1.3 3ª feira 1 01-01-2000

1.4 4ª feira 1 01-01-2000

1.5 5ª feira 1 01-01-2000

1.6 6ª feira 1 01-01-2000

tercRotaDef_PeriodoFim tercRotaDef_tipoExecucao tercRotaDef_Activa

31-12-2020 S2 1

31-12-2020 S3 1

31-12-2020 S4 1

31-12-2020 S5 1

31-12-2020 S6 1

A partir desta definição, é necessário definir quais as rotas atribuídas a cada cliente, fazendo corresponder a cada cliente um ou mais IDs de rotas definidas no ponto anterior. Essa definição é feita na tabela TerceirosRotasDefDetalhe, preenchendo os seguintes campos, e deixando os outros com os seus valores pré-definidos:

tercRotaDefDet_idRotaDef tercRotaDefDet_nrTerceiro

1.2 1.0

1.2 10.0

1.3 100.0

1.3 1000.0

1.4 10000.0

1.4 1001.0

1.5 1002.0

1.5 1003.0

1.6 1004.0

1.6 1005.0

1.2 1006.0

1.2 1007.0

Pg 70

1.3 1008.0

1.3 1009.0

1.4 101.0

1.4 1010.0

1.5 10100.0

1.5 1011.0

1.6 1012.0

1.6 1013.0

1.2 1014.0

1.2 1015.0

1.3 1016.0

1.3 1017.0

1.4 1018.0

1.4 1019.0

1.5 102.0

1.5 1020.0

1.6 10200.0

1.6 1021.0

1.4 1021.0

1.2 1021.0

Neste exemplo, o cliente 1021.0 é visitado à 2ª, 4ª e 6ª, enquanto os outros clientes são visitados apenas uma vez por semana. A manutenção desta tabela deverá ser integrada no ficheiro de importação do ERP, criando o idRotaDef a partir da concatenação do código de vendedor com um ponto e o dia da semana a visitar. Por fim, há que mudar o parâmetro nº 42 - Tipo de Rota, atribuíndo-lhe o valor S O parâmetro 105 controla a ordem de exbição dos cliente na rota.

A ter em conta!

Neste momento há um desenvolvimento que levou a que não haja um 'sincronismo' entre os estados do relatório de visita e o estado de execução da rota, o que pode levar a que os ícones que surgem na lista não sejam os correctos. Está a ser preparado um desenvolvimento que resolve esta situação.

Pg 71

Parametrização de contas correntes suplementares

Pode ser necessário ter disponível por cliente, para além da conta corrente 'normal', outras listas de documentos por regularizar. O m2uMobileSales permite definir até duas contas correntes suplementares, bem como indicar o tipo de documento a gerar na regularização de cada uma delas.

Parametrização

O parâmetro geral 103 permite definir quantas contas suplementares são pretendidas, bem como as suas propriedades: Parâmetro Geral 103 Valor: [descricao1, x1, y1[|descricao2, x2, y2]]

descricaon: descrição a associar à conta corrente

xn: tipo de registos na HistoricoDoc a exibir

yn: tipo de documento a gerar para regularização, ou 0 caso não se permita regularização.

Por ex., o seguinte valor... Guias de Consignação, 11, 0|Comissões, 12, 22 indicaria que se pretendem 2 contas correntes suplementares, uma para Guias de Consignação em aberto presentes na tabela HistoricoDoc com o docHist_idTipoDocHist = 11, sem que o utilizador possa criar um documento a partir das mesmas, e outra para regularização de comissões presentes na tabela HistoricoDoc com o docHist_idTipoDocHist = 12, originando documentos do tipo 22 para sua regularização. Nota! É conveniente associar uma descrição à conta corrente 'base' no parâmetro geral 85.

Alimentação das c/c suplementares

A informação que constará nas contas correntes suplementares no PDA será armazenada da mesma forma que a conta corrente 'normal' na tabela HistoricoDoc, obviamente com os docHist_idTipoDocHist de acordo com o parâmetro geral 103. Previamente deverá ser criado um registo na tabela TiposHistoricoDoc para cada um dos ID parametrizados.

Pg 72

Controlo de emissão de documentos

Introdução

Há situações em que se pode pretender restringir a emissão de determinados tipos de documentos em função da situação actual do cliente relativamente à sua conta corrente. O m2uMobileSales permite controlar os seguintes aspectos: - nº máximo de documentos 'abertos' por cliente - só pode emitir o documento se o nº de documentos pendentes for inferior ou igual à definição. Nota: não são tidos em conta documentos a favor do cliente. - controlo de existência de documentos vencidos, com possibilidade de definição de tolerância - controlo de plafond e saldo de documentos pendentes

Parametrização

A parametrização destes controlos é efectuada a nível dos parâmetros de documento dos tipos de documento a controlar. 66 - Nº máximo de documentos em aberto Valor: x[, y][,z] x: Indica o nº máximo de documentos em aberto. Se for um inteiro indica o nº de documentos, se for precedido de C indica o ID do campo de cliente que inclui essa informação. Caso o valor do campo de cliente seja vazio ou inferior a zero, assume que não há limite y: indica o ID da TipoHistoricoDoc a controlar, 1 se nada for indicado z: 0 indica que o controlo bloqueia a emissão de novos documentos, 1 apenas exibe mensagem de alerta 67 - Controlo de data de vencimento de documentos vencidos Valor: x[, y][,z] x: se 0 indica que não há tolerância em relação à data de vencimento de documentos vencidos, se maior que zero indica a tolerância em dias. Se for precedido de C indica o ID do campo de cliente que contem essa informação. Caso o campo de cliente seja vazio ou inferior a zero, assume que não controla a data de vencimento, se zero, indica que não há tolerância, se maior que zero, indica tolerância em dias y: indica o ID da TipoHistoricoDoc a controlar, 1 se nada for indicado z: 0 indica que o controlo bloqueia a emissão de novos documentos, 1 apenas exibe mensagem de alerta 68 - Controlo de plafond do cliente Valor: c1, c2, c3, c4[,x] c1: indica campo do cliente que contem o respectivo plafond. Pode ser precedido de C. c2: indica o campo do cliente que contem o respectivo saldo de CC no ERP. Pode ser precedido de C c3: indica campo do cliente que contem a soma dos documentos a crédito emitidos no PDA (ex. recebimentos). Se 0, não considera documentos emitidos a crédito. c4: indica campo do cliente que contem a soma dos documentos a débito emitidos no PDA (ex. facturas). Se 0, não considera documentos emitidos a débito. x: 0 indica que o controlo bloqueia a emissão de novos documentos, 1 apenas exibe mensagem de alerta Para o controlo de plafond de cliente ter em conta os documentos emitidos no PDA (de regularização e de débito), é necessário prever 2 campos para o cliente, um para a soma dos documentos a débito, e outro para a soma dos documentos a crédito. Nos parâmetros dos documentos que devem actualizar estes campos, deve ser definido no parâmetro 69 . Adicionalmente, no interface de importação de dados do ERP, estes campos devem ser repostos a zero a cada importação.

Pg 73

Auto-Venda

As operações de auto-venda tem associadas algumas parametrizações e funcionalidades específicas.

Cargas & Descargas

As operações de carga e descarga do lado do Caso o processo de carga e descarga sejam feitos pelo vendedor, há a necessidade de parametrizar um documento para cada uma destas operações. Parâmetro 87 - Definir o ID do tipo de documento a criar no processo de carga da viatura (0 singnifica que a opção não está disponível) Parâmetro 88 - Definir o ID do tipo de documento a criar no processo de descarga da viatura (0 singnifica que a opção não está disponível) Nalguns casos pode pretender-se que o utilizador possa automaticamente proced XXXXXXXXXXXXXXXXXXXXXXxxx Em relação à descarga, pode ser conveniente ter uma funcionalidade que permita que o vendedor possa com um clique no ecrã preencher automaticamente o documento de descarga de acordo com o stock da viatura reportado pelo PDA. No entanto, poderão existir empresas que prefiram que o vendedor não tenha nenhum auxiliar e proceda à contagem manual dos artigos na viatura, enquanto outras podem querer forçar o preenchimento automático do documento de descarga, sem possibilidade de edição pelo vendedor. Parâmetro 89 - Preencher de acordo com a seguinte tabela: Valor Descrição 0 A 'Descarga Automática' é opcional e editável 1 A 'Descarga Automática' não está disponível pelo que o utilizador tem de contar os artigos manualmente 2 A 'Descarga Automática' é forçada e o vendedor não pode editá-la 3 A 'Descarga Automática' é forçada mas pode ser editada pelo vendedor Caso ainda não exista, criar um tipo de linha na tabela TiposDocLinha para 'Cargas/Descargas', com as flags _selArtigo e _MovStock a True e as restantes a False, e atribuír o ID desta linha aos parâmetros 5 e 6 do documento, no formato 1,n em que n corresponde ao ID do tipo de linha. É importante actualizar os seguintes parâmetros de documento, de modo a limitar acções que não fazem sentido para este tipo de documento: Parâmetro Valor Descrição 3, 26 Bloquear emissão e visualização de descontos 6 Exibir último stock OPCIONAL 11 15 17 33, 34, 39 35 0 1 0 Bloquear edição do preço 0 Pode anular documento

Pg 74

art Tipo de documento 0 Opções relacionadas com bónus e promoções 1 Movimentar stocks A parametrização para poder preencher ou editar estes documentos a partir da grelha é em tudo igual à dos outros documentos, aplicando-se o mesmo à impressão.

Pg 75

Tratamento de Lotes

Nalguns modelos de negócio é requerido que todos os movimentos que envolvam determinados artigos tenham que mencionar sempre o respectivo lote para efeitos de rastreabilidade. As implicações na aplicação são que todas as seguintes operações têm forçosamente que mencionar o lote do artigo movimentado: - Carga/Descarga preparadas no ERP - Carga/Descarga efectuadas no PDA - Vendas, Guias de Remessa, ... - Devoluções Antes de parametrizar o tratamento de lotes na aplicação, é necessário determinar: - o ERP permite registar mais de um lote por linha? - modelo de identifcação de lotes pretendido? Podem prever-se diferentes modelos de movimentação de lotes, como: - digitação manual - escolha a partir de lista - identificação automática

Parametrização

A parametrização dos lotes é efectuada a nível da parametrização dos documentos e parâmetros gerais:

Parâmetros Gerais

108 - Tratamento de lotes Valor: 0/1 0: Não existe tratamento de lotes 1: Existe tratamento de lotes (exibe na ficha de artigos um separador para visualização dos lotes)

Parâmetros de documento

72 - Requer identificação de lote Valor: x[, y[:info][, z]] x: 0 ou vazio - indica que a informação de lote nunca é requerida 1 - indica que a informação de lote é sempre requerida Cn=v - indica que a informação de lote é requerida quando o campo n do artigo tem o valor v Ln=v - indica que a informação de lote é requerida quando a classificação n do artigo tem o valor v y: 0 ou vazio - o lote pode ser escolhido de uma lista (-)1 - o lote tem de ser digitado manualmente (-)2 - identificação mista (manual e escolha da linha) >= 0 - tem de constar no PDA < 0 - não tem de constar z: 0 ou vazio - só pode movimentar um lote por linha 1 - pode movimentar mais de um lote por linha 73 - Máscara para introdução de lotes manualmente Valor: x x: Regular expression de validação dos lotes introduzidos manualmente Exemplo: ^[A-Z]{2}(\d{6})$ força 2 letras seguidas de 6 dígitos

** Importante ** O tratamento de lotes não pode ser utilizado com as grelhas de

selecção de produtos.

Pg 76

Devoluções de produtos

Nalguns tipos de negócio, os produtos devolvidos não podem ser vendidos de novo, pelo que a aplicação ao registar a sua devolução não deve contabilizar a quantidade devolvida como stock disponível, podendo esses artigos serem de novo movimentados apenas com o documento de descarga da viatura. A definição de produtos que não podem ser revendidos pode ser transversal a todos os produtos (ex., uma empresa que apenas vende bolos), por tipo de produtos (ex., só os produtos de uma determinada família não podem ser vendidos de novo) ou depender de uma resposta do utilizador (ex., se o utilizador constatar que o produto devolvido está deteriorado, marca-o como não podendo ser vendido de novo). Para efeitos de simplificação, abaixo serão designados de 'produtos bloqueados' todos aqueles que não podem ser de novo vendidos e de 'produtos normais' todos os outros.

Parametrização

A parametrização desta funcionalidade é efectuada a nível da parametrização dos documentos. 75 - Tratamento de devolução de produtos Valor: x[, y] x: Comportamento face aos produtos 'bloqueados' - 0 ou parâmetro vazio: os produtos movimentados pelo documento são 'normais' e o documento não permite movimentar produtos 'bloqueados' - 1: todos os produtos movimentados pelo documento devem ser considerados 'bloqueados', excepto se for passado um valor para o parâmetros y. Em termos gerais, esta definição apenas faz sentido para documentos de devolução - 2: o documento pode movimentar produtos 'bloqueados'. Normalmente esta definição aplicar-se-á ao documento de descarga da viatura, para registar a entrega dos produtos 'bloqueados' no armazém da empresa, e à Guia de Transporte para que estas quantidades sejam consideradas na sua emissão y: Caso x = 1, indica a aplicabilidade da regra - vazio: o stock dos produtos movimentados ficam bloqueados nas quantidades movimentadas - PCi=z ou PLi=z: só os produtos que tenham o campo ou classificação i com valor z é que devem ser bloqueados como indicado acima. Exemplo: 1, PL5=BOLOS - só os produtos cuja classificação 5 tem o valor BOLOS é que ao serem devolvidos não podem ser revendidos - DCi=z ou DLi=z: mesma situação que a referida acima em relação aos campos e classificações dos produtos mas neste caso para a linha de documento Exemplo: 1, DL1=NAO - só os produtos das linhas de documentos cuja classificação 1 tem o valor NAO é que ao serem devolvidos não podem ser revendidos, supondo que à classificação 1 corresponde uma classifciação juja legenda seja 'Apto p/ venda?' e cujas opções sejam SIM e NAO.

Pg 77

Regras e Descontos Comerciais

Descontos Unitários

Os descontos unitários permitem definir um valor monetário que é aplicado a cada unidade de produto transaccionado. Na versão actual, estes descontos de linha não podem ser utilizados em paralelo com os descontos percentuais.

Parametrização

A parametrização dos descontos unitários é efectuada a nível da parametrização dos documentos. 2 - Pode emitir descontos unitários Valor: x[|d] x: 0 - Não pode emitir descontos unitários 1 - Pode emitir e editar descontos unitários 2 - Pode emitir descontos unitários pré-definidos mas não pode editá-los d: Desconto máximo unitário Os parâmetros relativos aos descontos percentuais e em euros (3, 9 e 26) deverão estar em branco ou a zero.

Descontos a partir de lista

Na emissão de alguns documentos, pode pretender-se limitar as opções de descontos a uma lista de descontos, por ex. 2,5% e 3,5%, a serem escolhidos a partir de uma combo box. A aplicação permite definir uma lista de opções comum a todos os clientes, ou definir por cliente a lista de opções a exibir. Neste momento este tipo de desconto apenas pode ser definido para descontos de cabeçalho, podendo a funcionalidade ser desenvolvida a nível das linhas se necessário.

Parametrização

A parametrização dos descontos a partir de lista é efectuada a nível da parametrização dos documentos e dos campos de documentos. 71 - Emissão de descontos a partir de lista Valor: Cn|[d1:]x1;[d2:]x2;...;[dn:]xn Cn: Id do campo de cliente que contém as opções a preencher na lista. O valor desse campo deverá encontrar-se no formato indicado abaixo, e sempre que vazio, a única opção disponível na combo box será o desconto de 0%. [d1:]x1;[d2:]x2;...;[dn:]xn: Lista de descontos possíveis separados por ponto-e-vírgula, em que o separador decimal se existente seja o ponto (xn). Pode associar-se uma designação amigável a cada opção (dn) Para o desconto de cabeçalho, será necessário criar um campo de desconto como habitual, mas indicando o tipo de dados 12.

Pg 78

Identificação de clientes nos documentos

Nas versões anteriores à 2.3, a aplicação baseava os documentos emitidos nos dados do cliente visualizado na respectiva ficha, sem permitir escolher de forma óbvia uma morada de facturação, nem nos casos de emissão de documentos a clientes não-identificados preencher a sus informação. A partir da versão 2.3 foram implementadas as seguintes funcionalidades: - no ecrã de pesquisa passa a constar um novo botão que permite escolher directamente o 'cliente indiferenciado' - nos casos de clientes com moradas múltiplas, a morada em visualização na ficha do cliente é usada para a emissão do documento - pode visualizar-se a informação do cliente com que o documento será emitido, bem como escolher uma outra morada quando o cliente tenha mais de uma morada - quando um cliente é identificado como sendo 'indiferenciado', a aplicação deixará preencher os seus elementos na emissão do documento - além do nº do cliente, única informação guardada até aqui, passam a ser guardados os seguintes campos por documento: nome e eventual designação social, morada (índice, linha 1, linha 2, cód. postal, localidade) e NIF

Parametrização da utilização de 'clientes indiferenciados'

Cada utilizador terá de ter na sua base de dados um cliente que servirá de base nos documentos a emitir em termos de caracterização geral. Esse cliente poderá ser partilhado por todos os vendedores ou específico para cada um, dependendo da forma como foi filtrada a informação de terceiros por vendedor. 117 - Identificação do cliente indiferenciado Valor: x x: Se diferente de vazio, indica o código do cliente indiferenciado a usar por todos os vendedores. Se for precedido de c, indica o campo de vendedor que contém o código do cliente indiferenciado por vendedor

Pg 79

Aceder mais de uma base de dados numa instalação num PDA

Introdução

Nalguns casos pode ser necessário permitir que num PDA o utilizador possa utilizar bases de dados diferentes, como por ex., de empresas diferentes e independentes.

Instalações múltiplas da aplicação m2uMobileSales

Nesses casos pode optar-se por instalar a aplicação tantas vezes quantas as necessárias no mesmo PDA, mas em pastas diferentes, editando o nome de cada atalho criado para reflectir o nome da empresa ao qual se liga. Esta abordagem tem a vantagem de permitir que as empresas possam ter versões diferentes da estrutura da base de dados, mas tem o inconveniente de ocupar mais espaço de armazenamento.

Instalação única da aplicação m2uMobileSales

A alternativa nos casos em que se pode presumir que as diferentes bases de dados terão sempre a mesma estrutura, é instalar a aplicação uma única vez, e simplesmente criar atalhos para cada empresa que se quer gerir, onde o atalho é editado de modo a passar na linha de comando a empresa a utilizar como argumento. Para o efeito deverá criar-se na pasta onde a aplicação é instalada uma subpasta por cada empresa, que poderá ter um nome simplificado da mesma, por ex: \Programas \m2uMobileSalesVx \EmpresaA \EmpresaB Para criar o atalho para a empresa A num PDA com a aplicação instalada na pasta \Programas, num PC, criar um ficheiro com o Notepad com o seguinte conteúdo: nn#"\Programas\m2uMobileSalesV2\m2uMobileSalesV2.exe" settingsfolder=EmpresaA onde nn terá de ser substituído pelo nº de caracteres depois do #, neste caso 74, e guardá-lo com um nome que indique a empresa ao qual se ligará e extensão .lnk, copiando-o de seguida pra a pasta \Windows\Menu Iniciar\Programas. Automanticamente a aplicação guardará os ficheiros de configuração necessários a cada empresa na subpasta respectiva.

Obtenção de informação para sincronização

A primeira vez em que a aplicação é executada para uma determinada empresa, será exibido o ecrã para obtenção da informação para sincronização. Caso as diferentes empresas partilhem o mesmo servidor, terão de prever-se diferentes instâncias do webservice m2uConfigPDA em diferentes portas do IIS se se pretender que para cada empresa apenas apareçam as ligações da empresa.

Sincronização

As difernetes empresas são sincronizadas independentemente, tendo o vendedor de repetir o processo em cada uma delas.

Pg 80

Funcionalidade Caixa/peças/kg

Nalguns casos, como o comércio de carne e derivados, o mesmo produto pode ser encomendado sob diferentes unidades,

Parametrização

Por tipo de documento podem ser definidos os seguintes parâmetros 28 - Implementa filosofia cx/un/kg Valor: x|f1|f2|f3|c1|c2|c3|tipooutput|tiposeleccao|camporesumo x: 0 ou 1, quando 1 indica se deve ser sempre implementada esta filosofia f1, f2 e f3: indicam os id dos campos de artigo que contêm respectivamente os factores de conversão de caixas para unidades, de caixas para kilogramas e de unidades para kilogramas. Se 0 indicam que a conversão não é possível ou não existe factor definido c1, c2 e c3: indicam os id dos campos da linha onde serão guardados respectivamente o nº de caixas, de unidades e de kilogramas. Se 0 indicam que o campo respectivo não existe ou não deve ser preenchido tipooutput: 0 indica que deve descriminar os valores introduzidos nos campos c1, c2 e c3, se 1 apenas preenche resumo no campo camporesumo tiposelecção: 0, 1, 2 ou 3, de acordo com a seguinte tabela: Valor Lógica Descrição 0 DaCruz Há validação das apresentações possíveis em função dos factores de conversão definidos 1 Livre Não há validação da informação introduzida, excepto apenas permitir apenas a intorução de um dos elementos 2 Carnes da Gândara 3 DeltaMarisco camporesumo: id do campo de linha onde deverá ser guardada a informação resumo da selecção 41 - Implementa filosofia cx/un/kg em função de artigo Valor: x x: Indica o id do campo de artigo que indica se ao mesmo deve ser aplicada esta filosofia. O campo em causa deverá estar vazio ou preenchido de acordo com o parâmetro 28 acima referido. Nota: Para que este parâmetro seja efectivo, o parâmetro 28 não deverá encontrar-se preenchido.

Pg 81

Impressão

Documentos com cabeçalhos com dados diferentes

Esta funcionalidade permite definir que alguns tipos de documentos específicos devem ser impressos com uma identificação no respcetivo cabeçalho diferente da pré-definida, podendo por ex., prever a emissão de documentos em nome de outra entidade em nome da qual a empresa esteja autorizada a emitir documentos. O parâmetro 61 permite definir qual os dados da empresa a utilizar na impressão, mediante um valor numérico inteiro que quando diferente de 0 ou NULL indica que deverão ser utilizados esses dados em detrimento da empresa pré-definida. Para prever múltiplos dados de empresas de modo a poder seleccioná-los, é necessários incluí-los no ficheiro de definição de impressão. O seguinte exemplo inclui, para além dos dados pré-definidos, a informação sobre duas empresas adicionais, a nº 1 e a nº 2. Nota! Todas as chaves têm de ser duplicadas para cada 'nova' empresa <?xml version="1.0" encoding="utf-8" ?> <printinginfo printermodel="Extech3500" connection="PORT_TOFILE"> <add key="companyL1" value="moving2u" tipo="header" /> <add key="companyL2" value="Soluções de Mobilidade" tipo="header" /> <add key="addressL1" value="Centro de Empresas de Taveiro" tipo="header" /> <add key="addressL2" value="Taveiro" tipo="header" /> <add key="PostalCode" value="3045-508 Coimbra" tipo="header" /> <add key="VAT" value="506 560 482" tipo="header" /> <add key="phone" value="239 983 900" tipo="header" /> <add key="fax" value="239 983 901" tipo="header" /> <add key="www" value="www.moving2u.pt" tipo="header" /> <add key="email" value="[email protected]" tipo="header" /> <add key="notesL1" value="Boas Férias!" tipo="footer" /> <add key="notesL2" value="Obrigado pela sua encomenda" tipo="footer" /> <add key="1.companyL1" value="empresa 1" tipo="header" /> <add key="1.companyL2" value="Soluções 11 Mobilidade" tipo="header" /> <add key="1.addressL1" value="Centro 11 Empresas de Taveiro" tipo="header" /> <add key="1.addressL2" value="Taveiro11" tipo="header" /> <add key="1.PostalCode" value="3045-111 Coimbra" tipo="header" /> <add key="1.VAT" value="506 560 111" tipo="header" /> <add key="1.phone" value="239 983 111" tipo="header" /> <add key="1.fax" value="239 111 901" tipo="header" /> <add key="1.www" value="www.moving2u.pt1" tipo="header" /> <add key="1.email" value="[email protected]" tipo="header" /> <add key="1.notesL1" value="Boas Férias!1" tipo="footer" /> <add key="1.notesL2" value="Obrigado pela sua encomenda1" tipo="footer" /> <add key="2.companyL1" value="empresa 2" tipo="header" /> <add key="2.companyL2" value="Soluções 22 Mobilidade" tipo="header" /> <add key="2.addressL1" value="Centro 22 Empresas de Taveiro" tipo="header" /> <add key="2.addressL2" value="Taveiro22" tipo="header" /> <add key="2.PostalCode" value="3045-222 Coimbra" tipo="header" /> <add key="2.VAT" value="506 560 222" tipo="header" /> <add key="2.phone" value="239 983 222" tipo="header" /> <add key="2.fax" value="239 222 901" tipo="header" /> <add key="2.www" value="www.moving2u.pt2" tipo="header" /> <add key="2.email" value="[email protected]" tipo="header" /> <add key="2.notesL1" value="Boas Férias!22" tipo="footer" /> <add key="2.notesL2" value="Obrigado pela 222 encomenda" tipo="footer" /> </printinginfo>

Pg 82

Impressão de informação suplementar por linha de documento

Introdução

Nalguns contextos é importante que alguma da informação preenchida manual ou automaticamente nos campos e/ou classificações das linhas de documento seja impressa junto dessa mesma linha, como por ex., a origem de um determinado produto, ou ainda as notas preenchidas para a própria linha.

Parametrização

Para cada documento em que se pretenda utilizar esta possibilidade, é preciso parametrizar para diferentes tipos de linha, qual a informação a imprimir.

Parâmetro de documento 81 - Impressão de campos & classificações de linhas

Valor:

t1:(Cx1'formatocampo'|Ly1'formatoclass')|(Cx2'formatocampo'|Ly2'formatoclass')|...|(Cxn'for

matocampo'|Lyn'formatoclass')[,tn:...]

tn: id do tipo de linha ao qual se aplica

xn: id do campo

yn: id da classificação da linha

formatocampo: formato a utilizar na impressão, baseado na sintaxe do String.Format, correspondendo ao elemento {0} à legenda do campo e {1} ao valor do campo formatoclass: formato a utilizar na impressão, baseado na sintaxe do String.Format, correspondendo ao elemento {0} à legenda da classificação, {1} ao valor da classificação e {2} à descrição do valor Exemplo 3:C4'{0}: {1}'|L2'{0}: {2} ({1})'

Para as linhas do tipo 3, imprime o campo 4 da linha precedido da respectiva legenda e para a classificação 2, imprime a sua legenda, a descrição do valor seleccionado e esse valor entre parentesis.

Parâmetro de documento 82 - Impressão de notas de linha

Valor: t1:x|'y'[,tn:...]

tn: id do tipo de linha ao qual se aplica

x: se 0, não imprime, se 1, imprime as notas sem nenhum prefixo y: se for incluída uma string entre plicas, precede as notas quando existam dessa string Exemplo 3:'Anotações importantes: '

Para as linhas do tipo 3 para as quais o utilizador tenha preenchido notas, essas notas são impressas precedidas de Anotações importantes:

Pg 83

Impressão de logotipos nos documentos

Introdução

Alguns clientes pretendem que nos cabçalhos dos documentos impressos a partir dos PDA seja incluído um logotipo da empresa em complemento ou em substituição dos detalhes da empresa. Para implementar esta funcionalidade é necessário que a impressora em causa preveja a possibilidade de pré-download do logotipo em causa, cuja impressão é despoletada com um comando de impressão.

Parametrização

As chaves printcompanydetails e printcompanyinfo do ficheiro printinginfo.xml controlam a impressão do logotipo anteriormente descarregado para a impressora e dos detalhes da empresa. printcompanydetails Esta chave quando inexistente ou com um valor não vazio e diferente de 0 despoleta a impressão dos detalhes da empresa no cabeçalho de documento printcompanyinfo Esta chave quando definida com um valor não vazio e diferente de 0 desencadeia a impressão do logotipo. O valor a definir deverá ter em causa eventais especificidades da impressora em causa, como por ex. o índice da imagem em memória a imprimir. <?xml version="1.0" encoding="utf-8" ?> <printinginfo printermodel="Extech3500" connection="PORT_TOFILE"> <add key="companyL1" value="moving2u" tipo="header" /> <add key="companyL2" value="Soluções de Mobilidade" tipo="header" /> <add key="addressL1" value="Centro de Empresas de Taveiro" tipo="header" /> <add key="addressL2" value="Taveiro" tipo="header" /> <add key="PostalCode" value="3045-508 Coimbra" tipo="header" /> <add key="VAT" value="506 560 482" tipo="header" /> <add key="phone" value="239 983 900" tipo="header" /> <add key="fax" value="239 983 901" tipo="header" /> <add key="www" value="www.moving2u.pt" tipo="header" /> <add key="email" value="[email protected]" tipo="header" /> <add key="notesL1" value="Boas Férias!" tipo="footer" /> <add key="notesL2" value="Obrigado pela sua encomenda" tipo="footer" /> <add key="printcompanydetails" value="0" tipo="header" /> <add key="printcompanylogo" value="1" tipo="header" /> </printinginfo>

Pg 84

Extender o Relatório de Visita com informação suplementar

Introdução

O relatório de visita pode ser extendido de modo a solicitar mais informação ao utilizador, para além do estado/tipo de visita e do campo de notas. Essa informação poderá ser de preenchimento por digitação (por ex., valores numéricos ou alfanuméricos, datas) ou por escolha de uma lista de valores.

Implementação Para a implementação desta funcionalidade é necessário: 1 - caracterizar os campos suplementares a preencher 2 - definir as listas de valores manualmente ou importá-las

1. Caracterizar campos a preencher

Primeiro que tudo, verificar se na tabela TiposInfoComplementares existe um registo com o id 101, e se não existir, criá-lo com a descrição sugerida 'Informação para relatório de Visita'. Consoante a informação a preencher seja de introdução manual ou de escolha de uma lista de valores, estaremos perante um campo ou uma classificação:

- campos Na tabela TiposInfoComplCampos, criar um registo para cada campo, atibuindo à coluna _idTipoInfoCompl o valor 101, à coluna _id um valor numérico, e uma descrição na coluna _descr. A coluna _aux deverá ser preenchida da seguinte forma: legenda | ordem | tipoItem | valorMin | valorMax | requerido legenda: legenda que deve surgir associada ao campo no PDA ordem: nº de ordem pelo qual deve ser exibido tipoItem: o tipo de item define o tipo de input esperado por parte do utilizador: ItemTextBox: recolhe input alfanumérico do utilizador ItemNumeric: apenas admite valores numéricos ItemCheckBox: permite alternar um valor entre 'sim' e 'não' com uma checkbox ItemDateTime: permite recolher uma data valorMin: valor ou comprimento mínimo admissível, consoante se trate de um valor numérico ou data, ou de um texto valorMax: valor ou comprimento máximo admissível, consoante se trate de um valor numérico ou data, ou de um texto requerido: 1 se requerido, 0 se opcional - classificações Na tabela TiposInfoComplCampos, criar um registo para cada campo, atibuindo à coluna _idTipoInfoCompl o valor 101, à coluna _id um valor numérico, e uma descrição na coluna _descr. A coluna _aux deverá ser preenchida da seguinte forma: legenda | ordem | default | requerido | tipoInfo legenda: legenda que deve surgir associada ao campo no PDA ordem: nº de ordem pelo qual deve ser exibido default: escolha por omissão requerido: 1 se requerido, 0 se opcional tipoInfo: se vazio exibe a lista de valores a partir da lista de valores definidos para a classificação consoante ponto 2 abaixo, se contactname, exibe a lista de contactos do cliente

Pg 85

Na definição das ordens, ter em conta que o mesmo nº de ordem não se pode repetir entre os 'campos' e as 'classificações'.

2. Definir as listas de valores

No caso das classificações, em que pretendemos que o utilizador escolha uma opção de uma lista de valores, é necessário definir esses valores ou definir uma origem para esses valores. Regra geral esses valores serão partilhados entre todos os clientes, mas também poderá acontecer que cada cliente tenha a sua lista de valores. Para definir uma lista de valores comum a todos os clientes, introduzi-la na tabela TiposInfoComplClassValores, definindo no campo _idTipoInfoCompl o valor 101, no _idClass o id da clasificação ao qual o valor está associado, no campo _cod, o código da opção e no campo _descr, a descrição a ser exibida ao utilizador. Nalguns contextos, o código e a descrição poderão ser iguais. Na versão 2.3 é possível no entanto definir que uma lista de valores é definida dinamicamente em função do cliente em causa, permitindo escolher de uma lista de contactos da empresa. Futuramente poderão ser previstas outras listas dinâmicas. ´

Exemplo

Para conseguir o output no exemplo acima, há que definir as classificações Resumo e Contacto.

Na tabela TiposInfoComplClass, preencher da seguinte forma:

tInfoComplClass_idTipoInfoCompl tInfoComplClass_id tInfoComplClass_descr tInfoComplClass_aux

101 1 Resumo Resumo|1||1

101 2 Contacto Contacto|2||1|ContactName

Na tabela TiposInfoComplClassValores, definir as opções para a classificação resumo, ou em alternativa, manter sincronizado com o software CRM com o m2uDataInterface:

tInfoComplClassValor_idTipoInfoCompl tInfoComplClassValor_idClass tInfoComplClassValor_Cod tInfoComplClassValor_Descr

101 1 Apresentar proposta Apresentar proposta

101 1 Entregar mercadoria Entregar mercadoria

101 1 Visita ao cliente Visita ao cliente