Guia Componentes do Painel de Projeto¶

Introdução¶

A guia Componentes do aba do projeto é uma das duas guias acessíveis no painel do projeto. (A outra aba é a aba Workflows.)

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 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 (consulte Grupos de componentes). Depois de criar um grupo personalizado, seu nome definido pelo usuário é exibido como uma subcategoria em Grupos Personalizados. Em cada grupo personalizado, todos os componentes contidos no grupo personalizado são listados.

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

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

  Depois de criar uma instância de atividade associada a uma conexão, o tipo de endpoint é exibido como uma subcategoria em Endpoints, seguido pelo número de instâncias de conexão desse tipo entre parênteses. Por exemplo, Endpoints 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 definida pelo usuário é listado como uma subcategoria adicional no 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).

  Em 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 (consulte Operações).

• Scripts: Todos os scripts dos componentes do projeto estão listados (veja Scripts). Os 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).

• 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 são listadas (veja Variáveis Globais).

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

• Horários: Todos os horários de operação estão listados (veja Horários de Operação).

Ver Controles¶

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

• Procurar
• Filtro
• Mostrar tipos de atividades
• Expandir e selecionar componentes

Procurar¶

Para pesquisar na aba Componentes, use a caixa de pesquisa para inserir uma única palavra-chave ou sequência de palavras-chave. As categorias são expandidas automaticamente para mostrar os componentes onde a sequência de palavras-chave aparece. A sequência de palavras-chave fica em negrito e roxo no nome do componente:

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

Filtro¶

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

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

• Não implantado: Mostra apenas os componentes do projeto atual que ainda não foram implantados ou que foram modificados após terem sido implantados.

• Não utilizado: Mostra 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 não referenciado (link quebrado) independentemente de este filtro estar selecionado. Componentes não utilizados também são chamados de componentes não referenciados ou órfãos.

  Nota

  A classificação não utilizada é baseada no projeto como existe atualmente no designer de projeto do Cloud Studio e não leva em consideração se os componentes foram implantados no Harmony.

• Inválido: Mostra apenas componentes inválidos no projeto atual. Componentes inválidos não podem ser implementados. Os critérios de validação estã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.

Depois que um filtro é aplicado, os rótulos do filtro são exibidos abaixo do ícone do 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.

Mostrar Tipos de Atividades¶

Quando Mostrar tipos de atividade é selecionado (padrão), o nome da atividade definida pelo usuário é precedido pelo tipo de atividade entre colchetes. Por exemplo, [Criar] Criar perfis de RH:

A seleção é lembrada e não é redefinida após sair do projeto.

Expandir e Selecionar Componentes¶

Para expandir ou recolher todas as categorias de uma vez, clique duas vezes no nome da categoria. Para expandir ou recolher uma única categoria, clique no nome da categoria ou nos triângulos de divulgação próximo à categoria.

À medida que você trabalha em projetos, o Cloud Studio lembra os estados de exibição que um determinado usuário usou pela última vez em um determinado projeto, incluindo se as categorias no painel do projeto estão expandidas ou recolhidas.

Quando uma categoria for expandida, clique em um componente 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 quadro de design, a primeira instância dele será exibida na rolagem.

As 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 Componentes¶

Indicações visuais de validade, 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 componentes

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 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 implementadas.

• Vermelho: Ao usar a opção Realçar itens inválidos na quadro 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 Realçar itens inválidos na quadro de design ou ao filtrar itens Inválidos, um ícone de erro é exibido próximo aos componentes inválidos:

Você pode visualizar os erros de validação associados a 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 aba do projeto ou na quadro de design, um ícone de dependência é exibido próximo ao 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 que possuem um novo ícone de componente são componentes que foram criados recentemente desde a última implantar.
• Componente modificado: Componentes que possuem um ícone de componente modificado são componentes que foram modificados desde a última implantar.
• 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 workflows 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 dentro dos workflows de um projeto é conhecido como um componente não utilizado e é exibido com um ícone não referenciado (link quebrado) .
• Um componente que é referenciado apenas uma vez na quadro de design é exibido sem nenhum indicador visual.
• Um componente que é referenciado várias vezes na quadro de design, inclusive em outros componentes usados na quadro de design, tem o número de componentes pelos quais é referenciado exibido em um selo.

Mais detalhes são fornecidos em Reutilização de componentes e Operação Reutilização.

Menus de Ações¶

Para abrir um menu de ações a serem executadas em cada categoria de componente ou componente, siga um destes procedimentos:

• Clique com o botão direito na categoria ou componente.
• Passe o mouse sobre a categoria ou componente e clique no ícone do menu de ações .

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

Menu de Ações de Categoria¶

Algumas ações estão disponíveis apenas em determinadas categorias, conforme detalhado abaixo. As imagens abaixo exibem os menus de ações para a categoria Scripts (imagem à esquerda) e para a categoria Endpoints (imagem à direita):

Item do menu	Descrição
	Criar novo cria um componente novo e não referenciado do respectivo tipo na categoria. Esta ação está disponível nas categorias Scripts, Transformações, Variáveis do projeto, Emails e Programações. Ao criar o componente, a tela de configuração do componente é aberta para você configurar o componente.
	Colar Tipo de componente: Coloca o componente recortado ou copiado que está na área de transferência, criando assim uma duplicata do componente como um componente novo e sem referência (consulte Reutilização de componente). Essa ação está disponível em Arquivos, Endpoints, Operações, Scripts, Transformações, Variáveis de projeto, Emails e Agendamentos. Ele é ativado somente quando você tem um componente do tipo correspondente em sua área de transferência. Ao criar a duplicata do componente, o cursor é posicionado no nome do componente para renomeá-lo.
	Excluir não utilizados exclui permanentemente os componentes da categoria que não são referenciados por nenhum outro componente no projeto atual (consulte Dependências, exclusão e remoção de componentes). Essa ação está disponível em Arquivos, Endpoints, Operações, Scripts, Transformações, Variáveis de projeto, Variáveis Globais, Emails e Agendamentos. É ativado somente quando a categoria contém componentes não referenciados, exibidos com um ícone não referenciado (link quebrado) .

Menu de Ações do Componente¶

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

• Operações: O menu de ações para operações (mostrado na imagem à esquerda) tem itens exclusivos, como Configurações, Executar e Ver registros e submenus exclusivos para Duplicar e Implantar. Também inclui ações comuns como Cortar, Copiar, Renomear, Ver dependências, Adicionar ao grupo, Excluir e Remover.
• 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, como Visualizar/Editar, Cortar, Copiar, Duplicar, Renomear, Ver dependências, Adicionar ao grupo, Excluir e Remover. O menu de ações de um script (mostrado na imagem do meio) mostra todas as ações disponíveis. Algumas destas ações não estão disponíveis em todos os componentes, conforme descrito nesta seção.
• Conexões: O menu de ações para uma conexão (mostrado na imagem à direita) possui as ações Visualizar/Editar e Testar.

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 guias: Programações: Crie e aplique programações para executar operações automaticamente (consulte Programações de Operação). Ações: Configure ações a serem executadas em caso de sucesso ou falha da operação (consulte Ações de operação). Opções: Defina opções como quando a operação atingirá o tempo limite, o que registrar e o período de registro, quando a operação será executada ou se deseja usar fragmentação de dados (consulte Opções de operação).
	Cut coloca uma cópia da operação na área de transferência e exclui a operação original do projeto (consulte Reutilização de operação).
	Copiar coloca uma cópia da operação na área de transferência (consulte Reutilização de operação).
	Duplicar mostra essas ações de menu (consulte Operação Reutilizar): 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 de operação. Novos componentes são criados para cada etapa de operação e são referenciados pela operação duplicada.
	Deploy mostra estas ações de menu: Deploy: Implanta a operação e suas dependências (consulte Implantação e execução da operação). Implantar e executar: Implanta e executa a operação e quaisquer operações abaixo (vinculadas) (consulte Implantação e execução da operação). Implantação configurável: Abre a tela de implantação, onde você pode selecionar workflows e operações para implantar (consulte Implantação e execução de operações).
	Run executa uma operação já implantada e quaisquer operações abaixo (vinculadas) (consulte Implantação e execução de operação).
	Ver logs abre a tela de log de operação, que inclui logs desta operação e quaisquer operações filhas que foram implantadas e executadas (consulte Logs de operação).
	Renomear posiciona o cursor no nome da operação para você fazer as edições necessárias.
	Visualizar 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 (consulte Dependências de operação, exclusão e remoção).
	Adicionar ao grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou para adicionar o componente a um grupo existente (consulte Grupos de componentes).
	Excluir exclui permanentemente o componente (consulte Dependências de operação, exclusão e remoção).
	Remover remove a operação da quadro de design. Quaisquer outras referências à operação, como em scripts, transformações ou definições de configuração, não são afetadas (consulte 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 em Endpoints e componentes em 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. A tela de configuração do componente também pode ser aberta clicando duas vezes no nome de um componente. p> Para obter detalhes sobre a configuração, consulte o respectivo componente em Conectores, Scripts, Variáveis do Projeto, Transformações, Notificações ou Cronogramas de operação.
	Cut coloca uma cópia do componente na área de transferência e exclui 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 em Arquivos, Scripts, Transformações, Variáveis de Projeto, Categorias Emails e Agendamentos. (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 em Arquivos, Scripts, Transformações, Variáveis de Projeto, Categorias Emails e Agendamentos. (Esta ação não está disponível na categoria Variáveis Globais.)
	Duplicar cria um componente novo e não referenciado usando a mesma configuração do componente original (consulte Reutilização de componente). 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, 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 você fazer as edições necessárias. Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes em Arquivos, Scripts, Transformações, Variáveis de Projeto, Categorias 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 (consulte 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 para adicionar o componente a um grupo existente (consulte Grupos de componentes).
	Excluir exclui permanentemente o componente (consulte 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 em Endpoints e componentes em Arquivos, Scripts, Transformações, Variáveis de Projeto, Categorias Emails e Agendamentos. (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. Quaisquer outras referências aos componentes, como em scripts, transformações ou definições de configuração, não são afetadas. Esta ação está disponível para atividades listadas em uma subcategoria de tipo de endpoint em Endpoints e componentes em Scripts, Transformações, Variáveis de Projeto, Emails e Horários categorias. (Esta ação não está disponível para componentes nas categorias Arquivos ou Variáveis Globais.) Ela é funcional somente quando usada em uma atividade, transformação ou script que é referenciado como uma etapa em uma operação ou quando usado em uma notificação email configurada com uma ação de operação (consulte Dependências, exclusão e remoção de componentes).

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 Conexão Global:

Item do menu	Descrição
	Visualizar/Editar abre a tela de configuração da conexão (consulte a documentação sobre a conexão específica do endpoint em Conectores).
	Teste testa a conexão. Esta ação é o mesmo que clicar no botão Testar disponível em uma tela de configuração de conexão (consulte a documentação sobre a conexão específica do endpoint em Conectores).
	Promover para conexão global converte a conexão em uma conexão global no ambiente onde o projeto reside. Esta ação não está disponível para API, Variável ou SOAP conexões, conexões que usam variáveis em sua configuração de conexão, ou conexões que já são uma conexão global (veja Conexões Globais).