Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,6 @@ displayed_sidebar: docs
</div>
<!-- END REF-->

*Esse comando não é seguro para thread e não pode ser usado em código adequado.*


## Descrição
Expand All @@ -40,4 +39,15 @@ Se quiser apagar uma text box usando seu ID:

## Ver também

[WP New text box](../commands/wp-new-text-box)
[WP New text box](wp-new-text-box.md)


## Propriedades

| | |
| --- | --- |
| Command number | 1798 |
| Thread safe | yes |



Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,6 @@ displayed_sidebar: docs
</div>
<!-- END REF-->

*Esse comando não é seguro para thread e não pode ser usado em código adequado.*


## Descrição
Expand Down Expand Up @@ -62,5 +61,16 @@ method2 poderia parecer com algo como:

## Ver também


[Blog post - ORDA and 4D Write Pro : The power couple!](https://blog.4d.com/orda-and-4d-write-pro-the-power-couple/)
[WP SET DATA CONTEXT](../commands/wp-set-data-context)


## Propriedades

| | |
| --- | --- |
| Número do comando | 1787 |
| Thread safe | sim |



Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,25 @@ slug: /WritePro/commands/wp-new-text-box
displayed_sidebar: docs
---

<!--REF #_command_.WP New text box.Syntax-->**WP New text box** ( *wpDoc* : Object ; *pageNum* : Number ) -> Resultado<!-- END REF-->
<!--REF #_command_.WP New text box.Syntax-->**WP New text box** ( *wpDoc* : Object ; *pageNum* : Real ) : Object<!-- END REF-->
<!--REF #_command_.WP New text box.Params-->
<div class="no-index">

| Parâmetro | Tipo | | Descrição |
| --- | --- | --- | --- |
| wpDoc | Object | &#8594; | Documento 4D Write Pro |
| pageNum | Number | &#8594; | Número de página onde ancorar a caixa de texto |
| Resultado | Object | &#8592; | Objeto caixa de texto |
| pageNum | Real | &#8594; | Número de página onde ancorar a caixa de texto |
| Function result | Object | &#8592; | Objeto caixa de texto |
</div>
<!-- END REF-->

*Esse comando não é seguro para thread e não pode ser usado em código adequado.*


## Descrição

<!--REF #_command_.WP New text box.Summary-->O comando **WP New text box** cria e retorna um novo objeto caixa de texto na página *pageNum* de *wpDoc*.<!-- END REF-->

**Nota:** Para saber mais sobre caixas de texto, veja o parágrafo *Gerenciar caixas de texto*.
**Nota:** Para saber mais sobre caixas de texto, veja o parágrafo [*Caixas de texto*](../text-boxes).

No parâmetro *wpDoc*, passe um documento 4D Write Pro.

Expand All @@ -41,7 +40,7 @@ O comando cria um novo elemento caixa de texto com os atributos padrão abaixo:
* id = "textBoxN" onde N é um número,
* ancorado na frente do corpo no canto esquerdo superior do retângulo de página (imagem, uma caixa de texto pode ser ancorada em modo embebido, ou a uma seção, a todas as seções ou uma subseção em modo página e ao fundo ou camada superior)

Ver a seção *Atributos 4D Write Pro* para descrição detalhada desses atributos. .
Ver a seção [Atributos 4D Write Pro](../4d-write-pro-attributes) para descrição detalhada desses atributos. .

A nova caixa de texto é renderizada só na página *pageNum,* então não pode ser renderizada se:

Expand Down Expand Up @@ -83,9 +82,9 @@ Se quiser adicionar uma caixa de texto em um modelo de carta, para exibir o ende
 WP SET ATTRIBUTES($textBox;wk vertical align;wk center)

  // #3: define as fórmulas dentro da caixa de texto
 WP INSERT FORMULA($textBox;Formula(This.data.fullName);wk append)
 WP Insert formula($textBox;Formula(This.data.fullName);wk append)
 WP INSERT BREAK($textBox;wk paragraph break;wk append)
 WP INSERT FORMULA($textBox;Formula(This.data.fullAddress);wk append)
 WP Insert formula($textBox;Formula(This.data.fullAddress);wk append)

  // #4: Dá estilo ao conteúdo da caixa de texto
 WP SET ATTRIBUTES($textBox;wk font;"Arial";wk font bold;wk true;wk font size;"18pt")
Expand All @@ -97,4 +96,15 @@ Result:

## Ver também

[WP DELETE TEXT BOX](../commands/wp-delete-text-box)
[WP DELETE TEXT BOX](wp-delete-text-box.md)


## Propriedades

| | |
| --- | --- |
| Número do comando | 1797 |
| Thread safe | yes |



Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,17 @@ slug: /WritePro/commands/wp-set-data-context
displayed_sidebar: docs
---

<!--REF #_command_.WP SET DATA CONTEXT.Syntax-->**WP SET DATA CONTEXT** ( *wpDoc* : Object ; *contextoData* : Object )<!-- END REF-->
<!--REF #_command_.WP SET DATA CONTEXT.Syntax-->**WP SET DATA CONTEXT** ( *wpDoc* : Object ; *contextData* : Object )<!-- END REF-->
<!--REF #_command_.WP SET DATA CONTEXT.Params-->
<div class="no-index">

| Parâmetro | Tipo | | Descrição |
| --- | --- | --- | --- |
| wpDoc | Object | &#8594; | Documento 4D Write Pro |
| contextoData | Object | &#8594; | Data a ser colocado em contexto |
| contextData | Object | &#8594; | Data a ser colocado em contexto |
</div>
<!-- END REF-->

*Esse comando não é seguro para thread e não pode ser usado em código adequado.*


## Descrição
Expand All @@ -42,7 +41,7 @@ Quando usar o contexto de dados em fórmulas computadas de um processo diferente

Se estabelecer um contexto de dados que já foi definido para o mesmo documento em outro processo, um erro é jogado

Para computar fórmulas com contextos de dados diferentes em processos diferentes (ou seja, gera faturas diferentes do mesmo documento model), é recomendado para duplicar o documento usando [WP New](../commands/wp-new) em cada um desses processos para evitar qualquer erro. Note que o contexto de dados não é copiado quando duplicar um documento.
Para computar fórmulas com contextos de dados diferentes em processos diferentes (ou seja, gera faturas diferentes do mesmo documento model), é recomendado para duplicar o documento usando [WP New](wp-new.md) em cada um desses processos para evitar qualquer erro. Note que o contexto de dados não é copiado quando duplicar um documento.

## Exemplo 1

Expand Down Expand Up @@ -94,6 +93,18 @@ O exemplo abaixo recorre uma seleção de entidades e cria uma vista previa de i

## Ver também

[Blog post - 4D Write Pro: Dynamically Fill Tables with Entity Selections & Collections](https://blog.4d.com/4d-write-pro-dynamically-fill-tables-with-entity-selections-collections/)
[WP COMPUTE FORMULAS](../commands/wp-compute-formulas)
[WP Get data context](../commands/wp-get-data-context)
[Blog post - ORDA and 4D Write Pro : The power couple!](https://blog.4d.com/orda-and-4d-write-pro-the-power-couple/)
[Blog post - 4D Write Pro: Dynamically Fill Tables with Entity Selections & Collections](https://blog.4d.com/4d-write-pro-dynamically-fill-tables-with-entity-selections-collections/)
[WP COMPUTE FORMULAS](wp-compute-formulas.md)
[WP Get data context](wp-get-data-context.md)


## Propriedades

| | |
| --- | --- |
| Número do comando | 1786 |
| Thread safe | sim |



Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: /WritePro/commands/wp-table-merge-cells
displayed_sidebar: docs
---

<!--REF #_command_.WP TABLE MERGE CELLS.Syntax-->**WP TABLE MERGE CELLS** ( *targetObj* : Object ) | ( *tableRef* : Object ; *startColumn* : Integer ; *startRow* : Integer {; *columnCount* : Integer{; *rowCount* : Integer}} )<!-- END REF-->
<!--REF #_command_.WP TABLE MERGE CELLS.Syntax-->**WP TABLE MERGE CELLS** ( *targetObj* : Object )<br/>**WP TABLE MERGE CELLS** ( *tableRef* : Object ; *startColumn* : Integer ; *startRow* : Integer {; *columnCount* : Integer{; *rowCount* : Integer}} )<!-- END REF-->
<!--REF #_command_.WP TABLE MERGE CELLS.Params-->
<div class="no-index">

Expand All @@ -20,7 +20,6 @@ displayed_sidebar: docs
</div>
<!-- END REF-->

*Esse comando não é seguro para thread e não pode ser usado em código adequado.*


## Descrição
Expand Down Expand Up @@ -70,4 +69,15 @@ Para mais detalhes, consulte *Fundir e separar células*.
## Ver também

*Gerenciar tabelas*
[WP TABLE SPLIT CELLS](../commands/wp-table-split-cells)
[WP TABLE SPLIT CELLS](wp-table-split-cells.md)


## Propriedades

| | |
| --- | --- |
| Número do comando | 1815 |
| Thread safe | yes |



Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ displayed_sidebar: docs
</div>
<!-- END REF-->

*Esse comando não é seguro para thread e não pode ser usado em código adequado.*


## Descrição
Expand All @@ -45,6 +44,8 @@ Se *targetObj* intersectar uma ou muitas células que não forem fusionadas ante

Se rowCount for omitido, é equivalente de passar 1 (valor normal). Se tanto columnCount quanto rowCount, forem omitidos, equivale a dividir una única célula e se não forem fusionados antes não acontece nada.

Se startColumn mais columnCount ou *startRow* mais rowCount exceder o número de colunas/linhas em *tableRef*, ou se startColumn ou *startRow* for maior que o número de colunas/linhas em *tableRef*, o intervalo retornado contém o máximo possível de colunas/linhas, o que significa que toda célula da tabela (se tiver sido fusionada antes) será dividida.

## Exemplo

Se quiser atribuir a um intervalo de células (que contenha algumas células já combinadas) e dividí-lo:
Expand All @@ -68,3 +69,14 @@ Para mais detalles, consulte *Fundir e separar células*.

*Gerenciar tabelas*
[WP TABLE MERGE CELLS](../commands/wp-table-merge-cells)


## Propriedades

| | |
| --- | --- |
| Número do comando | 1816 |
| Thread safe | sim |



Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
id: on-exit-database-method
title: On Exit database method
title: Método banco de dados On Exit
slug: /commands/on-exit-database-method
displayed_sidebar: docs
---
Expand All @@ -21,10 +21,10 @@ displayed_sidebar: docs
Este método é utilizado nos seguintes ambientes 4D:

* 4D em modo local
* 4D em modo remoto (do lado do cliente)
* Aplicação 4D compilada e fusionada com 4D Volume Desktop
* 4D em modo remoto
* Aplicação 4D compilada e fusionada com 4D VolumeDesktop

**Nota**: o Método banco de dados On Exit NÃO é invocado por 4D Server.
**Nota**: o Método banco de dados On Exit NÃO é invocado por 4D Server. Você deve usar o [On Server Shutdown database method](../commands/on-server-shutdown-database-method) neste contexto.

O Método banco de dados On Exit é invocado automaticamente por 4D; diferentemente dos métodos de projeto, você não pode chamar este método por programação. Entretanto, pode ser executado desde o editor de métodos. Igualmente pode utilizar subrotinas.

Expand All @@ -39,6 +39,14 @@ Sem importar como se inicie a saída do banco, 4D realiza as seguintes ações:
* Se não existir um Método banco de dados On Exit, 4D aborta cada processo em execução um por um, sem distinção. Se o usuário está introduzindo dados, os registros não serão guardados.
* Se existir um Método banco de dados On Exit , 4D começa a execução deste método em um processo local criado recentemente. Observe que sairá eventualmente de 4D, o Método banco de dados On Exit pode realizar toda a limpeza ou fechar as operações que queira, mas não pode ser negado a sair.

Quando 4D está prestes a sair, o programa:

* solicita que os processos em execução abortem sua execução o mais rápido possível (considerado apenas em processos executando código 4D)
* define o flag ‘process aborted’ deles
* acorda processos que foram atrasados por [DELAY PROCESS](../commands/delay-process) ou outros meios.

4D continua iterando processos enquanto qualquer processo ainda estiver ativo, por uma duração máxima de 13 segundos. Para responder a uma ação de saída, recomendamos definir uma flag (como uma entrada no objeto [Storage](../commands/storage)) no Método banco de dados On Exit ou no seu método personalizado de saída. Pode fazer sentido fazer um loop nesse método (máx. 10 segundos) para dar tempo aos seus processos em execução de responderem e saírem corretamente. Não é recomendado esperar mais de 10 segundos, para evitar que o 4D mate o processo ou o sistema operacional encerre toda a aplicação.

O Método banco de dados On Exit é perfeito para:

* Salvar (localmente, no disco) preferências ou parâmetros a reutilizar ao começo da seguinte sessão em .
Expand Down Expand Up @@ -99,4 +107,5 @@ O exemplo abaixo mostra um caso típico onde você lança um ou mais processos n
## Ver também

[Método banco de dados On Startup](../commands/metodo-banco-de-dados-on-startup)
[QUIT 4D](../commands/quit-4d)
[QUIT 4D](../commands/quit-4d)

Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: /commands/on-rest-authentication-database-method
displayed_sidebar: docs
---

<!--REF #_command_.On REST Authentication database method.Syntax-->$1, $2, $3, $4 -> On REST Authentication database method : Boolean<!-- END REF-->
<!--REF #_command_.On REST Authentication database method.Syntax-->$1, $2, $3, $4 -> On REST Authentication database method -> $0<!-- END REF-->
<!--REF #_command_.On REST Authentication database method.Params-->
<div class="no-index">

Expand All @@ -15,14 +15,28 @@ displayed_sidebar: docs
| $2 | Texto | &#8592; | Senha |
| $3 | Booleano | &#8592; | True = modo Digest, False = modo Basic |
| $4 | Texto | &#8592; | Endereço IP do caller |
| Resultado | Boolean | &#8592; | True = pedido aceito, False = pedido rejeitado |
| $0 | Boolean | &#8592; | True = pedido aceito, False = pedido rejeitado |
</div>
<!-- END REF-->

<div class="no-index">
<details><summary>History</summary>

|Release|Changes|
|---|---|
|14|Created|
|14 R3|Renamed|
|18|Modified|
|18|Renamed|
|20 R6|Modified|

</details>
</div>

## Descrição

<!--REF #_command_.On REST Authentication database method.Summary-->**On REST Authentication database method** está obsoleto em projetos desde 4D 20 R6.<!-- END REF-->

A [Force login authentication](../REST/authUsers.md) é recomendada em seu lugar. Em projetos convertidos, pode atualizar sua configuração clicando no botão das configurações [**Activate REST authentication through ds.authentify() function**](../settings/web.md#access) Veja também [este artigo](https://blog.4d.com/force-login-becomes-default-for-all-rest-auth/) para saber como migrar seu código se necessário.


Original file line number Diff line number Diff line change
Expand Up @@ -48,8 +48,14 @@ Em cada caso com um 4D remoto, três processos são iniciados. Um na máquina cl
 CREATE RECORD([Table_1])
 [Table_1])field1_1:="Hello world"
 SAVE RECORD([Table_1]) // criação aqui do processo apropriado no servidor
 $serverTime:=Current time(*) // criação aqui do processo cooperativo no servidor
  // chamada ao On Server Open Connection
```

**Importante**: Conexões Web e conexões SQL não invocam o **On Server Open Connection database method**. Quando um navegador Web conecta ao 4D Server, o *On Web Authentication Database Method* (se existir) e/ou o [On Web Connection database method](../commands/on-web-connection-database-method) são invocados. Quando o 4D Server recebe uma consulta SQL, o [On SQL Authentication database method](../commands/on-sql-authentication-database-method) (se existir) é chamado. Para mais informações, consulte a descrição deste método base no manual de Referência da Linguagem 4D.

**Importante**: Quando um Stored Procedure é iniciado, o **On Server Open Connection database method** NÃO é invocado. *Stored Procedures* são processos do servidor, não processos 4D Client. Eles executam código na máquina Servidor, mas não respondem a solicitações trocadas por um cliente 4D (ou outros clientes) e o 4D Server.

## Como se chama ao método base On Server Open Connection?

O On Server Open Connection database method é executado no equipo servidor no processo 4D Client que provocou a chamada do método.
Expand Down Expand Up @@ -141,12 +147,3 @@ O seguinte exemplo evita uma nova conexão entre as 2 e 4 A.M.
```


## Propriedades

| | |
| --- | --- |
| Número do comando | 16001 |
| Thread-seguro | no |



Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ O Método banco de dados On Startup é perfeito para:
* Carregar preferências ou parâmetros guardados durante a sessão de trabalho anterior.
* Evitar a abertura do banco se não se cumprirem uma condição (por exemplo, se faltar um recurso do sistema) chamando explicitamente [QUIT 4D](../commands/quit-4d).
* Realizar outras ações que deseja executar automaticamente cada vez que abra um banco.

No entanto, lhe recomendamos NÃO lançar trabalhos de impressão desde o **Método banco de dados On Startup**.

## Exemplo
Expand All @@ -43,6 +44,6 @@ Veja o exemplo na seção [Semaphore](../commands/semaphore).

## Ver também

[Método banco de dados On Exit](../commands/metodo-banco-de-dados-on-exit)
*Métodos de banco de dados*
[QUIT 4D](../commands/quit-4d)
[Método banco de dados On Exit](../commands/on-exit-database-method)
[QUIT 4D](../commands/quit-4d)
Loading
Loading