=========
`xMova Android <../doc.html>`_
=========

-----------
Splitted Grid
-----------
``Versão 2.26+``

Esta funcionalidade possibilita agilizar o apontamento de atividades quando no formato produtiva/improdutiva.


**Exemplo da configuração**::

	Boletim sync=out  cleanupDays=1 notSavedMessage
		id inc
		apontamentos List<Apontamento> transient splittedGrid
		apontamentos2 List<Apontamento2> transient splittedGrid splittedGridField=atividade splittedGridTimeout=6s splittedGridFilterField=FLAG_PRODUTIVA splittedGridDisableSpeach
		
	Apontamento sync=out notSavedMessage
		id long uuid
		atividade Atividade
	
	Apontamento2 sync=out notSavedMessage
		id long uuid
		atividade Atividade
		descricao String
	
	ATIVIDADE sync=in favorite searchFields=DESCRICAO descriptionFields=DESCRICAO smallDescriptionField=label
		SEQ_DB long
		DESCRICAO Str
		FLAG_PRODUTIVA boolean
		label String
		server name=Atividade_Mobile


---------
Atributos:
---------

* ``splittedGrid`` : Faz com que a funcionalidade seja usada com os parâmetros padrões
* ``splittedGridField`` : Determina qual o campo deve ser usado para a funcionalida. É mandatório que o campo seja do tipo Entity (Que faça referência a alguma entidade). Caso não for especificado será usado o primeiro campo encontrado que tenha o tipo Entity.
* ``splittedGridTimeout``: Determina por quanto tempo o aplicativo deve aguardar; uma vez clicada na opção, para gerar o apontamento ou que o usuário cancele a opção. Caso não seja informado, o padrão são 3s
* ``splittedGridFilterField``: Determina qual campo deve ser utilizado para realizar o filtro e criar os grids superior e inferior. O campo deve ser do tipo Boolean. Caso não seja declarado é utilizado o primeiro campo com tipo Boolean encontrado. 
* ``splittedGridDisableSpeach``: Usado para desabilitar a ação que faz a leitura da mensagem apresentada antes de realizar o apontamento, na tela de confirmação.
* ``splittedGridDisableConfirmation``: Faz com que a tela de confirmação de apontamento não seja exibida, partindo direto para a criação do apontamento.
* ``smallDescriptionField``: Usado para especificar um campo que será usado para definir o texto que será apresentado no botão do grid.
* ``FixedKeyCommandBack``: Label exibida na opção de voltar. (Padrão: Voltar)

------
Langs :
------

* ``FixedKeyCreatingRecordOf`` : Exibida na tela que informa ao usuário que o apontamento será criado. (SplittedGrid). (Padrão: Registrando apontamento)
* ``CreatingRecordOf``: Lang de campo usada para informar uma mensagem específica para cada campo na tela de criação do apontamento. Exemplo: **CreatingRecordOf.Apontamento.atividade**
* ``FixedKeyCommandEdit``: Label exibida na opção que permite ao usuário realizar edições. (Padrão: Editar)


-----------------------------------
Fotos da Utilização da Funcionalidade:
-----------------------------------

.. figure:: ../images/splittedgrid/1_splittedgrid.png
   :height: 400px
   :width: 240px
   :align: left
   
   Após iniciar o apontamento, será exibida a tela da funcionalidade **Splitted** **Grid** ao usuário que permite efetuar um apontamento de maneira mais rápida


.. figure:: ../images/splittedgrid/2_splittedgrid_enable_edition.png
   :height: 400px
   :width: 240px
   :align: left
   
   É possível alterar os elementos presentes na tela pressionando a opção de edição no menu superior e clicando no botão que deseja alterar o valor. 


.. figure:: ../images/splittedgrid/3_splittedgrid_edition_mode.png
   :height: 400px
   :width: 240px
   :align: left
   
   Após habilitar o modo de edição é possível trocar os valores clicando na posição e escolhendo um novo item na lista. Para remover o valor atribuído a um botão sem atribuir nenhum outro valor é necessário manter pressionado o botão até que a atribuição seja desfeita. Após terminar as edições é preciso clicar no botão OK.


.. figure:: ../images/splittedgrid/4_splittedgrid_record_selected.png
   :height: 400px
   :width: 240px
   :align: left
   
   Quando o usuário selecionar um item no grid o aplicativo irá iniciar o preenchimento do apontamento após aguardar a confirmação do usuário, caso a confirmação não seja desabilitada nos parâmetros.   
   

.. figure:: ../images/splittedgrid/5_splittedgrid_detail.png
   :height: 400px
   :width: 240px
   :align: left
   
   Fora do modo de edição, quando o usuário pressiona um dos itens da grade é possível ver os detalhes do registro que será selecionado quando o botão for pressionado.