Aba Componentes do painel de projeto no Jitterbit Studio

Introdução

A aba Componentes do painel de projeto é uma das três abas acessíveis no painel de projeto.

A aba Componentes exibe todos os componentes do projeto aberto agrupados por categoria de componente.

Categorias de componentes

Cada uma dessas categorias de nível superior é exibida ao lado de um número entre parênteses indicando quantos componentes estão na categoria:

• Grupos Personalizados: Grupos personalizados são uma ferramenta organizacional para ajudar a organizar os componentes do projeto (consulte Grupos de componentes). Após criar um grupo personalizado, seu nome definido pelo usuário é exibido como uma subcategoria em Grupos Personalizados. Sob cada grupo personalizado, qualquer componente contido nele é listado.

• Arquivos: Todos os esquemas são listados (consulte Esquemas).

• Pontos de Extremidade: Um ponto de extremidade refere-se a uma conexão específica e suas atividades, criado usando conectores (consulte Conectores). A contagem de componentes nesta categoria é baseada no número de tipos de ponto de extremidade exclusivos, não no número de instâncias de ponto de extremidade. Por exemplo, dois pontos de extremidade de banco de dados são contados como um único ponto de extremidade na categoria Pontos de Extremidade de nível superior.

  Após criar uma instância de atividade associada a uma conexão, o tipo de ponto de extremidade é exibido como uma subcategoria em Pontos de Extremidade, seguido pelo número de instâncias de conexão desse tipo entre parênteses. Por exemplo, Pontos de Extremidade de Banco de Dados (2). As conexões não são exibidas ou contadas a menos que pelo menos uma atividade tenha sido criada a partir delas.

  O nome da conexão definido pelo usuário é listado como uma subcategoria adicional sob o tipo de ponto de extremidade, seguido pelo número de instâncias de atividade criadas a partir de cada conexão entre parênteses. Por exemplo, PostgreSQL (4).

  Sob cada conexão, o nome definido pelo usuário de cada instância de atividade é listado.

• Operações: Todas as operações são listadas (consulte Operações).

• Scripts: Todos os scripts de componente do projeto são listados (consulte Scripts). Scripts criados em campos ou nós de destino em uma transformação não são componentes do projeto, pois são considerados parte do componente de transformação.

• Transformações: Todas as transformações são listadas (consulte Transformações).

• Decisões: Todas as instâncias da ferramenta Decisão são listadas (consulte Decisão).

• Invocar Operação: Todas as instâncias da ferramenta Invocar Operação são listadas (consulte Invocar Operação).

• Registros: Todas as instâncias da ferramenta Registro são listadas (consulte Registro).

• Variáveis de Projeto: Todas as variáveis de projeto são listadas (consulte Variáveis de projeto).

• Variáveis Globais: Todas as variáveis globais são listadas (consulte Variáveis globais).

• Emails: Todas as notificações por email são listadas (consulte Notificações por email).

• Agendamentos: Todos os agendamentos de operação são listados (consulte Agendamentos de operação).

Controles de visualização

Dentro da aba Componentes, estes controles de visualização estão disponíveis:

• Pesquisa
• Filtro
• Preferências de visualização em ícones
• Expandir e selecionar componentes

Pesquisa

Para pesquisar dentro da aba Componentes, use a caixa de pesquisa para inserir uma palavra-chave única ou uma sequência de palavras-chave. As categorias se expandem automaticamente para exibir componentes onde a sequência de palavras-chave aparece. A sequência de palavras-chave fica em negrito e roxo dentro do nome do componente:

Para limpar a pesquisa, clique no ícone de remoção .

Filtro

Para filtrar por componente do projeto, use o menu do ícone de filtro para selecionar entre Todos os componentes ou qualquer combinação das demais opções de filtro:

• Todos os componentes: Exibe todos os componentes no projeto atual.

• Não implantado: Exibe apenas componentes no projeto atual que ainda não foram implantados ou foram modificados após sua implantação.

• Não utilizado: Exibe apenas componentes que não são referenciados por outros componentes ou workflows no projeto atual. Componentes não utilizados são exibidos com um ícone de referência não encontrada (link quebrado) independentemente de esse filtro estar selecionado. Componentes não utilizados também são conhecidos como componentes não referenciados ou órfãos.

  Nota

  A classificação de não utilizado se baseia no projeto conforme existe atualmente no designer de projeto do Studio e não leva em consideração se os componentes foram implantados no Harmony.

• Inválido: Exibe apenas componentes no projeto atual que são inválidos. Componentes inválidos não podem ser implantados. Os critérios de validação estão descritos em Validade do componente. Esse filtro pode ser útil para identificar componentes inválidos que também não são utilizados, caso você queira deletar o componente não utilizado em vez de resolver erros.

Quando um filtro é aplicado, rótulos de filtro são exibidos abaixo do ícone de filtro:

Para retornar à seleção Todos os componentes, use o menu de filtro ou clique no ícone de remoção em todos os outros rótulos de filtro.

Preferências de visualização em ícones

Para alterar a exibição de indicadores visuais do componente, use o menu do ícone de visualização para selecionar entre Ocultar tudo ou qualquer combinação dos demais indicadores visuais do componente. As preferências de visualização em ícones são lembradas para cada usuário e projeto.

• Ocultar tudo / Mostrar tudo: Dependendo das configurações atuais, clique para ocultar ou exibir todos os indicadores visuais do componente. Por padrão, todos os indicadores visuais do componente são exibidos.

• Ocultar: O indicador visual do componente está visível. Clique para ocultá-lo.

• Mostrar: O indicador visual do componente está oculto. Clique para exibi-lo.

• Modificado: Quando exibido, este ícone de status indica que o componente foi modificado desde a última implantação.

• Novo: Quando exibido, este ícone de status indica que o componente foi criado recentemente desde a última implantação.

• Implantado: Quando exibido, este ícone de status indica que o componente foi implantado.

• Não utilizado: Quando exibido, este ícone de referências do componente indica que o componente não é referenciado por nenhuma das operações dentro dos workflows de um projeto.

• Instâncias: Quando exibido, este ícone de referências do componente indica quantas vezes o componente é referenciado na tela de design, incluindo dentro de outros componentes usados na tela de design.

• Dependências: Quando exibidas, os ícones de dependência indicam componentes que são uma dependência do componente selecionado no momento.

• [Tipos de Atividade de Endpoint]: Quando exibido, o nome da atividade definida pelo usuário é precedido pelo tipo de atividade entre colchetes. Por exemplo, [Create] Create HR Profiles:

  

Expandir e selecionar componentes

Para expandir ou recolher uma única categoria, clique no nome da categoria ou nos caret ao lado da categoria.

Para expandir ou recolher todas as categorias de uma vez, clique nos ícones expandir tudo ou recolher tudo acima da caixa de pesquisa. Também é possível clicar duas vezes em qualquer nome de categoria para expandir ou recolher todas as categorias.

Enquanto trabalha em projetos, o Studio lembra dos estados de exibição que um determinado usuário estava usando pela última vez para um determinado projeto, incluindo se as categorias no painel do projeto estão expandidas ou recolhidas.

Quando uma categoria está expandida, clique em um componente dentro da categoria para selecioná-lo. Um componente selecionado é exibido com um ícone de seleção e um fundo cinza:

Se o componente também for referenciado na tela de design, a primeira instância dele será exibida na tela.

Categorias em si não podem ser selecionadas.

O painel do projeto também pode ser redimensionado para ficar mais estreito ou mais largo, conforme descrito em Painel do projeto.

Indicadores visuais de componente

Indicações visuais de validade do componente, dependência, status e o número de outros componentes que fazem referência a um componente são exibidas ao redor do nome do componente:

1. Nome do componente
2. Ícone de erro de validade
3. Ícone de dependência
4. Ícone de status
5. Ícone de referências de componente

Para alterar a visibilidade desses indicadores visuais, consulte Preferências de visualização de ícones acima.

Nome do componente

O nome de um componente é exibido em preto, azul ou vermelho, dependendo se o componente é válido ou tem alterações não implementadas:

• Preto: Indica que o componente foi implementado ou que o componente é uma variável global ou grupo personalizado, que são sempre exibidos em preto.

• Azul: Indica que o componente tem alterações não implementadas.

• Vermelho: Ao usar a opção Destacar Itens Inválidos na tela de design ou ao filtrar itens Inválidos, a cor vermelha indica que o componente contém erros e não pode ser implementado.

Ícone de erro de validade

Ao usar a opção Destacar Itens Inválidos na tela de design ou ao filtrar itens Inválidos, um ícone de erro é exibido ao lado de componentes inválidos:

É possível visualizar os erros de validação associados aos componentes inválidos conforme descrito em Validade do componente e Validade da operação.

Ícone de dependência

Ao selecionar um componente na guia Componentes do painel do projeto ou na tela de design, um ícone de dependência é exibido ao lado do nome de um componente que é uma dependência do componente selecionado:

Um componente selecionado é exibido com um ícone de seleção e um fundo cinza.

Ícone de status

Estes ícones de status são exibidos para componentes:

• Novo Componente: Componentes com o ícone de novo componente são componentes criados recentemente desde a última implantação.
• Componente Modificado: Componentes com o ícone de componente modificado são componentes que foram modificados desde a última implantação.
• Componente Implantado: Componentes com o ícone de componente implantado são componentes que foram implantados.

Ícone de referências de componentes

Um componente pode ser referenciado por componentes dentro dos fluxos de trabalho de um projeto.

O número de componentes que fazem referência ao componente é indicado pela presença ou ausência de emblemas à direita do nome do componente:

• Um componente que não é referenciado por nenhuma das operações nos fluxos de trabalho de um projeto é conhecido como componente não utilizado e é exibido com um ícone de referência não encontrada (link quebrado) .
• Um componente referenciado apenas uma vez na tela de design é exibido sem nenhum indicador visual.
• Um componente referenciado várias vezes na tela de design, inclusive dentro de outros componentes utilizados na tela de design, exibe o número de componentes que o referenciam em um emblema .

Mais detalhes são fornecidos em Reuso de componentes e Reuso de operações.

Menus de ações

Para abrir um menu de ações a executar em um componente, faça um dos seguintes:

• Clique com o botão direito no componente.
• Passe o mouse sobre o componente e clique no ícone do menu de ações .
• Use o menu de ações da aba Componentes.

As ações disponíveis em cada menu dependem do contexto e variam conforme a categoria ou componente.

Menu de ações da aba Componentes

No menu de ações da aba Componentes, você pode criar, colar ou excluir componentes.

Item do Menu	Descrição
	Criar Novo cria um novo componente não referenciado do tipo respectivo selecionado. Esta ação está disponível para Scripts, Transformações, Decisões, Invocar Operação, Logs, Variáveis de Projeto, Emails e Agendamentos. Ao clicar no tipo de componente, a tela de configuração do componente abre para você configurar o componente.
	Colar posiciona o componente cortado ou copiado que está na sua área de transferência, criando assim uma duplicata do componente como um novo componente não referenciado (ver Reuso de componentes). Esta ação está disponível para Arquivos, Endpoints, Operações, Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. Ao criar a duplicata do componente, seu cursor é posicionado no nome do componente para renomeação.
	Excluir Não Utilizados exclui permanentemente componentes na categoria que não são referenciados por nenhum outro componente no projeto atual (ver Dependências, exclusão e remoção de componentes). Esta ação está disponível para Arquivos, Endpoints, Operações, Scripts, Transformações, Invocar Operação, Variáveis de Projeto, Variáveis Globais, Emails e Agendamentos. Ao clicar em um tipo de componente ou Todos os Componentes, exibe-se uma lista dos componentes não referenciados para esse tipo de componente. Desmarque qualquer componente que você não deseje excluir permanentemente e clique em Excluir (ver Excluir não utilizados em Dependências, exclusão e remoção de componentes.

Menu de ações de componentes

Algumas ações estão disponíveis apenas em certos tipos de componentes, conforme detalhado nas subseções abaixo:

• Operações
• Arquivos, atividades, scripts, transformações, variáveis de projeto, variáveis globais, emails e agendamentos
• Conexões

Operações

Esses itens estão disponíveis no menu de ações de uma operação:

Item do menu	Descrição
	Configurações abre as configurações da operação, contendo três abas: Agendamentos: Crie e aplique agendamentos para executar operações automaticamente (consulte Agendamentos de operações). Ações: Configure ações a serem tomadas no sucesso ou falha da operação (consulte Ações de operações). Opções: Defina opções como tempo limite da operação, o que registrar em log e o período de tempo para registro, quando a operação será executada ou se deve usar fragmentação (consulte Opções de operações).
	Publicar como uma API abre um diálogo para configurar e publicar uma API customizada do API Manager a ser usada para expor a operação para consumo (consulte Publicar como uma API). O número de APIs às quais a operação é atribuída é exibido ao lado desse item de menu. Essa ação fica visível apenas quando a operação não tem alterações não implementadas.
	Publicar como uma API usando IA abre o Assistente de IA do APIM, que o orienta na publicação da operação como uma API através de prompts interativos. Essa ação fica visível apenas quando a operação não tem alterações não implementadas e a organização tem licença para o Assistente de IA do APIM.
	Cortar coloca uma cópia da operação na sua área de transferência e exclui a operação original do projeto (consulte Reutilização de operações).
	Copiar coloca uma cópia da operação na sua área de transferência (consulte Reutilização de operações).
	Duplicar mostra essas ações de menu (consulte Reutilização de operações): Com referências de etapas: Duplica apenas a operação. A operação duplicada contém referências para cada uma das etapas da operação original. Com cópias de etapas: Duplica a operação e componentes referenciados como etapas de operação. Novos componentes são criados para cada etapa de operação e são referenciados pela operação duplicada.
	Implementar mostra essas ações de menu: Implementar: Implementa a operação e suas dependências (consulte Implementação e execução de operações). Implementar e executar: Implementa e executa a operação e quaisquer operações a jusante (vinculadas) (consulte Implementação e execução de operações). Implementação configurável: Abre a tela de implementação, onde você pode selecionar fluxos de trabalho e operações para implementar (consulte Implementação e execução de operações).
	Executar executa uma operação já implementada e quaisquer operações a jusante (vinculadas) (consulte Implementação e execução de operações).
	Visualizar logs abre a tela de log da operação, que inclui logs dessa operação e de quaisquer operações secundárias que tenham sido implementadas e executadas (consulte Logs de operações).
	Renomear posiciona o cursor no nome da operação para que você faça quaisquer edições conforme necessário.
	Visualizar dependências altera a visualização no painel do projeto para exibir qualquer outra parte do projeto de que a operação específica depende (consulte Dependências, exclusão e remoção de operações).
	Adicionar ao grupo abre um diálogo para criar um novo grupo personalizado ou adicionar o componente a um grupo existente (consulte Grupos de componentes).
	Transferência seletiva abre uma tela de configuração onde você pode selecionar componentes específicos para transferir para outro ambiente. Para mais informações, consulte Transferência de projeto.
	Excluir exclui permanentemente o componente (consulte Dependências, exclusão e remoção de operações).
	Remover remove a operação da tela de design. Qualquer outra referência à operação, como dentro de scripts, transformações ou configurações, não é afetada (consulte Dependências, exclusão e remoção de operações).

Arquivos, atividades, scripts, transformações, variáveis de projeto, variáveis globais, e-mails e agendas

Os menus de ações para esses componentes compartilham muitas das mesmas ações:

Item de Menu	Descrição
	Visualizar/Editar abre a tela de configuração para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Scripts, Transformações, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível para componentes nas categorias Arquivos ou Variáveis Globais.) A tela de configuração do componente também pode ser aberta clicando duas vezes no nome do componente. Para detalhes sobre configuração, consulte o respectivo componente em Conectores, Scripts, Variáveis de projeto, Transformações, Notificações ou Agendas de operação.
	Cortar coloca uma cópia do componente na área de transferência e deleta o componente original do projeto (consulte Reutilização de componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível na categoria Variáveis Globais.)
	Copiar coloca uma cópia do componente na área de transferência (consulte Reutilização de componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível na categoria Variáveis Globais.)
	Duplicar cria um novo componente sem referência usando a mesma configuração do componente original (consulte Reutilização de componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Scripts, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível para componentes nas categorias Arquivos, Transformações ou Variáveis Globais.)
	Renomear posiciona o cursor no nome do componente para fazer edições conforme necessário. Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível na categoria Variáveis Globais.)
	Visualizar Dependências altera a visualização no painel do projeto para exibir qualquer outra parte do projeto da qual o componente específico depende (consulte Dependências de componentes, exclusão e remoção).
	Adicionar ao Grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou adicionar o componente a um grupo existente (consulte Grupos de componentes).
	Deletar deleta permanentemente o componente (consulte Dependências de componentes, exclusão e remoção). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível na categoria Variáveis Globais.)
	Remover remove o componente como uma etapa de operação de todas as operações. Qualquer outra referência aos componentes, como dentro de scripts, transformações ou configurações, não é afetada. Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes nas categorias Scripts, Transformações, Variáveis de Projeto, E-mails e Agendas. (Esta ação não está disponível para componentes nas categorias Arquivos ou Variáveis Globais.) Funciona apenas quando usada em uma atividade, transformação ou script referenciada como uma etapa em uma operação, ou quando usada em uma notificação de e-mail configurada com uma ação de operação (consulte Dependências de componentes, exclusão e remoção).

Conexões

As conexões são listadas em uma subcategoria de tipo de endpoint em Endpoints. O menu de ações de uma conexão possui as ações Visualizar/Editar, Testar e Promover para endpoint global:

Item do Menu	Descrição
	Visualizar/Editar abre a tela de configuração da conexão (veja a documentação sobre a conexão específica do endpoint em Connectors).
	Testar testa a conexão. Esta ação é igual a clicar no botão Testar disponível na tela de configuração da conexão (veja a documentação sobre a conexão específica do endpoint em Connectors).
	Promover para endpoint global converte a conexão em um endpoint global no ambiente onde o projeto reside. Esta ação não está disponível para conexões API, Variable ou SOAP, conexões que usam variáveis em sua configuração de conexão ou conexões que já são um endpoint global (veja Global Endpoints).