TransformerRuleList - escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 20 min. de leitura

    • . TransformerRuleList A API permite que você crie uma lista de regras para transformar vários tipos de dados JSON e XML em saída de par nome-valor.

    Esta API funciona junto com Transformador e. TransformerDefinition APIs. Juntas, essas APIs transformam nós XML ou qualquer entidade em um documento JSON estruturado em uma saída de pares nome-valor. Entidades JSON compatíveis, incluindo objetos e elementos em uma matriz, como cadeias de caracteres, números e outras matrizes.

    • . TransformerRuleList A API permite que você crie listas de regras de transformação que definem quais dados no documento de origem serão incluídos na saída e como transformar os dados de origem.

    • . TransformerDefinition A API associa uma lista de regras de transformação a um caminho de registro JSON/XML para definir objetos de definição de transformação reutilizáveis. Você pode usar um objeto de definição de transformação para transformar um ou mais documentos de origem.

    • . Transformador A API executa a transformação de dados real, uma entidade de dados por vez, usando a lista de regras de transformação especificada para criar os dados de saída desejados.

    Ao instanciar o objeto TransformRuleList, você deve definir se ele descreve um documento de origem JSON ou XML usando .FromJSON() ou .FromXML() métodos. Por exemplo:

    Sn_tfrm.TransformerRuleList().fromJSON(); ou Sn_tfrm.TransformerRuleList().fromXML();

    Em seguida, use Addrule() método para definir uma regra de transformação para cada elemento no documento de origem que você deseja incluir como um par nome-valor na saída.

    Use "métodos de adaptador", como SetName() ou ThenAdd() para definir como manipular elementos de dados quando a transformação é realizada. Os métodos do adaptador funcionam junto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões. Você pode aplicar um ou mais métodos de adaptador a cada transformação de dados. Os métodos do adaptador permitem que você faça coisas como:
    • Concatenar texto.
    • Execute funções matemáticas, como adicionar, subtrair, dividir e multiplicar.
    • Arredonde valores para cima ou para baixo (arredondar para cima/para baixo, teto/piso).
    • Defina se o valor mínimo ou máximo deve ser usado ao comparar um elemento de dados de origem com um valor especificado.
    • Aplique um código de moeda.
    • Converta entre diferentes unidades de medida.
    • Formatar elementos de dados.
    • Aplicar padrões.
    • Substitua elementos de dados especificados por um valor especificado.
    • Divida e reorganize cadeias de caracteres.

    Você pode usar TransformerRuleList em scripts de servidor com escopo e global. Ao usar esta classe em uma aplicação com escopo, use sn_tfrm identificador de namespace. Antes que esta API esteja disponível em uma instância, você deve ativar o plug-in do Serviço de transformação (com.glide.transform).

    TransformerRuleList - addrule(regra de cadeia de caracteres, caminho de cadeia de caracteres)

    Cria uma entrada na lista de regras de transformação associadas que define um campo a ser criado na saída.

    Você pode criar regras para qualquer elemento em um documento de origem. Por exemplo, .Addrule('ticker', ' cria o campo "ticker" na saída e copia o valor em quote.symbol da origem.

    Depois de definir uma regra usando Addrule() , em seguida, você usa métodos de adaptador, como ThenAdd() , ThenSubstituir() e ThenFloor() para manipular os dados de saída da regra. Você pode definir quantos métodos de adaptador forem necessários para uma única regra. Todos os métodos do adaptador diretamente após um Addrule() chamada, até a próxima Addrule() aplicar a essa regra. Os métodos do adaptador são cumulativos e o resultado de todos os métodos do adaptador serem o valor final salvo no campo de saída.

    Por exemplo, no snippet de código a seguir, Multiplicar() e. ThenRoundDown() aplicar a. Addrule('change_percentage', ' .quote.changePercent') ; Addrule('close_price', ' inicia uma nova regra. Se o valor em $.quote.changePercenté .011, então o valor de saída final é "1" ( .011 * 100 arredondado para baixo para a posição unos).

    
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close')

    . Addrule() o método também oferece suporte ao parâmetro summary; .Addrule('summary') . Esta implementação cria o campo de nome "resumo:" na saída, mas não o correlaciona a nenhum campo na origem. Você pode usar os métodos do adaptador ThenConcat() e. TãoConcatSymbol() para modificar o conteúdo do campo de resumo.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    regra Cadeia de caracteres Nome do elemento na saída de destino.
    caminho Cadeia de caracteres Opcional. JSONPath ou XPath para o elemento de dados no documento de origem.

    Os métodos do adaptador ThenConcat() e. TãoConcatSymbol() não exija que você defina este parâmetro se nenhum outro método de adaptador estiver definido para a regra. Todos os outros métodos de adaptador exigem este parâmetro.
    Tabela 2. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList - setName(nome da cadeia de caracteres)

    Define um nome para o objeto TransformerRuleList associado para fins de registro em log.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome a ser usado para identificar o objeto TransformerRuleList associado.

    Embora a API não force este nome a ser exclusivo, é útil se eles forem exclusivos em uma instância.
    Tabela 4. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList - thenAdaptCurrency(String currencyCode, booliano outputNumericCurrencyValue)

    Adiciona um adaptador à regra atual que vincula o código de moeda especificado ao campo de saída definido no associado Addrule() chamada.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 5. Parâmetros
    Nome Tipo Descrição
    currencyCode Cadeia de caracteres Código da moeda a ser vinculado ao elemento de dados de destino, como USD, EUR e GBP.
    OutputNummericCurrencyValue Booliano Opcional. Sinalizador que indica se o código da moeda deve ser exibido.

    Valores válidos:

    • verdadeiro: não exibe o código do país; somente valor numérico
    • falso: exibe o código do país

    Padrão: falso
    Tabela 6. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList - thAdaptDuration(cadeia de caracteres de entrada, cadeia de caracteres de saída)

    Adiciona um adaptador à regra atual que converte o campo de origem de uma unidade de medida para outra, como de minutos para segundos ou semanas para dias.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 7. Parâmetros
    Nome Tipo Descrição
    InputDuration Cadeia de caracteres Unidade de medida atual do campo de origem.

    Valores válidos:

    • NANOSSEGUNDO
    • MICROSSEGUNDO
    • MILISSEGUNDOS
    • SEGUNDO
    • MINUTO
    • HORA
    • DIA
    • SEMANA
    OutputDuration Cadeia de caracteres Unidade de medida para converter o campo de origem na saída.

    Valores válidos:

    • NANOSSEGUNDO
    • MICROSSEGUNDO
    • MILISSEGUNDOS
    • SEGUNDO
    • MINUTO
    • HORA
    • DIA
    • SEMANA
    Tabela 8. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('daily', '$.quote.weekly') 
  .thenAdaptDuration('WEEK', 'DAY');

    TransformerRuleList - thenAdd (operando numérico)

    Adiciona um adaptador à regra atual que adiciona o valor passado ao campo de origem.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 9. Parâmetros
    Nome Tipo Descrição
    operando Número Valor a ser adicionado ao campo de origem.
    Tabela 10. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList.fromJSON()
  .setName('Stock Report 05182019 JSON')
  .addSymbol('ticker', '$.symbol') 
  .addSymbol('change_percentage', '$.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addSymbol('trade_price', '$.current_price')
  .thenAdaptCurrency('USD', false) 
  .addMultiply('$.trade_quantity')
  .thenAdd('4.5');

    TransformerRuleList - thenApplyMap (Mapa de objeto)

    Adiciona um adaptador à regra atual que pesquisa no campo de origem associado uma lista de cadeias de caracteres e as substitui na saída pelos valores de substituição especificados.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 11. Parâmetros
    Nome Tipo Descrição
    mapa Objeto Pares de nome/valor.
    • texto a ser localizado no elemento de dados de origem
    • texto para substituí-lo na saída
    Tabela 12. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual.

    Neste exemplo, ApplicyMap() A chamada pesquisa o texto de origem no campo company_info para Inc. E St. e substitui-os por Incorporado e Rua no campo company_info na saída.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('company_info', '$.quote.company_info') 
  .thenApplyMap({'Inc.': 'Incorporated', 'St.': 'Street'});

    TransformerRuleList - thenApplyPattern(Cadeia de caracteres matchPattern, Cadeia de caracteres de saída

    Adiciona um adaptador à regra atual que corresponde a um padrão regex especificado ao conteúdo no campo de origem e substitui/reformata esse conteúdo por um segundo padrão regex e armazena esse valor na saída.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 13. Parâmetros
    Nome Tipo Descrição
    MatchPattern Cadeia de caracteres Padrão regex a ser usado para localizar o texto a ser substituído/reformatado.
    Padrão de saída Cadeia de caracteres Padrão regex a ser usado para atualizar o texto localizado.
    Tabela 14. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual.

    Qualquer nome de empresa que termine com "Inc." é transformado em "Incorporado", como Empresa Inc. Para Empresa Incorporada.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('company', '$.quote.company') 
  .thenApplyPattern('(.+)(\\w{3}\\.)', '$1Incorporated');

    TransformerRuleList - thenCeiling (operando numérico)

    Adiciona uma ação à regra atual para arredondar o campo de origem para cima na posição decimal especificada pelo valor passado.

    Ao contrário do arredondamento reto, em que o número é arredondado com base no valor do dígito na posição decimal especificada (0-4 arredondado para baixo, 5-9 arredondado para cima), o teto sempre arredonda para cima. Por exemplo, o valor máximo para 2,156 e 2,152 é sempre 2,16 para o passado na casa decimal de 2; enquanto para o arredondamento reto, os valores seriam 2,16 e 2,15, respectivamente. Para números negativos, a operação de teto torna o número mais positivo, como no valor de teto de -2,156 é -2,15; enquanto o mesmo número arredondado para cima torna o valor mais negativo, -2,16.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 15. Parâmetros
    Nome Tipo Descrição
    operando Número Posição decimal à direita da vírgula decimal na qual arredondar o número para cima (aplicar teto).

    Por exemplo, se este valor for 2 e o elemento de dados de origem for 6,421, o valor resultante será 6,43.
    Tabela 16. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenCeiling('2') // Always round the interest rate up to the hundredths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList - thenConcat (valor de cadeia de caracteres)

    Adiciona um adaptador à regra atual que concatena a cadeia de caracteres passada no campo de saída.

    Ao contrário de outros métodos de adaptador, este método não precisa ser aplicado a um campo de origem. Você pode usar este método para criar cadeias de caracteres de dados completamente novas na saída.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 17. Parâmetros
    Nome Tipo Descrição
    valor Cadeia de caracteres Texto a ser concatenado com o final do elemento de dados atual.
    Tabela 18. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList - thenConcatSymbol(símbolo de cadeia de caracteres)

    Adiciona um adaptador à regra atual que concatena o valor de um campo definido anteriormente na lista de regras para o campo de saída atual.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 19. Parâmetros
    Nome Tipo Descrição
    symbol Cadeia de caracteres Nome do elemento da lista de regras a ser anexado ao campo de saída.
    Tabela 20. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList - thenDivideBy (operando numérico)

    Adiciona um adaptador à regra atual que divide o campo de origem pelo valor passado.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 21. Parâmetros
    Nome Tipo Descrição
    operando Número Valor pelo qual dividir o campo de origem.
    Tabela 22. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('dividend_per_share', '$.quote.total_dividend') 
  .thenDivideBy('$.quote.total_shares');

    TransformerRuleList - thenDivideInto(operando numérico)

    Adiciona um adaptador à regra atual que divide o valor passado pelo campo de origem.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 23. Parâmetros
    Nome Tipo Descrição
    operando Número Valor no qual dividir o campo de origem.
    Tabela 24. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('dividend_per_share', '$.quote.total_shares') 
  .thenDivideInto('$.quote.total_dividends');

    TransformerRuleList - thenFloor (operando numérico)

    Adiciona um adaptador à regra atual que arredonda o campo de origem para baixo na posição decimal especificada pelo valor passado e o armazena na saída.

    Ao contrário do arredondamento reto, em que o número é arredondado com base no valor do dígito na posição decimal especificada (0-4 arredondado para baixo, 5-9 arredondado para cima), o piso sempre arredonda para baixo. Por exemplo, o valor mínimo para 2,156 e 2,152 é sempre 2,15 para o passado na casa decimal de 2; enquanto para o arredondamento reto, os valores seriam 2,16 e 2,15, respectivamente. Para números negativos, a operação de piso torna o número mais negativo, já que o valor de piso de -2,156 é -2,16; enquanto o mesmo número arredondado para baixo torna o valor mais positivo, -2,15.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 25. Parâmetros
    Nome Tipo Descrição
    operando Número Posição decimal à direita da vírgula decimal na qual arredondar o número para baixo (aplicar piso).

    Por exemplo, se este valor for 2 e o elemento de dados de origem for 6,427, o valor resultante será 6,42.
    Tabela 26. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenFloor('2') // Always round the interest rate down to the hundreths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList - thenFormat(cadeia de caracteres matchPattern, cadeia de caracteres outputPattern)

    Adiciona um adaptador à regra atual que reformata o conteúdo no campo de origem que corresponde ao padrão de correspondência especificado, com o padrão de saída especificado.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 27. Parâmetros
    Nome Tipo Descrição
    MatchPattern Cadeia de caracteres Padrão a ser correspondido ao campo de origem.

    Valores válidos:

    • em: qualquer caractere
    • dígito decimal
    • : escape literal (
    Padrão de saída Cadeia de caracteres Padrão para substituir o conteúdo na saída.

    Valores válidos:

    • em: qualquer caractere
    • dígito decimal
    • : escape literal (
    Tabela 28. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual.

    Este exemplo reformata a data da cotação de AAAA/MM/DD para AAAA MM-DD.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('date', '$.quote.date') 
  .thenFormat('####/##/##', '#### ##-##');

    TransformerRuleList - thenMax (operando numérico)

    Adiciona um adaptador à regra atual que compara o valor passado em relação ao campo de origem e copia o maior dos dois valores para o campo de saída.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 29. Parâmetros
    Nome Tipo Descrição
    operando Número Valor a ser comparado com o campo de origem.
    Tabela 30. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('lowest_interest_rate', '$.quote.interest_rate') 
  .thenMax('3.5') // Interest rate cannot be less than 3.5%
  .addRule('dividend_per_share', '$.quote.total_shares') 
  .thenDivideInto('$.quote.total_dividends');

    TransformerRuleList - thenMin(operando numérico)

    Adiciona um adaptador à regra atual que compara o valor passado em relação ao campo de origem e copia o inferior dos dois valores para o campo de saída.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 31. Parâmetros
    Nome Tipo Descrição
    operando Número Valor a ser comparado com o campo de origem.
    Tabela 32. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addSymbol('broker_fee_percentage', '$.quote.broker_fee') 
  .thenMin('10') // Maximum of 10% broker fee
  .addSymbol('dividend_per_share', '$.quote.total_shares') 
  .thenDivideInto('$.quote.total_dividends');

    TransformerRuleList - thenMultiply(operando numérico)

    Adiciona um adaptador à regra atual que multiplica o campo de origem pelo valor passado.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 33. Parâmetros
    Nome Tipo Descrição
    operando Número Valor pelo qual multiplicar o campo de origem.
    Tabela 34. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('summary') 
  .thenConcat('Shares of ') 
  .thenConcatSymbol('ticker') 
  .thenConcat(' closed at ') 
  .thenConcatSymbol('close_price');

    TransformerRuleList - thenReplace(cadeia de caracteres matchString, cadeia de caracteres de substituição)

    Adiciona um adaptador à regra atual que encontra todo o texto no campo de origem que corresponde a uma cadeia de caracteres especificada e o substitui por uma cadeia de caracteres atualizada.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 35. Parâmetros
    Nome Tipo Descrição
    MatchString Cadeia de caracteres Cadeia de caracteres a ser correspondida ao campo de origem para identificar o texto a ser substituído.
    Cadeia de caracteres de substituição Cadeia de caracteres Cadeia de caracteres pela qual substituir o texto correspondente.
    Tabela 36. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual.

    Qualquer nome de empresa que termine com "Inc." é transformado em "Incorporado", como Empresa Inc. Para Empresa Incorporada.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('company', '$.quote.company') 
  .thenReplace('Inc.', 'Incorporated');

    TransformerRuleList - thenRoundDown(operando numérico)

    Adiciona um adaptador à regra atual que arredonda o campo de origem para baixo na posição decimal especificada pelo valor passado.

    Para números negativos, o. ThenRoundDown() o método torna o número mais positivo; o valor arredondado para baixo de -2,156 é -2,15. . ThenFloor() o método torna o mesmo número mais negativo, -2,16.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 37. Parâmetros
    Nome Tipo Descrição
    operando Número Posição decimal à direita da vírgula decimal na qual arredondar o número para baixo.

    Por exemplo, se este valor for 2 e o elemento de dados de origem for 6,427, o valor resultante será 6,42.
    Tabela 38. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList90
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenRoundDown('2') // Always round the interest rate down to the hundredths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList - thenRoundUp (operando numérico)

    Adiciona um adaptador à regra atual que arredonda o elemento de dados de origem para cima na posição decimal especificada pelo valor passado.

    Para números negativos, o. ThenRoundUp() o método torna o número mais negativo; o valor arredondado para cima de -2,156 é -2,16. . Ceiling() o método torna o mesmo número mais positivo, -2,15.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 39. Parâmetros
    Nome Tipo Descrição
    operando Número Posição decimal à direita da vírgula decimal na qual arredondar o número para cima.

    Por exemplo, se este valor for 2 e o elemento de dados de origem for 6,422, o valor resultante será 6,43.
    Tabela 40. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Mortgage Rates 05022019 JSON')
  .addRule('interest_rate', '$.quote.interest_rate') 
  .thenRoundUp('2') // Always round the interest rate up to the hundredths place 
  .addRule('monthly_payment', '$.quote.total_loan_amount') 
  .thenDivideBy('180');

    TransformerRuleList - thenSplit(cadeia de caracteres splitPattern, cadeia de caracteres de substituição)

    Adiciona um adaptador à regra atual que divide, reorganiza e substitui cadeias de caracteres no campo de origem e as salva no campo de saída.

    . splitPatterno parâmetro indica como dividir a cadeia de caracteres de texto de origem em segmentos. Este parâmetro pode ser um separador de palavras típico, como um espaço (' '), vírgula (',') ou ponto e vírgula (';'), e também pode ser qualquer cadeia de caracteres, como "nome". Por exemplo, se o texto de origem for "Smith John Michael" e splitPatternÉ um espaço, os segmentos disponíveis são "Smith", "John" e "Michael". Para fazer referência a um segmento, use o número, em que o número é o número da ordem do segmento na cadeia de caracteres de texto de origem. Por exemplo, se a chamada do método for ThenSplit(' ', '$2 $3 1') , Então a saída é "John Michael Smith". Além disso, você pode adicionar constantes no padrão de saída, como ThenSplit(' ', 'Nome: $2 Nome do meio: $3 Sobrenome: 1') .

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 41. Parâmetros
    Nome Tipo Descrição
    Padrão dividido Cadeia de caracteres Cadeia de caracteres que indica como dividir o texto em segmentos.
    Cadeia de caracteres de substituição Cadeia de caracteres Cadeia de caracteres que define a cadeia de caracteres de saída, incluindo referências de segmento e constantes. Nem todos os segmentos precisam ser referenciados.

    Faça referência aos segmentos definidos pelo splitPatternusando o número, em que o número é o número da ordem do segmento no elemento de dados de origem. Faça referência a todo o elemento de dados de origem usando USD 0.
    Tabela 42. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual.

    Neste exemplo, o nome do CEO é sobrenome, nome nos dados de origem e na saída, ele será transformado em sobrenome.

    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock Report 05022019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('CEO', '$.quote.CEO') 
  .thenSplit(',', '$2 $1');

    TransformerRuleList - thenSubtract (operando numérico)

    Adiciona um adaptador à regra atual que subtrai o valor passado do campo de origem e o armazena no campo de saída.

    Nota:
    Este é um método de adaptador e não pode ser usado sozinho. Os métodos do adaptador funcionam em conjunto com Addrule() método. Eles definem adaptações a serem aplicadas ao campo de saída definido pelo Addrule() método como formatação, arredondamento e aplicação de padrões.
    Tabela 43. Parâmetros
    Nome Tipo Descrição
    operando Número Valor a ser subtraído do elemento de dados de origem.
    Tabela 44. Retornos
    Tipo Descrição
    Objeto Objeto TransformerRuleList atual. 
    var transformerRuleList = new sn_tfrm.TransformerRuleList()
  .fromJSON()
  .setName('Stock 05182019 JSON')
  .addRule('ticker', '$.quote.symbol') 
  .addRule('change_percentage', '$.quote.changePercent') 
  .thenMultiply('100') 
  .thenRoundDown('0') 
  .addRule('close_price', '$.quote.close') 
  .thenAdaptCurrency('USD', false) 
  .addRule('trade_price', '$.quote.current_price') 
  .addMultiply('$.quote.trade_quantity')
  .thenSubtract('$.quote.discount_dollars');