Repository: organizar Domains, Folders e objetos compartilhados

Objetivo e modelo

O Repository organiza o trabalho no tenant ativo por meio de Domains e Folders. Um Domain agrupa atividades relacionadas; cada Folder pertence a um único Domain. Mappings, Sessions, Workflows e Connections mantêm uma localização que ajuda a encontrá-los e compreender suas relações.

A hierarquia não cria outro tenant nem substitui a autorização. Shared within tenant disponibiliza um objeto no escopo permitido dentro do mesmo tenant. Não o publica para outra organização, não muda sua localização proprietária e não cria uma cópia.

Pré-requisitos e navegação

Confirme o tenant e a função ativa no menu da conta. Consultar o repositório, criar localizações e editar ou excluir objetos exigem as permissões correspondentes. A ausência de uma ação pode refletir uma restrição de acesso.

Combine categoria e localização: All, Mappings, Sessions, Workflows, Connections e Shared mostram recortes diferentes. Um objeto pode existir em outra Folder ou estar oculto por um filtro.

Criar uma estrutura de laboratório

1. Abra Repository e selecione New domain.
2. Informe Laboratório ETL e uma descrição indicando que a estrutura contém dados sintéticos.
3. Crie a Folder Clientes Demo e selecione o novo Domain em Parent domain.
4. Abra a Folder e confira o caminho de navegação e a lista antes de criar objetos.
5. No editor de Mapping, selecione o mesmo Domain e a mesma Folder. Salve um pequeno rascunho e localize-o novamente pela categoria Mappings.

Siga as validações de nome e descrição exibidas no formulário. Domains e objetos executáveis têm regras próprias: a aceitação de espaços em um Domain não garante um identificador válido para Mapping ou Session. Parent domain define a propriedade da Folder; não é um diretório de execução.

Interpretar o estado de uma Folder

Congelar e fechar têm efeitos distintos. Abrir um objeto Closed pela lista Shared não contorna seu ciclo de vida. Solicite ao responsável autorizado a revisão do estado; não copie o artefato para evitar a restrição.

Exemplo: propriedade e compartilhamento controlado

Crie as Folders Origem e Consumo no Domain de laboratório. Salve um Mapping em Origem e confira a localização no editor. Se permitido, ative Shared within tenant, escolha um escopo autorizado e salve conforme o ciclo de vida do objeto.

A partir de uma localização consumidora permitida, encontre o Mapping em Shared. Ele deve manter Origem como proprietária e ficar disponível apenas no escopo concedido. Uma identidade sem a permissão necessária deve continuar restrita. Use contas de laboratório autorizadas, sem envolver tenants de outros clientes.

Validação e recuperação

Se a lista estiver vazia, remova filtros e volte à localização superior. Se um nome for inválido, corrija o campo indicado sem recriar a estrutura. Se a exclusão for bloqueada por referências, examine primeiro os consumidores; não suponha uma exclusão em cascata.

Registre o identificador e a localização antes de reorganizar objetos. Nomes facilitam a navegação, mas suas referências não são caminhos comuns do sistema de arquivos. Após salvar, confira a localização persistida e encontre o mesmo objeto novamente.

Purge contents e Delete

Purge contents... remove permanentemente o conteúdo revisado, preservando o Domain/Folder selecionado e o histórico de execução. A prévia pode incluir artefatos, rascunhos, versões e Folders filhas. As abas dos artefatos removidos são fechadas e suas alterações não salvas são descartadas. Delete é outra operação, que remove uma localização vazia elegível.

1. Use um laboratório descartável e a permissão de administração de localizações. Abra o menu da localização correta e selecione Purge contents....
2. Examine o nome do destino, todos os totais e os bloqueios. Se estiver apenas estudando o formulário, use Cancel.
3. Para uma remoção intencional e autorizada, digite exatamente o nome solicitado e confirme que compreende a exclusão permanente.
4. Selecione Purge contents uma vez e aguarde. Se a revisão mudou, use Refresh preview e confirme novamente o alcance atualizado.
5. Se o resultado ficar incerto, use Check result antes de tentar outra remoção.
6. Confira que apenas o conteúdo revisado foi removido e que a localização e o histórico permanecem. Use Delete separadamente se também precisar excluir a localização vazia.

Localizações protegidas e Folders que não estejam Active têm restrições. Não altere registros internos para contornar bloqueios nem suponha que existe uma ação de desfazer. Uma lista filtrada vazia não comprova ausência de dependências.

Relações e limites

Continue em Mappings, Sessions e Workflows. A estrutura do Repository é diferente dos caminhos de arquivos acessíveis ao worker. O exemplo descreve uma verificação de aceitação para seu laboratório, sem afirmar que as permissões do seu tenant já foram testadas.