Centro de suporte da Workiva

Importante: Clicar em Cancelar em qualquer uma dessas guias fecha a caixa de diálogo de configuração de comando. Todas as alterações feitas desde o último tempo em que você clicou em Salvar serão descartadas e não poderão ser recuperadas.

Guia Alterar comando

A guia Alterar comando permite que você defina quais campos devem ser considerados ou excluídos quando esse comando for executado.

Para alterar esse comando, você deve selecionar a guia Modify command :

1. Selecione a guia Alterar comando.
2. (Opção) Em Name, Altere o nome padrão fornecido.
3. (Opção) Em Description, insira uma descrição útil do que o comando está configurado para fazer.

4. Em Command Properties, selecione a Workday Connection apropriada para esse comando e o tipo de conexão (CloudRunner ou GroundRunner).

   Nota: CloudRunner é a seleção padrão, mas essa conexão também funcionará usando um GroundRunner. Para obter informações sobre como instalar e usar um GroundRunner, consulte a página de suporte da Workiva Instalar e gerenciar GroundRunners.

5. Selecione o arquivo de entrada a ser usado.
   Você pode selecionar o arquivo .csv que contém os dados da fonte. Um modelo desse arquivo pode ser obtido na documentação da Workiva.

   Nota: Se você estiver usando um modelo EIB (veja abaixo), os cabeçalhos do CSV devem corresponder aos campos definidos no arquivo de modelo.

6. Em Configuração de orçamento, insira o Budget Structure ID associado à estrutura do plano e o Custom_Budget_ID associado ao nome do plano financeiro.

7. Selecione o modo de importação a ser usado.

   Modo de importação	Comportamento
   Somente adicionar incremental	Adiciona novas linhas e atualiza as existentes. Não exclui nada.
   Substituir tudo	Exclui todo o plano de orçamento existente e o substitui estritamente pelos dados que você tem no arquivo.
   Incremental Add with Delete (Adicionar Incremental com Excluir)	Sincroniza o sistema para que você corresponda ao arquivo carregado. Adiciona novas linhas, atualiza as existentes e exclui quaisquer linhas do sistema que estejam faltando no arquivo carregado.
   Substituir tudo por período	Limpa e substitui os dados somente para os períodos de tempo localizados no arquivo carregado. Você preserva dados para outros meses/períodos.

8. (Opção) Insira um Memo com uma descrição da finalidade do comando.

9. Selecione as ações a serem acionadas quando esse nó for concluído.

   Comando	Descrição
   Conclusão automática	Quando marcada (marcada), o processo de negócios é processado automaticamente. Isso significa que todas as aprovações serão automaticamente aprovadas no sistema, todas as revisões e tarefas serão automaticamente ignoradas e todas as notificações serão automaticamente suprimidas.
   Enviar	Quando marcado (checked), a cadeia envia automaticamente a ação.

Se você não estiver usando um arquivo de modelo EIB, pode ignorar os dois. Se não estiver usando um arquivo de modelo EIB, você pode ignorar essas duas informações.

Nota:O modelo EIB deve ser um arquivo XML que define os campos necessários para que você conclua uma ação Import Budget. Se você especificar, isso terá precedência sobre os dados de "Configuração do orçamento".

1. Se você estiver usando um arquivo de modelo EIB para importar os dados do orçamento, insira o nome do arquivo no campo EIB template file.
2. (Opção) Selecione a caixa de seleção Ignore warnings para ignorar todos os avisos de campos opcionais ausentes.
   O arquivo de modelo conterá campos opcionais, portanto, o comando emitirá um erro se os campos não estiverem presentes, a menos que essa opção tenha sido selecionada.
   Essa opção é aplicável apenas para importar processos orçamentários usando um modelo EIB.

Guia Notificações

A guia Notifications permite que você defina um e-mail de notificação a ser enviado quando uma condição for atendida.

Para estabelecer uma notificação:

1. Selecione a guia Notifications (Notificações ).
2. Clique em Nova notificação.
3. Clique em Email.
   

4. Preencha os campos no painel de notificação. 

   

   Campos do painel de notificação

   Nome do campo	Valores e ações suportados
   Condição	As condições suportadas são: Sucesso: o comando foi concluído corretamente. Erro: o comando falhou de alguma forma. Aviso: indica que um resultado pretendido foi afetado, mas pode haver circunstâncias pendentes sobre como isso ocorreu. Verifique os logs de saída do comando para saber por que isso foi acionado.  Pausa é um status para o comando. Se o comando estiver "pausado", a notificação será enviada. Não tem nada a ver com a pausa das notificações. Sempre enviar: Sempre envia a mensagem.
   Destinatários	Endereços de e-mail (deve ser um endereço de e-mail completo) para os quais a mensagem deve ser enviada. Se você clicar nesse campo, abrirá uma lista suspensa com todos os endereços de e-mail válidos para o espaço de trabalho|workspace. Nenhum outro e-mail pode ser fornecido.
   Assunto	A linha de assunto do e-mail. O padrão usa as variáveis Chain.Environment, Chain.Name e Command Name, seguidas da condição selecionada, mas você pode inserir seu próprio texto, se desejar.
   Anexo	Isso permite que você anexe um arquivo ao e-mail. Selecione o arquivo dentre os listados no painel Selecione uma variável à esquerda da caixa de diálogo de configuração.
   Nome do anexo	Este é o nome (incluindo a extensão, como .txt ou .csv) a ser atribuído ao arquivo.
   Corpo da mensagem	O texto a ser exibido na mensagem de e-mail. Você pode usar formatação HTML básica.

5. Clique em Salvar.

Para enviar notificações adicionais por e-mail, clique em Nova notificação abaixo da notificação atual e repita estas etapas.

Para obter mais informações sobre notificações, consulte a página de Suporte da Workiva Gerenciar notificações de cadeia e comando.

Pular a guia Condições

A guia Skip conditions permite que você especifique uma condição que fará com que o comando seja ignorado e o que acontecerá se o comando for ignorado.

Para estabelecer uma condição de ignorar esse comando, você deve selecionar a guia

1. Selecione a guia Skip conditions (Ignorar condições ).
2. Clique no campo Skip conditions e selecione a condição de acionamento.
   As opções são: 
   • Sucesso (o comando foi concluído corretamente).
   • Error (o comando falhou de alguma forma).

   • Aviso (indica que um resultado pretendido foi afetado, mas pode haver circunstâncias pendentes sobre como isso aconteceu. Verifique os logs de saída do comando para obter razões mais específicas sobre por que isso foi acionado.)

     

3. Crie a regra que determina o que acontece quando o comando é ignorado.
   1. Selecione AND ou OR. Por padrão, a primeira instrução começa com AND.

   2. Clique em +RULE e selecione o tipo de dados que você deseja testar.
      As opções são String (padrão), Integer, Date, Float e JSON.

      

   3. Insira os critérios que devem ser usados para o teste.

   4. Selecione o valor do teste. As opções são as seguintes:

      Opção	Resultado
      Está em branco	O resultado está em branco (um conjunto vazio).
      Is Not Blank	O resultado não é um conjunto vazio.
      Contém	O resultado contém um valor específico. Selecionar isso abre um campo secundário para que você insira a string a ser correspondida.
      Corresponde a RegExp	O resultado corresponde à expressão regular específica. Selecionar isso abre um campo secundário para você inserir a expressão regular.
      Começa com	O resultado começa com uma cadeia específica. Selecionar isso abre um campo secundário para você inserir a string.
      Encerra com	O resultado encerra com uma string específica. Selecionar isso abre um campo secundário para você inserir a string.
      = (igual)	O resultado corresponde a um valor específico. Selecionar isso abre um campo secundário para que você insira o valor.
      != (não é igual)	O resultado não corresponde a um valor específico. Selecionar isso abre um campo secundário para que você insira o valor.
      < (menor que)	O resultado é menor do que um valor específico. Selecionar isso abre um campo secundário para que você insira o valor.
      > (maior que)	O resultado é maior do que um valor específico. Selecionar isso abre um campo secundário para que você insira o valor.
      <= (menor ou igual a)	O resultado é menor ou igual a um valor específico. Selecionar isso abre um campo secundário para que você insira o valor.
      >= (maior ou igual a)	O resultado é maior ou igual a um valor específico. Selecionar isso abre um campo secundário para que você insira o valor a ser considerado.

4. Se você tiver apenas uma condição, clique em Salvar.
5. Se você tiver mais de uma condição, clique em +RULE novamente para adicionar uma única condição ou +GROUP para fazer com que as condições sejam avaliadas como um grupo.

Notas

• As condições são avaliadas na ordem em que estão listadas (de cima para baixo). As condições agrupadas são avaliadas como uma unidade e, em seguida, o resultado delas é avaliado na ordem em que o grupo aparece na lista.
• Não há uma maneira de reordenar as condições; se quiser alterar a ordem das condições, você terá de recriar a lista na ordem em que deseja que elas sejam avaliadas.
• Para obter mais informações sobre as condições de ignorar, faça referência à página da comunidade Workiva Skip Condições: Not to Be Skipped, But Definitely Worth Considering! e a página de suporte da Workiva Gerenciar comandos em cadeias.

Guia Saídas dinâmicas

A guia Dynamic outputs permite que você especifique regras para extrair um valor ou uma lista de valores da saída de um comando, que pode ser usado posteriormente na cadeia. Você pode adicionar várias saídas dinâmicas a um comando usando:

• Uma correspondência exata - para um texto específico no início ou no final dos valores a serem extraídos.
• Uma expressão regular - para corresponder valores com base em um padrão ou uma sequência específica.

Para definir as regras de saída dinâmica, conclua as etapas a seguir.

1. Selecione a guia Dynamic outputs.
2. Clique em +ADD DYNAMIC OUTPUT. Você verá o painel de configuração da saída dinâmica.
   
3. Insira um nome para essa saída.
4. Em Original output, selecione a saída a ser transformada.
5. Configure como a saída deve ser derivada e armazenada. Os campos a seguir são todos opcionais.
   • O campo Match text pode conter o texto a ser correspondido ou uma expressão regular.
   • Para fazer a correspondência exata do texto fornecido, selecione "Exact" em Match type.
   • Para usar uma expressão regular, selecione "Regular expression (regex)" (Expressão regular (regex)) em Match type.
   • Em Match result, você insere como o texto resultante deve ser exibido.
     Por exemplo, se o resultado fosse dígitos entre parênteses, você poderia inserir $0 para exibir todo o valor correspondente, incluindo os parênteses, ou $1 para exibir apenas os dígitos correspondentes sem os parênteses.
   • Para fazer a correspondência de texto somente em linhas específicas da saída, insira o(s) número(s) da(s) linha(s) ou o(s) intervalo(s) de números separados por vírgulas em Linhas a serem verificadas. Para incluir um intervalo de linhas, use um traço (-), de modo que 1-10 retorne o conteúdo somente das linhas 1 a 10. Para separar linhas ou intervalos, use uma vírgula (,), de modo que 1-10, 13 retorne o conteúdo apenas das linhas 1 a 10 e da linha 13.
6. Em Output type, selecione se você deseja retornar uma única saída ou uma lista de saídas.
7. Marque ou limpe as caixas de seleção Case sensitive e Trim Matches para produzir os resultados que você deseja.
8. Clique em Salvar.
9. (Opção) Clique em Teste para ver se você está obtendo os resultados esperados.

Se você quiser criar uma saída dinâmica adicional, clique em +ADD DYNAMIC OUTPUT. Isso exibe o painel de configuração de saída dinâmica para uma saída dinâmica adicional.

Para obter mais informações sobre como trabalhar com operadores dinâmicos, consulte a página de suporte da Workiva Manage dynamic outputs for a command.

Guia Ações de erro

A guia Error actions permite que você especifique o que acontecerá se ocorrer um erro no processo do comando.

Para definir as ações a serem tomadas se esse comando gerar um erro, você deve selecionar a guia Error Actions :

1. Selecione a guia Error Actions.
2. Em Error actions, selecione a ação que você deseja que a cadeia execute se o comando falhar.
   • Para seguir a lógica de ramificação da cadeia, selecione Continuar com a cadeia.
   • Para interromper a cadeia temporariamente, por exemplo, para solucionar o problema, selecione Pause chain. 
     Para reiniciar a cadeia depois que o problema for resolvido, selecione o comando na cadeia e clique em Resume.
   • Para interromper completamente a cadeia, selecione Exit chain.
3. Para interromper o comando se ele estiver sendo executado por mais tempo do que o desejado, em Timeout conditions, insira o tempo máximo para a execução da tarefa (em segundos).
4. Para tentar novamente um comando se a fonte de dados estiver intermitente ou indisponível, digite o número de tentativas e quantos segundos você deve esperar entre elas.
   

5. Em Error conditions, selecione os erros a serem ignorados.

   Condição	Descrição
   Argumentos inválidos	Se você marcar essa opção, o comando ignorará todos os argumentos inválidos.
   Falha geral	Se você marcar essa opção, a cadeia continuará, mesmo que o comando tenha falhado.

6. Para definir o status do comando com base em sua saída, clique no sinal de adição com círculo verde à esquerda de Output interpretation.
7. Clique em +Rule e defina a regra - ou grupo de regras - para interpretar o status da saída.
   
   Se você quiser especificar condições adicionais, clique no sinal de adição com círculo azul para adicionar outros campos de definição de condições.
   As condições são avaliadas na ordem em que são listadas (de cima para baixo). As condições agrupadas são avaliadas como uma unidade e, em seguida, o resultado delas é avaliado na ordem em que o grupo aparece na lista.

Nota: Não há uma maneira de reordenar as condições; se quiser alterar a ordem das condições, você terá de recriar a lista na ordem em que deseja que elas sejam avaliadas.

8. Em Interpretação de log, selecione se você deseja reprovar o comando com base em saídas específicas.
   • Para que não falhe o comando com base em saídas específicas, selecione Não interpretar.
   • Para que o comando falhe quando saídas específicas forem localizadas, selecione Fail if output(s) found e insira as saídas a serem pesquisadas.
   • Para que o comando falhe quando saídas específicas não forem localizadas, selecione Fail if output(s) not found e insira a saída a ser pesquisada.
   • Separe várias linhas de texto com \n.
9. Clique em Salvar.

Guia Iteradores

A guia Iteradores permite que você defina as regras para iterar (repetir ou repetir) o comando Get Workers.

Nota: Essa guia está desativada por padrão.

Para definir as regras de iteração, conclua as etapas a seguir.

1. Selecione a guia Iteradores.
2. Para ativar os iteradores, você deve alternar o botão na parte superior da guia. 
   
   Ao fazer isso, você altera o ícone ao lado do cabeçalho da guia (Iterators) de cinza escuro para azul e exibe o painel de configuração de iteradores. O marcador ao lado do título da guia também fica verde.
   

3. Selecione o tipo de modificador a ser usado.
   As opções são List (padrão) e Repeat until.

   • Se você selecionar List, o comando repetirá o comando:
     • Uma lista estática de valores, como regiões ou entidades. Também pode ser um número, como "3".
     • Uma lista dinâmica ou variável de valores, como um arquivo carregado como recurso do espaço de trabalho|workspace ou a saída de um comando anterior na cadeia.
   • Se você selecionar Repeat until, o comando será repetido até que a condição especificada seja atendida.

   Nota: Os comandos são limitados a um máximo de 1.000 iterações.

4. Insira a(s) regra(s) para controlar as iterações.
   Para obter mais informações sobre o uso de iteradores, incluindo como especificá-los, consulte a página de suporte da Workiva Use iteradores com comandos e grupos de comandos.
5. Clique em Salvar.