Histórico do projeto no Jitterbit Studio

Introdução

Esta página descreve como visualizar o histórico do projeto, gerenciar instantâneas e restaurar projetos. O histórico do projeto é armazenado por um máximo de 180 dias. As instantâneas permanecem disponíveis indefinidamente. Quando você exporta um projeto, tanto o histórico do projeto quanto as instantâneas são limpas da versão exportada.

Acessar histórico do projeto e instantâneas

Você pode acessar o painel de Histórico do projeto a partir das seguintes localizações:

• O canvas de design (veja Menu de ações do canvas de design).
• A página de Projetos (veja Visualização em cartão ou Visualização em lista).

O painel 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.
• Instantâneas: Mostra uma lista de instantâneas criadas automaticamente ou manualmente.

Visualizar histórico do projeto

Os eventos do histórico do projeto são agrupados por dia em ordem cronológica reversa. Cada evento é listado individualmente com seu carimbo de data/hora e mostra o primeiro nome e a inicial do sobrenome do usuário. O cabeçalho do dia exibe uma contagem de todos os eventos de alteração para aquele dia.

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 que mostra 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: Insira uma única palavra-chave ou string de palavras-chave. Apenas eventos contendo a string de palavras-chave aparecem, e a string de palavras-chave é 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 eventos exibir. As seguintes opções estão disponíveis:

  • Todos os eventos: Exibe todos os eventos de histórico do projeto com quaisquer tags.
  • 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.

Ver detalhes do evento

Para visualizar ou colapsar os detalhes do evento, clique na seta ao lado de um cabeçalho de dia para expandir ou colapsar todos os eventos daquele dia.

Os seguintes controles adicionais estão disponíveis:

• Expandir / Colapsar tudo: Expande ou colapsa todos os detalhes dos eventos 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 eventos

A tabela a seguir descreve cada tipo de evento:

Informações detalhadas sobre alterações para scripts e transformações

Para componentes de script e transformação, as informações detalhadas sobre alterações são exibidas por padrão como pontos de lista aninhados abaixo da entrada do evento de alteração:

As alterações detalhadas podem incluir o seguinte:

• Mudanças no tipo de script (por exemplo, "O tipo de script foi alterado de JavaScript para Jitterbit Script").
• Mudanças no conteúdo do script (exibido como "O corpo do script foi alterado").
• Mudanças no mapeamento de transformação.
• Outras atualizações de configuração direta.

Comparar alterações

Para eventos de alteração de script e transformação que incluem atualizações de corpo ou regras de mapeamento, um Ver alterações ícone aparece ao lado da entrada de detalhe da alteração. Clique em Ver alterações para abrir uma visualização de diferenças que mostra uma comparação lado a lado do conteúdo do componente antes e depois da alteração.

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

• Abrir: Abre a visualização de diferenças em uma nova janela pop-up.

• Maximizar / Restaurar: Expande a visualização de diferenças para preencher o espaço disponível na tela ou retorna ao seu tamanho padrão.

• Fechar: Fecha a visualização de diferenças.

Você pode arrastar a visualização de diferenças pela barra de título para reposicioná-la em qualquer lugar da tela e redimensioná-la arrastando suas bordas ou cantos.

A visualização de diferenças mostra dois painéis lado a lado:

• Painel esquerdo: Mostra a versão anterior do conteúdo. As linhas removidas estão destacadas em vermelho.
• Painel direito: Mostra a versão atualizada do conteúdo. As linhas adicionadas estão destacadas em verde.

Para transformações, cada regra de mapeamento alterada aparece como uma seção colapsável rotulada com o caminho do campo (por exemplo, "Regra de mapeamento json/isActive"). Clique na seta para expandir ou colapsar seções individuais. Uma barra de rolagem vertical está disponível quando a diferença contém muitas alterações.

Gerenciar instantâneas

As instantâneas capturam o estado do seu projeto em pontos específicos no tempo. Instantâneas automáticas são criadas durante implantações, transferências e importações. Você também pode criar instantâneas manuais.

Criar uma instantânea manual

Para criar uma instantânea, complete estas etapas:

1. Abra a aba Instantâneas no painel de histórico do projeto.

2. Clique no ícone Criar instantânea.

3. A caixa de diálogo Nova instantânea inclui os seguintes campos:

   

   • Tag: Insira uma tag única para rotular a instantânea (obrigatório).
   • Descrição: Insira uma descrição opcional.

4. Clique em Salvar.

As instantâneas são armazenadas indefinidamente.

Filtrar instantâneas

Os seguintes controles estão disponíveis na aba Instantâneas:

• Pesquisar por tag: Insira nomes de tags para encontrar instantâneas específicas.

• Menu de tipo: Filtrar por instantâneas Automáticas ou Manuais:

  • Automáticas: Instantâneas automáticas são capturadas 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 que a transferência ou migração seja aplicada.
    • Importação: O designer do projeto antes que a importação seja aplicada.

  • Manuais: Instantâneas criadas manualmente.

Eventos de tag e snapshots

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

Requisitos de tag

Eventos de transferência devem ser etiquetados a partir da tela de transferência do projeto antes que o projeto possa ser transferido.

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 Implantar das configurações do projeto. Quando ativado, você verá um diálogo que solicita a tag ou comentário necessário ao 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: Insira um rótulo (tag única recomendada, mas não obrigatória).

   • Comentário (eventos) ou Descrição (snapshots): Insira 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 para visualização.

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, complete estas etapas:

1. No painel de histórico do projeto, localize o evento ou snapshot para o qual deseja restaurar.

2. Passe o mouse sobre o evento ou snapshot.

3. Clique em Restaurar esta versão.

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

O designer do 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.

Alternativamente, 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 à corrupção.

Colaborar durante a restauração

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

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

Esse comportamento previne mudanças inesperadas nas sessões de trabalho ativas sem aviso.