Antes de começar
Uma Session reutiliza um Mapping publicado em um contexto de execução. Não redefine o algoritmo. Prepare uma versão aceita, localização autorizada e capacidade compatível. Separe permissões de edição, publicação e execução. Arquivos locais do navegador não aparecem automaticamente no sistema de arquivos do worker.
Escolha ambiente e destino de laboratório antes de testar escritas. Classificar o ambiente como Production não concede permissão nem publica o artefato.
Procedimento
- Crie a Session e selecione o Mapping publicado. Confira identificador e versão, não apenas o nome.
- Revise o ambiente e a política de worker. Mantenha a seleção herdada se não precisar de atribuição explícita; qualquer escolha deve atender a capacidades e permissões.
- Complete conexões e bindings de entrada/saída. Use caminhos acessíveis pelo worker selecionado e uma saída exclusiva de teste.
- Configure parâmetros declarados com os tipos corretos. Overrides de tarefa pertencem ao Workflow, não às camadas da Session.
- Revise timeout, tentativas e recuperação. Salve o rascunho e publique a versão aceita antes de usá-la em um Workflow.
Exemplo sintético
Um Mapping lê name,amount de um CSV e mantém ambas as colunas. Crie duas Sessions com a mesma referência de Mapping: uma para Test e outra para Stage. Use entradas equivalentes e saídas diferentes. As diferenças de caminhos pertencem aos bindings; não é necessário duplicar o algoritmo apenas para mudar o arquivo.
Conferir o resultado
Reabra a Session e confirme referência de Mapping, versão, ambiente, política de worker e bindings. Nos parâmetros, confira a origem do valor resolvido. Crie um Workflow de laboratório para cada contexto e compare esquema e dados produzidos. Salvar corretamente não comprova que conexões ou arquivos estarão acessíveis na execução.
Ao atualizar um Mapping, revise o aviso de dependência e aceite a nova versão deliberadamente. Depois confira os Workflows que consomem essa Session.
Resolver problemas
Para arquivo ausente, corrija o binding e confira permissões do worker. Para falta de capacidade, diferencie estado do worker, slots, requisitos e políticas do tenant. Corrija JSON inválido sem descartar outras configurações. Um checkpoint só ajuda quando existe estado utilizável; não desfaz automaticamente escritas externas. Antes de repetir uma carga, determine se o destino permite novas tentativas sem duplicatas.
Runtime: perfil, nomes e variáveis
Em Runtime escolha Execution profile e compare limites de entrada, memória, disco e timeout com a capacidade do worker. Um perfil automático pode permitir menos bytes que seu arquivo; espaço livre na VM não aumenta esse limite nem a memória temporária do executor isolado.
Available runtime variables mostra nome, significado, Example preview e Last resolved value. O exemplo ajuda na configuração; o valor resolvido pertence ao run identificado e à sua data. Valores sensíveis ficam ocultos. Quando não existe uma execução compatível, o exemplo não substitui um valor real.
Para nomes de saída use Target filename timestamp e Target filename template. %RUN_TIMESTAMP% é resolvido no início da tentativa. Enabled o ativa para a Session; Disabled o desativa; Inherit segue a preferência global. Escrever o token no template enquanto o modo herdado está desativado não ativa a substituição. Filename preview · example ilustra o nome, sem comprovar a saída real de um run. Salve e publique para que os consumidores possam adotar a mudança.
General: escolher a localização antes do Mapping
Depois de Name, preencha Domain → Folder → Mapping e depois Environment e Status. Os mappings disponíveis são filtrados por Domain e permissões de compartilhamento e carregam ao abrir o formulário, sem selecionar Domain novamente. Folder organiza a Session e não exige que o Mapping esteja na mesma pasta. Ao mudar a localização, revise as opções e mantenha uma referência válida antes de salvar.
TRACE opcional
Em Sessions → Runtime, TRACE oferece Inherit from Workflow, Enabled ou Disabled. Inherit from Workflow segue o Workflow que a executa; uma execução direta de Session sem Workflow resolve a herança como desativada. Enabled e Disabled substituem a herança para aquela Session. Inherit from Workflow é o padrão e novos Workflows têm TRACE desativado.
O ajuste controla a geração de detalhes TRACE nas novas tentativas; não remove evidências históricas nem oculta INFO, WARNING ou ERROR. Salve, publique e atualize as versões das dependências do Workflow quando necessário para executar o ajuste aceito.
Contexto de ambiente
Antes de usar este módulo, confirme Tenant, Domain e Environment no menu do usuário. O ambiente inicial é Development. As capacidades do módulo, Domain e ambiente se aplicam juntas; Production fica somente leitura sem autorização explícita. Mudar o seletor não transfere artefatos nem publica ou executa seus dados. Consulte ambientes e recuperação e promoção entre ambientes.
Worker Unassigned
Antes de executar novamente, escolha capacidade compatível e autorizada e revise o pool do ambiente. Unassigned não seleciona outro worker silenciosamente. Você pode provisionar uma nova VM e atribuí-la explicitamente. Permissões, propriedade do recurso, servidor base protegido e operações pendentes continuam sendo verificadas; a retirada não ignora essas proteções.
Barra da lista e escopo do ambiente
Na lista de Sessions, os botões de ações usam ícones com ajuda e nomes acessíveis e ficam alinhados com Search e os filtros. Identifique-os com o ponteiro ou percorrendo-os com Tab. O filtro Environment é removido dessa lista: ela usa o contexto Tenant, Domain e Environment selecionado no menu do usuário e visível na barra inferior. Runtime e os demais filtros continuam disponíveis. Essa alteração da lista não remove a configuração Runtime da Session nem seus requisitos de worker.