Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

No Fluig, é possível movimentar solicitações workflow, a partir de aplicativos móveis. Devido a isso, ao salvar um formulário um formulário no Fluig, automaticamente o formulário o formulário mobile é gerado, de acordo com o mapeamento dos campos do formulário do processo.

Apesar do Fluig dispor da geração automática de formulários, existem diversas particularidades para o desenvolvimento de formulário de formulário mobile. Estas serão tratadas no decorrer deste guia.

...

Recomendações para processos com formulário mobile

...


  • Formulário

...

  • responsivo:

...

  • hoje no mercado existem

...

  • variados tamanhos de telas e resoluções dos dispositivos, por isso qualquer formulário desenvolvido para mobile deve ser responsivo, ou seja, deve se

...

  • adequar a qualquer tamanho de tela.

  • Estética:

...

  • a aparência visual e design do HTML devem ser atraentes para os usuários, conseguimos isso através de CSS, por isso recomendamos a utilização do Fluig

...

  • Style Guide.

  • Usabilidade:

...

  • o formulário deve ser fácil de usar, contendo apenas

...

  • os campos importantes para a tarefa ou processo.

  • Área de clique:

...

  • os elementos do HTML devem estar bem posicionados de forma que facilite a área de clique

...

  • .

...

...

Image Added


  • Posicionamento das ações:

...

  • as ações mais importantes devem estar posicionadas onde o usuário consegue alcançar facilmente, conforme a

...

  • imagem abaixo.


Image Added

Image Removed

...

Image Added


  • Desenvolvimentos: os desenvolvimentos devem ser feitos dentro dos eventos do processo ou de definições

...

  • de formulário na Web, todos os eventos que são aplicados nos formulários Web também são aplicados nos formulários

...

  • mobile. Para mais informações acesse o

...

...

  • o acesso a serviços

...

  • internos pode ser

...

  • feito através de Datasets via xmlRPC. Para mais informações, clique aqui.

  • Acesso a serviços externos:

...

  • recomendamos a utilização de Datasets para acessar serviços externos,

...

  • esses Datasets são acessados no mobile via xmlRPC conforme descrito acima.

  • Nem todas informações precisam estar

...

  • no formulário mobile: o grande limitador do

...

  • mobile é o tamanho de tela do dispositivo, por isso mapeie os campos que são mais importantes para que tenham prioridade

...

  • no formulário. Existem campos que são

...

  • de teor informativo e sem grande utilidade no processo ou tarefas, estes não precisam ser inclusos

...

  • no formulário mobile.

  • Consultas aos

...

  • datasets via Javascript em eventos para validação de formulários:

...

  • não é recomendada a consulta em Datasets dentro dos eventos beforeMovementOptions e beforeSendValidate, pois cada requisição gera uma atividade assíncrona, cujo tempo de retorno pode interferir na lógica de validação definida.

  • Carregamento inicial do formulário dentro de Javascript:

...

  • dependendo da plataforma e da versão do sistema operacional, o tempo e a ordem de carregamento do formulário a partir de um .js pode resultar em um comportamento diferente do planejado.


Deck of Cards
effectDuration0.

...

5
historyfalse
idsamples
effectTypeslide
Card
id1
labelCódigo que deve ser evitado

...

Bloco de código
languagejs
$(document).ready(function() { metodoDeCarregamento(); } //código presente em arquivo .js que será executado em tempo de carregamento (load) do mesmo e não do formulário.
Card
id2
labelComo sugestão

...

utilize
  • Incluir a função metodoDeCarregamento() dentro de um timeout:
Bloco de código
languagejs
setTimeout(function() { metodoDeCarregamento(); }, 1);

...


  • Usar o método dentro do evento onload:

...

Bloco de código
languagexml
<body onload=metodoDeCarregamento()>
  • Formulários offline:

...

  • para a plataforma Android, o serviço da API pública /public/ecm/dataset/search não carregará os dados em modo offline, quando a requisição for realizada através do método POST.

  • Eventos de teclado na plataforma Android:

...

  • o evento onkeypress, atribuído para campos HTML, não é detectado pelo teclado da plataforma Android. Recomendamos utilizar o evento oninput e realizar os tratamentos necessários na chamada desse evento.


  • A tag <input> possui a capacidade de suportar diferentes tipos de dados, dessa forma, como boa prática quando a mesma for utilizada, o atributo type deve ser definido, por exemplo:   
Bloco de código
languagejs
<input type="text" id="idCampo" name="campoTxt">

                                                                                                                                                                                                                  

Tipos: Definições de

...

formulário mobile suporta os tipos abaixo:

  • text
  • textArea
  • radio
  • select
  • combobox
  • checkbox.
  • email (3)
  • tel (3)
  • range (3)
  • date (3)
  • time (1)(3)
  • week (2)(3)
  • number
  • hidden
  • password
Painel
borderColor#f2f2f2
bgColor#f2f2f2

(1) Existe um bug no Android Lollipop (5.0) que inviabiliza o uso do tipo time. Para mais informações, clique aqui

...

;

(2) O campo week

...

não é suportado

...

pelo iOS;

(3) Existe um bug no Android Jelly Bean (4.1, 4.2 e 4.3) que inviabiliza o uso do tipo select. Para mais informações, clique aquiaqui e aqui. Como medida de correção, a sugestão é utilizar o componente de Zoom: Desenvolvimento de Formulários - Zoom.

Nota
titleAtenção

Não está homologada a implementação de evento que utilizem Gestures (swipe, longpress, tap, entre outros) em formulário no Fluig Mobile.

...

Porque devo usar formulários no Mobilemobile?

  • Permite iniciar/movimentar solicitações de qualquer dispositivo móvel, independente de sua localização geográfica.;
  • Acesso rápido as informações, mostrando apenas as informações mais relevantes.;
  • Permite a continuidade do processo, mesmo fora do ambiente empresarial.;
  • Através do recurso "Processo Off-line" consigo é possível preencher informações mesmo sem acesso a internet, para futura sincronização.


Criando um formulário

...

mobile

...

Notainfo
titleAtenção!Informações

Ao realizar customizações, atente-se para que a renderização seja feita de forma correta em navegadores mobile. A customização deve estar compatível com o Safari para iOS e Chrome para Android. 

Versões mínimas de cada plataforma que devem ser consideradas durante o desenvolvimento

Versão mínima de cada plataformaVersão mínima de cada browser
Android 4.0 (Ice Cream Sandwich)Webkit 534.30
iOS 7Mobile Safari 9537.53

No Fluig é possível criar definições de formulários de diferentes maneiras, utilizando o Fluig Studio, através da modelagem de processos workflow ou através de upload de formulário na navegação de documentos.

Acompanhe a seguir, movimentando-se pelas abas abaixo, as formas de criação de formulários:

...

effectDuration0.5
historyfalse
idinstall-windows
effectTypefade
Card
defaulttrue
id1
labelFluig Studio
titleSelecione a linguagem

Fluig Studio

Para incluir um novo formulário com suporte a dispositivos móveis, desenvolva um único formulário que atenda todos requisitos para o funcionamento na web e mobile, e realize o procedimento padrão para exportação de formulário.

...

id2
labelFormulário Mobile em Processos
titleTermo de uso

Configuração de Formulário Mobile em Processos

É possível permitir a criação do Formulário Mobile também através do Gerador de Formulário, conforme passo a seguir:

Passo 1: Criar ou editar um processo existente e acionar o item Formulário.

Image Removed

Passo 2: Selecionar a pasta destino onde esse formulário será publicada, também atribua um título e descrição. Após isso, clique em Criar Formulário.

Image Removed

Passo 3:  Inclua os campos e em cada um deles, selecione se este será também adicionado ao formulário para dispositivos móveis, clicando na opção Formulário Mobile?.

Image Removed

Informações
iconfalse
titleInformação

Nem todos os campos mapeados no formulário do processo, podem ser mapeados para o formulário para dispositivos móveis. Os campos que podem ser mapeados exibem a opção "Formulário Mobile?".

criar formulários para dispositivos móveis, é importante adotar algumas diretrizes para assegurar uma experiência eficaz para o usuário e garantir que a disposição dos campos e botões não comprometa a usabilidade. Nesse sentido:

  • Evite posicionar os botões personalizados do formulário em áreas que concorram com o espaço reservado para o botão flutuante, geralmente utilizado ao acessar um processo ou tarefa. Isso visa garantir que os usuários não enfrentem dificuldades ao inserir dados no formulário.
  • Garanta que os botões e campos do formulário sejam adaptáveis a diferentes tamanhos de tela e orientações, proporcionando uma experiência consistente em diversos dispositivos.
  • Evite sobrecarregar a tela com múltiplos botões inferiores no formulário, dando prioridade à ação principal associada ao botão flutuante. Isso simplifica a interação do usuário, focando na funcionalidade mais relevante.
Nota
titleAtenção!

Ao realizar customizações, atente-se para que a renderização seja feita de forma correta em navegadores mobile. A customização deve estar compatível com o Safari para iOS e Chrome para Android. 

Versões mínimas de cada plataforma que devem ser consideradas durante o desenvolvimento

Versão mínima de cada plataformaVersão mínima de cada browser
Android 4.0 (Ice Cream Sandwich)Webkit 534.30
iOS 7Mobile Safari 9537.53


No Fluig é possível criar definições de formulários de diferentes maneiras, utilizando o Fluig Studio, através da modelagem de processos workflow ou através de upload de formulário na navegação de documentos.

Acompanhe a seguir, movimentando-se pelas abas abaixo, as formas de criação de formulários:

Nota
titleAtenção!

Formulários de processos que possuem versões em rascunho não são carregados quando o usuário está offline (sem conexão com a internet). Somente informações do rascunho do processo são apresentadas.

Deck of Cards
effectDuration0.5
historyfalse
idinstall-windows
effectTypefade
Card
defaulttrue
id1
labelFluig Studio
titleSelecione a linguagem

Fluig Studio

Para incluir um novo formulário com suporte a dispositivos móveis, desenvolva um único formulário que atenda todos requisitos para o funcionamento na web e mobile, e realize o procedimento padrão para exportação de formulário.

Card
id2
labelFormulário mobile em processos
titleTermo de uso

Configuração de formulário mobile em processos

É possível permitir a criação do Formulário mobile também através do Gerador de Formulário, conforme os passos abaixo:


01. Crie ou edite um processo existente e acionar o item Formulário;

Image Added


02. Selecione a pasta destino onde o formulário será publicado, também atribua um título e descrição. Após isso, clique em Criar Formulário;


Image Added


03.  Inclua os campos e em cada um deles, selecione se este será também adicionado ao formulário para dispositivos móveis, clicando na opção Formulário Mobile?.


Image Added


Informações
iconfalse
titleInformação

Nem todos os campos mapeados no formulário do processo podem ser mapeados para o formulário em dispositivos m´oveis. Os campos que podem ser mapeados exibem a opção Formulário mobile?

Card
id3
labelUpload via navegação de documentos
titleInstalação do fluig

Upload via navegação de documentos

No upload via navegação de documentos é feito uma publicação de um formulário único, que deve atender os requisitos de funcionamento para web e mobile.


Image Added

Nota
titleAtenção

As definições de formulários geradas pelos métodos de criação acima elencados, precisam ser editados e caso necessite de algum desenvolvimento especial, eles são gerados automaticamente contendo os itens básicos para seu funcionamento.

Nota
titleAtenção

Ao contrário da web, o comportamento da função setHidePrintLink no mobile não esconde o botão de impressão. Mas também não permite que o usuário efetue a impressão do formulário.


Carregando dados do dataset em modo offline

...

Para realizar o carregamento dos dados do dataset em modo offline no formulário do processo, é necessário relacionar o dataset ao campo zoom faz uso durante o modo offline. Acompanhe a seguir, o procedimento para configuração do carregamento:


Deck of Cards
id1
Card
labelLocalizar o formulário

Localizar o formulário

01. Dentro do ECM, localize o formulário que está sendo utilizado no processo e em seguida acione Propriedades.

Image Added

...

id3
labelUpload via Navegação de Documentos
titleInstalação do fluig

Upload via Navegação de Documentos

No upload via navegação de documentos é feito com uma publicação de um formulário único, que deve atender os requisitos de funcionamento para web e Mobile.

Image Removed

Nota
titleAtenção

As Definições de Formulários geradas pelos métodos de criação acima elencados, precisam ser editados caso necessite de algum desenvolvimento especial, eles são gerados automaticamente contendo os itens básicos para seu funcionamento.

Nota
titleAtenção!

Ao contrário da web, o comportamento da função setHidePrintLink no mobile não esconde o botão de impressão. Mas também não permite que o usuário efetue a impressão do formulário.

Carregando dados do dataset em modo offline

Para realizar o carregamento dos dados do dataset em modo offline no formulário do processo, é necessário relacionar o dataset o qual o campo zoom faz uso durante o modo offline. Acompanhe a seguir, o procedimento para configuração do carregamento:

Deck of Cards
id1
Card
labelLocalizar o formulário

Localizar o formulário

Dentro do ECM, localizar o formulário que está sendo utilizado no processo e em seguida acionar Propriedades. Image Removed

Card
labelDatasets do Formulário

Datasets do Formulárioformulário

02. Após acionar as clicar nas propriedades do formulário, navegue até a aba Datasets do Formulário” e  e relacione o dataset o ao qual está sendo utilizado no campo zoom. Image Removed


Image Added

Nota
titleAtenção

Após definir as configurações, é necessário efetuar a limpeza de cache do no aplicativo e realizar uma nova consulta.

Dica

Acesse nossa documentação e saiba mais sobre como Habilitar dataset offline no mobile.


Desenvolvimento de formulário

...

mobile

...

Com a inclusão de formulários que suportem a visualização em dispositivos móveis, é possível movimentar solicitações Workflow workflow e realizar o preenchimento das informações de formulários com maior mobilidade e agilidade.

Pai Filho e Zoom para dispositivos móveis

A partir do TOTVS Fluig Plataforma 1.5.2 (server), temos uma nova técnica para utilização de Pai e Filho e Zoom que vai facilitar em muito o desenvolvimento sobre nossa plataforma. Usando o Fluig Style Guide tudo ficará mais responsivo e esses dois componentes se adequam a web e ao mobile.

Image RemovedImage Removed

Comece a usar hoje mesmo lendo detalhes na nossa documentação: Desenvolvimento de Formulários - Zoom e Desenvolvimento de Formulários - Pai x Filho.
 

Nota
titleAtenção
  • O Fluig dispõe de um serviço nativo para consumo de dados de datasets no componente de zoom. Não é permitido o uso de serviços personalizados para este componente.
  • Procure utilizar um número limitado de campos em componentes de Zoom para que se adequem melhor ao tamanho de tela. A utilização de um grande número de campos, ou do zoom dentro outros componentes, pode comprometer a visualização dos dados.
Nota
titleAtenção - Trabalhando com tabelas
  • Não é recomendada a utilização de underscore - "___" - na propriedade name de uma coluna (tag <td>) em formulário que utilizem Pai x Filho pois não é renderizada no Mobile.

Insira anexos da solicitação diretamente do formulário

Há uma maneira bem simples para salvar anexos upload através de um botão no formulário. Para isso é necessário inserir no evento onclick do button o método showCamera:

Nota
titleAtenção!

Não recomendamos o troca do nome da função para o método showCamera no IOS pois isso fará com que o método não funcione.

Bloco de código
languagexml
<input type="button" value="Insira Foto" onclick="showCamera('Nome do arquivo em anexo');"/>
 
<script language="javascript">
          
          function showCamera(param) {
              JSInterface.showCamera(param);
          }
</script>

O parâmetro passado na função JSinterface.showCamera é uma String e corresponde ao nome do anexo que será salvo na listagem de anexos daquela solicitação.

Nota
titleImportante

No Fluig mobile somente imagens podem ser adicionadas como anexo. É possível escolher uma imagem da galeria ou ainda tirar uma foto usando a câmera.

...

titleA partir da atualização 1.5.5

Ao implementar o método JSinterface.showCamera, esta técnica também é aplicada na plataforma web. Acessando a plataforma Fluig pelo navegador, ao clicar em um botão utilizando o recurso você será direcionado para a aba Anexos e uma janela exibida para a seleção dos arquivos.

Acessando a aba de anexos será possível realizar o upload de apenas um arquivo por vez; Tentar selecionar mais que um causará erro.

Image Removed

Desabilite o evento Pull to refresh do componente nativo

Há uma maneira bem simples para desabilitar o evento de Pull to refresh responsável por atualizar os dados do formulário. Para isso é necessário inserir o método disablePullToRefresh:

Bloco de código
languagexml
<script language="javascript">
    function disablePullToRefresh(){
        return true;
    }
</script>

Como identificar que estou usando o Mobile nos eventos?

Com esse recurso é possível aplicar um desenvolvimento e/ou restrição somente no Formulário Mobile, independente da Web. Assim posso definir que um processo ou atividade vai receber um valor diferenciado ou que determinada atividade não pode ser executada pelo Mobile via desenvolvimento.

Existe duas formas de fazer tal desenvolvimento:

...

  • AfterProcessing
  • AfterSaveNew
  • BeforeProcessing
  • DisplayFields
  • EnableFields
  • InputFields
  • ValidadeForm

...

Bloco de código
languagejavascript
function displayFields(form, customHTML) {
   if ( form.getMobile() != null && form.getMobile()) {
     form.setValue('mtr_usuario', new java.lang.Integer(123456));
   }
}

Eventos do Processo

...

Nota
titleImportante

 Os eventos "beforeMovementOptions" e "beforeSendValidate" serão executados no dispositivo mobile antes mesmo de serem enviados para o servidor.

Para mais informações sobre estes eventos acesse a página Desenvolvimento de Workflow - Eventos para validação de formulário.

...


Funções mobile

...

getAttachments

É uma função que retorna uma Promise com a lista dos anexos do formulário.  Funciona de forma offline.

No exemplo abaixo foi utilizado um await para aguardar a lista dos arquivos que pode ser vazia, caso não haja anexos.

Bloco de código
languagejs
titleChamada no JS
var listaArquivos = await JSInterface.getAttachments();

O objeto retorna sempre um json que é uma lista de arquivos. Cada arquivo pode ou não ter os dados, conforme abaixo:


Bloco de código
languagejs
themeEclipse
linenumberstrue
 [{
    "documentId": 4917,
    "version": 1000,
    "createDate": 1713872206178,
    "newAttach": false,
    "size": 1.2485828,
    "fileName": "file.pdf",
    "description": "file.pdf",
    "streamControlUrl": "" //Pode ser http ou caminho do arquivo /folder/file.pdf
  }]
Painel
borderColor#f2f2f2
bgColor#f2f2f2

Caso não tenha a informação no arquivo anexado, o valor será null por padrão.


Exemplo de chamada no JS de forma async:

Bloco de código
languagejs
async function getFiles() {  
    var listFiles = await JSInterface.getAttachments();
    
} 


beforeValidateAttachments

...

Este evento acontece ao clicar em "enviar" no navegador antes de abrir a tela de movimentação. Por isso, esse código deve ser implementado em um arquivo javascript vinculado ao formulário html. Ele recebe um parâmetro que é a lista de todos os anexos que estão vinculados no formulário e é muito útil para algumas validações antes mesmo de ser enviado para o servidor. 


Bloco de código
languagejs
var beforeValidateAttachments = function (listFiles) {
	if (listFiles.length == 0) {
		throw 'Necessário incluir um anexo.';
	}

}
  • Os dados sempre serão uma lista de arquivos com os valores:
Bloco de código
languagepowershell
themeEclipse
linenumberstrue
 [{
    "documentId": 0, //0 caso for novo anexo
    "version": 0, //0 caso for novo anexo
    "createDate": null,
    "newAttach": true, //true para novo anexo
    "size": 1.2485828, // tamanho do arquivo em MB
    "fileName": "file.pdf",
    "description": "file.pdf",
    "streamControlUrl": "" //Pode ser http ou caminho do arquivo /folder/file.pdf
  }]


Pai x Filho e Zoom para dispositivos móveis

...

A partir do TOTVS Fluig Plataforma 1.5.2 (server), temos uma técnica para utilização de Pai e Filho e Zoom que facilita o desenvolvimento sobre a plataforma. Usando o Fluig Style Guide tudo ficará mais responsivo e esses dois componentes se adequam a web e ao mobile.

Image AddedImage Added

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Leia mais detalhes na nossa documentação: Desenvolvimento de Formulários - Zoom e Desenvolvimento de Formulários - Pai x Filho.



Nota
titleAtenção
  • O Fluig dispõe de um serviço nativo para consumo de dados de datasets no componente de zoom. Não é permitido o uso de serviços personalizados para este componente.
  • Procure utilizar um número limitado de campos em componentes de Zoom para que se adequem melhor ao tamanho de tela. A utilização de um grande número de campos, ou do zoom dentro outros componentes, pode comprometer a visualização dos dados.
Nota
titleAtenção - Trabalhando com tabelas
  • Não é recomendada a utilização de underscore - "___" - na propriedade name de uma coluna (tag <td>) em formulários que utilizem Pai x Filho pois a mesma não é renderizada no mobile.


Insira anexos da solicitação diretamente do formulário

...

Há uma maneira bem simples para salvar anexos upload através de um botão no formulário. Para isso é necessário inserir no evento onclick do button o método showCamera:

Nota
titleAtenção

Não é recomendada a troca do nome da função para o método showCamera no iOS. Isso faz com que o método não funcione conforme o esperado. 

Bloco de código
languagexml
<input type="button" value="Insira Foto" onclick="showCamera('Nome do arquivo em anexo');"/>
 
<script language="javascript">
          
          function showCamera(param) {
              JSInterface.showCamera(param);
          }
</script>


O parâmetro passado na função JSinterface.showCamera é uma String e corresponde ao nome do anexo que será salvo na listagem de anexos daquela solicitação.

Nota
titleImportante

No My Fluig somente imagens podem ser adicionadas como anexo. É possível escolher uma imagem da galeria ou ainda tirar uma foto usando a câmera.

Informações
titleA partir da atualização 1.5.5

O método JSinterface.showCamera, também é aplicado na plataforma web. Acessando o Fluig Plataforma pelo navegador, ao clicar em um botão utilizando o recurso você será direcionado para a aba Anexos e uma janela será exibida para a seleção dos arquivos.

Acessando a aba de Anexos será possível realizar o upload de apenas um arquivo por vez.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Tentar selecionar mais que um causará erro.


Image Added


Desabilite o evento Pull to refresh do componente nativo

...

Há uma maneira bem simples para desabilitar o evento de Pull to refresh responsável por atualizar os dados do formulário. Para isso é necessário inserir o método disablePullToRefresh:

Bloco de código
languagexml
<script language="javascript">
    function disablePullToRefresh(){
        return true;
    }
</script>

Como identificar se estou usando o mobile nos eventos?

...

Com esse recurso é possível aplicar um desenvolvimento e/ou restrição somente no formulário mobile, independente da Web. Assim posso definir que um processo ou atividade vai receber um valor diferenciado ou que determinada atividade não pode ser executada pelo mobile via desenvolvimento.

Existe duas formas de fazer tal desenvolvimento:


Eventos do Formulário

...

Todos os eventos que recebem no método o form podem fazer um desenvolvimento exclusivo para o formulário mobile:

  • AfterProcessing
  • AfterSaveNew
  • BeforeProcessing
  • DisplayFields
  • EnableFields
  • InputFields
  • ValidadeForm

Para utilizar o evento é necessário fazer a seguinte chamada: form.getMobile(), onde retornará um booleano indicando se é um formulário mobile ou não. Exemplo:


Bloco de código
languagejavascript
function displayFields(form, customHTML) {
   if ( form.getMobile() != null && form.getMobile()) {
     form.setValue('mtr_usuario', new java.lang.Integer(123456));
   }
}


Eventos do Processo

  • beforeMovementOptions
  • beforeSendValidate

Nota
titleImportante

 Os eventos "beforeMovementOptions" e "beforeSendValidate" serão executados no dispositivo mobile antes mesmo de serem enviados para o servidor.

Para mais informações sobre estes eventos acesse a página Desenvolvimento de Workflow.


Nos eventos de processo, a propriedade WKMobile identifica se a ação foi realizada pelo dispositivo móvel. Ela pode ser utilizada nos eventos do processo conforme exemplo:

...

languagejavascript
Bloco de código
languagejavascript
function beforeStateEntry(sequenceId){
	var isMobile = getValue("WKMobile");
	if (isMobile!=null && isMobile==true){ 
		throw "Esse processo não pode ser executado pelo mobile."; 
	}
}


Consumo de Datasets via xmlRPC

...

O acesso de datasets pelo

...

mobile é realizado com o xmlPRC, desse modo é possível trocar de informações com Fluig via AJAX.

...

Para utiliza-lo, basta acionar as seguintes importações no HTML do formulário:


Bloco de código
languagejavascript
<script src="../vcXMLRPC.js"></script>
<script src="http://URL_DO_SERVIDOR/portal/resources/js/jquery/jquery.js"></script>


O acesso aos Datasets é igual à Webweb, a seguir são apresentados alguns exemplos:


1) Datasets internos Fluig:


Este este tipo de Dataset permite navegar em dados das entidades do próprio Fluig plataformaPlataforma, como usuários, grupos, processos ou tarefas por exemplo. Esses datasets são pré-definidos, por isso não podem ser alterados pelo usuário. A lista com os datasets disponíveis pode ser consultada aqui.


Bloco de código
languagejs
linenumberstrue
var filter = new Object();
filter["colleaguePK.colleagueId"] = "john"; 
var colleagues = DatasetFactory.getDatasetValues("colleague", filter);
if(colleagues.length > 0){       
	document.getElementById("colleagueName").value = colleagues[0].colleagueName;
	document.getElementById("login").value = colleagues[0].login;
}else{
	alert("Nenhum Usuário Encontrado");
}
Atenção
Painel
borderColor#f2f2f2
bgColor#f2f2f2


Para atualizações anteriores ao TOTVS Fluig Plataforma 1.5.6, substituir a linha 3 por:

Bloco de código
languagejavascript
var colleagues = getDatasetValues("colleague", filter);


2) Datasets internos formulário:


Este este tipo de Dataset permite navegar nos dados existentes em formulários de uma determinada definição de formulário publicada no Fluig. Para que uma definição de formulário seja disponibilizada como Dataset,  é é necessário preencher o campo Nome Dataset na publicação da definição de formulário. O

valor informado será utilizado para a busca do Dataset no Fluig;


Bloco de código
languagejavascript
var c1 = DatasetFactory.createConstraint("cod_area", "2", "2", ConstraintType.MUST); 
var constraints = new Array(c1);
			
var area = DatasetFactory.getDataset("areas", null, constraints, null);
			
if(area.values.length){
	document.getElementById("cod_area").value = area.values[0].cod_area;
	document.getElementById("area").value = area.values[0].area;
}else{
	alert("Area não encontrada") ;
}
info
Painel
borderColor#f2f2f2
bgColor#f2f2f2

Para fazer o download de um exemplo de formulário utilizando xmlPRC clique aqui.


3) Chamadas assíncronas:


 A partir do TOTVS Fluig Plataforma 1.5.6, você também pode é possível realizar chamadas assíncronas:


Bloco de código
languagejavascript
var filter = new Object();
filter["colleaguePK.colleagueId"] = "john"; 
var colleagues = DatasetFactory.getDatasetValues("colleague", filter,
{ success: function(colleagues) {
	if(colleagues.length > 0){       
		document.getElementById("colleagueName").value = colleagues[0].colleagueName;
		document.getElementById("login").value = colleagues[0].login;
	}else{
		alert("Nenhum Usuário Encontrado");
	}
}, error: function(jqXHR, textStatus, errorThrown) {}
});
Bloco de código
languagejavascript
DatasetFactory.getDataset("areas", null, constraints, null, { 
	success: function(area) {
		if(area.values.length){
			document.getElementById("cod_area").value = area.values[0].cod_area;
			document.getElementById("area").value = area.values[0].area;
		}else{
			alert("Area não encontrada") ;
		}
	}
}, error: function(jqXHR, textStatus, errorThrown) {}
);
Deck of Cards
idsample
Nota
titleImportante!
  • A geolocalização funciona apenas em ambientes https. Em ambientes http o navegador não permite informar a geolocalização. 
  • Essa técnica pode ser aplicada em Android quanto em iOS.
Card
id1
labelGeolocalização em formulários


Para utilizar a Geolocalização geolocalização em formulários é bem simples, basta incluir esse script no html:


Bloco de código
languagejavascript
function getLocation()
    {
        if (navigator.geolocation)
        {
        navigator.geolocation.getCurrentPosition(showPosition,showError);
		
        }
    }

    function showPosition(position)
    {
        var latlon=position.coords.latitude+","+position.coords.longitude;


        var img_url="http://maps.googleapis.com/maps/api/staticmap?center="
        +latlon+"&zoom=14&size=300x200&sensor=false";
        document.getElementById("map").innerHTML="<img src='"+img_url+"'>";
		
		var lat = position.coords.latitude;
		var longi = position.coords.longitude;
		document.getElementById("latitude").value = lat;
		document.getElementById("longitude").value = longi;
    }

    function showError(error)
    {
        switch(error.code) 
        {
        case error.PERMISSION_DENIED:
          doc.innerHTML="Pedido de Geolocalização negado pelo usuário."
          break;
        case error.POSITION_UNAVAILABLE:
          doc.innerHTML="Informação de localização não está disponível."
          break;
        case error.TIMEOUT:
          doc.innerHTML="Solicitação de localização não retornou em tempo hábil (timeout)."
          break;
        case error.UNKNOWN_ERROR:
          doc.innerHTML="Erro desconhecido."
          break;
        }
    }
Card
id2
labelGeolocalização em páginas


Para utilizar a Geolocalização geolocalização em páginas, processos e na home é bem simples, basta incluir esse script no html:


Bloco de código
languagejavascript
function getLocation()
    { getLocation()
    {
        if (navigator.geolocation)
        {         
        navigator.geolocation.getCurrentPosition(showPosition, showError, { timeout: 10000 });            
}
    }

    iffunction showPosition(navigator.geolocationposition)
    {
    {         var latlon=position.coords.latitude+","+position.coords.longitude;


        navigator.geolocation.getCurrentPosition(showPosition, showError, { timeout: 10000 });            
}var img_url="http://maps.googleapis.com/maps/api/staticmap?center="
        +latlon+"&zoom=14&size=300x200&sensor=false";
    }

    function showPosition(position)
    {
        var latlon=position.coords.latitude+","+document.getElementById("map").innerHTML="<img src='"+img_url+"'>";
		
		var lat = position.coords.latitude;
		var longi = position.coords.longitude;


        var img_url="http://maps.googleapis.com/maps/api/staticmap?center="
        +latlon+"&zoom=14&size=300x200&sensor=false";		document.getElementById("latitude").value = lat;
		document.getElementById("longitude").value = longi;
    }

    function showError(error)
    {
        document.getElementById("map").innerHTML="<img src='"+img_url+"'>";
		
		var lat = position.coords.latitude;
		var longi = position.coords.longitude;
		document.getElementById("latitude").value = lat;
		document.getElementById("longitude").value = longiswitch(error.code) 
        {
        case error.PERMISSION_DENIED:
          doc.innerHTML="Pedido de Geolocalização negado pelo usuário."
          break;
    }

    functioncase showError(error)
error.POSITION_UNAVAILABLE:
      {
    doc.innerHTML="Informação de localização não está switch(error.code) 
disponível."
          {break;
        case error.PERMISSION_DENIEDTIMEOUT:
          doc.innerHTML="PedidoSolicitação de Geolocalização negado pelo usuário localização não retornou em tempo hábil (timeout)."
          break;
        case error.POSITIONUNKNOWN_UNAVAILABLEERROR:
          doc.innerHTML="Informação de localização não está disponívelErro desconhecido."
          break;
        }
        case error.TIMEOUT:
          doc.innerHTML="Solicitação de localização não retornou em tempo hábil (timeout)."
          break;
        case error.UNKNOWN_ERROR:
          doc.innerHTML="Erro desconhecido."
          break;
        }
    }
  • Para baixar um exemplo de formulário com geolocalização clique aqui.
Informações

Veja o exemplo (form-mobile-waze) em nosso repositório aqui.

Nota
titleImportante
Esta técnica só funciona em ambiente HTTPS a partir do Android 6.0 e iOS 10.
    }



Dica
titleDica

Para baixar um exemplo de formulário com geolocalização clique aqui.



Informações

Veja o exemplo (form-mobile-waze) em nosso repositório aqui.

Nota
titleImportante
Esta técnica funciona apenas em ambiente HTTPS a partir do Android 6.0 e iOS 10.


Explorando o input file no mobile

...

É possível manipular arquivos diretamente do formulário mobile através do input file, onde no aplicativo mobile é possível acessar arquivos do dispositivo ou incluir uma imagem diretamente da câmera. Importante observar que ao escolher um ou mais arquivos através desse componente, esses arquivos

não serão anexados à solicitação em questão, uma vez que essa funcionalidade é exclusiva do recurso showCamera descrito nessa documentação.

Bloco de código
titleExemplo de implementação
<input type="file" id="btUpload" name="btUpload" title="Arquivos" accept="image/*" class="btn btn-primary" multiple>

Um ponto para observar é que, ao realizar o upload direto da câmera, não é possível adicionar várias fotos simultaneamente, mesmo quando o parâmetro 'multiple' é especificado, sendo este um comportamento do próprio sistema operacional. O cenário de múltiplo upload pode ser realizado acessando os

arquivos já existentes do dispositivo.

Deck of Cards
historyfalse
idsamples
Card
id1
labelVeja o recurso na prática

Image Added

Formulário único

...

A partir da atualização 1.5 do Fluig Plataforma os formulários da web e do mobile devem ser criados de forma única. Sendo assim, o formulário deve atender tanto o mobile quanto a web.

...

  1. Download de anexos: este procedimento será automático, porém apenas os anexos do formulário são baixados.  
  2. Download de anexos em processos offline: durante o download dos processos offline os anexos do formulário são baixados e estarão disponíveis para utilização de maneira offline.
Importante
Nota
titleImportante
title
  • Para o funcionamento de anexos do formulário, o caminho dos arquivos devem ser relativos e não podem ser externos.
Nota
  • No sistema operacional Android não é recomendado carregar anexos do formulário via requisições como XMLHttpRequest. O carregamento do conteúdo de arquivos via caminhos relativos já é suficiente.
Dica
titleDica!

Recomendamos a leitura da documentação Eventos de formulários na seção das funções getAttachments e sendAttachments. Referentes ao retorno e envio das informações dos anexos.


Guia de estilos off-line

...

Agora é possível utilizar o guia de estilos em modo off-line sem a necessidade de qualquer conexão a internet, ficou bem mais fácil e independente personalizar seu formulário para processo off-line. Uma vez ao dia o Fluig Mobile ira verificar novas atualizações, caso alguma atualização esteja disponível, o download da mesma será feita automaticamente de forma rápida e transparente, sem precisar se atentar a formas manuais e demoradas para atualização. O guia de estilos off-line está disponível tanto para Android como para IOS. 


...