Ir para o conteúdo

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.

visão geral do histórico do projeto

Acessar o histórico do projeto e instantâneas

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

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.

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:

filtros do histórico do projeto

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

    search

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

event details

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:

Tipo de Evento Ações
Mudança: Componente criado, atualizado ou excluído. Para scripts e transformações, informações detalhadas sobre a mudança são expandidas por padrão como pontos de lista aninhados. Esses detalhes podem ser expandidos ou colapsados usando os ícones de seta . Ao clicar em um evento de mudança para um componente criado ou atualizado, a tela de design foca no componente (contornado com uma borda azul), a aba Workflows é exibida com um fundo verde, e o componente é selecionado na aba Components. Clique para ver o componente.
Exportar: Projeto exportado em uma data e hora específicas. Ver detalhes apenas.
Importar: Componente importado. Um ícone de Substituir indica que o componente importado substitui um componente existente. Um ícone de Novo indica que o componente importado é novo. Ver detalhes apenas.
Transferir: evento de transferência seletiva, junto com a tag de histórico do projeto do evento, se presente. Adicionar tags e comentários ou restaurar.
Migrar: Transferência completa de projeto para ou de outro ambiente, junto com a tag de histórico do projeto necessária do evento. Adicionar tags e comentários ou restaurar.
Implantar: Implantação do projeto, junto com a tag de histórico do projeto do evento, se presente. Adicionar tags e comentários ou restaurar.
Restaurar: Projeto restaurado para a versão anterior, junto com a tag de histórico do projeto do evento, se presente. Adicionar tags e comentários ou restaurar.

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:

details

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

Nota

Mudanças indiretas não são registradas. Por exemplo, se um script ou transformação foi alterado indiretamente ao mudar o valor de uma variável usada em um script, esse detalhe não é registrado. No entanto, uma alteração no próprio componente da variável ainda é registrada separadamente.

Gerenciar instantâneas

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.

snapshots tab

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:

    new snapshot

    • 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:

snapshot filter

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

  • Menu de tipo: Filtrar por Automático ou Manual snapshots:

    • Automático: 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 que a transferência ou migração seja aplicada.
      • Importação: O designer do projeto antes que a importação seja aplicada.
    • Manual: Snapshots criados 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 de 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 Detalhes.

  3. O diálogo inclui os seguintes campos:

    diálogo de tag do histórico do projeto

    • 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 projeto 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 instantâneo ao qual deseja restaurar.

  2. Passe o mouse sobre o evento ou instantâneo.

  3. Clique em Restaurar esta versão.

  4. Na caixa de 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).

Nota

Eventos de restauração de projeto não podem ser desfeitos ou refeitos.

Restaurar projetos corrompidos

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

Colaborar durante a restauração

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

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

Esse comportamento evita mudanças inesperadas nas sessões de trabalho ativas sem aviso prévio.