Antes de iniciar a criação de um novo Metadados é necessário que você identifique que tipo de licença o seu servidor está usando. Pode ser uma licença por Metadados ou por Servidor. Se for o primeiro caso você precisa de um arquivo de licença novo para criar este Metadados. Se for uma licença por Servidor você pode criar quantos Metadados quiser.


Se você for no PIS, em Manager\License observe o parâmetro IsGlobal. Se ele for igual a Yes significa que a licença é por servidor. Se não é por Metadados.


Vamos verificar, a seguir, como adicionamos um novo Metadados a um ambiente do PIS.


Nota: Versão 4.4.3.1


Criação do banco de Metadados:


  • Certifique-se que o arquivo de licença, temporário, para este novo Metadados, está disponível no servidor (Isso se a licença for por Metadados).


  • Acesse o SQL Server Management Studio com um usuário que tenha o privilégio de criação de bases.


  • Vá em Database, botão da direita do mouse e escolha a opção New Database.


  • Inclua o nome do novo banco de dados e clique em OK.


  • Se o usuário que você for usar para que o PIS acesse este banco de dados for o mesmo que usado para criá-lo você pode seguir. Mas, se o usuário usado pelo PIS para acesso for outro, você deve incluir certos privilégios de acesso a esta base. Para isso abra as pastas Security / Logins, em Object Explorer do SQL Server Management Studio, procure o usuário do banco que fará o acesso às bases, pelo PIS, botão da direita do mouse sobre ele e escolha Propriedades.


  • Na opção User Mapping deixe como a propriedade db_owner os bancos Master e o criado neste momento para ser o banco do novo Metadados.


  • Clique em OK para configurar a mudança nas propriedades de segurança dos bancos.



Registro do Metadados:


  • Abra o PIS.


  • Vá em Manager / Scheme.


  • Inclua em Name Scheme um nome que permita a identificação fácil do assunto associado a este Metadados.


  • Se você tem o Web Service configurado desmarque a opção Local e insira, em URL, o endereço de acesso HTTP. Se não, marcar a opção Local.


  • Na aba Use existing database digite em Database name o nome do banco de dados no SQL Server onde o Metadados será criado. Mantenha marcado a opção Use existing database.


  • Clique na barra de ferramentas da caixa  de diálogo a opção New.


  • Confirme a inclusão e depois clique em Close.


  • Confirme a ação que irá escrever no diretório local do cliente o registro dos Metadados.



Propriedades de conexão no SQL Server:


  • Vá em Manager / Login.


  • Como se trata do primeiro acesso digite em Username  o usuário supervisor. .Este será um super usuário que terá permissão completa de acesso a todas as funcionalidades. Para cada Metadados podemos ter apenas um único usuário supervisor.


Nota: Você não precisa usar como usuário a palavra supervisor. Você pode determinar aqui um novo nome. Mas este usuário, como novo nome, será o único usuário com privilégio de supervisor. Usamos o nome supervisor apenas como uma convenção. Mas isso não é obrigatório.


  • Digite a senha do supervisor. Como se trata do primeiro acesso à senha pode ser inventada por você. Esta senha que será criada aqui é a usada pelo usuário supervisor quando as parametrizações do Metadados do PIS forem finalizadas.


  • Escolha o Metadados que foi registrado nos passos anteriores.


  • Clique em OK.


  • Como se trata do primeiro acesso, o PIS irá perguntar se deseja incluir as propriedades de acesso ao banco de Metadados. Quase sempre usamos, aqui, a conexão com o usuário que foi disponibilizado pelo DBA do cliente para acesso ao banco de Metadados.


  • Inclua o nome do servidor, se o tipo de autenticação será via usuário do Windows, digite o usuário e senha do SQL Server . Depois inclua o nome do banco de dados. Deve ser o mesmo usado quando do registro do Metadados. Se você modificou, no SQL Server, as propriedades de db_owner para um usuário específico é aqui que este usuário deve ser usado.


  • Clique em OK e volte a tela de Login.



Propriedades do servidor:


  • Mantenha o usuário Supervisor e a mesma senha incluída no passo anterior e clique em OK.


  • A ferramenta irá perguntar se deseja criar na base o usuário Supervisor cuja senha foi determinada neste momento de acesso pela primeira vez. Confirme clicando em Yes.


Nota: Neste momento todas as tabelas necessárias para armazenar o Metadados do PIS foram criadas. Caso você deseje observar isso siga os passos abaixo:


  • Vá ao SQL Server Management Studio.


  • Se conecte com o usuário “sa” e, como senha, a que foi incluída no momento da instalação do servidor do banco.(Ou com um usuário administrador que possa criar bancos de dados).


  • Botão da direita do mouse sobre a base que está sendo usada como Metadados e expanda a aba Tables. Você verá uma série de tabelas criadas. Elas serão as tabelas a serem usadas para armazenar os Metadados dos processos de integração.


Voltando a tela de Login do PIS.


  • Clicando novamente em OK na tela de Login o produto irá perguntar se você quer configurar algumas propriedades do servidor neste momento. Clique em Yes.


  • Basicamente precisamos especificar o caminho da localização de alguns programas que rodam no servidor do PIS. E é apresentando como padrão o diretório C:\Program Files.


  • Clique nos 5 botões Copy para copiar o diretório padrão para as propriedades dos módulos Server Command, Server 32 Bits Command, Schedule Services, Thread Services e Server Profit. O diretório padrão será copiado para cada uma das áreas de texto correspondente aos módulos mencionados acima.


  • Se o diretório especificado durante a instalação for diferente do C:\Program Files eles devem ser evitados e substituídos pelo diretório onde a ferramenta foi instalada. Erros na especificação destes caminhos acarretam num mal funcionamento do PIS.


  • Clique no botão Save para confirmar as alterações e depois clique em Close.



Registrando a licença:


  • Na tela de Login, mantendo o usuário supervisor e a senha editada durante o primeiro acesso, clique em OK.


  • O PIS irá perguntar se você deseja registrar a licença temporária. Selecione Yes.


  • Clique no botão Open e selecione o arquivo com extensão “.KLC” recebida junto com os instaladores.


  • Podemos ver, na caixa de diálogo, as propriedades da licença temporária que está sendo registrada. Destacando a informação sobre a data de expiração da licença temporária.


  • Clique em Salvar.


  • E pronto. Voltamos para a tela de Login.


  • Clique em OK e o acesso a este novo Metadados será permitido.


  • Neste momento você deve voltar em Manager \ License e escolher a opção para gerar um Token (Generate Token) a fim de que seja providenciado uma licença definitiva. O fato de não possuir a licença definitiva, neste momento, não impede que você continue a configuração deste novo Metadados e nem de começar a desenvolver seus processos de ETL e Integração.



Configurando os serviços:


  • Feche a abra o PIS como Administrador (Run As Administrator).


Nota: Para instalação dos serviços não somos obrigados a executar o PIS como Administrador. Mas, em alguns servidores, pode ser que o sistema operacional não deixe que o PIS crie os mesmos serviços ele mesmo. Rodar como Administrador aumenta as possibilidades de sucesso deste processo.


  • No menu Manager selecione a opção Server Config.


  • Vá na aba Services.


  • Clique duas vezes sobre System Manager, tanto na parte de cima (Schedules) quanto na parte de baixo (Threads).


  • Inclua em User Schedule Service e em Password Schedule Services os dados do usuário do sistema operacional que irá gerenciar este serviço.


  • Repita para o usuário em User Threads Service e em Password Threads Services.


  • Antes de continuar clique em Save para salvar as propriedades de usuário e senha.


Nota: Outro processo que não há garantias que vai funcionar, devido a privilégios de segurança, é configurar os usuários dos serviços pelo PIS. Aconselhamos sempre incluir o usuário aqui mas, depois, confirmar em Services se o usuário realmente estará gerenciando os serviços. Caso não dê certo você pode configurar os usuários manualmente.


  • Na parte de cima clique no botão Files Schedules. Confirme a operação.


  • Repita, na parte de baixo, clicando no botão Files Threads. Confirme a operação.


  • O próximo passo consiste em criar o serviço no sistema operacional do servidor. Para isso clique no botão Service Schedules. Confirme a operação.


  • Repita o procedimento para o outro serviço clicando em Service Threads. Confirme a operação.


  • Se a operação funcionar podemos ver, nesta mesma caixa de diálogo, dois ícones verdes destacando que os serviços estão no ar.


Podemos verificar, pelo sistema operacional, o status dos serviços:


  • Vá em Control Panel / Administrative Tools / Services para verificar a lista de serviços ativos no servidor.


  • Procure pelos serviços iniciados com a palavra PIS.


  • Não esqueça de verificar, como orientado acima, os usuários que estão gerenciando os serviços.



Salvando a lista de Metadados registrados no Web Service:


  • Caso você esteja usando a configuração via Web Service é necessário salvar a lista de esquemas do servidor no site para que os usuários possam fazer download dos mesmos pelo PIS Client. Para isso vá em Manager / Scheme.


  • Clique, no botão da barra de ferramentas, em Save schema in Web Service site.


  • Certifique-se que o endereço do Web Service apresentado na caixa de diálogo esteja correto. Clique então em Save.


  • Salve o arquivo Schema.zip no diretório onde o Web Service foi instalado, dentro da subpasta Install. Deve haver um arquivo Schema.zip dentro deste diretório. Substituída pelo que está sendo salvo agora.



Registrando o novo Metadados no cliente:


  • Agora vamos até o cliente. Abra o PIS Administrator and Designer (Light) pelo Pis Thin.


  • Vá em Manager / Scheme.


  • Clique, no botão da barra de ferramentas, em Download Schemas.


  • Na caixa de diálogo digite a URL do Web Service. Deve-se colocar o endereço do servidor, o número da porta, seguido de /api/wareWSNET.


Exemplos:  http://localhost:8082/api/wareWSNET ou https://pis.servidor.com:9097/api/wareWSNET


  • Clique em Save.


  • Selecione um diretório na sua máquina local. Clique em OK. O Download do arquivo Schema.Zip será efetuado e salvo neste diretório. Também será feita sua descompactação automaticamente.


  • Feche a caixa de diálogo de Download Schemas.


  • Na caixa de diálogo de gerenciamento de esquemas de Metadados clique em Open.


  • Selecione o arquivo que foi descompactado a partir do arquivo Schema.Zip, que foi baixado. Pronto. Os esquemas são carregados.


  • Feche a caixa de diálogo referente ao gerenciamento dos esquemas. Confirme a atualização dos esquemas.


  • Vá em Manager / Login e efetue a conexão. Agora você está conectado ao servidor através do cliente.


Mais detalhes no link abaixo:


0034  Criando novo Metadados