Criar e configurar um projeto no Jitterbit Studio

Introdução

Um projeto é uma coleção de um ou mais fluxos de trabalho que compõem e executam um caso de uso de integração. Os projetos são o "container" para operações que estão organizadas em fluxos de trabalho, bem como outros componentes do projeto que podem fazer parte de uma operação ou existir em outro lugar no projeto.

Esta página descreve como criar e configurar um novo projeto a partir do Studio, como abrir um projeto existente, como editar as configurações de configuração de projetos existentes e como excluir projetos existentes.

Novos projetos do Studio também podem ser criados usando receitas de integração do Studio ou modelos de processo do Studio fornecidos através do Jitterbit Marketplace. Para informações sobre como criar um novo projeto do Studio a partir do Marketplace, veja Iniciar um projeto de receita ou modelo.

Criar um novo projeto

Novos projetos são criados a partir da página Projetos. Esta página contém um repositório de projetos do Studio acessíveis. Se não houver projetos acessíveis na organização selecionada, nenhum será listado.

Para criar um novo projeto do Studio, clique em Novo Projeto:

Ao clicar em Novo Projeto, a tela de configuração do projeto é aberta. Cinco abas estão disponíveis: Aba Geral, Aba de Papéis de Usuário, Aba Designer, Aba de Implantação e Aba Avançada.

Observe que um projeto não é implantado automaticamente após a criação (veja Implantação de Projetos).

Para informações sobre como fazer alterações na configuração do projeto após sua criação, veja Editar configurações do projeto mais adiante nesta página.

Aba Geral

Esta aba possui as seguintes configurações:

• Nome do projeto: Insira um nome para identificar o projeto. O nome do projeto deve ser único para cada ambiente e não pode já estar em uso como um nome de projeto do Design Studio no mesmo ambiente. Se um projeto com o mesmo nome já existir na nuvem Harmony, acesse a página Console de Gerenciamento > Projetos para gerenciar o projeto implantado.

  Dica

  Ao renomear um projeto que já foi implantado, o novo nome do projeto é automaticamente refletido na nuvem Harmony sem a necessidade de uma nova implantação.

• Ambiente: Use o menu suspenso para selecionar um ambiente existente onde você deseja criar o projeto. Administradores da organização podem configurar novos ambientes através da página Console de Gerenciamento > Ambientes.

  Dica

  Se você não vê um ambiente recém-criado disponível para seleção, atualize a página Projetos para forçar o recarregamento dos ambientes.

  Ao editar as configurações de um projeto, observe que o ambiente não pode ser alterado. No entanto, o projeto pode ser transferido para outro ambiente.

• Descrição: Insira uma descrição opcional para o projeto. Esta descrição aparecerá na página Projetos e pode ser útil para ajudar os colaboradores do projeto a entender o projeto.

Ao editar as configurações de um projeto, essas informações estão disponíveis na aba Geral:

• Ambiente: O ambiente em que o projeto reside (especificado durante a criação do projeto ou transferência).

• Grupo de Agentes: O grupo de agentes associado ao ambiente em que o projeto reside (especificado no Console de Gerenciamento).

• Criado em: A data e hora em que o projeto foi criado.

Aba de Papéis de Usuário

A aba Papéis de Usuário controla quais papéis podem ver o projeto na página de Projetos no Studio e na página de Projetos no Console de Gerenciamento. A aba contém uma caixa de pesquisa e uma tabela com as seguintes colunas:

• Papel de Usuário: Lista os papéis na organização. Os papéis que aparecem dependem da sua associação de papéis, conforme descrito abaixo.

• Acesso ao Papel: O nível de acesso mais alto que o papel possui no ambiente. Os valores possíveis são Ver Logs, Ler, Executar e Escrever.

• Habilitado: Um interruptor que controla se o projeto é visível na página de Projetos no Studio e na página de Projetos do Console de Gerenciamento para membros desse papel.

Quando um novo projeto é criado, todos os papéis dos quais o usuário criador é membro são habilitados por padrão, juntamente com o papel de Administrador, que está sempre habilitado.

Os papéis que aparecem na tabela e se a configuração Habilitado pode ser alternada dependem da sua associação de papéis. Para modificar os interruptores Habilitado, os usuários devem ter acesso ao ambiente de Escrever. Usuários com acesso ao ambiente de Ver Logs, Ler ou Executar podem visualizar a aba, mas não podem editá-la.

• Se você é membro de um papel com permissão de Admin, a tabela lista todos os papéis na organização que têm pelo menos acesso de Ver Logs ao ambiente, com o papel de Administrador sempre listado primeiro. Todos os interruptores podem ser alternados, exceto o papel de Administrador e o último papel do qual você é membro.

• Se você não é membro de um papel com permissão de Admin, apenas os papéis aos quais você pertence aparecem na tabela. Se você pertence exatamente a um papel, seu interruptor está habilitado e não pode ser alterado. Se você pertence a mais de um papel, seus interruptores podem ser alternados individualmente, mas pelo menos um deve sempre permanecer habilitado.

O papel de Administrador é sempre exibido com seu alternador permanentemente ativado.

As alterações nas configurações de visibilidade do papel entram em vigor imediatamente e não requerem uma implantação do projeto.

Aba Designer

Esta aba possui as seguintes configurações:

• Auto-numerar operações na tela de design: Selecione para mostrar um número sequencial precedendo o nome de cada operação na tela de design. Os números das operações correspondem ao fluxo de trabalho em que cada operação está. Por exemplo, no fluxo de trabalho 2.0, as operações são auto-numeradas como 2.0, 2.1, 2.2, e assim por diante. A auto-numeração é exibida apenas durante o tempo de design; os números não aparecem como parte do nome da operação nos logs de operação.

Aba Deploy

Esta aba possui as seguintes configurações:

• Requer comentários ao implantar: Selecione para exigir que cada vez que este projeto for implantado, um diálogo seja apresentado solicitando que um comentário seja adicionado.
• Requer tags ao implantar: Selecione para exigir que cada vez que este projeto for implantado, um diálogo seja apresentado solicitando que uma tag seja adicionada.
• Regra de validação HTTP: Habilitada por padrão. Desabilitar esta configuração normalmente não é necessário. Para mais informações, consulte erros de regra de validação HTTP em Solução de problemas de design de operação.

Aba Avançada

Esta aba possui a seguinte configuração:

• Ativar novo analisador de script Jitterbit: Habilitado por padrão a partir da versão 10.68 / 11.6. Desabilitar esta configuração normalmente não é necessário e é aconselhado apenas se você experimentar uma saída de script inesperada.

• Preservar nomes JSON: Determina qual método de processamento de esquema é usado durante o design e a execução do projeto, seja o processamento de nomes JSON preservados (ativado), ou o processamento JSON legado (desativado). A versão usada por padrão depende de quando o projeto foi criado e da versão do agente em uso:

  • Processamento de nomes JSON preservados: O padrão para projetos criados após o [lançamento 11.48 Harmony] e executando na versão do agente 11.48 ou posterior.

  • Processamento JSON legado: O padrão para projetos criados antes do [lançamento 11.48 Harmony] ou aqueles executando na versão do agente 11.47 ou anterior. A configuração Preservar nomes JSON pode ser ativada em tais projetos uma vez que a versão do agente seja atualizada para 11.48 ou posterior.

Abrir um projeto existente

Projetos existentes são exibidos na página Projetos filtrados por ambiente. Apenas projetos para os quais seu papel tem visibilidade habilitada são mostrados (veja a aba de papéis de usuário). Use o menu suspenso de ambiente para selecionar um ambiente diferente para sua organização selecionada.

Projetos existentes podem ser abertos a partir da visualização de mosaico do projeto ou da visualização de lista do projeto. Para detalhes sobre todas as opções disponíveis em cada uma dessas visualizações, veja Projetos.

• Visualização de mosaico do projeto: Clique no ícone de visualização de mosaico para entrar na visualização de mosaico. Em seguida, passe o mouse sobre um mosaico de projeto e selecione Visualizar/Editar para abrir o projeto no designer de projetos:

  

• Visualização de lista do projeto: Clique no ícone de visualização de lista para entrar na visualização de lista. Em seguida, passe o mouse sobre a célula vazia na coluna Ações e clique no ícone de edição para abrir o projeto no designer de projetos:

  

Editar configurações do projeto

Um projeto é configurado inicialmente durante a criação do projeto, abordada anteriormente nesta página. Após a criação de um projeto, é possível editar as configurações do projeto para fazer alterações no nome do projeto, descrição ou visibilidade de funções, ou para exportar ou excluir o projeto.

A opção Configurações do projeto está acessível a partir da página Projetos e da barra de ferramentas do projeto.

Isso abre a tela de configuração do projeto. Cinco abas estão disponíveis, conforme descrito acima, e estas opções adicionais:

• Salvar: Salva e fecha a configuração do projeto. Este botão será habilitado apenas após você ter feito alterações nas configurações existentes.

• Cancelar: Fecha a configuração do projeto sem salvar.

• Exportar: Gera e inicia o download de um arquivo JSON do projeto do Studio. Uma exportação de projeto pode ser usada, por exemplo, como um backup do projeto ou para compartilhar uma cópia do projeto. Para detalhes, veja Exportações e importações de projetos.

• Mover para a lixeira: Remove o projeto do ambiente no Studio e na nuvem Harmony. Projetos podem ser restaurados até 90 dias após serem movidos para a lixeira. Após 90 dias, o projeto é excluído permanentemente e não pode ser restaurado (veja Excluir e restaurar um projeto mais adiante nesta página).

Excluir e restaurar um projeto

Você pode excluir, restaurar ou excluir permanentemente um projeto na página Projetos.

A opção Mover para a lixeira está acessível a partir destes locais:

• As configurações do projeto (veja Editar configurações do projeto mais cedo nesta página).
• A página Projetos (veja Visualização em bloco ou Visualização em lista em Projetos).

Ao clicar em Mover para a lixeira, uma mensagem de confirmação solicita que você confirme que deseja mover o projeto para a lixeira:

As opções Restaurar e Excluir permanentemente estão acessíveis a partir da página Projetos (veja Visualização em bloco ou Visualização em lista em Projetos).

Ao clicar em Excluir permanentemente, uma mensagem de confirmação solicita que você confirme que deseja excluir permanentemente o projeto:

Você deve digitar a palavra EXCLUIR para habilitar o botão Excluir.

Solução de problemas

Razões comuns pelas quais você pode não conseguir excluir um projeto são que o projeto possui projetos dependentes ou que o projeto possui operações com um status incompleto.

Projetos transferidos

Se o projeto que você está tentando excluir foi transferido, ele não pode ser excluído até que você primeiro exclua todos os projetos mais abaixo na cadeia de transferência (veja Cadeias de transferência em Transferir um projeto). Após clicar em Excluir na caixa de diálogo Excluir para sempre, uma segunda caixa de diálogo indica que o projeto não pode ser excluído e inclui os nomes e ambientes dos projetos transferidos que impedem a exclusão:

Para resolver, primeiro exclua todos os projetos mais abaixo nessa cadeia de transferência (listados na caixa de diálogo) e, em seguida, tente excluir o projeto original novamente.

Operações com status incompleto

Projetos com operações enviadas que estão em um status incompleto não podem ser movidos para a lixeira. Se o projeto que você está tentando mover para a lixeira tiver alguma operação em status incompleto, incluindo Enviado, Recebido, Pendente, Executando, Cancelamento solicitado ou Status atrasado, uma mensagem de erro será retornada.

Para resolver, você pode cancelar operações incompletas a partir destes locais:

• A operação (veja status da operação em Canvas de design).
• A tabela de logs de operações.
• A página Runtime do Console de Gerenciamento.