Variáveis Core - Histórico de revisão

Mike em 22h33min de 20 de outubro de 2013

2013-10-20T22:33:22Z

Mike: /* String formatted time */

2013-10-20T22:16:08Z

String formatted time

Mike: /* =Transport protocol of SIP request URI */

2013-10-20T22:15:30Z

=Transport protocol of SIP request URI

Mike em 22h14min de 20 de outubro de 2013

2013-10-20T22:14:47Z

Mostrar alterações

Mike em 21h43min de 20 de outubro de 2013

2013-10-20T21:43:59Z

Mostrar alterações

Mike em 20h51min de 20 de outubro de 2013

2013-10-20T20:51:15Z

Mike em 20h26min de 20 de outubro de 2013

2013-10-20T20:26:51Z

Mike em 20h17min de 20 de outubro de 2013

2013-10-20T20:17:13Z

Mike em 20h16min de 20 de outubro de 2013

2013-10-20T20:16:50Z

Mike em 20h16min de 20 de outubro de 2013

2013-10-20T20:16:09Z

@@ Linha 659: / Linha 659: @@
 ===SIP Headers===
-'''$(hdr(name)[N])''' - represents the body of the N-th header identified by 'name'. If [N] is omitted then the body of the first header is printed. The first header is got when N=0, for the second N=1, a.s.o. To print the last header of that type, use -1, no other negative values are supported now. No white spaces are allowed inside the specifier (before }, before or after {, [, ] symbols). When N='*', all headers of that type are printed.
+'''$(hdr(name)[N])''' - Representa o conteúdo do cabeçalho N identificado por 'name', se [N] for omitido então o conteúdo do primeiro cabeçalho será exibido, o primeiro cabeçalho é pego quando N=0, para o segundo N=1 e assim por diante, para imprimir o último cabeçalo  daquele tipo é possível utilizar o index [-1], nenhum outro valor negativo é suportado, não é permitido espaço em branco antes ou depois de [, {, }, ], quando N='*' , todos os cabeçalhos serão exibidos.
-The module should identify most of compact header names (the ones recognized by '''OpenSIPS''' which should be all at this moment), if not, the compact form has to be specified explicitly. It is recommended to use dedicated specifiers for headers (e.g., %ua for user agent header), if they are available -- they are faster.
+O módulo deve identificar a maior parte dos cabeçalhos  compactos (o  '''OpenSIPS''' reconhece todos atualmente), se não a forma compacta do cabeçalho necessita ser especificada explicitamente, é recomendado usar identificadores especiais para os cabeçalhos (ex: %ua para user agent), se eles estiverem disponiveis pois são mais rapidos.
-Note that some headers (e.g., Path) may be joined together with commas and appear as a single header line. This variable counts the number of header lines, not header values.
+'''$(hdrcnt(name))''' -- Retorna o numero de cabeçalhos deste tipo existentes, o tipo é defnido por 'name', utiliza as mesmas regras de especificação de nome de cabeçalho como '''$hdr(name)''', muitos cabeçalhos (ex: Via, Path, Record-Route) podem aparecer mais de uma vez na mensagem, esta variavel então retorna o numero referente a quantidad ede vezes que o cabeçalho em questão está presente.
      Path: <a.com>
      Path: <b.com>
-For message fragment below, '''$hdrcnt(Path)''' will have value 1 and '''$(hdr(Path)[0])''' will have value '''<a.com>,<b.com>''':
+Para o fragmento de mensagem abaixo , '''$hdrcnt(Path)''' terá o valor 1, e '''$(hdr(Path)[0]''' terá o valor '''<a.com>,<b.com>'''
-[@
      Path: <a.com>,<b.com>
-Note that both examples above are semantically equivalent but the variables take on different values.
+Veja que os dois exemplos representam a mesma coisa mas as variaveis possuem valores diferentes
-These sequences are exported, and mainly used, by xlog module to print messages in many colors (foreground and background) using escape sequences.
+==Escape Sequences==
-Colors could be:
+$C(xy) - Referencia uma sequencia de scape. 'x' repreenta a core de foreground (cor da fonte) e 'y' representa a cord de background (cor do fundo).
-* x : default color of the terminal
+Cores devem ser:
-A few examples of usage.
+Alguns exemplos de uso
-[@
+<pre>
 ...
 route {
@@ Linha 721: / Linha 720: @@
+}
 ...
-@]
+</pre>

← Edição anterior		Edição das 22h16min de 20 de outubro de 2013
Linha 634:		Linha 634:

	'''$T_branch_idx''' - O index (iniciando com 1 para a primeira branche) da branch para qual é executada uma branch_route[], se utilizado fora da branch_route[] o valor será 0, esta variável é exportado pelo módulo TM.		'''$T_branch_idx''' - O index (iniciando com 1 para a primeira branche) da branch para qual é executada uma branch_route[], se utilizado fora da branch_route[] o valor será 0, esta variável é exportado pelo módulo TM.
		+
		+	====Time Variables====

	=====String formatted time=====		=====String formatted time=====

← Edição anterior		Edição das 22h15min de 20 de outubro de 2013
Linha 551:		Linha 551:


−	====Transport protocol of SIP request URI===	+	====Transport protocol of SIP request URI====

	'''$rP''' - Referencia ao protocolo de transporte da R-URI		'''$rP''' - Referencia ao protocolo de transporte da R-URI

@@ Linha 31: / Linha 31: @@
 Exemplo de uso:
-Types of variables:
+==Tipos de variáveis==
-* [[#varscript | '''script variables''']] - as the name says, these variables are strictly bound to the script routes. The variables are visible only in the routing blocks - they are not message or transaction related, but they are process related (script variables will be inherited by script routes executed by the same '''OpenSIPS''' process).\\
+===script variables==
-Script variables are read write and they can have integer or string values. A script variable can have only a single value. A new assignment (or write operation) will overwrite the existing value.
+* Como o nome diz, estas variáveis são estritamente utilizadas em rotas de script, estas variáveis são visiveis apenas nos blocos de roteamento, não existem mensagem ou transações relacionas, mas são processos relacionados (variaveis de script são dependentes de rotas executadas pelo mesmo processo do '''OpenSIPS''').
-* [[#varavps | '''AVP - Attribute Value Pair''']] - the AVPs are dynamic variables (as name) that can be created - the AVPS are linked to a singular message or transaction (if stateful processing is used). A message or a transaction will initially (when received or created) have an empty list of AVPS attached to it. During the routing script, the script directly or functions called from script may create new AVPS that will automatically attached to the message/transaction. The AVPS will be visible in all routes where any message (reply or request) of the transaction will be processed - branch_route , failure_route, onreply_route (for this last route you need to enable the TM parameter ''onreply_avp_mode'').\\
+Variáveis de scripts são de leitura e escrita e podem ter valores inteiros ou strings, uma variável de script pode ter apenas um valor, uma nova atribuição (ou escrita) irá sobrescrever os valores existentes.
-* [[#varpv | '''pseudo variables''']] - pseudo-variables (or PV) provide access to information from the processed SIP message (headers, RURI, transport level info, a.s.o) or from '''OpenSIPS''' inners (time values, process PID, return code of a function). Depending of what info they provide, the PVs are either bound to the message, either to nothing  (global). Most of the PVs are read-only and only several allow write operations. A PV may return several values or only one, depending of the referred info (if can have multiple values or not).\\
+===AVP - Atribute Value Pair===
-Standard PV is read-only and returns a single value (if not otherwise documented).
+* As avp's são variaveis dinamicas que podem ser criadas, as avp's são linkadas para uma mensagem singular ou uma transação ( se processamento stateful está em uso), uma mensagem ou transação irá inicialmente (quando recebida ou criada) ter uma lista vazia de avp's atreladas, durante o processo de roteamento o script diretamente ou via função poderá criar novos AVP's que automaticamente serão atrelados a mensagem/transação, as avp's serão visiveis em todas as rotas onde qualquer mensagem (reply ou request) da transação seja processada, branch_route, filure_route, onreply_route ( para onreply_route voce deve ter ativado o parametro ''onreply_avp_mode'').
-* [[#varesc | '''escape sequences''']] - escape sequences used to format the strings; they are actually not variables, but rather formatters.
+AVP's são variáveis de leitura e escrita e uma AVP existente pode ser deletada (removida), uma AVP pode conter multiplos valores, uma nova atribuição (operação de escrita) irá adicionar o novo valor para a AVP, os valores são mantidos no formado ''ultimo adicionado é o primeiro a ser utilizado'' .
-[[#varscript]]
+PV padrões são apenas de leitura e retornam apenas um valor (se não foi documentado de forma diferente)
-'''Hints''':
+[[escape sequences]]
-# if you want to start using a script variable in a route, better initialize it with same value (or reset it), otherwise you may inherit a value from a previous route that was executed by the same process.
-# script variables are faster the AVPs, being referenced directly to memory location.
+* Sequencias de escape são utilizadas para formatar strings, estas não são variaveis mas podem ser formatadas.
-# the value of script variables persists over a '''OpenSIPS''' process.
 # a script value can have only one value.
-Example of usage:
+Exemplos de uso
-[@
+<pre>
 $var(a) = 2;  # sets the value of variable 'a' to integer '2'
 $var(a) = "2";  # sets the value of variable 'a' to string '2'
@@ Linha 78: / Linha 91: @@
    xlog("var a has third bit set\n");
+}
-@]
+</pre>
-Setting a variable to NULL is actually initializing the value to integer '0'. Script variables don't have NULL value.
+Definir uma variável para NULL corresponde a iniciar a a mesma com valor '0', variáveis de script não possuem valor NULL.
 '''Naming''': **$avp(name)** or **$(avp(name)[N])**

@@ Linha 13: / Linha 13: @@
   $(<context>'''name'''(subname)[index]{transformation})
-The fields written in green are optional.
+Os campos context, subname, index e transformation são opcionais
-Usage examples:
+Os campos significam:
 * Only '''name''': %green%$ru
 * '''Name''' and '''subname'': %green%$hdr(Contact)%%

← Edição anterior		Edição das 20h17min de 20 de outubro de 2013
Linha 12:		Linha 12:
	A sintaxe completa de uma pseudo-variavel é:		A sintaxe completa de uma pseudo-variavel é:

−	$('<context>'''name'''(subname)[index]{transformation}')	+	$(<context>'''name'''(subname)[index]{transformation})

← Edição anterior		Edição das 20h16min de 20 de outubro de 2013
Linha 12:		Linha 12:
	A sintaxe completa de uma pseudo-variavel é:		A sintaxe completa de uma pseudo-variavel é:

−		+	$('<context>'''name'''(subname)[index]{transformation}')
−	$('<context>'''name'''(subname)[index]{transformation}'')

← Edição anterior		Edição das 20h16min de 20 de outubro de 2013
Linha 13:		Linha 13:


−	$(~~%green%'~~'<context>~~''%black%~~'''name'~~''%green%~~''(subname)[index]{transformation}''%%)	+	$('<context>'''name'''(subname)[index]{transformation}'')