IBM TRIRIGA Anywhere Versão 10 Release 4.2. Configurando apps móveis IBM

Transcrição

1 IBM TRIRIGA Anywhere Versão 10 Release 4.2 Configurando apps móveis IBM

2 Nota Antes de usar essas informações e o produto suportado, leia as informações em Avisos na página 15. Esta edição aplica-se à versão 10, liberação 4, modificação 2 do IBM TRIRIGA Anywhere e a todas as liberações e modificações subsequentes, até que seja indicado de outra forma em novas edições. Copyright IBM Corporation 2014, 2015.

3 Índice Customizando aplicativos móveis IBM TRIRIGA Anywhere Ambiente de desenvolvimento do MobileFirst Studio 1 Criando e modificando campos em aplicativos móveis Alterando rótulos de campo Reorganizando campos em um aplicativo móvel. 2 Incluindo campos em aplicativos móveis Incluindo listas de valores como consultas nos campos Incluindo registros relacionados aos aplicativos móveis Organizando o layout de telas móveis Arquivos de modelo de layout Alterando o layout de campos nas visualizações de lista Customizando arquivos javascript para aplicativos móveis Criando campos condicional em aplicativos.. 12 Criando campos condicionais somente leitura.. 14 Avisos Considerações da Política de Privacidade Marcas comerciais Índice Remissivo Copyright IBM Corp. 2014, 2015 iii

4 iv Configurando apps móveis

5 Customizando aplicativos móveis IBM TRIRIGA Anywhere É possível modificar a interface com o usuário dos aplicativos móveis IBM TRIRIGA Anywhere, como por exemplo, alterando rótulos de campo, incluindo campos ou incluindo visualizações, atualizando os arquivos de artefato de aplicativo para o aplicativo no IBM MobileFirst Platform Studio. Ambiente de desenvolvimento do MobileFirst Studio O MobileFirst Studio é um ambiente de desenvolvimento integrado baseado no Eclipse, que é possível implementar com o IBM TRIRIGA Anywhere. Use o MobileFirst Studio para configurar e testar os aplicativos IBM TRIRIGA Anywhere e gerenciar o processo de construção e implementação. Configure o aplicativo móvel editando a definição do aplicativo, o arquivo app.xml, no editor XML no MobileFirst Studio. Usando a guia Design no editor XML, é possível localizar facilmente os elementos no arquivo e alterar ou incluir no conteúdo. Ao salvar suas mudanças, o aplicativo é construído automaticamente e você poderá testar suas mudanças. Em seguida, é possível implementar os aplicativos atualizados no servidor. Cada elemento na definição do aplicativo requer um ID. Quando você tiver preenchido o campo de ID, essa customização da definição do aplicativo será preservada durante qualquer upgrade. Antes de implementar os aplicativos móveis no ambiente de produção, é possível visualizar e testar todas as atualizações nos aplicativos móveis no simulador de navegador remoto. Você deve selecionar Google Chrome como o seu navegador da web externo a ser visualizado no simulador de navegador remoto. Para visualizar suas mudanças, clique com o botão direito na pasta de aplicativos e selecione Executar como > Visualizar. Informações relacionadas: Instalando um ambiente de desenvolvimento Testando Aplicativos Implementando aplicativos com o MobileFirst Studio Visão geral do Worklight Studio Criando e modificando campos em aplicativos móveis Para desenvolver um aplicativo móvel IBM TRIRIGA Anywhere, é possível incluir campos nos aplicativos móveis, renomear campos e visualizações, e também incluir lista de valores nos campos. Alterando rótulos de campo Os rótulos para os campos nos aplicativos móveis são definidos no arquivo app.xml. É possível alterar qualquer um dos rótulos para corresponder à implementação do IBM TRIRIGA Anywhere. Copyright IBM Corp. 2014,

6 Procedimento 1. No MobileFirst Studio, acesse o diretório TRIRIGAAnywhere\apps\ application_name\artifact e abra o arquivo app.xml com o editor XML. 2. Na guia Design, expanda a visualização que contém o atributo de rótulo que você deseja alterar, e insira o novo nome. 3. Se você traduzir o aplicativo móvel, altere o nome do rótulo no arquivo artifact.js para cada idioma suportado. Por exemplo, se o idioma base do aplicativo móvel for o inglês e você traduzir o aplicativo para francês, altere o nome do rótulo no arquivo artifact.js no diretório TRIRIGAAnywhere\apps\ WorkTaskManagement\common\js\application\translation\nls\fr. 4. Salve suas mudanças. O aplicativo é construído automaticamente. 5. Opcional: Para visualizar suas mudanças no simulador de navegador móvel, clique com o botão direito na pasta do aplicativo e selecione Executar como > Visualizar. O que Fazer Depois Implemente o aplicativo no servidor Reorganizando campos em um aplicativo móvel A ordem de como os campos aparecem em uma visualização de contêiner móvel é definida no arquivo app.xml. É possível alterar a posição dos campos para que os usuários digitem as informações em uma ordem que satisfaça os requisitos de negócios. Sobre Esta Tarefa Os campos em uma visualização de contêiner são definidos como atributos dentro dos elementos de <item de grupo> no arquivo de definição do aplicativo e estão contidos dentro de um elemento de <grupo>. O elemento de <grupo> exibe os campos em uma visualização do aplicativo. A ordem dos atributos em um grupo reflete a ordem em que os atributos aparecerem na tela. Uma visualização de contêiner em um aplicativo móvel exibe os campos predefinidos e os detalhes de um registro. Por exemplo, a visualização Detalhes da Tarefa de Trabalho no aplicativo Work Task Management é uma visualização de contêiner que exibe os campos para a tarefa de serviço. Procedimento 1. No MobileFirst Studio, acesse o diretório TRIRIGAAnywhere\apps\ application_name\artifact e abra o arquivo app.xml com o editor XML. 2. Mova a posição do campo. a. Na guia Design, localize e selecione o elemento de <grupo> que contém o elemento <item de grupo> que você deseja mover. b. Na guia Origem, recorte e cole o elemento de <item de grupo> para a nova posição. 3. Salve suas mudanças. O aplicativo é construído automaticamente. 4. Opcional: Para visualizar suas mudanças no simulador de navegador móvel, clique com o botão direito na pasta do aplicativo e selecione Executar como > Visualizar. 2 Configurando apps móveis

7 O que Fazer Depois Implemente o aplicativo no servidor Incluindo campos em aplicativos móveis Os campos que você inclui em aplicativos móveis são definidos pelos RDFs do recurso do OSLC. Ao incluir campos em aplicativos móveis, especifique o recurso do OSLC para o campo como um atributo de recurso no arquivo de definição do aplicativo. Sobre Esta Tarefa O recurso do OSLC deve existir no IBM TRIRIGA Application Platform para o campo que você está incluindo no aplicativo móvel. É possível utilizar um recurso existente do OSLC para o campo que está sendo incluído. Também é possível criar um campo criando o recurso para o campo no IBM TRIRIGA Application Platform e importar o RDF do recurso no IBM TRIRIGA Anywhere. Ao incluir um campo em uma visualização de aplicativo, você deve primeiro definir o recurso para o campo na seção Dados do arquivo de definição do aplicativo. Em seguida, inclua o recurso na visualização na seção da UI, para que o campo seja mostrado no aplicativo. Se você traduzir o aplicativo móvel, atualize o arquivo artifact.js para cada idioma suportado para incluir o nome do campo. Os arquivos artifact.js para cada idioma estão no diretório TRIRIGAAnywhere\apps\application_name\common\ js\application\translation\nls\fr. Procedimento 1. No MobileFirst Studio, acesse o diretório TRIRIGAAnywhere\apps\ application_name\artifact e abra o arquivo app.xml com o editor XML. 2. Na seção Dados, inclua o atributo no recurso em que você deseja incluir o campo. a. Na guia Design, localize o elemento de <recurso> em que deseja incluir o campo. b. Na guia Origem, inclua o atributo que inclui os detalhes do documento de formato no elemento de <recurso>. Por exemplo, para incluir um campo denominado Classe de Serviço na visualização Detalhes da Tarefa de Trabalho no aplicativo Work Task Management, inclua os detalhes do atributo de Classe de Serviço no recurso denominado worktask: <resource providedby="/oslc/sp/triworkmanagementsp" describedby=" name="worktask" pagesize="50" class="application.business.worktaskobject" <attributes> <attribute name="triserviceclasscl" describedbyproperty="dcterms:identifier" 3. Na seção da UI, inclua o atributo de recurso na visualização em que deseja incluir o campo. a. Na guia Design, localize o elemento de <visualização> que deseja atualizar. b. Na guia Origem, inclua o atributo de recurso no elemento de <item do grupo> dentro da visualização que está atualizando. Por exemplo, inclua o atributo de recurso para o campo Classe de Serviço na visualização para o Detalhes da Tarefa de Trabalho: Customizando aplicativos móveis IBM TRIRIGA Anywhere 3

8 <!-- Service Class Lookup --> <lookup id="worktask.serviceclasslookup" label="service Class" resource="serviceclass" filterclass="" filtermethod=""> <requiredresources> <requiredresource name="serviceclass" /> </requiredresources> <list resource="serviceclass"> <listitemtemplate layout="listitem"> <listtext resourceattribute="trinametx" layoutinsertat="item1" cssclass="bold textappearance-medium" /> </listitemtemplate> </list> </lookup> 4. Opcional: Torne o campo editável incluindo o valor true no atributo editável e incluindo o valor tap to enter no atributo de item temporário. O atributo de item temporário indica que o campo é editável e que é possível inserir qualquer valor no campo. Para alterar o campo para somente leitura, altere o valor do atributo editável para false e exclua o atributo de item temporário. 5. Salve suas mudanças. O aplicativo é construído automaticamente. 6. Opcional: Para visualizar suas mudanças em um simulador móvel, clique com o botão direito do mouse na pasta do aplicativo e selecione Executar como > Visualizar. O que Fazer Depois Implemente o aplicativo no servidor Informações relacionadas: Criando recursos OSLC no TRIRIGA Application Platform Incluindo listas de valores como consultas nos campos Alguns campos em um aplicativo móvel possuem listas de valores, ou classificações, nos quais os usuários podem selecionar um valor. Inclua uma lista de valores como uma consulta em um campo no arquivo app.xml. Antes de Iniciar Inclua o campo que deseja associar à consulta de valores com o aplicativo móvel. O IBM TRIRIGA Anywhere inclui recursos do OSLC para classificações. Verifique se o recurso do OSLC é fornecido no IBM TRIRIGA Anywhere para o tipo de classificação que você está incluindo. Também é possível criar recursos para um classificação no IBM TRIRIGA Application Platform e importá-los no IBM TRIRIGA Anywhere. Sobre Esta Tarefa Para incluir uma lista de valores em um campo, inclua a lista de valores como um recurso e crie uma consulta para esse recurso. Em seguida, é possível incluir o recurso e a consulta na visualização para o campo. Procedimento 1. No MobileFirst Studio, abra o arquivo app.xml em um editor XML para o aplicativo móvel que você deseja atualizar. O arquivo app.xml está na pasta TRIRIGAAnywhere\apps\application_name\artifact. 4 Configurando apps móveis

9 2. Na seção Definição de Dados, inclua os dados de recurso para a lista de valores. Por exemplo, para incluir uma lista de valores no campo denominado Classe de Serviço na visualização Detalhes da Tarefa de Trabalho do aplicativo Work Task Management, inclua os dados do recurso para a Consulta da Classe de Serviço na seção de dados do arquivo app.xml. <!-- Service Class Resource --> <resource providedby="/oslc/sp/trismarterphysicalinfrastructuresp" describedby=" name="serviceclass" pagesize="20" additionaldata="true"> <attributes> <attribute name="trinametx" describedbyproperty="spi:trinametx" index="true" /> </attributes> <querybases> <querybase name="triserviceclass" describedbyqcusage=" smarter_physical_infrastructure#serviceclass" /> </querybases> </resource> 3. Na seção da UI, crie os dados de consulta para a lista de valores e associe o recurso à consulta. Por exemplo, inclua a consulta para o recurso Classe de Serviço. <!-- Service Class Lookup --> <lookup id="worktask.serviceclasslookup" label="service Class" resource="serviceclass" filterclass="" filtermethod=""> <requiredresources> <requiredresource name="serviceclass" /> </requiredresources> <list resource="serviceclass"> <listitemtemplate layout="listitem"> <listtext resourceattribute="trinametx" layoutinsertat="item1" cssclass="bold textappearance-medium" /> </listitemtemplate> </list> </lookup> 4. Na seção da UI, associe a nova consulta ao campo. a. Na guia Design, localize o elemento de <visualização> para o campo em que deseja incluir a consulta. b. Na guia Origem, inclua a consulta no elemento de <item de grupo> dentro da visualização que você está atualizando. Por exemplo, associe a consulta Classe de Serviço à visualização Detalhes da Tarefa de Trabalho. <!-- Work Task Details View --> <view id="worktask.taskdetailview" label="work Task Details" resource="worktask">... <container resource="worktask">... <group> <groupitem> <text resourceattribute="triserviceclasscl" label="service Class" editable="false" placeholder="tap to enter" lookup="worktask.serviceclasslookup" lookupattribute="trinametx"> </text> </groupitem> <groupitem> <text resourceattribute="tritasktypecl" label="task Type" editable="false" placeholder="tap to enter" lookup="worktask.tasktypelookup" lookupattribute="trinametx"> </text> </groupitem> Customizando aplicativos móveis IBM TRIRIGA Anywhere 5

10 ... </group> </container> </view> 5. Salve suas mudanças. O aplicativo constrói automaticamente. 6. Opcional: Para visualizar e testar suas mudanças em um simulador móvel, clique com o botão direito na pasta do aplicativo e selecione Executar como > Visualizar. O que Fazer Depois Implemente o aplicativo no servidor Informações relacionadas: Criando recursos OSLC no TRIRIGA Application Platform Incluindo registros relacionados aos aplicativos móveis Os objetos que é possível incluir como registros relacionados nos aplicativos móveis são definidos pelos arquivos Resource Description Framework (RDF) do OSLC. No IBM TRIRIGA Application Platform, é possível incluir um objeto relacionado a um recurso do OSLC e usar metadados para o objeto como um registro relacionado em um aplicativo IBM TRIRIGA Anywhere. Sobre Esta Tarefa Ao incluir um objeto relacionado ou um objeto-filho no IBM TRIRIGA Application Platform para uma consulta do OSLC que existe no IBM TRIRIGA Anywhere, atualiza-se o recurso do OSLC pai para incluir o objeto-filho. Para usar o objeto-filho como um registro relacionado em um aplicativo móvel, importe o RDF do IBM TRIRIGA Application Platform para o IBM TRIRIGA Anywhere. Após importar o RDF, defina o recurso e as visualizações para o registro relacionado nos arquivos de artefato de aplicativo. O recurso para o objeto filho deve existir no arquivo app.xml, para que os campos possam aparecer em um aplicativo móvel. Para mostrar o registro relacionado, atualize o arquivo app.xml para incluir uma visualização para mostrar os detalhes do registro e uma visualização para mostrar a lista de registros que estão relacionados ao aplicativo móvel. Por exemplo, o objeto de comentários é um objeto-filho do objeto de negócios do IBM TRIRIGA da Tarefa de Trabalho. Uma lista de comentários pode ser relacionada à Tarefa de Trabalho. Para usar comentários como registros relacionados na visualização Detalhes da Tarefa de Trabalho no aplicativo Work Task Management, inclua o objeto para os comentários na consulta de tarefa de trabalho OSLC e recurso associado OSLC em IBM TRIRIGA Application Platform. Importe os metadados atualizados para dentro do IBM TRIRIGA Anywhere e inclua o atributo para a lista de comentários no arquivo app.xml, para que os registros para os comentários e seus campos possam aparecer na visualização do Detalhes da Tarefa de Trabalho. Procedimento 1. No IBM TRIRIGA Application Platform, inclua o objeto para o registro relacionado no recurso do OSLC. a. Abra o recurso do objeto-pai. b. Inclua um novo recurso e referencie o recurso-filho. 6 Configurando apps móveis

11 c. Associe o recurso vinculado ao recurso pai. d. No aplicativo Recursos do OSLC, localize o recurso do OSLC e verifique se o objeto-filho está incluído. Por exemplo, para incluir o objeto de comentários como um recurso vinculado, no recurso de tarefa de trabalho inclua um novo recurso vinculado e selecione a associação entre a tarefa de trabalho e o objeto de comentários. Selecione o recurso-filho como o recurso. Salve e o registro da tarefa de trabalho verifica que verifica que o objeto-filho está incluído. 2. Importe o recurso atualizado do OSLC a partir do IBM TRIRIGA Application Platform no IBM TRIRIGA Anywhere. a. Edite o arquivo anywhere-rdfs-puller.xml e inclua o nome RDF. b. Execute o arquivo anywhere-rdfs-puller.xml para importar o RDF para o diretório de recursos OSLC no IBM TRIRIGA Anywhere. c. Verifique se o RDF foi importado no diretório TRIRIGAAnywhere\oslc-doc\ resources\rdf\oslc. Por exemplo, no MobileFirst Studio edite o arquivo anywhere-rdfs-puller.xml para incluir o RDF de comentários. Execute o arquivo anywhere-rdfspuller.xml para importar o RDF de comentários. Verifique se o documento de formato para o objeto de comentários está importado no diretório TRIRIGAAnywhere/oslc-docs/resources/rdf/oslc/shapes/triCommentRS. 3. Defina o atributo e o recurso para o registro relacionado na seção Dados do arquivo app.xml. a. No MobileFirst Studio, abra o arquivo app.xml e inclua o atributo para o registro relacionado ao recurso do OSLC. O atributo define o registro relacionado que está disponível para utilização no aplicativo. b. Inclua o recurso para o registro relacionado. O recurso descreve os metadados para os campos que o registro relacionado utiliza. Por exemplo, inclua o atributo para os comentários no recurso de tarefa de trabalho para mostrar os comentários em uma visualização filha da visualização do Detalhes da Tarefa de Trabalho para o aplicativo Work Task Management. A visualização do Detalhes da Tarefa de Trabalho faz referência ao recurso worktask. Inclua o recurso para os comentários com os campos a serem usados no aplicativo Work Task Management. 4. Na seção da UI do arquivo app.xml, crie a visualização para mostrar os detalhes do registro relacionado. a. Inclua um elemento de <visualização> e especifique o ID e o rótulo para a visualização. b. Defina o recurso para a visualização. c. Inclua os campos para a visualização. Por exemplo, para criar a visualização de detalhe para os comentários, especifique o atributo do ID como worktask.commentsdetailsview em um novo elemento <view>. A visualização de detalhes é chamada Comentários e os campos a seguir são incluídos na visualização como campos somente leitura: v Criado por v Descrição 5. Na seção da UI do arquivo app.xml, crie a visualização para mostrar uma lista de registros relacionados para o aplicativo móvel. a. Inclua um elemento de <visualização> e especifique o ID e o rótulo para a visualização. Customizando aplicativos móveis IBM TRIRIGA Anywhere 7

12 8 Configurando apps móveis b. Defina o recurso e o atributo para a visualização. c. Inclua os campos para a visualização. d. Inclua um link para a visualização de detalhes. e. Especifique o nome de modelo de layout para a visualização de lista. Por exemplo, para criar a visualização de lista para os comentários, especifique o atributo do ID como worktask.comments em um novo elemento <view>. A visualização de lista é chamada Comentários. Os campos a seguir foram incluídos na visualização como campos somente leitura: v Criado por v Descrição A data e hora que o comentário foi criado também é incluída. 6. No diretório TRIRIGAAnywhere\apps\application_name\artifact\layouts\ templates\small, crie o modelo de layout para a visualização de lista. Por exemplo, para definir o layout para a visualização Comentários, crie um arquivo de layout chamado Comments.xml no diretório TRIRIGAAnywhere\apps\ WorkTaskManagement\artifact\layouts\templates\small e especifique a estrutura para o layout. 7. Na seção da UI do arquivo app.xml, inclua um campo na visualização principal no aplicativo móvel para acessar o registro relacionado. Por exemplo, para acessar a visualização de lista Comentários na visualização do Detalhes da Tarefa de Trabalho, inclua a visualização de lista no elemento <groupitem> dentro da visualização. 8. Opcional: Para mostrar o número de registros relacionados que estão disponíveis a partir da visualização principal, especifique as variáveis para o tamanho da lista e o atributo do registro relacionado no arquivo JavaScript associado no diretório TRIRIGAAnywhere\apps\WorkTaskManagement\common\js\ application\handlers. a. Especifique o atributo de recurso do registro relacionado na variável de atributos. O atributo de recurso para o registro relacionado deve ser definido no recurso do OSLC no arquivo app.xml. b. Especifique o atributo de recurso para o tamanho da lista do registro relacionado na variável listsizearray. O atributo de recurso para o tamanho da lista deve ser definido como um atributo local no recurso do OSLC no arquivo app.xml. Por exemplo, para mostrar o número de comentários para cada tarefa de trabalho na visualização do Detalhes da Tarefa de Trabalho, inclua as variáveis a seguir no arquivo do WODetailHandler.js no diretório do TRIRIGAAnywhere\apps\WorkTaskManagement\common\js\application\handlers: v Inclua o atributo de recurso commentslistsize na variável listsizearray. v Inclua o atributo de recurso commentslist na variável attributes. 9. Salve suas mudanças. O aplicativo é construído automaticamente. O que Fazer Depois Para verificar suas mudanças em um simulador de navegador móvel, clique com o botão direito na pasta do aplicativo e selecione Executar como > Visualizar. Implemente o aplicativo no servidor Tarefas relacionadas: integration/t_define_oslc_resource.dita Para usar novos recursos como campos em um aplicativo móvel, crie o recurso no

13 IBM TRIRIGA Application Platform. Organizando o layout de telas móveis É possível organizar o layout das telas móveis para os aplicativos IBM TRIRIGA Anywhere para corresponderem ao processo e ao fluxo serviço de sua organização. É possível alterar a ordem dos campos em uma tela e modificar arquivos de modelo de layout para acomodar novos campos. Arquivos de modelo de layout Um arquivo de modelo de layout é um arquivo XML que define a estrutura e a sequência de controles nas visualizações em um aplicativo móvel IBM TRIRIGA Anywhere. Ao alterar a estrutura de uma visualização no arquivo de definição do aplicativo, você deve atualizar o arquivo de modelo de layout associado. O IBM TRIRIGA Anywhere inclui arquivos de modelo de layout para as visualizações de listas de aplicativos móveis. Nos arquivos app.xml para os aplicativos móveis, o elemento <listitemtemplate> identifica o nome do arquivo de modelo de layout que é utilizado para a visualização. Os arquivos de modelo de layout para o aplicativo Work Task Management estão no diretório TRIRIGAAnywhere\apps\WorkTaskManagement\artifact\layouts\ templates\small. Estrutura de arquivos de layout O elemento <layout> é o elemento raiz de um arquivo de modelo de layout. O elemento <linha> e o elemento <coluna> dentro do layout identificam a localização dos campos na visualização. Para aplicar uma estrutura para um aplicativo móvel, é possível definir os atributos a seguir: atributo width A largura do layout como uma porcentagem na tela móvel. Defina a largura no elemento <layout>. atributo columnid O ponto de anexo para o campo na visualização móvel. O atributo columnid é associado ao atributo layoutinsertat no arquivo app.xml. atributo colspan O número de colunas que a linha ocupa. atributo rowspan O número de linhas que uma coluna deve abranger. Ajuste o rowspan, se for necessário manter a posição vertical dos atributos columnid. Exemplo do layout para a visualização de lista de trabalho O arquivo de layout WorkTaskList.xml possui três linhas que definem a estrutura de qualquer visualização móvel associada e abrange a largura da tela móvel. Cada linha define o atributo columnid que está associado ao atributo layoutinsertat no arquivo app.xml. O atributo colspan define o número de colunas que a linha ocupa. <layout width="100"> <row> <column columnid="item3" colspan="10" /> <column columnid="button1" colspan="2" rowspan="3" halign="right"/> </row> Customizando aplicativos móveis IBM TRIRIGA Anywhere 9

14 <row> <column columnid="item1" colspan="3" /> <column columnid="item2" colspan="7" /> </row> <row> <column columnid="item4" colspan="5" /> <column columnid="item5" colspan="5" /> </row> </layout> A visualização Trabalho Designado é definida no arquivo app.xml para o aplicativo Work Task Management. O arquivo de layout associado, que é identificado pelo atributo de layout, é o arquivo WorkTaskList.xml. O resourceattribute define cada campo que é mostrado na visualização. O atributo layoutinsertat define o ponto de anexo para os campos. Por exemplo, o atributo layoutinsertat para o campo trinametx é identificado como item 2. O atributo columnid no arquivo WorkTaskList.xml para item2 está na segunda linha. Portanto, o campo de horário de início está na segunda linha da visualização. <!-- Work Task List View --> <view id="worktasklistview" label="my Assigned Tasks" saveonshow="true" showbackbutton="false">... <listitemtemplate layout="worktasklist"> <listtext resourceattribute="triidtx" layoutinsertat="item1" cssclass="bold textappearancemedium" /> <listtext resourceattribute="trinametx" layoutinsertat="item2" cssclass="bold textappearance-medium" /> <listtext resourceattribute="locationname" layoutinsertat="item3" /> <listtext resourceattribute="roomname" layoutinsertat="item4" /> <listtext resourceattribute="priorityshortname" layoutinsertat="item5" /> </listitemtemplate>... </view> Alterando o layout de campos nas visualizações de lista As visualizações de lista, que exibem registros em uma lista rolável, possuem um layout que é possível customizar. Por exemplo, você pode desejar alterar a ordem dos campos existentes ou incluir um campo. Ao alterar a ordem de uma visualização no arquivo app.xml, aplique também as mudanças no arquivo de modelo de layout associado. Sobre Esta Tarefa No arquivo app.xml, o nome do modelo de layout que é associado a uma visualização é identificado no atributo de layout do elemento <listitemtemplate>. O elemento <listtext> define o atributo de recurso ou campo dentro da estrutura do layout e o atributo layoutinsertat define o ponto de anexo do campo na visualização móvel. No arquivo de modelo de layout, o valor do atributo columnid corresponde ao valor do atributo layoutinsertat. Se você alterar a estrutura de uma visualização, o valor do atributo columnid e do atributo layoutinsertat deverão se corresponder para que as mudanças do layout na visualização entrem em vigor. Por exemplo, se você incluir um campo na visualização no arquivo app.xml, o valor do atributo columnid no arquivo de modelo de layout deverá corresponder ao valor do atributo layoutinsertat para que o campo apareça na visualização móvel. 10 Configurando apps móveis

15 Procedimento 1. Na seção da UI do arquivo app.xml, localize a visualização que deseja alterar. 2. Modifique o elemento <listtext> no elemento <listitemtemplate> para a visualização, atualizando o atributo de recurso e o atributo layoutinsertat e salve o arquivo. Por exemplo, para incluir um campo denominado Classe de Serviço na visualização de lista de serviços para o Serviço Designado, inclua o atributo de recurso para o campo no elemento <listtext> no <listitemtemplate>. Identifique o atributo layoutinsertat como item6. Você identifica o atributo layoutinsertat como item6 porque o campo Classe de Serviço é o sexto campo na visualização. <!-- Work Task List View --> <view id="worktasklistview" label="my Assigned Tasks" saveonshow="true" showbackbutton="false">... <listitemtemplate layout="worktasklist"> <listtext resourceattribute="triidtx" layoutinsertat="item1" cssclass="bold textappearancemedium" /> <listtext resourceattribute="trinametx" layoutinsertat="item2" cssclass="bold textappearance-medium" /> <listtext resourceattribute="locationname" layoutinsertat="item3" /> <listtext resourceattribute="roomname" layoutinsertat="item4" /> <listtext resourceattribute="priorityshortname" layoutinsertat="item5" /> <listtext resourceattribute="triserviceclasscl" layoutinsertat="item6" /> </listitemtemplate>... </view> Incluindo o campo, você deve aplicar a mudança no arquivo de modelo de layout. Nota: Você também deve incluir os dados de recurso para o campo de supervisor no recurso Ordem de Serviço para que o campo exista na visualização. 3. Abra o arquivo de modelo de layout associado no diretório TRIRIGAAnywhere\apps\application_name\artifact\layouts\templates\small 4. Modifique a estrutura de layout para refletir as alterações feitas no arquivo app.xml. É possível fazer as seguintes mudanças para atualizar o layout: v Insira um elemento da <linha> para incluir uma linha. v Digite o atributo columnid para identificar o ponto de anexo do campo. O valor para o atributo columnid deve corresponder ao valor do atributo layoutinsertat para o campo. v Inclua um valor para o atributo colspan para mover o elemento da <coluna> dentro da linha para uma posição especificada. v Atualize o valor do atributo rowspan para ajustar o posicionamento vertical dos atributos columnid. Se um novo campo foi incorporado em uma linha existente, não será necessário ajustar o atributo rowspan. Por exemplo, o arquivo de layout associado para a visualização da lista de serviços possui atualmente quatro linhas. O atributo rowspan para o columnid botão1 na segunda linha é 3 porque o botão abrange as três linhas subsequentes na visualização. <layout width="100"> <row> <column columnid="item1" colspan="10" /> </row> <row> <column columnid="item3" colspan="10" /> <column columnid="button1" colspan="2" rowspan="3" halign="right"/> </row> Customizando aplicativos móveis IBM TRIRIGA Anywhere 11

16 <row> <column columnid="item2" colspan="10" /> </row> <row> <column columnid="item4" colspan="5" /> <column columnid="item5" colspan="5" /> </row> </layout> Para incluir a adição do campo de supervisor na visualização de lista em uma nova linha, inclua um elemento da <linha> no layout e defina o atributo columnid como item6. O rowspan para o columnid button1 é 4, para que o botão de cronômetro abranja as linhas subsequentes, incluindo a nova linha, na visualização. <layout width="100"> <row> <column columnid="item1" colspan="10" /> </row> <row> <column columnid="item3" colspan="10" /> <column columnid="button1" colspan="2" rowspan="4" halign="right"/> </row> <row> <column columnid="item2" colspan="10" /> </row> <row> <column columnid="item4" colspan="5" /> <column columnid="item5" colspan="5" /> </row> <row> <column columnid="item6" colspan="5" /> </row> </layout> 5. Salve as mudanças no layout. O aplicativo é construído automaticamente. 6. Opcional: Para visualizar suas mudanças, clique com o botão direito na pasta de aplicativos e selecione Executar como > Visualizar. O que Fazer Depois Implemente o aplicativo no servidor. Conceitos relacionados: Arquivos de modelo de layout na página 9 Um arquivo de modelo de layout é um arquivo XML que define a estrutura e a sequência de controles nas visualizações em um aplicativo móvel IBM TRIRIGA Anywhere. Ao alterar a estrutura de uma visualização no arquivo de definição do aplicativo, você deve atualizar o arquivo de modelo de layout associado. Customizando arquivos javascript para aplicativos móveis O IBM TRIRIGA Anywhere aplica regras de negócios e comportamento aos aplicativos móveis. É possível customizar os arquivos JavaScript que são associados aos arquivos app.xml para implementar essas regras. Criando campos condicional em aplicativos Para controlar quando um campo aparece em um aplicativo IBM TRIRIGA Anywhere, é possível tornar o campo condicional. Sobre Esta Tarefa Especifique um manipulador de eventos no arquivo app.xml para controlar se o campo que depende dos valores de outro campo deve ser mostrado ou ocultado 12 Configurando apps móveis

17 quando o valor for selecionado pelo usuário móvel. Os manipuladores de eventos são implementadas em arquivos JavaScript que são associados a uma visualização no aplicativo móvel. Por exemplo, se uma tarefa de trabalho tiver um status de trabalho de Ativo, Suspenso para Partes ou Suspenso por Solicitante, o botão de cronômetro deverá aparecer na visualização Lista de Tarefas de Trabalho. O botão de cronômetro não é necessário para outros valores de status de tarefas de trabalho, portanto, é necessário aplicar uma condição a ser controlada quando o botão de cronômetro aparecer. Crie um manipulador de eventos para o botão de cronômetro para monitorar o recurso e atributo associados ao status de trabalho e mostrar o botão, se um usuário móvel selecionar Concluído no campo Status de Trabalho. Também crie um manipulador de eventos para a visualização à qual o cronômetro pertence, para que seja possível monitorar se os valores no campo Status de Trabalho serão alterados. Se um usuário móvel alterar o valor de status, o manipulador verificará o valor para determinar se o cronômetro será mostrado. Procedimento 1. No MobileFirst Studio, abra o arquivo app.xml para o aplicativo que você deseja atualizar e inclua o campo ao qual deseja aplicar o evento. 2. Na seção de UI do arquivo app.xml, inclua um tipo de renderização de manipulador de eventos no campo. a. No elemento de <botão> do novo campo, inclua um elemento filho nomeado <eventhandlers>. b. No elemento <eventhandlers>, inclua um elemento-filho denominado <eventhandler>. c. Especifique renderização como o atributo do evento, e inclua os atributos de método e classe. Por exemplo, para mostrar o botão de cronômetro para status de serviço Ativo, Suspenso para Partes ou Suspenso por Solicitante, inclua um manipulador de eventos em que o atributo do evento seja changed e o atributo do método seja enabletimerbutton para definir a condição para o campo. O evento é associado ao manipulador para a visualização Lista de Tarefas de Trabalho nomeada TimerHandler. 3. No diretório TRIRIGAAnywhere\apps\application_name\common\js\application\ handlers, inclua a condição para o manipulador de eventos no arquivo JavaScrip associado. Por exemplo, para incluir o código JavaScript para o manipulador de eventos para mostrar o botão de cronômetro para o status de trabalho Ativo, Suspenso para Partes ou Suspenso por Solicitante, atualize o arquivo TimerHandler.js no diretório TRIRIGAAnywhere\apps\ application_name\common\js\application\handlers. 4. Opcional: para validar a qualquer momento as mudanças de status, inclua a condição do manipulador de mudança de dados no campo. 5. Salve suas mudanças e visualize o aplicativo móvel atualizado em um simulador de navegador móvel. O que Fazer Depois Implemente o aplicativo no servidor Customizando aplicativos móveis IBM TRIRIGA Anywhere 13

18 Criando campos condicionais somente leitura Para controlar quando um campo se torna somente leitura ou leitura/gravação dinamicamente em um aplicativo IBM TRIRIGA Anywhere, é possível tornar o campo condicional a ser somente leitura. Sobre Esta Tarefa Especifique um evento ou ação no arquivo app.xml para controlar se um campo que depende dos valores de outro campo é somente leitura. Os manipuladores de eventos são implementadas em arquivos JavaScript que são associados a uma visualização no aplicativo móvel. Procedimento 1. No MobileFirst Studio, abra o arquivo app.xml para o aplicativo que você deseja atualizar e inclua o campo ao qual deseja aplicar o evento. 2. Na seção da UI do arquivo app.xml, inclua um tipo de inicializador de manipulador de eventos nos campos. a. No elemento de <texto> do novo campo, inclua um elemento-filho denominado <eventhandlers>. b. No elemento <eventhandlers>, inclua um elemento-filho denominado <eventhandler>. c. Especifique inicializar como o atributo do evento, e inclua os atributos de método e de classe. 3. Aplique a condição para o manipulador de eventos a um arquivo JavaScript. a. Crie uma pasta para o manipulador no diretório TRIRIGAAnywhere\apps\ app_name\common\js\application. O nome da pasta deve corresponder ao nome aplicado ao atributo de classe do manipulador de eventos. b. Inclua o arquivo JavaScript no diretório TRIRIGAAnywhere\apps\app_name\ common\js\application. O nome do arquivo JavaScript deve corresponder ao nome aplicado ao atributo de classe do manipulador de eventos. c. Inclua a condição para o manipulador de eventos de inicialização no arquivo JavaScript. 4. Salve suas mudanças e visualize o aplicativo móvel atualizado em um simulador de navegador móvel. O que Fazer Depois Implemente o aplicativo no servidor 14 Configurando apps móveis

19 Avisos Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação em outros países. Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e verificação da operação de qualquer produto, programa ou serviço não IBM são de responsabilidade do Cliente. A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta publicação. O fornecimento desta publicação não lhe garante direito algum sobre tais patentes. Pedidos de licença devem ser enviados, por escrito, para: Gerência de Relações Comerciais e Industriais da IBM Brasil Av. Pasteur, Botafogo Rio de Janeiro, RJ CEP Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos de licença, por escrito, para: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japan O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, AS GARANTIAS IMPLÍCITAS DE NÃO INFRAÇÃO, COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas transações; portanto, essa disposição pode não se aplicar ao Cliente. Essas informações podem conter imprecisões técnicas ou erros tipográficos. São feitas alterações periódicas nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nesta publicação, sem aviso prévio. Copyright IBM Corp. 2014,

20 Referências nestas informações a websites não IBM são fornecidas apenas por conveniência e não representam de forma alguma um endosso a esses websites. Os materiais contidos nesses websites não fazem parte dos materiais desse produto IBM e a utilização desses websites é de inteira responsabilidade do Cliente. A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer em qualquer obrigação para com o Cliente. Os licenciados deste programa que desejarem obter informações sobre este assunto com o propósito de permitir: (i) a troca de informações entre programas criados independentemente e outros programas (incluindo este) e (ii) o uso mútuo das informações trocadas, deverão entrar em contato com: Gerência de Relações Comerciais e Industriais da IBM Brasil Av. Pasteur, Botafogo Rio de Janeiro, RJ CEP Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos o pagamento de uma taxa. O programa licenciado descrito nesta publicação e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato Internacional de Licença do Programa IBM ou de qualquer outro contrato equivalente. As informações relativas a produtos não IBM foram obtidas junto aos fornecedores dos respectivos produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou estes produtos e não pode confirmar a precisão de seu desempenho, compatibilidade nem qualquer outra reivindicação relacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBM devem ser encaminhadas diretamente a seus fornecedores. Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estão sujeitas a mudanças ou cancelamento sem aviso prévio e representam apenas metas e objetivos. Estas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos incluem nomes de indivíduos, empresas, marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com os nomes e endereços utilizados por uma empresa real é mera coincidência. Considerações da Política de Privacidade Os produtos de Software IBM, incluindo soluções software as service, ( Ofertas de Software ), podem usar cookies ou outras tecnologias para coletar informações de uso do produto, ajudar a melhorar a experiência do usuário final, customizar interações com o usuário final ou para outros propósitos. Em muitos casos, nenhuma informação identificável pessoalmente é coletada pelas Ofertas de Software. Algumas de nossas Ofertas de Software podem ajudar a permitir que você colete informações identificáveis pessoalmente. Se essa Oferta de Software usar cookies para coletar informações identificáveis pessoalmente, informações específicas sobre o uso de cookies dessa oferta serão estabelecidas abaixo. 16 Configurando apps móveis

21 Marcas comerciais Esta Oferta de Software não usa cookies ou outras tecnologias para coletar informações de identificação pessoal. Se as configurações implementadas para esta Oferta de Software lhe fornecerem como cliente a capacidade de coletar informações identificáveis pessoalmente dos usuários finais via cookies e outras tecnologias, você deverá buscar conselho jurídico sobre todas as leis aplicáveis a essa coleta de dados, incluindo quaisquer requisitos para aviso e consentimento. Para obter informações adicionais sobre o uso de diversas tecnologias, incluindo cookies, para esses propósitos, consulte a Política de Privacidade da IBM em e a Declaração de Privacidade Online da IBM em na seção intitulada Cookies, Indicadores da Web e Outras Tecnologias e os "Produtos de Software IBM e Declaração de Privacidade Software-como-um-Serviço" em product-privacy/. IBM, o logotipo IBM e ibm.com são marcas comerciais ou marcas registradas da International Business Machines Corp., registradas em vários países no mundo todo. Outros nomes de produtos e serviços podem ser marcas comerciais da IBM ou de outras empresas. Uma lista atual de marcas comerciais da IBM está disponível na web em Copyright and trademark information em Java e todas as marcas comerciais e logotipos baseados em Java são marcas comerciais ou marcas registradas da Oracle e/ou de suas afiliadas. Linux é uma marca comercial de Linus Torvalds nos Estados Unidos e/ou em outros países. Microsoft, Windows, Windows NT e o logotipo Windows são marcas comerciais da Microsoft Corporation nos Estados Unidos e/ou em outros países. UNIX é uma marca registrada do The Open Group nos Estados Unidos e em outros países. Outros nomes de produtos e serviços podem ser marcas comerciais da IBM ou de outras empresas. Avisos 17

22 18 Configurando apps móveis

23 Índice Remissivo A ambiente de desenvolvimento 1 C classificações 4 I incluindo listas de valores 4 M MobileFirst Studio 1 R Recursos do OSLC 4 Copyright IBM Corp. 2014,

24 20 Configurando apps móveis

25

26 IBM Impresso no Brasil