Histórico do projeto no Jitterbit Studio

Introdução

Esta página descreve como visualizar o histórico do projeto, gerenciar snapshots e restaurar projetos. O histórico do projeto é armazenado por um máximo de 180 dias. Os snapshots permanecem disponíveis indefinidamente. Ao exportar um projeto, tanto o histórico do projeto quanto os snapshots são removidos da versão exportada.

Acessar o histórico do projeto e snapshots

Você pode acessar a gaveta Histórico do projeto nos seguintes locais:

• A tela de design (consulte Menu de ações da tela de design).
• A página Projetos (consulte Visualização em cards ou Visualização em lista).

A gaveta contém duas abas:

• Histórico do projeto: Mostra uma lista de alterações e implantações do projeto. Cada entrada inclui a data, hora e o usuário que realizou cada ação.
• Snapshots: Mostra uma lista de snapshots criados automaticamente ou manualmente.

Visualizar o histórico do projeto

Os eventos do histórico do projeto são agrupados por dia em ordem cronológica inversa. Cada evento é listado individualmente com seu timestamp e mostra o primeiro nome e inicial do sobrenome do usuário.

Os eventos de alteração de componente exibem um ícone que identifica o tipo de componente. Passe o mouse sobre o ícone para visualizar uma dica de ferramenta mostrando o tipo (por exemplo, "Script", "Variável global" ou "Transformação").

Filtrar histórico

Os seguintes controles estão disponíveis para filtrar a visualização do histórico:

• Caixa de pesquisa: Digite uma palavra-chave única ou uma sequência de palavras-chave. Apenas eventos contendo a sequência de palavras-chave aparecem, e a sequência é destacada em azul.

  

• Menu de período: Selecione Últimos 30 dias, Últimos 60 dias, Últimos 90 dias ou Últimos 180 dias.

• Menu de tipo de evento: Selecione quais tipos de evento deseja exibir. As seguintes opções estão disponíveis:

  • Todos os eventos: Exibe todos os eventos do histórico do projeto com qualquer tag.
  • Implantações: Exibe apenas eventos de implantação.
  • Migrações: Exibe apenas transferências completas de projeto.
  • Importações: Exibe apenas eventos de importação.
  • Transferências: Exibe apenas eventos de transferência seletiva.
  • Marcados: Exibe eventos que foram marcados com tags.

Visualizar detalhes do evento

Para visualizar ou recolher os detalhes do evento, clique na seta ao lado do cabeçalho do dia para expandir ou recolher todos os eventos desse dia.

Os seguintes controles adicionais estão disponíveis:

• Expandir / Recolher tudo: Expande ou recolhe todos os detalhes do evento de uma vez.
• Restaurar última versão implantada: Restaura o projeto para a última implantação.
• Baixar como CSV: Baixa os dados do histórico filtrado atual.

Tipos de evento

A tabela a seguir descreve cada tipo de evento:

Informações detalhadas de alterações

Para componentes de script, transformação, ferramenta, notificação por email, operação, variável de projeto e configuração de endpoint de conector e atividade, as informações detalhadas de alterações são exibidas por padrão como pontos de marcação aninhados sob a entrada do evento de alteração:

As alterações detalhadas podem incluir o seguinte:

• Alterações de tipo de script (por exemplo, "Script type was changed from JavaScript to Jitterbit Script").
• Alterações de conteúdo de script (exibidas como "Script body was changed").
• Alterações de mapeamento de transformação.
• Alterações de configuração de ferramenta, como campos de condição, operadores e valores de uma ferramenta Decision.
• Alterações de campo de notificação por email, como alterações de destinatário, assunto ou mensagem.
• Alterações de configuração de operação, como alterações de agendamento, ação ou opção.
• Alterações de campo de variável de projeto, como alterações de valor padrão ou descrição.
• Alterações de campo de configuração de endpoint de conector e atividade, incluindo alterações de campo de autenticação (por exemplo, "Authentication type changed").
• Outras atualizações de configuração direta.

Comparar alterações

Para eventos de alteração que incluem atualizações de conteúdo ou configuração, um ícone View changes aparece ao lado da entrada de detalhe de alteração. Clique em View changes para abrir uma visualização de diff que mostra o conteúdo ou a configuração do componente antes e depois da alteração.

A barra de título da visualização de diff exibe o timestamp do evento, o tipo de componente e o nome do componente (por exemplo, "7:06am Script: Fine Tune Data"). Os seguintes controles estão disponíveis na barra de título:

• Pop-out: Abre a visualização de diff em uma nova janela pop-up.

• Maximize / Restore: Expande a visualização de diff para preencher o espaço de tela disponível ou a retorna ao seu tamanho padrão.

• Close: Fecha a visualização de diff.

Você pode arrastar a visualização de diff pela sua barra de título para reposicioná-la em qualquer lugar da tela e redimensioná-la arrastando suas bordas ou cantos. Uma barra de rolagem vertical está disponível quando o diff contém muitas alterações.

A visualização de diff usa um dos seguintes formatos, dependendo do tipo de componente:

• Code diff view: Usada para scripts e transformações. Mostra dois painéis lado a lado:

  • Left panel: Mostra a versão anterior do conteúdo. Linhas removidas são destacadas em vermelho.

  • Right panel: Mostra a versão atualizada do conteúdo. Linhas adicionadas são destacadas em verde.

  Para transformações, cada regra de mapeamento alterada aparece como uma seção recolhível rotulada com o caminho do campo (por exemplo, "Mapping rule json/isActive"). Clique na seta para expandir ou recolher seções individuais.

• Field comparison diff view: Usada para ferramentas, notificações por email, operações (incluindo seus agendamentos, ações e opções), variáveis de projeto, endpoints de conector e atividades de conector. Mostra uma tabela com colunas Name, Before e After listando cada campo alterado:

  

  Uma linha alterada é tingida de vermelho na coluna Before e verde na coluna After, e os caracteres ou palavras específicos que mudaram dentro de um valor são destacados mais fortemente. Campos relacionados são agrupados sob cabeçalhos de seção, como as condições individuais de uma ferramenta Decision, os grupos de opção aninhados de um endpoint de conector ou as etapas de uma atividade de conector. Um campo cujo valor faz referência a uma variável de projeto ou variável global é exibido como uma referência vinculada mostrando o nome da variável em vez de seu valor literal. Um campo de credencial, como uma senha ou token de segurança, é mascarado nas colunas Before e After.

Um campo cujo nome ou valor é muito longo para exibir na tabela, ou cujo valor é um objeto ou array (mostrado como uma string JSON), inclui um ícone de expansão. Clique no ícone para abrir um diff inline do conteúdo desse campo, exibido como um diff de código com linhas removidas destacadas em vermelho e linhas adicionadas destacadas em verde.

Para uma atividade de conector que consulta ou recupera dados, um campo Response pode mostrar o esquema de resposta como uma árvore expansível. Os campos adicionados ao esquema são destacados em verde.

Gerenciar snapshots

Os snapshots capturam o estado do seu projeto em pontos específicos no tempo. Os snapshots automáticos são criados durante implantações, transferências e importações. Você também pode criar snapshots manuais.

Criar um snapshot manual

Para criar um snapshot, complete estas etapas:

1. Abra a aba Snapshots na gaveta de histórico do projeto.

2. Clique no ícone Criar snapshot.

3. O diálogo Novo snapshot inclui os seguintes campos:

   

   • Tag: Digite uma tag única para rotular o snapshot (obrigatório).
   • Descrição: Digite uma descrição opcional.

4. Clique em Salvar.

Os snapshots são armazenados indefinidamente.

Filtrar snapshots

Os seguintes controles estão disponíveis na aba Snapshots:

• Pesquisar por tag: Digite nomes de tags para encontrar snapshots específicos.

• Menu Tipo: Filtre por snapshots Automáticos ou Manuais:

  • Automático: Os snapshots automáticos são capturados durante estes eventos:

    • Implantação: O designer do projeto no momento da implantação.
    • Transferência ou migração: O designer do projeto de destino antes da transferência ou migração ser aplicada.
    • Importação: O designer do projeto antes da importação ser aplicada.

  • Manual: Snapshots criados manualmente.

Marcar eventos e snapshots

Os eventos de transferência, implantação e restauração podem incluir tags e comentários para versionamento e organização.

Requisitos de tag

Os eventos de transferência devem ser marcados com tag na tela de transferência do projeto antes que o projeto possa ser transferido.

Os eventos de implantação podem ser configurados para exigir tags ou comentários. Para exigir tags ou comentários no momento da implantação, ative Exigir tags ao implantar na aba Deploy das configurações do projeto. Quando ativado, você verá um diálogo que solicita a tag ou comentário obrigatório quando implantar o projeto.

Adicionar ou editar tags

Para adicionar ou editar uma tag, complete estas etapas:

1. Passe o mouse sobre o evento ou snapshot.

2. Clique em Detalhes.

3. O diálogo inclui os seguintes campos:

   

   • Tag: Digite um rótulo (tag única recomendada, mas não obrigatória).

   • Comentário (eventos) ou Descrição (snapshots): Digite informações adicionais.

4. Clique em Salvar.

Você pode editar tags e comentários que adicionou. Tags e comentários adicionados por outros usuários são somente leitura.

Restaurar um projeto

Backups de projetos são criados automaticamente quando você transfere, implanta ou restaura um projeto.

Restaurar para uma versão específica

Para restaurar um projeto, siga estas etapas:

1. Na gaveta de histórico do projeto, localize o evento ou snapshot que deseja restaurar.

2. Passe o mouse sobre o evento ou snapshot.

3. Clique em Restaurar esta versão.

4. Na caixa de diálogo de confirmação, clique em Restaurar.

O designer de projeto reverte para a versão selecionada. Esta ação não afeta a versão implantada. Reimplante o projeto para implantar o estado restaurado.

Como alternativa, você pode restaurar seu projeto para a última versão implantada usando o ícone Restaurar última versão implantada (descrito acima).

Restaurar projetos corrompidos

Se um projeto estiver corrompido e não puder ser aberto, você pode acessar o histórico do projeto no menu de ações do projeto na página Projetos e restaurar o projeto para um estado anterior antes da corrupção ocorrer.

Colaborar durante a restauração

Quando vários usuários trabalham no mesmo projeto simultaneamente e alguém restaura o projeto, ocorre o seguinte:

• Uma caixa de diálogo informativa aparece para todos os usuários ativos.
• Fechar a caixa de diálogo atualiza a visualização deles para refletir o estado do projeto restaurado.

Este comportamento evita mudanças inesperadas nas sessões de trabalho ativas sem aviso.