As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Estado de passagem do fluxo de trabalho
Gerenciando o estado e transformando dados
Recentemente, o Step Functions adicionou variáveis JSONata para gerenciar dados de estado e transformação.
Saiba mais sobre como transmitir dados com variáveis e transformar dados com JSONata.
Um estado Pass
("Type": "Pass"
) passa sua entrada para sua saída, sem executar o trabalho. Os estados Pass
são úteis na construção e na depuração de máquinas de estado.
Você também pode usar um Pass
estado para transformar a entrada de JSON estado usando filtros e, em seguida, passar os dados transformados para o próximo estado em seus fluxos de trabalho. Para ver mais informações sobre a transformação de entrada, consulte Manipule parâmetros nos fluxos de trabalho do Step Functions.
Além dos campos de estado comuns, os estados Pass
permitem os campos a seguir.
-
Assign
(Opcional, JSONata somente) -
Uma coleção de pares de valores-chave para atribuir dados às variáveis. Para obter mais informações, consulte Passando dados entre estados com variáveis.
Output
(Opcional, JSONata somente)-
Usado para especificar e transformar a saída do estado. Quando especificado, o valor substitui o padrão de saída de estado.
O campo de saída aceita qualquer JSON valor (objeto, matriz, string, número, booleano, nulo). Qualquer valor de string, incluindo aqueles dentro de objetos ou matrizes, será avaliado como JSONata se estivesse cercado por {%%} caracteres.
A saída também aceita uma JSONata expressão diretamente, por exemplo: “Output”: “{% jsonata expression%}”
Para obter mais informações, consulte Transformando dados com Step JSONata Functions.
-
Result
(Opcional, JSONPath somente) -
Refere-se à saída de uma tarefa virtual que é transmitida para o próximo estado. Se você incluir o campo
ResultPath
na definição da máquina de estado, oResult
será colocado conforme especificado peloResultPath
e enviado para o próximo estado. -
ResultPath
(Opcional, JSONPath somente) -
Especifica onde colocar a saída (em relação à entrada) da tarefa virtual especificada no
Result
. A entrada é filtrada adicionalmente, conforme especificado pelo campoOutputPath
(se houver) antes de ser usada como a saída do estado. Para obter mais informações, consulte Processar entrada e saída no Step Functions. -
Parameters
(Opcional, JSONPath somente) -
Cria um conjunto de pares de chave-valor que será transmitido como entrada. Você pode especificar
Parameters
como um valor estático ou selecionar a partir da entrada usando um caminho. Para obter mais informações, consulte Manipule parâmetros nos fluxos de trabalho do Step Functions.
Exemplo de estado de passagem (JSONPath)
Veja a seguir um exemplo de um estado Pass
que injeta alguns dados fixos na máquina de estado, provavelmente para finalidade de teste.
"No-op": {
"Type": "Pass",
"Result": {
"x-datum": 0.381018,
"y-datum": 622.2269926397355
},
"ResultPath": "$.coords",
"End": true
}
Vamos supor que a entrada para esse estado seja a seguinte.
{
"georefOf": "Home"
}
A saída seria esta.
{
"georefOf": "Home",
"coords": {
"x-datum": 0.381018,
"y-datum": 622.2269926397355
}
}