Histórico da Página
Função para contar o tamanho de uma lista de campos.
Sintaxe
que retorna a quantidade de ocorrências de uma determinada informação de um serviço disponível no TOTVS Api Services(TAS). É 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 quantidade total de 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_getFieldLength ( < l_fieldList > ) => INTEGER | ||
Painel | ||
TAS_getFieldLength ( [ l_fieldList ] ) → BOOLEAN |
Parâmetros
Nome | Tipo | Obrigatório? | Descrição |
---|---|---|---|
l_fieldList | CHAR | Sim |
Nome do campo que deseja identificar a quantidade de ocorrências no respectivo serviço que foi feita carga prévia de informações pelas funções TAS_<serviço>_load(). Somente informe campos do serviço que estiverem definidos como tipo LISTA no serviço do TAS. Em caso de dúvidas consulte o retorno da API do serviço desejado em Documentação APIs TAS (Swagger) Este nome de campo deve ser descrito no padrão XPATH. Exemplo: suframa/inscricoesEstaduais |
Retorno
Tipo | Descrição |
---|
QUALQUER
| Quantidade de ocorrências do campo do serviço do TAS que foi pré-carregado por uma das funções TAS_<serviço>_load(). |
Exemplo
Bloco de código | ||||
---|---|---|---|---|
| ||||
#--------------------------------------# FUNCTION TAS_SUFRAMAgetFieldLength_test() #--------------------------------------# DEFINE l_idx, l_count SMALLINT IF TAS_SUFRAMA_load('20337684000129',NULL) THEN ## Após fazer a busca de informações SUFRAMa para um determinado CNPJ usando a função TAS_SUFRAMA_load(), ## é feita a recuperação da quantidade de inscrições estaduais registradas para este CNPJ no serviço SUFRAMA ## o campo inscricoesEstaduais na resposta do serviço SUFRAMA retorna uma lista como resultando e por isso é ## possivel utilizar a função TAS_getFieldLength() para recuperar a quantidade de informações contidas na lista deste camppo LET l_count = TAS_getFieldLength("suframa/inscricoesEstaduais") # Função TAS_getFieldLength FOR l_idx = 1 TO l_count CALL CONOUT("TAS_SUFRAMA_getInscricaoEstadual["||LOG_alltrim(l_idx)||"]", TAS_SUFRAMA_getInscricaoEstadual(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.
Veja também
Documentação APIs TAS (Swagger)