Personalização avançada > Usando componentes reutilizáveis
  
Usando componentes reutilizáveis
Visão global
Este tópico fornece uma breve visão global dos componentes reutilizáveis BETA do ThingWorx Navigate, que são baseados nas diretrizes e práticas recomendadas do ThingWorx para a criação de componentes.
Ao criar aplicativos, é eficiente reutilizar componentes padrão em seus aplicativos. Estes componentes reutilizáveis tornam-se elementos básicos para a criação do seu aplicativo e é possível configurar e personalizá-los para atender às suas necessidades de negócios.
Para obter mais informações gerais sobre componentes reutilizáveis, consulte a seção Construindo aplicativos do ThingWorx usando componentes reutilizáveis no Help Center do ThingWorx.
Este tópico fornece informações sobre o seguinte:
Componentes reutilizáveis no ThingWorx Navigate
Incluindo componentes reutilizáveis no seu mashup
Configurando componentes reutilizáveis
Personalizando componentes reutilizáveis
Componentes reutilizáveis no ThingWorx Navigate
O ThingWorx Navigate 8.5 apresenta componentes reutilizáveis BETA. Os componentes reutilizáveis melhoram e simplificam o desenvolvimento de tarefas ao fornecer componentes predefinidos que estão prontos para serem montados em tarefas personalizadas.
* 
Estes componentes são liberados como BETA com documentação limitada e estão disponíveis para teste e avaliação. Não é recomendado usá-los em um ambiente de produção.
A primeira variedade de componentes reutilizáveis foi criada para o desenvolvimento da tarefa Minhas tarefas. Esta tarefa é a primeira da série de tarefas do ThingWorx Navigate Contribute.
Ao inserir um componente reutilizável em um mashup, ele tem uma configuração default. Em geral, a configuração default não tem nenhuma funcionalidade inerente e o componente reutilizável requer configuração adicional para trabalhar. Alguns componentes reutilizáveis também têm uma ou mais configurações predefinidas disponíveis, permitindo que esses componentes sejam usados para aplicativos especializados com configuração mínima adicional. Por exemplo, o componente Lista de itens tem quatro configurações predefinidas: Lista de tarefas, Lista de anexos, Lista de itens afetados e Lista de atividade. Cada uma delas é uma configuração especializada do componente Lista de itens.
As configurações predefinidas se conectam ao Windchill como sistema back-end. Todas as configurações de controle de acesso, configurações de visibilidade de atributo e legendas de segurança que são configuradas no Windchill são seguidas no ThingWorx Navigate. Como resultado, os usuários podem ver somente o que as regras do Windchill permitem ver.
Consulte a seção Configurando componentes reutilizáveis abaixo para obter mais informações sobre a configuração de componentes reutilizáveis e a seleção de configurações predefinidas.
O diagrama e a tabela a seguir fornecem um resumo dos componentes reutilizáveis existentes e suas configurações predefinidas. Os componentes reutilizáveis são baseados no Sistema de design do PTC para garantir a consistência. Alguns dos componentes reutilizáveis incluem outros componentes reutilizáveis incorporados. Por exemplo, o componente Lista de itens inclui o componente Barra de ações.
Componentes
Descrição
Tipo
Configurações predefinidas
Lista de itens
Exibe um conjunto de dados como uma lista em formato de grade. Inclui classificação, filtragem e busca, bem como mais capacidades avançadas.
Mashup contido
Lista de tarefas, Lista de anexos, Lista de itens afetados, Lista de atividade
Atributo
Exibe dados na forma de pares nome-valor. Pode ser incorporado em um painel Identidade do item.
Widget
Nenhuma
Bloco
Exibe um conjunto de blocos em que cada um contém dados na forma de um par nome-valor.
Widget
Nenhuma
Barra de ação
Exibe ações disponíveis. Pode ser incorporado em um painel Lista de itens ou Identidade do item para habilitar ações nesses componentes.
Widget
Nenhuma
Identidade do item
Exibe informações básicas de identidade sobre um item específico, incluindo os atributos de título e identidade.
Widget
Identidade da tarefa
Progresso da tarefa
Exibe o resumo do progresso da tarefa, incluindo os votos de membros e quantos membros já tomaram a ação.
Widget
Nenhuma
Incluindo componentes reutilizáveis no seu mashup
1. No Mashup Builder, encontre o componente desejado.
a. Para componentes reutilizáveis que são widgets, vá para o painel Widgets e selecione Beta no menu suspenso Category.
b. Para o componente reutilizável da lista de itens, acesse o painel Mashups e busque PTC.ItemListMashup.
2. Arraste o componente para o seu mashup.
3. Configure o componente. Veja a seção a seguir para obter mais informações.
Configurando componentes reutilizáveis
Os componentes reutilizáveis estão no modo BETA a partir do ThingWorx Navigate 8.5. Como resultado, você só pode configurar componentes editando sua configuração JSON. Neste ponto, esses tópicos são a extensão do suporte disponível para a configuração de componentes reutilizáveis.
Para configurar um componente reutilizável, siga estes passos:
1. Selecione um componente reutilizável existente em seu mashup.
2. Clique em na parte superior direita do painel Widget Properties. A janela Configure Mashup Parameters aparece.
3. Se o componente reutilizável selecionado tiver configurações predefinidas, o menu suspenso Configuration Type ficará visível. É possível selecionar uma configuração predefinida no menu.
4. É possível configurar o componente reutilizável editando o arquivo JSON na caixa Configuration.
* 
É possível usar o botão Restore defaults para restaurar a configuração predefinida. Observe que este botão não restaura a última configuração salva.
5. Clique em Done para salvar o seu trabalho. Ao concluir o trabalho no Mashup Builder, clique em Save na parte superior da página.
Personalizar componentes reutilizáveis
Um componente do ThingWorx Navigate 8.5 consiste em uma camada de interface do usuário e uma camada de lógica de negócios. É possível personalizar a camada de lógica de negócios do componente. A peça personalizável do componente é chamada de modelo de componente. Para personalizar o modelo de componente, siga estes passos:
1. Herde o template de coisa do modelo de componente.
2. Substitua os serviços requeridos.
3. Crie uma nova coisa do template de coisa.
4. Adicione a coisa ao valor da propriedade de configuração do componente modelThingName.
Quando esses passos são concluídos, o componente usa o código personalizado do modelo em vez do código de modelo inovador.