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 no 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 que indica quantos componentes estão na categoria:

• Grupos Personalizados: Grupos personalizados são uma ferramenta organizacional para ajudar a organizar os componentes do projeto (veja Grupos de Componentes). Após criar um grupo personalizado, seu nome definido pelo usuário é exibido como uma subcategoria sob Grupos Personalizados. Sob cada grupo personalizado, quaisquer componentes contidos dentro do grupo personalizado são listados.

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

• Endpoints: Um endpoint refere-se a uma conexão específica e suas atividades, criadas usando conectores (veja Conectores). A contagem de componentes nesta categoria é baseada no número de tipos de endpoint únicos, em vez do número de instâncias de endpoint. Por exemplo, dois endpoints de banco de dados são contados como um único endpoint na categoria de nível superior Endpoints.

  Após criar uma instância de atividade associada a uma conexão, o tipo de endpoint é exibido como uma subcategoria sob Endpoints, seguido pelo número de instâncias de conexão desse tipo entre parênteses. Por exemplo, Endpoints de Banco de Dados (2). 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 endpoint, seguido pelo número de instâncias de atividade que foram 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 estão listadas (veja Operações).

• Scripts: Todos os scripts de componentes do projeto estão listados (veja 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 estão listadas (veja Transformações).

• Invocar Operação: Todas as instâncias da ferramenta Invocar Operação (Beta) estão listadas (veja Invocar Operação).

• Variáveis do Projeto: Todas as variáveis do projeto estão listadas (veja Variáveis do projeto).

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

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

• Agendas: Todas as agendas de operações estão listadas (veja Agendas de operações).

Controles de visualização

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

• Pesquisar
• Filtrar
• Preferências de visualização de ícones
• Expandir e selecionar componentes

Pesquisar

Para pesquisar dentro da aba Componentes, use a caixa de pesquisa para inserir uma única palavra-chave ou string de palavras-chave. As categorias são automaticamente expandidas para mostrar componentes onde a string de palavras-chave aparece. A string de palavras-chave se torna negrito e roxa dentro do nome do componente:

Para limpar a pesquisa, clique no ícone de remover .

Filtro

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

• Todos os Componentes: Mostra todos os componentes no projeto atual.

• Não Implantados: Mostra apenas os componentes no projeto atual que ainda não foram implantados ou que foram modificados após a implantação.

• Não Utilizados: Mostra apenas os componentes que não são referenciados por outros componentes ou fluxos de trabalho no projeto atual. Componentes não utilizados são exibidos com um ícone de não referenciado (link quebrado) independentemente de este filtro estar selecionado. Componentes não utilizados também são referidos como componentes não referenciados ou órfãos.

  Nota

  A classificação de não utilizados é baseada no projeto como ele existe atualmente no designer de projetos do Studio e não leva em conta se os componentes foram implantados no Harmony.

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

Uma vez que um filtro é aplicado, os 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 remover em todos os outros rótulos de filtro.

Preferências de visualização de ícones

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

• Ocultar tudo / Mostrar tudo: Dependendo das configurações atuais, clique para ocultar ou mostrar todos os indicadores visuais de componentes. Por padrão, todos os indicadores visuais de componentes são mostrados.

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

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

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

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

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

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

• Instâncias: Quando mostrado, este ícone de referências de componente indica o número de vezes que o componente é referenciado na tela de design, incluindo dentro de outros componentes usados na tela de design.

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

• [Tipos de Atividade de Endpoint]: Quando mostrado, o nome da atividade definida pelo usuário é precedido pelo tipo de atividade entre colchetes. Por exemplo, [Criar] Criar Perfis de RH:

  

Expandir e selecionar componentes

Para expandir ou colapsar todas as categorias de uma vez, clique duas vezes no nome da categoria. Para expandir ou colapsar uma única categoria, clique no nome da categoria ou nos triângulos de divulgação ao lado da categoria.

À medida que você trabalha em projetos, o Studio lembra os estados de exibição que um determinado usuário estava usando por último para um determinado projeto, incluindo se as categorias no painel do projeto estão expandidas ou colapsadas.

Quando uma categoria é 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á rolada para a visualização.

As categorias em si não podem ser selecionadas.

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

Indicadores visuais do componente

Indicações visuais de validade do componente, dependência, status e o número de outros componentes que referenciam 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 possui alterações não implantadas:

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

• Azul: Indica que o componente possui alterações não implantadas.

• 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 implantado.

Ícone de erro de validade

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

Você pode 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 aba Componentes do painel do projeto ou no canvas 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

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

• Novo Componente: Componentes que possuem um ícone de novo componente são componentes que foram criados recentemente desde o último deploy.
• Componente Modificado: Componentes que possuem um ícone de componente modificado são componentes que foram modificados desde o último deploy.
• Componente Implantado: Componentes que possuem um ícone de componente implantado são componentes que foram implantados.

Ícone de referências de componentes

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

O número de componentes que referenciam o componente é indicado pela presença ou ausência de distintivos à direita do nome do componente:

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

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

Menus de ações

Para abrir um menu de ações a serem realizadas em um componente, faça uma das seguintes opções:

• Clique com o botão direito no componente.
• Passe o mouse sobre o componente e, em seguida, 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 de acordo com a categoria ou componente.

Menu de ações da aba Componentes

A partir do 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, Invocar Operação (Beta), Variáveis de Projeto, Emails e Agendas. Ao clicar no tipo de componente, a tela de configuração do componente é aberta para que você possa configurá-lo.
	Colar coloca o componente cortado ou copiado que está na sua área de transferência, criando assim um duplicado do componente como um novo componente não referenciado (veja Reutilização de Componentes). Esta ação está disponível para Arquivos, Endpoints, Operações, Scripts, Transformações, Variáveis de Projeto, Emails e Agendas. Ao criar o duplicado do componente, o 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 (veja Dependências de Componentes, Exclusão e Remoção). Esta ação está disponível para Arquivos, Endpoints, Operações, Scripts, Transformações, Invocar Operação (Beta), Variáveis de Projeto, Variáveis Globais, Emails e Agendas. Ao clicar em um tipo de componente ou Todos os Componentes, uma lista dos componentes não referenciados para o tipo de componente é exibida. Desmarque qualquer componente que você não deseja excluir permanentemente e, em seguida, clique em Excluir (veja Excluir não utilizados em Dependências de Componentes, Exclusão e Remoção.

Menu de ações do componente

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

Estes 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 (veja Agendamentos de operação). Ações: Configure ações a serem tomadas em caso de sucesso ou falha da operação (veja Ações de operação). Opções: Defina opções como quando a operação irá expirar, o que registrar e o período de registro, quando a operação será executada ou se deve usar divisão (veja Opções de operação).
	Publicar como uma API abre uma caixa de diálogo para configurar e publicar uma API personalizada no Gerenciador de API, a ser usada para expor a operação para consumo (veja Publicar como uma API). O número de APIs às quais a operação está atribuída é exibido ao lado deste item de menu. Esta ação é visível apenas quando a operação não possui alterações não implantadas.
	Cortar coloca uma cópia da operação na sua área de transferência e exclui a operação original do projeto (veja Reutilização de operação).
	Copiar coloca uma cópia da operação na sua área de transferência (veja Reutilização de operação).
	Duplicar mostra estas ações de menu (veja Reutilização de operação): Com Referências de Etapas: Duplica apenas a operação. A operação duplicada contém referências a cada uma das etapas da operação original. Com Cópias de Etapas: Duplica a operação e os componentes referenciados como etapas da operação. Novos componentes são criados para cada etapa da operação e são referenciados pela operação duplicada.
	Implantar mostra estas ações de menu: Implantar: Implanta a operação e suas dependências (veja Implantação e execução de operação). Implantar e Executar: Implanta e executa a operação e quaisquer operações downstream (vinculadas) (veja Implantação e execução de operação). Implante Configurável: Abre a tela de implantação, onde você pode selecionar fluxos de trabalho e operações para implantar (veja Implantação e execução de operação).
	Executar executa uma operação já implantada e quaisquer operações downstream (vinculadas) (veja Implantação e execução de operação).
	Ver Logs abre a tela de log da operação, que inclui logs para esta operação e quaisquer operações filhas que tenham sido implantadas e executadas (veja Logs de operação).
	Renomear posiciona o cursor no nome da operação para que você possa fazer as edições necessárias.
	Ver Dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais a operação específica depende (veja Dependências, exclusão e remoção de operação).
	Adicionar ao Grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou adicionar o componente a um grupo existente (veja Grupos de componentes).
	Excluir exclui permanentemente o componente (veja Dependências, exclusão e remoção de operação).
	Remover retira a operação da tela de design. Quaisquer outras referências à operação, como dentro de scripts, transformações ou configurações, não são afetadas (veja Dependências, exclusão e remoção de operação).

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

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

Item do Menu	Descrição
	Visualizar/Editar abre a tela de configuração para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. (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 de um componente. Para detalhes sobre a configuração, consulte o respectivo componente em Conectores, Scripts, Variáveis de projeto, Transformações, Notificações, ou Agendamentos de operações.
	Recortar coloca uma cópia do componente na sua área de transferência e exclui o componente original do projeto (veja Reutilização de Componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. (Esta ação não está disponível na categoria Variáveis Globais.)
	Copiar coloca uma cópia do componente na sua área de transferência (veja Reutilização de Componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. (Esta ação não está disponível na categoria Variáveis Globais.)
	Duplicar cria um novo componente não referenciado usando a mesma configuração que o componente original (veja Reutilização de Componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Scripts, Variáveis de Projeto, Emails e Agendamentos. (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 que você possa fazer as edições necessárias. Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. (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 quaisquer outras partes do projeto das quais o componente específico depende (veja Dependências, exclusão e remoção de Componentes).
	Adicionar ao Grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou adicionar o componente a um grupo existente (veja Grupos de Componentes).
	Excluir exclui permanentemente o componente (veja Dependências, exclusão e remoção de Componentes). Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Arquivos, Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. (Esta ação não está disponível na categoria Variáveis Globais.)
	Remover remove o componente como um passo de operação de todas as operações. Quaisquer outras referências aos componentes, como dentro de scripts, transformações ou configurações, não são afetadas. Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint sob Endpoints, e componentes nas categorias Scripts, Transformações, Variáveis de Projeto, Emails e Agendamentos. (Esta ação não está disponível para componentes nas categorias Arquivos ou Variáveis Globais.) É funcional apenas quando usada em uma atividade, transformação ou script que é referenciado como um passo em uma operação, ou quando usada em uma notificação de email que está configurada com uma ação de operação (veja Dependências, exclusão e remoção de Componentes).

Conexões

As conexões são listadas em uma subcategoria de tipo de endpoint sob Endpoints. O menu de ações para 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 para a conexão (veja a documentação sobre a conexão de endpoint específica em Conectores).
	Testar testa a conexão. Esta ação é a mesma que clicar no botão Testar disponível na tela de configuração da conexão (veja a documentação sobre a conexão de endpoint específica em Conectores).
	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, Variável, ou SOAP, conexões que utilizam variáveis em sua configuração de conexão, ou conexões que já são um endpoint global (veja Endpoints Globais).