Documentação de software

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
======ISA - IntelliStock Android======

====== PRÉ-REQUISITOS PARA UTILIZAÇÃO DO ISA ======

O INTELLISTOCK ANDROID trabalha em um ambiente de **rede local (LAN)** e por isso é necessário que alguns parâmetros de rede sejam definidos para que a comunicação entre o serviço e a aplicação ocorra sem problemas.

<note important>SOLICITE AO RESPONSÁVEL DE INFRAESTRUTURA DO SEU COMÉRCIO PARA REALIZAR A ALTERAÇÕES NECESSÁRIAS PARA O FUNCIONAMENTO DO ISA.</note>

O primeiro pré-requisito para a utilização do ISA é a disponibilidade de um aparelho que opere o **Sistema Operacional Android** 6 ou superior.

O equipamento (seja um smartphone ou um coletor de dados), precisa estar conectado a uma rede WI-FI, que **SEJA A MESMA** rede do ambiente cabeado. Por exemplo, se a rede WI-FI tralha na rede 192.168.0.1 e o servidor do ISA esta em uma máquina com o IP 192.168.1.1 e as redes forem isoladas, não haverá comunicação entre o serviço e a aplicação.

Além desse requisito básico, há os requisitos de regurança da rede que precisam ser averiguados antes da intlação do ISA.

Se houver bloqueio de IPs ou Portas na rede, estas pecisam ser liberadas. Por padrão o ISA sugere a utilização da porta 8033, mas pode ser outra qualquer. Além disso, é recomendável que **UTILIZE IP FIXO** no equipamento móvel para evitar perda de comunicação com o serviço. 

Faça a verficação de PING entre o servidor e o equipamento móvel.

===== Apresentação =====

O ISA, assim como o IS, possui uma [[http://iws.com.br/produtos/is/isa/|página]] onde são disponibilizados os instaladores das últimas versões. 

Além dos instaladores, existem dois links diferentes para se fazer download dos **Apps**. O primeiro é no texto **Download APK** próximo a cada imagem dos Apps. Este link permite baixar para o computador ou diretamente no smartphone o arquivo de instalação para **Android**.

<note warning>Este link para download do APK foi criado com o intuido de ser possível disponibilizar versões de **Hot Fix**. Portanto, nem sempre a versão do APK direto será igual a versão da Play Store.</note>

O Segundo link é no logo de cada aplicação que direciona para a página da **Play Store**.

{{ ::linksapks.png |}}

(http://iws.com.br/produtos/is/isa/)


===== Instalação =====

Execute o intalador **NO MODO DE ADMINISTRADOR** e siga as etapas de Instalação para iniciar a utilização do ISA.

<note warning>DURENTE AS ETAPAS PODE SER SOLICITADO A FECHAR OUTRAS APLICAÇÕES ANTES DE PROSSEGUIR. **DESMAQUE A OPÇÃO PARA DE FECHAR OUTRAS APLICAÇÕES**. ISSO PODE ENCERRAR O ENTERPRISE SERVER SE A INSTALAÇÃO ESTIVER OCORRENDO NO SERVIDOR. </note>


{{ :intellistock:iss_install1.png?nolink |}}

{{ :intellistock:iss_install2.png?nolink |}}

{{ :intellistock:iss_install3.png?nolink |}}

{{ :intellistock:iss_install4.png?nolink |}}

{{ :intellistock:iss_install4_1.png?nolink |}}

{{ :intellistock:iss_install4_2.png?nolink |}}

==== Instalação de APK no SMARTPHONE ====

Conecte o Samrtphone no cabo USB e habilite a opção de **Transferência de arquivos**

{{ :intellistock:isa_install1.png?nolink |}}

{{ :intellistock:isa_install2.png?nolink |}}

Copie os arquivos **.apk** para do computador para o samrtphone.

{{ :intellistock:iss_install5.png?nolink |}}

{{ :intellistock:iss_install6.png?nolink |}}

{{ :intellistock:iss_install7.png?nolink |}}

Em seguida, abra o gerenciador de arquivos no Samartphone e execute os arquivos **.apk** para a instalação.

<note important>Para instalar um APK no smartphone é preciso conceder permissão para instalação de apps de fontes desconhecidas. O Android encaminha para a configuração durante a instalação.</note>

===== Entrerprise ISA =====
A partir da versão **1.0.1.9** o ISA faz a conexão com o banco de dados utizando o Enterprise Server.

{{ ::enterprise_isa.png |}}

<note important>O Enterprise deve ser executado no servidor do banco de dados do **IntelliCash **. A porta padrão de comunicação é a **5033**</note>

<note tip>Quando o **ISA** está instalado na mesma máquina que o servidor é possível configurá-lo para executar o Enterprise se ele estiver fechado.
A configuração do **.INI** é: **INITES=1** dentro de **[DBCONNECTION]**

Mas para isso funcionar o Enterprise deve permanecer na página de instalação do ISA/ESServer/ES_ISA.exe</note>

Uma versão recente do ES está modificada para alterar a cor do ícone para ver se o parâmetro do **ES_ISA.INI** estiver configurada par ao isa: 

  [Produto]
  Tipo=ISA


===== Aplicação Servidora =====

{{ ::main.png?nolink |}}

No menu superior encontram-se 3 opções: **Servidor**, **Configurações** e **Sobre**.

====Servidor ====

Exibe o log de comunicação entre um terminal e o servidor.

{{ ::servidor.png?nolink |}}


====Configurações====
Neste menu estão disponíveis as opções de configuração da conexão com o banco de dados, opções de configuração de uso do programa e configuração de etiquetas.

===Conexão===
{{ ::conexao_cli.png?nolink |}}

**Dados de Liberação** Nesta seção são informados os dados para a liberação do produto pela nova versão do IntelliWeb. O link de liberação não precisa ser alterado e é o valor padrão do programa.
O **Token** é uma chave obtida no perfil do usuário IntelliWeb, associado a um cliente, que dá acesso às informações disponibilizadas pela API.

<note important>Esta chave é única e não pode ser compartilhada com outras pessoas.</note>


**Dados de Conexão** Nesta seção são informados os dados de conexão com o Banco de dados do IntelliCash.

===Opções===

Exibe uma interface que permite configurar o diretório de destino dos arquivos enviados pelos smartphones, como arquivos de recebimento de notas, coletas de inventários e impressão de etiquetas.

Além disso, é possível visualizar quais são os usuários do IS cadastrados no IC por meio do botão **Usuários** e ainda os dispositivos cadastrados no IS.

<note important>O ISA é uma versão Android do IS, logo, todas as informações produzidas pelo ISA são armazenadas da mesa forma que as informações do IS.</note>

{{ ::configuracoes.png |}}

A configuração da **PORTA HTTP** é a mesma que deve ser indicada nos Apps. Dependendo das configurações de rede do ambiente em que o sistema estará operando, será necessário incluir no firewall uma exceção para a porta. Isso pode ser feito por meio do botão **ADD FIREWALL EXCEPTION**.

Depois de efetuar as alterações nos campos, é necessário **SALVAR**.
===Editar Etiqueta===
Esta opção permite que as configurações de impressão das etiquetas sejam alteradas, assim como no IC.


===== Aplicações Android =====

====Configurações Gerais====
Configurações gerais referen-se as configurações que são iguais para todas as aplicaçoes do ISA, seja **Recebimento de Notas**, **Inventários**, **Impressão de Etiquetas**, **Consulta de Preços Concorrentes** e **Sugestão de Preços**.

Normalmente a primeira tela apresentada é a tela de **Login**.

{{ ::isa_login.png |}}

Os usuário são carregados automaticamente toda vez que o App é executado. Mas para que isso seja possível, as configurações de conexão precisam estar preenchidas de forma correta.

Para acessar a tela de **Configurações**, clique no botão **Voltar** na tela de **Login**.

{{ ::isa_cfg.png |}}


No campo **Nome** deve ser informado um nome que identifique o samrtphone para o sistema.

No campo **IP** deve ser informado o IP da máquina onde o Servidor do ISA está instalado, seguido da **Porta de Conexão** (":8033").

<note important>Não altere ou esqueça de preencher a informação da porta. Caso não seja possível utilizar esta porta, entrar em contato com o Atendimento.</note>

====Inventário====

===Menu Principal===

No menu principal do App de Inventário são apresentadas opões para a contagem de situações específicas como: **Inventário**, **Troca**, **Devolução**, **Perda** e **Consumo**. Cada opção irá gerar um arquivo próprio, facilitando a identificação de cada contagem.

Na parte inferior, existem três opções: **Enviar Arquivos**, **Atualizar Produtos** e **Voltar**.

**Enviar arquivos**: envia para o **Servidor** as contagens em aberto. Constagens em aberto deixarão o botão correspondente na cor roxa.

**Atualizar Produtos**: busca no servidor a relação de todos os produtos cadastrados, seja no IC ou no próprio ISA. Essa ação permite que a consulta de produtos possa ocorrer de forma offline.

**Voltar**: volta para a tela de login.

===Contagem===

A tela de contagem apresente um **Título** indicando qual é o tipo de contagem que está sendo realizada. O toque no título abre uma tela de **Produtos Contados**

Abaixo do Título, são exibidas as informações do último item contado.

Na parte inferior, são exibidos os campos para a contagem atual: **Código Ean** e **QTDE** (quantidade).

{{ :intellistock:isa_inv_contagem.png?nolink |}}

O botão **LER CÓDIGO** abre a câmera do samrtphone para a captura do codigo de barras. Ao ler o código do produto, suas informações são consultadas e a quantidade é solicitada.

{{ ::isa_cam.png?nolink |}}

O botão confirmar Insere o Item no inventário.

==== Recebimento de Nota Fiscal ====

No menu principal do recebimento de notas há botões para **Receber Nota**,**Nota Cega**,**Enviar Arquivo**,**Backup do Banco**,**Atualizar Produtos** e **Voltar**.

{{ :recebimento.png?300 |}}

**Receber Nota**: Preenchendo a data do __recebimento__,será encaminhado para uma tela onde os dados da nota devem ser informados.

{{ :recebimentocalendario.png?nolink&300 |}}

{{ :localizarnota.png?nolink&300 |}}

A captura da chave do DANFe pode ser feita pela opção **LER CÓDIGO** que irá ativar a câmera do samrtphone.

Ao capturar a chave, os outros dados serão preenchidos automaticamente.

Também é possível iniciar o recebimento informando apenas o CNPJ e o Número da nota.

Na tela de recebimento há um **Título** que corresponde ao número da nota que está sendo conferida. Um toque nesse título abre uma tela com os produtos já conferidos.
{{ :titulonf.png?nolink&300 |}}

{{ :lista_de_produtos.png?nolink&300 |}}

A contagem dos produtos pode ser realizada pela captura do código de barras, quantidade de itens e a validade, de acordo com configurações do ISA e do IC.

{{ :localizar_produto.jpg?nolink&300 |}}


Se faz possível a alteração da quantidade de um produto clicando sobre ele, e inserindo a nova quantidade.

{{ :alterar_quantidade.jpg?nolink&300 |}}


{{ :alterar_quantidade2.png?nolink&300 |}}


**OBSERVAÇÃO: **
-Ao incluir um produto que já consta como coletado, aparecerá uma caixa de dialogo perguntando qual ação o usuário quer tomar: 

-**DESCARTAR** o produto:  a nova coleta será descartada. Mantendo assim intacto o registro do produto realizado na coleta anterior.

-**SUBSTITUIR** o produto: a coleta anterior do produto será descartada.

-**SOMAR** o produto: a nova coleta será somada a coleta anterior.

{{ :alert_dialog_dss.png?nolink&200 |}}


=== Consulta de Código Interno de Produtos ===

Foi incluído no campo do EAN um botão que lista os itens de código interno, definidos no IC. Por eles é possível realizar o lançamento na nota diretamente pela lista.

{{ ::nf_internos.png |}}


{{ ::nf_internos_itens.png |}}

{{ ::nf_internos_qtde.png |}}


==== Ordens de Recebimento ====

A opção de O.R. Exibe a lista de Ordens de Recebimento disponível para o dispositivo. Há um botão para editar e um botão para enviar em cada uma das opções.

{{ :nota_cega.png?nolink&300 |}}

=== Recebimento Cooperativo ===
A partir da versão 1.0.2.1 o app de recebimento de notas permitirá realizar o recebimento de O.R.s em mais de um aparelho simultaneamente.

A nova função é chamada de **Cooperar**.

{{ :btncooperaron.png?300 |}}

O botão do canto superior direito permite que outros usuários visualizem a O.R.

{{ ::cooperaropen.png?300 |}}

Após a ação de abrir para recebimento cooperado, o "proprietário" da O.R. vai exibir a tela de conferência com o botão desabilitado.

Entende-se "proprietário" o aparelho que abrir a O.R. primeiro.

{{ ::btncooperaroff.png?300 |}}

Os dispositivos que estão auxiliando a coleta da O.R. não irão alterar o status do recebimento, e irão apresentar uma mensagem informativa.

{{ ::cooperar_envio2.png?300 |}}

<note warning>É IMPORTANTE QUE OS EQUIPAMENTOS AUXILIÁRES ENVIEM AS COLETAS **ANTES** DO EQUIPAMENTO "PROPRIETÁRIO" PARA QUE A O.R. NÃO ALTERE O STATUS PARA PENDENTE!!</note>

===== Entregas =====

==Download do aplicativo==

O aplicativo está disponível na Play Store. Clique em "Instalar" para que seja instalado no seu dispositivo.
{{ :playstore.png?nolink&300 |}}

Ao iniciar o aplicativo pela primeira vez, uma janela com os termos de uso será exibida. É necessário clicar em "Li e Aceito" para concordar com os termos de uso.

{{ :primeiro_termo_de_uso.png?nolink&300 |}}

Em seguida, uma janela informando que você aceitou os termos de uso será exibida. Clique em "OK" e depois em "Permitir" para autorizar o acesso aos diretórios do dispositivo.
{{ :juntos.png?nolink&300 |}}

O aplicativo estará em modo de demonstração, portanto, é necessário realizar a ativação do aplicativo para acessar todas as funcionalidades disponíveis. Para ativar o aplicativo, selecione o ícone da engrenagem laranja no canto superior direito da tela e, em seguida, insira o endereço IP do servidor do programa ISA.

{{ :ip_juntos.png?nolink |}}

Se a ativação foi bem-sucedida, uma janela aparecerá informando que tudo ocorreu corretamente.

{{ :liberacao_ok.png?nolink&300 |}}

Após essa notificação, é preciso inserir o nome de usuário e senha, e prosseguir para a próxima tela, que é a tela de seleção de veículos. Nesta etapa, você deve escolher o veículo que será usado para as entregas.

{{ :seleciona_veiculo.png?nolink&300 |}}

**Menu Principal:**

Botão **"Abrir Lista**": Ao selecionar este botão, você será direcionado para iniciar a criação do itinerário das entregas. Isso envolve adicionar os cupons que serão carregados pelo entregador.

Botão "**Lista de Entregas**": Nesta opção, você encontrará as entregas que já foram adicionadas ao itinerário. (As informações nesta tela só serão exibidas quando o botão "**__Abrir Lista__**" estiver definido como "**__Confirmar Entregas__**"; este tópico será abordado mais adiante.)

**Enviar Pendentes**: Caso existam entregas que ainda não foram enviadas ao servidor e estão armazenadas no celular, você pode reenviá-las através deste botão.

{{ :menu_opcoes.png?nolink&300 |}}

**ABRIR LISTA:**

Nesta tela, você encontrará o campo onde os cupons adicionados ao itinerário serão exibidos, juntamente com quatro botões:

**Ler Cupom de Entrega**: Utilize esta opção para fazer a leitura do QR code do cupom de entrega.

**Digitar Cupom**: Se não for possível ler o QR code no cupom de entrega, o aplicativo permite que você insira manualmente as informações do cupom.

**Limpar Lista** de Entrega: Este botão apagará todas as entregas adicionadas à lista.

**Pronto para Entrega**: Selecione este botão somente após inserir todos os cupons das entregas na lista, a fim de iniciar a rota de entrega.

{{ :tela_inserir_cupom.png?nolink&300 |}}

Após a inclusão dos cupons de entrega, é essencial clicar no botão **'PRONTO PARA ENTREGA**' para que o usuário retorne ao menu principal.
===== IDENTIFICAÇÃO DE PROBLEMAS =====

Muitas vezes acontece do cliente reclamar que não está havendo comunicação entre a aplicação mobile e a aplicação servidora. Neste caso há um passo a passo para se identificar os possíveis problemas.

Antes de começar, tenha certeza de que a versão da aplicação servidora e do App são as mesmas!!!

  1 - Abra a aplicação servidora e clique na opção servidor para verificar os logs de comunicação.  
  
  2 - Abra o menu Configuração -> Opções e verifique a porta HTTP que está configurada e 
  verifique qual é o ip da máquina em que a aplicação servidora está instalada.
  
  3 - É possível realizar teste de consulta ao serviço do isa pelo navegador do PC. Abra o 
  navegador e coloque o link da consulta (GET): 
    http://<ip>:<porta>/iws/api/TControllerProduto/Ping  
  retorna {"result":[{"CONNECTED":"TRUE"}]} se estiver comunicando
  Consulta de um produto pra gerar log no server:
    http://<ip>:<porta>/iws/api/TControllerProduto/Produto/0000000000001
  retorna um Json com dados do produto.  
  
  4- Se não aparecer nada, verifique se a aplicação servidora está sendo bloqueada 
  pelo firewall, tente usar a opção de "ADD FIREWALL EXCEPTION" em Configurações -> Opções. 
    Pode ser tentado desativar temporariamente o Firewall para fins de testes.
    Pode tentar usar o Telnet para verificar a porta também.
  
  5 - Peça acesso via Anydesk ao celular e verifique se a configuração de IP está 
  apontando para IP:PORTA corretamente.
  
  6 - Verifique se o celular está conectado no WI-FI da rede LAN.
  
  7 - Salve as configurações do celular e verifique na aplicação servidora se há logs 
  de consulta de Liberação e Download de Usuários.
  Se houver log de comunicação, pule para o passo 9.
  
  8 - Verifique se o celular está com um IP da mesma rede em que está o pc da aplicação 
  servidora (Ex. de erro: PC=192.168.0.30 Cel=192.168.1.128). Neste caso pode ser necessário 
  configurar um IP Fixo no celular. (Peça para o responsável de Infraestrutura de Redes 
  do cliente liberar este novo IP Fixo do celular.
  
  9 - Se houver logs de comunicação entre o celular e o servidor (do ISA), verifique a 
  conexão com o banco de dados em Configurações -> Conexão.
    Aqui a configuração é de conexão com o banco de dados do IC! Pode copiar de lá dele o ip.
  
  10 - Se o App abre a tela de login no modo demonstração e no servidor retorna log com LIB:FALSE, 
  verifique o limite de dispositivos permitidos para o cliente.
    Abra o menu Configurações -> Opções e veja se é possível remover algum dispositivo se for o caso de limite.
  
  11 - Se retorna LIB:TRUE e mesmo assim o app entra no modo demonstração, tente reiniciar o app.
  
  12 - Se o problema é etiqueta, abra a plicação servidora e acesse o menu Configurações -> Editar Etiqueta (Atacado).
    Configure os RTMs, verifique a imporessora, o DATA(fonte de dados), salve como arquivo com os 
  nomes respectivos (EtiquetaProduto.rtm e EtiquetaProdutoAtacado.rtm).
    Faça testes configurando a impressora para PDF Printer e faça um Preview. Teste mandando 
  imprimir pelo navegador: http://<ip>:<porta>/iws/api/TControllerProduto/Print/0000000000001.
  
  13 - Verifique se a impressora está devidamente instalada.
  
  14 - Os arquivos não aparecem na pasta correta: Verifique o caminho em Configurações -> Opções.
    Verifique se é uma pasta compartilhada e se usa o IP ao invés do alias da rede, se há permissão 
  para gravação na pasta, se o programa está sendo executado como ADM. 
    
===== Modos de espelhamento da tela =====
Utilize programas que possibilitem o espelhamento da tela do seu smartphone no computador para que os técnicos do suporte possam acessar as funcionalidades do ISA durante o atendimento remoto.

==== Anydesk ====

Para a instalação do aplicativo Anydesk é necessário seguir os seguintes passos:

**1-**Procurar na **Playstore** o aplicativo Anydesk, após encontrá-lo clicar em instalar:

{{ :localizar_na_playstore2.jpg?nolink&300 |}}


**2-**Após a instalação, abrir o aplicativo e clicar **OK**, em todas as telas que aparecerem:

{{ :clicando_em_ok2.jpg?nolink&300 |}}

**3-** Aparecerá uma tela informando que é necessário um **Plugin** para que seja possível o acesso remoto. Clicar em **OK**. Uma nova janela da **Playstore** irá aparecer. Basta clicar em instalar.

{{ :ok_plugin.jpg?nolink&300 |}}

{{ :install_plugin2.jpg?nolink&300 |}}

**4-** Será necessário habilitar o plugin, Para isso basta clicar selecionar Anydesk control service AD1, e depois arrastar o botão de ativação. Logo após clicar em **Permitir** na nova janela que abrirá.

{{ :habilitar_plugin.jpg?nolink&300 |}}


{{ :arrastando_sim.jpg?nolink&300 |}}

{{ :permitir_sim.jpg?nolink&300 |}}

**5-**Volte ao aplicativo Anydesk após esses passos. Uma mensagem de otimização de bateria irá aparecer, selecione Sim. Em seguida será exibido o número para acesso remoto. **Esse número deverá ser informado ao analista!**.

{{ :otimizacao_bateria.jpg?nolink&300 |}}


{{ :numero_do_anydesk.jpg?nolink&300 |}}


**6-** Depois de informado o número ao analista, Será exibido uma mensagem para aceitar o acesso. Clique em **Aceitar**. E em **Perfil de permissão** selecione __**Acesso integral**__. Aceite a solicitação de acesso remoto, e depois clique em **Iniciar**

{{ :aceitar_contato_anydesk.jpg?nolink&300 |}}


{{ :proecao_contra_fraude.jpg?nolink&300 |}}

{{ :acesso_integral.jpg?nolink&300 |}}

{{ :aceitar_contato_final.jpg?nolink&300 |}}

{{ :aceitar_tranmissao.jpg?nolink&300 |}}

















https://fossbytes.com/android-screen-mirroring-apps-pc/

Para os programas que não requerem a instalação de um app no smartphone, o modo de depuração deve ser habilitado no aparelho.

  1- Acesse as configurações;
  2- Acesse a opção SOBRE O DISPOSITIVO;
  3- Localize a informação "Número da versão" e toque 6 vezes rápidamente, ou até que a mensagem "Agora você é um desenvolvedor" apareça.
  
{{ ::android-pie-developer-options.jpg}}
  
{{ :usb-debugging-prompt-allow.jpg}}

**Ativar WebGL mp chrome**
  Ative o WebGL no Google Chrome
  Abra o Google Chrome. Na barra de endereço, digite chrome://flags/e pressione Enter;
  Role para desabilitar WebGL-ativar. 
  Esta opção impede que aplicativos da Web acessem a API WebGL e clique em habilitar.
  Ir para chrome://settings
  Clique no botão Advanced na parte inferior da página;
  Na seção sistema, verifique se a caixa de seleção usar aceleração de hardware quando disponível está marcada.
Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página
