As cadeias do seu espaço de trabalho podem ser exportadas para um arquivo .chain e compartilhadas com usuários de outro espaço de trabalho, ambiente ou organização. O destinatário do arquivo pode, então, importá-lo para seu próprio espaço de trabalho, definir as configurações e executá-lo em grande parte como está.
Como alternativa aos modelos de cadeia , os arquivos de exportação são recomendados quando as cadeias precisam ser transferidas rapidamente entre espaços de trabalho com alterações mínimas. Os modelos são preferíveis ao armazenar ou compartilhar amplamente modelos de dados com outras pessoas.
Requisitos
- A função Editar é necessária para exportar uma cadeia.
- A função Criar é necessária para importar uma cadeia.
Exportar uma cadeia
Para exportar uma cadeia:
- Em Construtor de Cadeia, vá para a guia Cadeias .
- Localize a cadeia que você deseja exportar, selecione o menu de três pontosno lado direito e clique em Exportar.
- Salve o arquivo .chain em seu computador.
Exportação de cadeias que incluem um evento Executar cadeia
Um evento Executar cadeia permite que você encadeie várias cadeias de modo que uma cadeia inicial ative outras subcadeias posteriormente no processo. Quando as cadeias são unidas dessa forma, você pode exportar a cadeia inteira ou apenas uma parte dela. Você pode exportar uma cadeia de até cinco níveis de profundidade.
Por exemplo, digamos que você tenha cinco cadeias:
| Se você exportar... | |
| Cadeia 1 | Todas as correntes serão incluídas |
| Cadeia 2 | Somente as cadeias 2-5 serão incluídas |
| Cadeia 3 | Somente as cadeias 3-5 serão incluídas |
| Cadeia 4 | Somente as cadeias 4-5 serão incluídas |
| Cadeia 5 | Somente a cadeia 5 será incluída |
Observação: Se a sua exportação incluir um evento Executar cadeia, você deverá ter a permissão Editar tanto para a cadeia original quanto para as subcadeias incluídas.
Importar uma cadeia
Para importar uma cadeia:
- Em Construtor de Cadeia, vá para a guia Cadeias .
- Clique no botão Import no canto superior direito.
- No navegador de arquivos, selecione o arquivo . chain em seu computador.
Após o upload, você precisará configurar a nova cadeia antes que ela possa ser executada em seu espaço de trabalho.
Importação de cadeias com um evento Executar cadeia
Conforme mencionado na seção Exportar uma cadeia, um evento Executar cadeia permite que você execute sequencialmente várias cadeias. Ao importar essas cadeias de várias partes para seu espaço de trabalho, somente a primeira cadeia da sequência é mostrada:
Quando essa cadeia de nível superior estiver configurada, você poderá visualizar e gerenciar as subcadeias também.
Observação: Embora as subcadeias sejam configuradas ao mesmo tempo que a cadeia de nível superior, elas não são publicadas automaticamente. Você precisará publicar manualmente cada cadeia antes que ela possa ser executada.
Configurar uma cadeia
Se você já trabalhou com modelos de corrente no passado, a configuração de uma nova corrente é muito semelhante.
Veja como funciona:
- Na guia Cadeias , localize sua cadeia importada e clique em Configure no lado direito.
- Digite um nome exclusivo para identificar a cadeia.
- Por padrão, -- Importar é adicionado ao nome da cadeia exportada.
- Se a cadeia tiver alguma variável diferente do espaço de trabalho original, configure cada uma delas:
- Para cada conexão usada na cadeia, selecione o conector e o executor para executar seus comandos e clique em Enviar.
PERGUNTAS FREQUENTES
Devo usar modelos de exportação ou de cadeia?
Isso depende muito de seu objetivo inicial, pois ambos os recursos executam muitas das mesmas funções.
Os arquivos de exportação expiram após 14 dias e só podem ser compartilhados enviando o arquivo .chain diretamente para outro usuário. Eles funcionam como um instantâneo no tempo; não se destinam à distribuição ampla ou ao armazenamento de modelos de cadeia.
Os modelos, no entanto, são projetados como um ponto de partida para futuras personalizações. Eles funcionam especialmente bem quando você arquitetou um modelo de cadeia que precisa ser repetidamente compartilhado com outras pessoas.
Saiba mais sobre o uso de modelos de cadeia.
Os arquivos .chain são seguros?
Sim, os arquivos .chain são criptografados na exportação e só podem ser abertos na plataforma Workiva.
O que está incluído em um arquivo .chain?
Um arquivo .chain contém a estrutura da cadeia em si, mas não contém informações específicas do espaço de trabalho, como detalhes de configuração do conector (como OAuth ou segredo do cliente), histórico de execuções ou histórico de versões.
Posso rastrear quando as cadeias são exportadas ou importadas?
Sim, essas ações acionam um evento Exportar ou Import em seus registros de auditoria.
Se sua cadeia incluir um evento Executar cadeia, serão criados eventos de auditoria separados para a cadeia de nível superior e para cada subcadeia na exportação.
Saiba mais sobre o rastreamento de eventos no Construtor de Cadeia.
Os arquivos .chain expiram?
Os arquivos em cadeia expiram após 14 dias.
Há um limite para o número de eventos de Executar cadeia que posso exportar?
Os eventos da cadeia de execução são limitados a um máximo de cinco níveis de profundidade. Na verdade, essa é a cadeia raiz (Cadeia 1 na ilustração acima), além de até quatro cadeias subordinadas.
Se uma cadeia tiver mais de quatro cadeias subordinadas, você não poderá exportá-la.