Histórico da Página
Função para Retorna o valor de um item de um campo de um serviço disponível via TOTVS Api Services (TAS) que é retornado no formato de lista. É também possível retornar a lista completa de todas todos os itens de uma lista (separado por vírgula).
Sintaxe
itens da lista do campo, sendo que os valores da lista são separados por vírgula.
Esta função é usada para campos que tem registrado no serviço desejado do TAS, não apenas uma informação única, mas uma lista de informações que pode variar de 0 (zero) a várias ocorrências.
Exemplo: No serviço SUFRAMA, podem existir uma ou mais inscrições estaduais que está disponivel no campo suframa/inscricoesEstaduais e para recuperar a uma ou todas as inscrições estaduais disponíveis para um determinado CNPJ e Unidade de Federação (Estado), utiliza-se esta função para o campo suframa/inscricoesEstaduais.
Esta função tem como pré-requisito realizar a consulta de dados em um dos serviços disponíveis para integração com o TAS no produto LOGIX como por exemplo, TAS_CNPJ_load, TAS_CPF_load, TAS_SUFRAMA_load.
Sintaxe
Bloco de código | ||
---|---|---|
| ||
TAS_getFieldListValue ( < l_fieldList >, < l_idx >, [ < l_field > ] ) => CHAR | ||
Painel | ||
TAS_getFieldLength ( [ l_fieldList ], [ l_idx ], [ l_field ] ) → BOOLEAN |
Parâmetros
Nome | Tipo | Obrigatório? | Descrição | |
---|---|---|---|---|
l_fieldList | CHAR | Sim | lista com os campoNome do campo, no formato XPATH, que é retornado no formato de lista no serviço do TAS, para o qual deseja recuperar um ou mais valores. | |
l_idx | SMALLINT | Sim | Informe a ordem do item da lista de itens que deseja recuperar valor. Caso informe o valor 0 (zero), será retornada a lista completa Quantidade de itens da lista do campo informado, sendo que os itens da lista serão separados por vírgula. Exemplo: "item1,item2,item3" | |
l_field | CHAR | Sim | Não | Nome do elemento dentro da lista resultante do campo do serviço desejado. Quando não houver nome, por se tratar de uma lista simples de valores, deve-se informar este parâmetro com valor em branco. Exemplo: No serviço SUFRAMA, temos o campo inscricoesEstaduais que é uma Lista de inscrições estaduais que possui alguns elementos conforme abaixo:
Para recuperar o Número de uma das inscrições estaduais da lista do campo inscricoesEstaduais, deve-se informar o nome do elemento inscricaoEstadual. Nome do campo. |
Retorno
Tipo | Descrição |
---|
QUALQUER
| Valor |
de um item da lista de um dos campos do serviço disponível no TAS. Quando retornar a lista completa, os valores estarão separados por vírgula. |
Exemplo
Bloco de código | ||||
---|---|---|---|---|
| ||||
#--------------------------------------# FUNCTION TAS_CNPJ_getAtividadeEconomicaSecundariagetfieldlistvalue_test(l_idx) #--------------------------------------# #Valores: 0 retorna lista completa separada por vírgula #DEFINE l_idx SMALLINT DEFINE l_count SMALLINT >0 retorna a atividade na ordem específica da lista retornada DEFINE l_idx SMALLINT RETURN IF TAS_CNPJ_load("<número de CNPJ>") THEN LET l_count = TAS_getFieldLength("receitaFederal/atividadesEconomicasSecundarias") FOR l_idx = 1 TO l_count #Neste caso o campo atividadesEconomicasSecundarias não possui nome para os elementos da lista, por isso o 3o parâmetro ficou em branco CALL conout("Atividade Economica Secundaria "||l_idx||": "||TAS_getFieldListValue("receitaFederal/atividadesEconomicasSecundarias",l_idx,"")) END FOR END IF END FUNCTION |
Informações
Fontes: tas.4gl
Disponível a partir do pacote Logix 12.1.2305 ou Fix Framework Logix 12.1.2305.fix01.