Calc Tab - Idioma
O separador «Linguagem» permite-lhe aceder às funções e operadores disponíveis para os arrastar e largar facilmente na janela de código. Quando inseridos na janela de código, incluirão parâmetros fictícios que devem ser substituídos para que funcionem corretamente. Consulte a secção sobre Funções Especiais abaixo para obter uma lista das funções exclusivas do IndySoft.
Code Toolbox - Separador «Linguagem»
Funções especiais
Todas as funções abaixo são específicas do separador «Calc» no IndySoft Custom Report Designer. Existem outras funções padrão para além das que se seguem. Nota: estas funções estão disponíveis no separador «Calc» do IndySoft Custom Report Designer, no separador «Code Toolbox: Language», à direita. Alguns grupos nesta secção incluem funções especializadas, conforme descrito abaixo. Depois de selecionar um grupo, verá uma lista das várias funções na grelha abaixo. Pode arrastar e soltar esses nomes de funções na janela de código à esquerda, e será apresentado um modelo da função, juntamente com os nomes dos parâmetros necessários.
Math
RoundToSigDig
Esta função aceita três parâmetros: dNumber, iSigDigits e iResolution. Devolve o valor de dNumber arredondado para iSigDigits e atualiza iResolution para a resolução dos pontos de teste correspondente a esse valor.
GetEventStatusValue
GetEventStatusValue
Esta função aceita uma abreviatura do estado do evento (como «IN») como parâmetro e, em seguida, devolve a versão completa dessa abreviatura do estado do evento como texto (como «Checked In»).
GetEventStatusAbbrev
GetEventStatusAbbrev
Esta função aceita um estado de evento completo como parâmetro (por exemplo, «Checked In») e, em seguida, devolve o estado de evento abreviado como texto (por exemplo, «IN»).
ReportSettings
GetCurrentUserName
Esta função devolve o nome do utilizador atualmente conectado ao IndySoft, sob a forma de texto. Esta função não requer quaisquer parâmetros.
GetReportFilters
Utilizada apenas quando são utilizados relatórios STANDARD no estado «Design» — quando esta função é chamada a partir do separador «Calc» no IndySoft Custom Report Designer, o filtro de relatório atual é devolvido como texto. Esta função não requer quaisquer parâmetros.
GetReportSortBy
Utilizado apenas quando os relatórios STANDARD são utilizados no estado «Design» — quando esta função é chamada a partir do separador «Calc» no IndySoft Custom Report Designer, o(s) campo(s) de ordenação atual(is) do relatório é(são) devolvido(s) como texto. Esta função não requer quaisquer parâmetros.
AccumulateSettings
GetAccumFreq
Utilizado apenas quando os relatórios STANDARD são utilizados no estado «Design» — quando esta função é chamada a partir do separador «Calc» no IndySoft Custom Report Designer, o filtro de frequência «Intervalo até ao vencimento» do relatório é devolvido como texto. Esta função não requer quaisquer parâmetros.
GetAccumInterval
Utilizado apenas quando os relatórios STANDARD são utilizados no estado «Design» — quando esta função é chamada a partir do separador «Calc» no IndySoft Custom Report Designer, o filtro de relatório «Intervalo até ao vencimento» é devolvido como texto. Esta função não requer quaisquer parâmetros.
GetAccumType
Utilizado apenas quando os relatórios STANDARD são utilizados no estado «Design» — quando esta função é chamada a partir do separador «Calc» no IndySoft Custom Report Designer, o filtro de relatório «Tipo de calendário» é devolvido como texto. Esta função não requer quaisquer parâmetros.
InputBox
InputBox
Esta função abre uma caixa de diálogo pop-up que solicita que o utilizador introduza texto. O texto do utilizador é devolvido como resultado da função. Esta função aceita 3 parâmetros: 1) o título da janela pop-up, 2) o texto da etiqueta para a informação solicitada e 3) o valor predefinido (se houver) utilizado na caixa de edição da janela de diálogo pop-up.
ScheduleCalc
AutoIncreaseInterval
Esta função gera um novo intervalo de programação com base nas definições de «Reprogramação automática» a nível do sistema. Dada a frequência (1.º parâmetro, número inteiro) e o intervalo (2.º parâmetro, cadeia de caracteres) fornecidos, será devolvida uma nova frequência sob a forma de um número inteiro. A nova frequência é sempre apresentada em DIAS. Note que este novo intervalo corresponde simplesmente ao intervalo anterior, acrescido da percentagem especificada nas definições de «Reagendamento automático» nas Opções gerais do sistema.
CalcLastCalDate
Esta função calcula retroativamente a data de um evento com base na frequência (1.º parâmetro, número inteiro), no intervalo (2.º parâmetro, cadeia de caracteres) e na última data em que o evento ocorreu (3.º parâmetro, data) fornecidos. A função devolve uma data.
DetermineIfDueWithSpecificDate
Esta função devolve «true» ou «false» (booleano), consoante um equipamento tenha ou não uma data de vencimento em uma determinada data, com base nos parâmetros fornecidos. São necessários 11 parâmetros: 1) frequência da programação, como número inteiro; 2) intervalo da programação, como cadeia de caracteres; 3) se a programação se baseia na acumulação de tempo («1» se verdadeiro, «0» se falso), como cadeia de caracteres; 4) data da última execução, como data; 5) data de vencimento, como data; 6) data em que o contador de acumulação foi iniciado (apenas para estudos baseados na acumulação de tempo), como data; 7) hora em que o equipamento foi retirado na última data em que o relógio de acumulação começou (apenas para agendamentos baseados na acumulação de tempo), como número inteiro; 8) número de horas já acumuladas no agendamento atual (apenas para agendamentos baseados na acumulação de tempo), como número inteiro; 9) frequência do agendamento necessária para comparação, como número inteiro; 10) intervalo do agendamento necessário para comparação, como cadeia de caracteres; 11) data para comparação, como data.
DetermineIfDue
Esta função devolve «true» ou «false» (booleano) consoante um equipamento esteja ou não na data prevista para uma manutenção programada, com base nos parâmetros fornecidos. São necessários 10 parâmetros: 1) frequência da programação, como número inteiro; 2) intervalo da programação, como cadeia de caracteres; 3) se a programação se baseia na acumulação de tempo («1» se verdadeiro, «0» se falso), como cadeia de caracteres; 4) data da última execução, como data; 5) data de vencimento, como data; 6) data em que o contador de acumulação foi iniciado (apenas para estudos baseados na acumulação de tempo), como data; 7) hora em que o equipamento foi retirado na última data em que o relógio de acumulação começou (apenas para agendamentos baseados na acumulação de tempo), como número inteiro; 8) número de horas já acumuladas no agendamento atual (apenas para agendamentos baseados na acumulação de tempo), como número inteiro; 9) frequência do agendamento necessária para comparação, como número inteiro; 10) intervalo do agendamento necessário para comparação, como cadeia de caracteres.
GetRemainingAsRealString
Esta função devolve o número de horas restantes numa programação, com base na acumulação de tempo, de acordo com os parâmetros fornecidos. São necessários seis parâmetros: 1) frequência da programação, como um número inteiro; 2) intervalo da programação, como uma cadeia de caracteres; 3) Data da última execução, como data; 4) Data em que o relógio acumulado foi iniciado (apenas para estudos baseados na acumulação de tempo), como data; 5) Hora em que o equipamento foi retirado na data em que o relógio acumulado foi iniciado (apenas para agendamentos baseados na acumulação de tempo), como um número inteiro; 6) Número de horas já acumuladas no agendamento atual (apenas para agendamentos baseados na acumulação de tempo), como um número inteiro. Esta função devolve um número (que representa HORAS) como texto.
GetRemainingAsString
Esta função devolve a frequência e o intervalo restantes numa programação, com base na acumulação de tempo, de acordo com os parâmetros fornecidos. São necessários seis parâmetros: 1) frequência da programação, como número inteiro; 2) intervalo da programação, como cadeia de caracteres; 3) Data da última execução, como data; 4) Data em que o relógio acumulado foi iniciado pela última vez (apenas para estudos baseados na acumulação de tempo), como data; 5) Hora em que o equipamento foi retirado na data em que o relógio acumulado foi iniciado pela última vez (apenas para agendamentos baseados na acumulação de tempo), como número inteiro; 6) Número de horas já acumuladas no agendamento atual (apenas para agendamentos baseados na acumulação de tempo), como número inteiro. Esta função devolve um texto que inclui a frequência e o intervalo.
CalcCalDueDate
Esta função devolve uma data de vencimento com base nos parâmetros fornecidos. São necessários três parâmetros: 1) frequência da programação, expressa como um número inteiro; 2) intervalo da programação, expresso como uma cadeia de caracteres; 3) data da última execução, expressa como uma data. Esta função devolve uma data. Note que esta função só é adequada para horários que não se baseiem na acumulação de tempo.
CalcAccumDueDate
Esta função devolve uma data de vencimento para os calendários com base na acumulação de tempo, de acordo com os parâmetros fornecidos. São necessários sete parâmetros: 1) frequência da programação, como um número inteiro; 2) intervalo da programação, como uma cadeia de caracteres; 3) data da última execução, como uma data; 4) data em que o contador de tempo acumulado foi iniciado (apenas para estudos baseados na acumulação de tempo), como uma data; 5) Número de horas do equipamento retirado na última data em que o relógio de acumulação foi iniciado (apenas para agendamentos baseados na acumulação de tempo), como um número inteiro; 6) Número de horas já acumuladas no agendamento atual (apenas para agendamentos baseados na acumulação de tempo), como um número inteiro; 7) Se a data de vencimento é devolvida no formato curto de data/hora, como um valor booleano. A data de vencimento é apresentada como texto. Note que esta função só é adequada para horários baseados na acumulação de tempo. Parte-se do princípio de que o equipamento é retirado imediatamente e permanece «fora» (com o contador a acumular tempo) até que o contador chegue a 0. Esta data 0 é então devolvida como resultado da função (ou seja, a data mais próxima em que este calendário acumulado se tornará exigível).
SQL
ReturnFromSQL
Esta função devolve os resultados de uma instrução SQL, fornecida como o primeiro (e único) parâmetro. O SQL é executado na base de dados; o primeiro registo / primeiro campo é devolvido como texto no resultado da função. Se ocorrer um erro, será devolvido '' (texto vazio).
SequenceNums
GetUniqueDocNum
Esta função devolve o próximo número de documento do evento, sob a forma de texto, com base nos parâmetros fornecidos. São necessários 2 parâmetros: 1) O número do evento atual, na forma de texto. (Nota: o número do evento é um campo interno do IndySoft.) Todos os eventos na base de dados da IndySoft são únicos por empresa, ID e número do evento) 2) Prefixos dos documentos, se existirem, como texto.
GetUniqueEventNum
Esta função devolve o próximo número de evento sob a forma de texto. (Nota: o número do evento é um campo interno do IndySoft.) Todos os eventos na base de dados da IndySoft são únicos por empresa, ID e número do evento.
GetUniqueLogNum
Esta função devolve o próximo número de registo sob a forma de texto. Os números de registo no IndySoft são utilizados para registar eventos a nível do sistema, como tentativas de início de sessão inválidas, etc.
GetUniqueCertNum
Esta função devolve o próximo Cert. número, como texto, com base no parâmetro fornecido. É necessário um parâmetro: 1) Fornecedor utilizado no evento, como texto (os números de certificado no IndySoft são sempre únicos por fornecedor).
GetUniqueWO_Number
Esta função devolve o próximo número de ordem de trabalho sob a forma de texto. Os números das ordens de trabalho são utilizados como «Número do trabalho» no sistema de ordens de trabalho da IndySoft e no campo «Ordem de trabalho» nos eventos. |