Criação de variáveis de entrada

Crie as variáveis a serem passadas para a atividade no formulário de Entradas do designer de atividades.

Antes de Iniciar

Você deve nomear sua atividade no formulário Geral antes de avançar para a fase de Entradas.

Funções necessárias: workflow_admin ou activity_creator

Nota:

As cadeias de caracteres variáveis no formulário Entradas têm um limite de 255 caracteres.

Procedimento

1. Clique em + para criar uma nova variável de entrada.

   O designer cria uma variável padrão chamada Entrada1.

   

2. Digite o novo nome da variável no campo.
3. Para mudar o nome de uma variável ou qualquer um de seus atributos, clique duas vezes no valor e selecione ou insira um novo valor no campo que aparece.
4. Configure sua variável usando estes campos:

   Tabela 1. Configuração de variável

   Campo	Descrição
   Tipo	Tipo de dados para esta variável. Clique duas vezes no campo para exibir a lista de seleção. Além dos tipos de dados normais, você pode criar matrizes de entrada e criptografar variáveis individuais que contenham dados confidenciais. Variáveis criptografadas são passadas para a Fila do ECC e, em seguida, descriptografadas pelo MID Server quando são executadas no host de destino. Os dados confidenciais retornados da execução dessas variáveis no host podem ser passados para outra atividade por meio de variáveis de saída criptografadas.
   Obrigatório	Marca uma variável de entrada como obrigatória. Variáveis marcadas como obrigatórias são campos obrigatórios no formulário de propriedades para a atividade no fluxo de trabalho. O recurso de teste de entrada permite filtrar variáveis obrigatórias.
   Padrão	Valor padrão para esta variável de entrada. Os valores padrão são preenchidos previamente para variáveis no formulário de propriedades da atividade no fluxo de trabalho. Você pode substituir este valor ao testar as variáveis.

5. Para reordenar a lista de variáveis, selecione uma linha e arraste a linha para seu novo local.

   Quando você seleciona uma linha para movê-la, o ícone do ponteiro muda para um ícone de seta para cima/para baixo (ícone de seta para ).

6. Para excluir uma variável, clique no ícone de exclusão ( ) na linha.
7. Clique em Continuar para avançar para a fase Comando de execução ou clique em Ir para pré-processamento (avançado) para criar um script que seja executado antes da execução da atividade.

Mapeamento de uma variável de entrada

Depois de criar as variáveis de entrada, mapeie-as para os campos no formulário de Comando de Execução.

Antes de Iniciar

Funções necessárias: activity_admin, activity_creator

Por Que e Quando Desempenhar Esta Tarefa

Esses campos contêm valores exigidos pelo host de destino ou endpoint para autenticar e consultar os dados. Incluídos neste exemplo estão os campos para um comando ser executado no destino e o MID Server a ser usado, se for necessário.

Procedimento

Para mapear uma variável, arraste-a para o campo apropriado.

O designer expressa automaticamente a variável na sintaxe que o sistema requer.

Configuração do comando de execução do PowerShell

Use as variáveis de entrada que você criou para configurar o comando que a Orquestração executa na máquina de destino do Windows.

Antes de Iniciar

Crie as variáveis de entrada necessárias no formulário Entradas antes de avançar para a fase Comando de Execução.

Funções necessárias: activity_creator, administrador

Nota:

Você pode testar a conexão do PowerShell entre o MID Server e o computador de destino sem precisar executar a atividade em um contexto de fluxo de trabalho. Para obter detalhes, consulte saídas do modelo de teste.

Procedimento

1. Arraste as variáveis da lista de entradas e solte-as nos campos de comando.
   O sistema formata a variável na sintaxe apropriada para o comando.

   Figura 1. Comando de execução do PowerShell

   

2. Preencha os campos exibidos na tabela.

   Tabela 2. Campos de comando do PowerShell

   Campo	Descrição
   Entrada	Construtor de variáveis de entrada. Crie variáveis para mapear para os campos disponíveis.
   Host de destino	Nome do host ou endereço IP do servidor de destino para esta atividade do PowerShell.
   Tipo de script	Tipo de script a ser executado no host do PowerShell. Opções disponíveis incluem: Comando PowerShell personalizado Arquivo de script do MID Server
   Arquivo de script do MID Server	Arquivo de script do MID Server a ser executado Este campo está disponível quando o tipo de script selecionado é o arquivo de script do MID Server.
   Comando	Comando para que esta atividade seja executada no host de destino. Este campo está disponível quando o tipo de script selecionado é o comando PowerShell personalizado. Você pode arrastar e soltar variáveis de entrada do construtor de variáveis para este campo para criar seu comando.
   Variáveis do PowerShell	Pares de nome-valor a serem passados para o host com o PowerShell. Você pode criar essas variáveis manualmente ou arrastar variáveis de entrada para o campo Valor. As variáveis de entrada criptografadas mantêm sua criptografia, independentemente das configurações de tipo de dados neste campo. Se você digitar um valor e selecionar o tipo de dado Criptografado, o valor aparecerá em texto sem formatação neste campo e só será criptografado quando for passado para a Fila do ECC.
   Usar conta de serviço do MID	Força esta atividade a ser autenticada no host de destino usando somente as credenciais da conta de serviço do MID Server, sem tentar nenhuma outra credencial. Quando esta caixa de seleção está marcada, o campo de marcador de credencial não está disponível.
   Marcador de credencial	Os aliases de credencial das atividades da Orquestração nesta atividade devem ser usados para executar comandos Powershell no host. Se este campo for deixado em branco, o MID Server tentará todas as credenciais disponíveis até encontrar uma credencial válida, terminando com a conta de serviço do MID Server. Se um alias de credencial for definido, o MID Server tentará as credenciais somente para esse alias e não tentará a conta de serviço do MID Server. Este campo não está disponível quando a caixa de seleção Usar conta de serviço do MID está marcada.
   Requer recursos do MID Server	MID Server a ser usado para consultar o PowerShell, por recursos. Por padrão, o sistema seleciona um PowerShell MID Server.

3. Clique em Salvar.
4. Clique em Continuar para avançar para a fase Saídas.

Teste de entradas de modelo de atividade

Você pode testar os parâmetros de entrada de uma atividade personalizada durante seu desenvolvimento sem precisar executar a atividade em um contexto de fluxo de trabalho.

Antes de Iniciar

Crie variáveis de entrada e mapeie-as para campos no formulário de Comando de Execução ou forneça valores reais para esses campos.

Funções necessárias: web_service_admin, activity_admin, activity_creator

Por Que e Quando Desempenhar Esta Tarefa

Um teste de entrada executa somente os parâmetros de entrada em um endpoint e não os scripts de pré-processamento ou pós-processamento. Você precisa usar um fluxo de trabalho para testar um script de pré-processamento ou pós-processamento. Você não precisa fazer check-out da atividade para testá-la e pode testar variáveis de entrada de qualquer fase no Designer de atividades, se sua atividade estiver configurada corretamente. Normalmente, a fase de Comando de Execução é o ponto em que suas entradas estão prontas para teste.

Nota:

Se você pretende usar o mapeamento automático, teste as variáveis de entrada.

Procedimento

1. Clique em Testar entradas.
   A lista de variáveis de origem de entrada é exibida. Se você adicionou valores padrão para essas variáveis, esses valores serão exibidos na coluna Valor substituto. As variáveis obrigatórias são marcadas com uma estrela vermelha. Neste exemplo, um endpoint SOAP retorna um valor para uma variável de cotação de ações.

   

2. Filtre a lista de variáveis com estes controles:
   • Todas as entradas: exibe todas as variáveis de entrada. Esta é a visualização padrão.
   • Entradas obrigatórias: exibe somente variáveis de entrada obrigatórias.
   • Entradas sem padrões: mostra as variáveis de entrada que não têm valores padrão atribuídos.
3. Redefina os valores conforme necessário.
   • Redefinir valores padrão: substitui todos os valores de teste definidos neste formulário pelos valores padrão, se estiverem presentes.
   • Limpar valores: limpa todos os valores na lista de variáveis de entrada, mesmo se houver valores padrão.
4. Quando os valores de teste estiverem configurados corretamente, clique em OK.
   O sistema executa os valores de todas as entradas configuradas em relação ao destino especificado e retorna a carga resultante. Os botões no formulário de resposta exibem diferentes exibições da carga. A carga inteira aparece na janela Saída bruta.

   Figura 2. Carga de resposta do teste de entradas

   

5. Para mapear valores de parâmetro apropriados na carga para variáveis na fase de Saídas automaticamente, selecione uma opção de mapeamento automático.
6. Como alternativa, você pode clicar em Salvar para regras de análise para copiar a carga inteira para as regras de análise.
   Isso permite que você selecione manualmente valores para as variáveis de saída diretamente da carga. Esta ação substitui completamente qualquer carga anterior existente nas regras de análise.
7. Clique no X no canto superior direito da janela para fechá-la.