Partilhar via


Função de ER SUMIFS

A função SUMIFS devolve um valor Real que representa a soma de valores devolvidos por enlaces de elementos de formato e recolhidos quando os elementos de formato foram utilizados para gerar um documento de saída durante a execução de formato e que satisfaz as condições especificadas. Cada condição consiste num intervalo de chaves e num valor de chave.

Sintaxe

SUMIFS (key name for summing, condition 1 range, condition 1 value[, condition 2 range, condition 2 value, …, condition N range, condition N value])

Argumentos

key name for summing: Cadeia

Um valor devolvido pela expressão configurada na propriedade Nome da chave dos dados recolhidos do componente de formato de Relatórios eletrónicos (ER) para o qual o valor do enlace tem de ser utilizado para efeitos de soma.

A propriedade Nome da chave dos dados recolhidos pode ser configurada para o componente Numérico ou o componente Cadeia de um formato de ER que reside no componente Ficheiro\Comum onde a opção Recolher detalhes do resultado está ativada.

condition 1 range: Cadeia

Um valor devolvido pela expressão configurada na propriedade Nome da chave dos dados recolhidos de um componente de formato de ER. Este argumento é obrigatório.

A propriedade Nome da chave dos dados recolhidos pode ser configurada para o componente Sequência ou o componente Elemento XML de um formato de ER que reside no componente Ficheiro\Comum onde a opção Recolher detalhes do resultado está ativada.

condition 1 value: Cadeia

Um valor devolvido pela expressão configurada na propriedade Valor da chave dos dados recolhidos de um componente de formato de ER. Este argumento é obrigatório.

A propriedade Valor da chave dos dados recolhidos pode ser configurada para o componente Sequência ou o componente Elemento XML de um formato de ER que reside no componente Ficheiro\Comum onde a opção Recolher detalhes do resultado está ativada.

condition N range: Cadeia

Um valor devolvido pela expressão configurada na propriedade Nome da chave dos dados recolhidos de um componente de formato de ER. Estes argumentos adicionais são opcionais.

A propriedade Nome da chave dos dados recolhidos pode ser configurada para o componente Sequência ou o componente Elemento XML de um formato de ER que reside no componente Ficheiro\Comum onde a opção Recolher detalhes do resultado está ativada.

condition N value: Cadeia

Um valor devolvido pela expressão configurada na propriedade Valor da chave dos dados recolhidos de um componente de formato de ER. Estes argumentos adicionais são opcionais.

A propriedade Valor da chave dos dados recolhidos pode ser configurada para o componente Sequência ou o componente Elemento XML de um formato de ER que reside no componente Ficheiro\Comum onde a opção Recolher detalhes do resultado está ativada.

Valores de retorno

Real

O valor numérico resultante.

Notas de utilização

Esta função devolve um valor 0 (zero) quando a opção Recolher detalhes do resultado do componente atual Ficheiro\Comum está desativada.

Nos argumentos condition range, o caráter universal "*" pode ser utilizado para representar quaisquer vários carateres.

Nos argumentos condition value, o caráter universal "*" pode ser utilizado para representar quaisquer vários carateres.

Exemplo

Para obter mais informações sobre como utilizar esta função, consulte o guia de tarefas Utilizar dados do resultado de formato de ER para contagem e soma, que faz parte do processo de negócio Componentes de solução/Serviço de TI de desenvolvimento/Aquisição.

Recursos adicionais

Funções de recolha de dados