Funcionalidades obsoletas e eliminadas

Transcrição

1 Funcionalidades obsoletas e eliminadas Sobre este manual Rev. October 2014 Durante mais de 25 anos, nosso principal objetivo foi melhorar nosso produto (utilização de novos conceitos e tecnologias) tendo a certeza a compatibilidade das aplicações 4D. Como os pioneiros de 4D sabem, sempre colocamos muito esforço na compatibilidade e podemos encontrar aplicações 4D em todo o mundo que são criados faz muitos anos, com antigas versões de 4D e sistema operativo, que ainda estão trabalhando com as últimas revisões do produto. Desafortunadamente, as vezes se torna muito difícil combinar antigas tecnologias com as novas: 4D deve trazer novas tecnologias, novas APIs e novos paradigmas aos desenvolvedores. Os sistemas operativos mudam todos os dias e as vezes se tornam obsoletas suas próprias APIs antigas É por isso que as vezes 4D necessita etiquetar alguns comandos e funcionalidades como obsoletos, o que significa que um dia, serão eliminados da linguagem em uma versão principal futura. Informar aos desenvolvedores o que é obsoleto e que tipo de substituição pode ser utilizada em seu lugar faz com que seja bem mais cômodo para eles implementar a mudança em seu código: não há urgência, não há pressão e o desenvolvedor tem muito tempo para fazer as mudanças necessárias. Começamos cobrindo todas as funções obsoletas, dando detalhes sobre cada uma, seguido de uma lista de comandos em desuso. Também oferecemos uma tabela de resume. Mudanças em 4D v14 Quick table Previous documents

2 Mudanças em 4D v14 Comandos obsoletos XSLT A linguagem XSLT transforma os dados XML a qualquer formato (XML, HTML, ou qualquer outro tipo). Os principais navegadores de Internet, assim como o software 4D foi implementado a especificação XSLT 1.0. Atualmente a tendência XSLT está em declive porque os desenvolvedores consideram que é difícil de usar e de depurar. Seguindo esta tendência, assim como os comentários dos desenvolvedores, decidimos que a funcionalidade de transformação XSL não será desenvolvida para versões 4D de 64 bits. Nota: para visualizar as tendências de pesquisa em XSLT em Google: #command_3 No entanto, para suportar a nossos clientes que continuam utilizando XSLT em 4D, escolhemos confiar na livraria XSL PHP, que oferece uma completa API que lhe permite realizar todas as operações necessárias para suas transformações XSL. Esta livraria é uma ferramenta eficaz que pode substituir facilmente os comandos _o_xslt APPLY TRANSFORMATION, [#cmd id="883"/] e _o_xslt GET ERROR depois de sua eliminação. 4D produziu um documento específico para lhe ajudar a utilizar PHP XSL como uma substituição para os comandos XSLT de 4D: Baixe XSLT com o documento técnico PHP (PDF). Também lhe sugerimos que considere o uso de etiquetas 4D quando se trata da geração dinâmica de páginas HTML, já que na maioria dos casos é mais fácil gerenciar código HTML como texto sem formato (ver também o comando PROCESS 4D TAGS). Por compatibilidade, as transformações XSL continuam suportando em 4D, mas seu uso não se recomenda. O suporte do processamento XSLT será eliminado em futuras versões de 4D. Nota 4D Server 64 bits OS X: XSLT não está disponível com 4D Server 64 bits para OS X. Portanto, ao chamar um destes comandos desde esta aplicação irá gerar um erro 33 "Comando ou função não implementada". Imagens em formato PICT O formato PICT não será suportado nos próximos grandes lançamentos de 4D e já não deve ser utilizado em 4D v14. A função AP Is Picture Deprecated, oferecida através de 4D Pack a partir da versão 13.2, têm a intenção de lhe ajudar a migrar suas aplicações. Nota: O formato "PICT" Mac foi desaprovado por Apple desde várias versões anteriores de Mac OS (consulte a descrição do formato PICT em Wikipédia). O formato 'PICT' é um formato bem antigo em Mac. Antes da versão 11, 4D armazenava todas as imagens neste formato, inclusive em Windows. O formato PICT é obsoleto desde que QuickDraw foi declarado obsoleto em Há algo importante de entender sobre PICT. Pode armazenar ("encapsular") 2 tipos principais de informação: os desenhos em si (seja mapa de bits ou vetorial), ou um formato mais moderno (JPEG, por exemplo) armazenado em um PICT utilizando QuickTime. (Geralmente, o desenvolvedor estava chamando COMPRESS PICTURE com a constante QT Photo compressor). Isto significa que inclusive antes quando todas as imagens armazenadas nos arquivos de dados eram PICT, esses PICT podiam, de fato, conter os arquivos JPEG (ou outros formatos). É importante que nossos clientes deixem de usar PICT, não só porque está obsoleto, mas também porque 4D necessita Altura (+ QuickTime utilizou COMPRESS PICTURE) para ler PICT em Windows. Isto não é eficiente, e requer que QuickTime esteja instalado. Ao migrar dados de versões anteriores a v11, os desenvolvedores devem aplicar o comando CONVERT PICTURE para cada campo imagem dos dados. Ao converter os dados das versões mais recentes, se recomenda utilizar a função para encontrar imagens que necessitam ser convertidas. QuickTime O suporte para os codecs de imagens relacionados com QuickTime já é obsoleto. Por padrão, o uso de QuickTime está desabilitado em 4D v14. No entanto, por razões de compatibilidade, pode ser habilitado seu uso utilizando a nova opção de suporte QuickTime dos comandos SET DATABASE PARAMETER e Get database parameter. Formatos de imagem QuickTime sob Windows Durante vários anos, o gerenciamento de imagens sob a versão Windows de QuickTime não evoluiu (só a parte de vídeo está evoluindo). Temos a intenção de eliminar o suporte para estas APIs específicas na próxima versão. 4D para Windows de forma nativa suporta todos os principais formatos (JPEG, PNG, GIF, TIFF, etc.), e também suporta WIC (Windows Imaging Component). Se, em seus dados, você tem algumas imagens guardadas em Windows em um formato específico conhecido só por QuickTime, pode ser convertido (CONVERT PICTURE). Também lhe recordamos que o suporte para os formatos de imagem de QuickTime foi eliminado da versão de 64 bits de 4D

3 Server para Windows como de 4D v12. Atribuição dinâmica de variáveis recebidas por meio de HTTP Nas versões anteriores de 4D, o servidor web recopiava automaticamente o valor das variáveis enviadas através de um formulário web ou um URL nas variáveis 4D quando tinham o mesmo nome. Por razões de otimização e controle, este princípio não se mantém a partir de 4D v14: o valor das variáveis Web já não se atribui automaticamente as variáveis 4D. Para recuperar as variáveis enviadas utilizando um POST ou um GET, deve utilizar o comando WEB GET VARIABLES exclusivamente. Para recuperar as imagens enviadas, deve utilizar os comandos WEB GET BODY PART/WEB Get body part count. Nota: a atribuição dinâmica também está desativada por padrão nas bases de dados 4D criadas a partir da versão No entanto, por compatibilidade, este mecanismo se mantém por padrão nas bases de dados criadas com uma versão de 4D anterior a Neste caso, pode ser desativado o uso da opção de compatibilidade de atribuição de variável automática na página Compatibilidade das Propriedades da base. Dado que este mecanismo é obsoleto, se recomenda desmarcar esta opção em suas bases de dados convertidas (e adaptar seu código se for necessário) com o propósito de facilitar futuras evoluções. Números de fonte O uso de números de identificação QuickDraw para designar fontes é obsoleto e não deve ser utilizado mais. Os comandos Font name e Font number se conservam em 4D v14 por compatibilidade, mas serão eliminadas em versões posteriores. O comando OBJECT SET FONT agora só aceita nomes de fontes. Suspensão de 4D Chart O plug-in 4D Chart já não se oferece na versão 14 e seu desenvolvimento e manutenção foi suspendido de forma permanente. Os comandos 4D no tema "Gráficos" só funcionam com a sintaxe SVG e o comando GRAPH TABLE foi eliminado. Barra de ferramentas em modo Aplicação A barra de ferramentas automática que estava disponível ao mudar ao modo Aplicação foi eliminado e a opção "Barra de ferramentas de visualização" foi eliminada da página Interface das Propriedades da base. A partir de 4D v14 R5, a criação de barras de ferramentas personalizadas é facilitada pela nova constante Toolbar form window, utilizada com o comando Open form window. Também pode utilizar os comandos SHOW TOOL BAR, HIDE TOOL BAR e Tool bar height neste contexto. Cordial spell check Os dicionários Cordial já não se suportam em 4D v14. Só os dicionários Hunspell (assim como também o dicionário nativo sob OS X) podem ser utilizados. Windows em modo no-composite (OS X) O modo composite agora se utiliza sistematicamente para todas as janelas criadas por 4D v14 em OS X. Nas versões anteriores de 4D, era possível criar janelas usando um antigo modo de gestão interna (baseado em QuickDraw). Este modo foi abandonado. Graças ao modo composite, as janelas 4D tem um novo comportamento e funções em OS X: animação quando se redimensionam janelas as janelas pode ser redimensionado utilizando qualquer papel e já não é uma caixa de redimensionamento na parte inferior direita das janelas a compatibilidade com o modo de tela HiDPI (ou modo "Retina") o modo "tela completa" com ocultação automática da barra de menu principal (a partir de OS X 10.7) suporte para o comando DISPLAY NOTIFICATION sob OS X (a partir de OS X 10.8). Nota: os plug-ins que requerem QuickDraw devem ser adaptados para que sejam compatíveis com o modo de composite. Para garantir a compatibilidade com os plug-ins que ainda requerem QuickDraw, se implementou uma capa de emulação. Para obter mais informação, entre em contato ao suporte técnico de 4D. Atalho Opção+F (OS X) O atalho Opção+F, que lhe permite "forçar" a mudança da Aplicação a modo Desenho em OS X, se elimina em 4D v14. É decisão do desenvolvedor agregar um comando de menu associado a ação estandarte "Voltar ao modo Desenho" e um acesso direto personalizado com o propósito de gerenciar esta operação.

4 Tenha em conta que o atalho Opção+Maiús+clique direito ainda pode seguir utilizando para acessar ao menu de depuração. Transações automáticas opção de compatibilidade Esta anterior opção de compatibilidade já não se suporta nas versões recentes de 4D e foi eliminado da página "Compatibilidade" das Propriedades da base em 4D 14. Altura Mac2Win Altura Mac2Win se utilizou para levar 4D a Windows. É um conjunto de APIs que ajudaram a levar código Mac OS (pre OS X) a Windows, mediante a tradução das APIs: filesystem, QuickDraw, Resources, PICT, etc. Foi bastante útil e ajudou muito (os desenvolvedores Mac plug-in, por exemplo, poderiam mover seus plug-ins a Windows mais facilmente), mas traduz APIs Mac OS antigas ("obsoleto") e não utiliza a API de Windows nativo moderno: 4D deve eliminar Mac2Win de seu código o máximo possível. Isto é um trabalho longo e difícil e em cada versão de 4D, algumas dependências se eliminam (e substituem por APIs modernas). Neste momento, 4D ainda depende em parte, ainda mais para poder gerenciar a compatibilidade de antigas bases de dados: Recursos, PICT, parte da gestão dos eventos de usuário, suporte para os plug-ins de terceiros que estão integrados utilizando Altura, etc. Mediante a eliminação de recursos no arquivo.rsr para separar os arquivos na pasta "Recursos" e mediante a conversão (CONVERT PICTURE) a no-pict, o desenvolvedor 4D estará pronto uma vez 4D eliminar Altura. Mas as primeiras pessoas preocupadas por este grande passo são os desenvolvedores do plug-in. Eles devem deixar de usar Altura o mais rápido possível, o que significa que têm que reescrever algumas partes de seu código fonte Windows. (Já tinha lhe advertido à muitos anos. Sub tabelas Em várias versões principais, 4D advertiu aos desenvolvedores em contra do uso das sub tabelas. Desde 4D v11, é impossível criar um campo do tipo sub tabela. Os sub registros têm algumas limitações conhecidas. Por exemplo, sempre se carregam em memória; não se gerenciam pelos comandos SEND RECORD ou DUPLICATE RECORD. Não temos planos de eliminar o suporte para as sub tabelas em um futuro próximo, mas é realmente o momento de que os desenvolvedores convertam suas sub tabelas a tabelas N-> regulares porque temos a intenção de eliminar em uma futura versão principal de 4D. Os desenvolvedores que utilizam sub tabelas por razões de rendimento (algumas situações específicas nas que a carga dos registros relacionados era lenta) fiquem tranquilos, especialmente com v12: utilizar as relações N <-> 1 clássicas é bem rápido. Basicamente, há duas formas principais para eliminar sub tabelas (nota: o seguinte não é uma tecnologia completa de ponta; só uma visão geral rápida): Antes da conversão de uma estrutura pre-v11: em 2004, criar a tabela N apropriada e o campo ID na tabela 1 (se não já está ali). Logo, mude o código em todas as partes se for necessário (ver mais a frente). Depois da conversão: nesta situação, 4D substitui a sub tabela com uma tabela N usando uma relação especial, que permite que a linguagem para trabalhar com a sub seleção e os sub registros. O desenvolvedor 4D necessita eliminar esta relação especial, substituir ela por uma relação normal e mudar o código por todas partes se for necessário (ver mais a frente). O que queremos dizer com "mudar o código por todas partes se for necessário" é, basicamente: Criar os novos formulários, atualizar os formulários incluídos Nos métodos (projeto, formulário, objeto, etc.): Substitua todos os comandos do tema "Sub registros" com o comando Selection ou Record correspondente (por exemplo, substituir CREATE SUBRECORD com CREATE RECORD, enchendo os campos ID) Explicitamente carregar os registros N quando for necessário Note: a partir de 4D v14 R3, pode atribuir valores aos campos "id_added_by_converter" especiais que se agregam automaticamente por 4D quando converte uma base de dados que contém sub tabelas. Isto lhe permite manter o link "relação sub tabela", e agregar ou modificar registros relacionados, sem necessidade de usar comandos em desuso tais como CREATE SUBRECORD. Uma vez que tenha atualizado seus métodos, estas relações especiais podem ser substituídas por outros estandartes com nenhuma mudança em seu código. Modo No Unicode O suporte ao modo ASCII (sinônimo de "modo no Unicode") conduz a um baixo rendimento na manipulação de texto, já que se deve converter desde e para Mac-roman cada vez que se utiliza na estrutura legacy-converted. Planejamos eliminar o modo ASCII em futuras versões principais. Note que o suporte para o modo ASCII já se retirou para estruturas compiladas que se executem sob 4D Server 64 bits para Windows.

5 Os desenvolvedores 4D devem, para estruturas convertidas, ativar o modo Unicode. O documento PDF Conversão a 4D v14 da pistas sobre este tema. Também note que o suporte do modo ASCII não está disponível na versão 4D Server 64 bits para OS X. Recursos Mac Esta é outra antiga tecnologia Mac OS, em desuso desde Mac OS X 10.4 (Tiger, 2005). Os recursos se utilizam para armazenar dados estruturados, como texto e cadeias (localização), assim como também ícones, etc. Basicamente, podemos dizer que não são os recursos que estão em desuso, é seu suporte em disco, conhecido como o resource fork. O resource fork é parte do sistema de arquivos de Mac OS e desde o início de Mac OS X, Apple tratou de eliminar este suporte, já que não é compatível com outros sistemas de arquivos (Unix, Windows), e é a fonte de uma grande quantidade de problemas quando os arquivos se transferem através da rede. Em Windows, este mecanismo se emula e os recursos Mac residem em um arquivo.rsr. Mas ainda assim, inclusive se há ainda APIs para gerenciar os recursos (e Mac OS gerencia de forma transparente os recursos armazenados em um data fork), já não se recomenda utilizar este velho mecanismo por várias razões: Os textos e as cadeias são Mac-roman. Não pode ser armazenado Unicode em recursos de tipo TEXT ou STR # Os recursos PICT armazenam PICTs: não é moderno, obsoleto, sem transparência, etc. (Consulte o tema "PICT" acima.) A contagem dos recursos e o tamanho dos recursos são limitados (uns recursos ou 16 MB) Eliminamos suporte para comandos de escritura/criação de recursos A grande maioria das aplicações 4D que utilizam recursos estão, de fato, utilizando recursos "Strings List", 'STR#'. 4D oferece as ferramentas para mudar facilmente do STR # a XLIFF: O componente 4D Pop pode criar automaticamente os arquivos XLIFF mediante a leitura e transferir o conteúdo do STR #. Todas as rotinas e as expressões que fazem referência a trabalho STR# sem mudança com XLIFF. Por exemplo, Se a etiqueta de um botão ou um menu era ":15000,3" (que significa "conseguir o terceiro elemento de STR# ID 15000"), 4D carregará o XLIFF apropriado (caso exista). Para outros tipos de recursos: Colocar os recursos em arquivos separados dentro da pasta Resources (criar sub diretórios se for necessário): Guardar recursos 'TEXT' em arquivos XLIFF ou.txt Guardar recursos 'PICT' como arquivos.jpg/.png/etc. separado Guardar recursos 'PICT' + MASK como arquivos png Utilizar (em Mac) icns em lugar de ICON ou ícones de cores Guardar todos os recursos privados como seja apropriado para você (normalmente: guardar como um arquivo binário com uma extensão específica) Utilize a pasta "Recursos" para armazenar seus recursos. Utilize Get 4D folder (pasta de recursos atuais) para obter de forma dinâmica a rota pai para seus recursos. API QuickDraw Há dois tipos de plug-ins: os que utilizam o novo plug-in API e os que seguem utilizando o velho (com QuickDraw). Para os plugins que utilizam a velha caixa de ferramentas (com QuickDraw): para manter a compatibilidade, o desenho/renderização já não se realiza diretamente em uma porta QuickDraw, como nas versões anteriores, mas em seu lugar através de uma área GWorld QuickDraw offscreen dedicada ao plugin. Em consequência, há que respeitar algumas regras, como os plug-ins não devem modificar a porta atual definido pelo recipiente (objeto formulario). Para os plug-ins que utilizam a nova caixa de ferramentas: só se utiliza esta nova caixa de ferramentas e no QuickDraw: (ver Linguagem: comandos obsoletos ou eliminados

6 Comando Substituído com desde Estado atual Tema Ambiente 4D: ADD DATA SEGMENT - v11 DATA SEGMENT LIST - v11 Tema Compilador: ARRAY STRING ARRAY TEXT v12 C_GRAPH (uso de SVG com o comando GRAPH) v12 C_INTEGER C_LONGINT v12 C_STRING C_TEXT (sempre que a base esteja em Unicode) v12 Tema Entrada de dados: ADD SUBRECORD ADD RECORD na tabela n de uma relação N->1 v12 Modifed Form event e On data change v12 MODIFY SUBRECORD MODIFY RECORD na tabela n de uma relação N->1 v12 Tema Eventos formulário: Activated Substituir com Form event e o evento apropriado v12 After Substituir com Form event e o evento apropriado v12 Before Substituir com Form event e o evento apropriado v12 Deactivated Substituir com Form event e o evento apropriado v12 During Substituir com Form event e o evento apropriado v12 In break Substituir com Form event e o evento apropriado v12 In footer Substituir com Form event e o evento apropriado v12 In header Substituir com Form event e o evento apropriado v12 Outside call Substituir com Form event e o evento apropriado v12 Tema Gráficos: GRAPH (utilizando 4D Graph Area) GRAPH TABLE Utilize SVG picture em seu lugar v12 Cria os dados em arrays e chama GRAPH em uma imagem SVG v13 Desativado em 4D v14 Tema listas hierárquicas: REDRAW LIST Eliminar em código (não faz nada desde v11) v11 Tema Propriedades de objeto: DISABLE BUTTON/ENABLE BUTTON OBJECT SET ENABLED v12 Tema Imágenes: PICTURE TYPE LIST PICTURE CODEC LIST v12 QT COMPRESS PICTURE CONVERT PICTURE v12 QT COMPRESS PICTURE FILE WRITE PICTURE FILE/PICTURE TO BLOB v12 QT LOAD COMPRESS PICTURE FROM FILE READ PICTURE FILE/CONVERT PICTURE v12 SAVE PICTURE TO FILE WRITE PICTURE FILE v12 Tema Recursos: todos os comandos que escrevem/criam recursos, por exemplo: ARRAY TO STRING LIST - v12 Create resource file - v12 DELETE RESOURCE - v12 Get component resource ID - v12 SET PICTURE RESOURCE - v12 SET RESOURCE - v12 SET RESOURCE NAME - v12 SET RESOURCE PROPERTIES - v12 SET STRING RESOURCE - v12 SET TEXT RESOURCE - v12

7 Tema SQL: USE EXTERNAL DATABASE SQL LOGIN v12 USE INTERNAL DATABASE SQL LOGOUT v12 Tema Cadeia: Convert case CONVERT FROM TEXT / Converter ao texto se for necessário. v11 ISO to Mac Remover o comando do método se a conversão não é necessária v11 Mac to ISO (o que significa a base executa em modo Unicode ) v11 Mac to Win v11 Win to Mac v11 Tema Sub registros: todos os comandos Substituir nnn SUBRECORD e nnnsubselection com uma ação no registro N ou N-selection de N-table em uma N->1 relation v12 Tema Documentos do sistema: Document type - v12 Tema Ambiente sistema: Font name Utilize os identificadores de fonte v14 Font number QuickDraw está obsoleto, de maneira que os comandos Font number e Font name estão obsoletos. v14. O comando OBJECT SET FONT já não aceita um parâmetro LongInt para a fonte: este parâmetro agora é uma Cadeia e deve especificar o nome de fonte. Tema Interface de Usuário: Get platform interface/set PLATFORM INTERFACE HIDE TOOL BAR/SHOW TOOL BAR Tema servidor web: Pode ser utilizado para uma aplicação convertida; com a constante Automatic Platform - - _o_set CGI EXECUTABLE - v12 _o_set WEB DISPLAY LIMITS Utilize modo não contextual v12 _o_set WEB TIMEOUT Utilize modo não contextua v12 _o_web Context Utilize modo não contextua v12 Tema XML: _o_xslt APPLY TRANSFORMATION _o_xslt GET ERROR _o_xslt SET PARAMETER Utilize o módulo libxslt PHP ou o comando PROCESS 4D TAGS Utilize o módulo libxslt PHP ou o comando PROCESS 4D TAGS Utilize o módulo libxslt PHP ou o comando PROCESS 4D TAGS v12 v14r4 v14r4 v14r4 Desativado en 4D v14 Desativado em 4D v13 Desativado em 4D v13 Desativado em 4D v13 Desativado em 4D v13 R4 R4 R4 Comandos 4D PACK: (ver Comandos 4D Pack excluídos para mais detalhes) AP AVAILABLE MEMORY GET MEMORY STATISTICS - AP HELP INDEX AP HELP ON HELP AP HELP ON KEY AP CLOSE HELP Não compatível com Windows Vista. Não recomendamos utilizar este comando. Não compatível com Windows Vista. Não recomendamos utilizar este comando. Não compatível com Windows Vista. Não recomendamos utilizar este comando. Não compatível com Windows Vista. Não recomendamos utilizar este comando

8 AP Create method METHOD SET CODE e METHOD SET ATTRIBUTE - AP Modify method - AP Does method exist METHOD GET NAMES - AP Get picture type Comandos do tema "Imagens" - AP Get templates - _AP External clock Widget TimePicker - AP SET CLOCK Widget TimePicker - AP Rect Dragger SET DRAG ICON - en v14 AP Timestamp to GMT $mydate:=string(current date;iso Date GMT;Current time) // devolve por exemplo: " T12:19:23Z" - AP SET PARAM - AP GET PARAM -

9 _o_xslt APPLY TRANSFORMATION _o_xslt APPLY TRANSFORMATION ( fontexml ; folhaxsl ; resultado {; compilafolha} ) Parâmetro Tipo Descrição fontexml cadeia, Nome ou rota de acesso ou documento fonte do XML, ou BLOB que contém a fonte XML BLOB folhaxsl cadeia, Nome ou rota de acesso do documento que contém uma folha XSL, ou BLOB que contém o estilo XSL BLOB resultado cadeia, BLOB Nome da rota de acesso do documento que recebe o reusltado da transformação XSLT; ou BLOB que recebe o resultado da transformação XSLT compilafolha Booleano True = Otimiza a transformação XSLT; False ou omitido = Sem otimização, remove o arquivo compilado XSL (se houver) Nota de compatibilidade A partir de 4D v14 R4, os comandos de transformação XSL são obsoletos. Por razões de compatibilidade, ainda estão suportados em 4D mas lhe recomendamos que deixe de utilizar eles. Em futuras versões de 4D, já não será possível utilizar a tecnologia XSLT. Para obter mais informação, consulte a seção Introdução aos comandos de XML Utilities.

10 PROCESS 4D TAGS PROCESS 4D TAGS ( dadosentrada ; dadossaida {; param}{; param2 ;... ; paramn} ) Parâmetro Tipo Descrição dadosentrada Texto, BLOB Dados que contém as etiquetas HTML a processar dadossaida Texto, BLOB Dados processados param Texto, Number, Data, Hora, Ponteiro Parameter(s) passed to template being executed Descrição O comando PROCESS 4D TAGS provoca o processamento das etiquetas de transformação 4D contidas em dadosentrada (campo ou variável de tipo Texto ou BLOB) enquanto opcionalmente insere valores utilizando os valores via os parâmetros param e retorna os dados resultantes em dadossaida. Este comando permite executar um texto de tipo "template" que contém as etiquetas e as referências as expressões ou variáveis 4D e produz um resultado dependendo do contexto de execução e/ou dos valores passados em parâmetro. Por exemplo, pode utilizar este comando para gerar e guardar as páginas HTML baseadas em páginas semi-dinâmicas que contém as etiquetas de transformação 4D (sem que seja necessário que o servidor Web de 4D se inicie). Pode utilizar para enviar mensagens de em formato HTML que contenham processamentos e/ou referências aos dados contidos na base através de 4D Internet Commands. É possível processar qualquer tipo de dados baseados em texto, tais como XML, SVG ou texto multi-estilo. Passe os dados que contém as etiquetas a processar no parâmetro dadosentrada. Este parâmetro pode ser um campo ou uma variável de tipo Texto ou BLOB. O tipo Texto é geralmente suficiente (os parâmetros podem receber até 2 GB de texto). Nota de compatibilidade: A partir da versão 12 de 4D, quando utilizar parâmetros de tipo BLOB, o comando considera automaticamente que o conjunto de caracteres utilizado por os BLOBs é MacRomam. Para maior eficiência, se recomenda utilizar os parâmetros de tipo Texto para os quais os processos se realizam em modo Unicode. Todas as etiquetas de transformação de 4D são compatíveis (4DTEXT, 4DHTML, 4DSCRIPT, 4DLOOP, 4DEVAL, etc.),, Nota: Quando utilizar a etiqueta 4DINCLUDE fora do marco do servidor web (processo web): Com 4D em modo local ou 4D Server, a pasta por padrão é a pasta que contém o arquivo de estrutura do banco, Com 4D em modo remoto, a pasta por padrão é a pasta que contém a aplicação 4D. O comando PROCESS 4D TAGS suporta um número indefinido de parâmetros param que podem ser inseridos no código que se executa. Igualmente com os métodos projeto, tais parâmetros podem conter valores escalares de tipos variados (texto, data, hora, inteiro longo, real, etc). Também pode utilizar os arrays, por meio de ponteiros de arrays. Dentro do código processado pelas etiquetas 4D, estes parâmetros são acessíveis por meio de argumentos padrão ($1, $2, etc.), igual que nos métodos 4D (ver exemplo). Um conjunto dedicado de variáveis locais se define no contexto de execução do comando PROCESS 4D TAGS. Estas variáveis podem ser escritas ou lidas durante o processamento. Depois da execução do comando, o parâmetro dadossaida recebe os dados do parâmetro dadosentrada, junto com o resultado do processo das etiquetas HTML 4D que contém, quando aplicável. Se dadosentrada não contiver etiquetas HTML 4D, o conteúdo de dadossaida é idêntico ao de dadosentrada. O parâmetro dadossaida pode ser um campo ou uma variável, mas deve ser do mesmo tipo que o parâmetro dadosentrada. Nota: este comando já não chama ao On Web Authentication database method. Exemplo 1 Este exemplo carrega um documento de tipo 'template', processa as etiquetas que contiver e depois o guarda: C_BLOB($Blob_x) C_BLOB($blob_out) C_TEXT($inputText_t) C_TEXT($outputText_t) DOCUMENT TO BLOB("meutemplate.txt";$Blob_x) $inputtext_t:=blob to text($blob_x;utf8 text without length) PROCESS 4D TAGS($inputText_t;$outputText_t) TEXT TO BLOB($outputText_t;$blob_out;UTF8 text without length) BLOB TO DOCUMENT($document;$blob_out)

11 Exemplo 2 Este exemplo gera um texto utilizando os dados dos arrays: ARRAY TEXT($array;2) $array{1}:="hello" $array{2}:="world" $input:="<!--#4deval $1-->" $input:=$input+"<!--#4dloop $2-->" $input:=$input+"<!--#4deval $2->{$2->}--> " $input:=$input+"<!--#4dendloop-->" PROCESS 4D TAGS($input;$output;"elements = ";->$array) // $output = "elements = hello world"

12 COMPRESS PICTURE COMPRESS PICTURE ( imagem ; metodo ; qualidade ) Parâmetro Tipo Descrição imagem Imagem Imagem a ser comprimida Imagem comprimida metodo cadeia método de compressão de string de 4 caracteres qualidade Inteiro longo Qualidade de compressão ( ) Nota de compatibilidade Este comando chama mecanismos obsoletos e só se conserva por razões de compatibilidade. Foi substituído favoravelmente pelo comando CONVERT PICTURE. Descrição O comando COMPRESS PICTURE comprime a imagem que se encontra no campo ou variável imagem. O parâmetro método é uma cadeia de 4 caracteres que indica o tipo de compressão. Neste parâmetro deve passar uma das constantes do tema Compressão de imagem. O parâmetro qualidade é um inteiro entre 1 e indicando a qualidade da imagem comprimida. Em geral, reduzir a qualidade permite uma melhor compressão da imagem. Advertência: o raio de compressão possível para uma qualidade dada depende do tamanho e a natureza da imagem que estiver comprimindo. A compressão de imagens pequenas poderia não produzir uma redução do tamanho.

13 CONVERT PICTURE CONVERT PICTURE ( imagem ; codec {; compressao} ) Parâmetro Tipo Descrição imagem Imagem Imagem a ser convertida Imagem convertida codec cadeia Codec de identificação de Imagem compressao Real Qualidade da compressão Descrição O comando CONVERT PICTURE converte imagem em um novo tipo. O parâmetro codec indica o tipo de imagem a gerar. Um codec pode ser uma extensão (por exemplo,.gif ), um tipo Mime (por exemplo, image/jpeg ). Pode obter uma lista de codecs disponíveis utilizando o comando PICTURE CODEC LIST. Se o campo ou variável imagem é de tipo composto (se por exemplo for o resultado da ação copiar -pegar), só a informação correspondente ao tipo codec se conserva na imagem resultante. Nota: Se o tipo de codec solicitado é o mesmo que o tipo original da imagem, não se realiza nenhuna conversão e a imagem se devolve "tal qual" (exceto quando se utiliza o parâmetro compressao, ver a continuação). O parâmetro opcional compressao, se for passada, permite definir a qualidade de compressão a aplicar a imagem resultante quando se utiliza um Codec compatível. Em compressao, passe um valor entre 0 e 1 para especificar a qualidade da compressão, onde 0 é a qualidade mais medíocre (alta compressão) e 1 a melhor qualidade (compressão baixa). Este parâmetro só é considerado quando o codec for compatível com a compressão (por exemplo JPEG o HDPhoto) e for compatível com os APIs WIC e ImageIO. Portanto, não pode ser utilizado com Codecs administrados por QuickTime unicamente. Para maior informação sobre os APIs de gestão de imagem em 4D, consulte a seção Introdução a Imagens. Por padrão, se omitir o parâmetro compressao, se aplica a melhor qualidade (compressão =1). Exemplo 1 Conversão da imagem vpfoto ao formato jpeg: CONVERT PICTURE(vpFoto;".jpg") Exemplo 2 Conversão de uma imagem com qualidade de 60%: CONVERT PICTURE(vPicture;".JPG";0.6)

14 Open form window Open form window ( {tabela ;} nomeform {; tipo {; hpos {; vpos {; *}}}} ) -> Resultado Parâmetro Tipo Descrição tabela Tabela Tabela do formulário ou tabela padrão, se omitido nomeform cadeia Nome do formulário tipo Inteiro longo tipo de janela hpos Inteiro longo Posição horizontal da janela vpos Inteiro longo Posição vertical da janela * Operador Salvar posição atual e tamanho da janela Resultado WinRef Número de referência de janela Descrição O comando Open form window abre uma nova janela utilizando as propriedades de tamanho e de redimensionamentos do formulário nomform. Note que o formulário nomform não se mostra na janela. Se desejar mostrar o formulário, tem que chamar um comando que carregue um formulário (por exemplo ADD RECORD). Como padrão (se não for passado o parâmetro tipo), uma janela padrão é aberta com uma caixa de fechar. Diferente do comando Open window, nenhum método está associado a caixa de fechar da janela. Ao clicar nesta caixa, cancela e fecha a janela, exceto se o evento de formulário On Close Box tiver sido ativado para o formulário. Neste caso, o código associado com este evento será executado. Se o formulário nomform for redimensionar, a janela aberta terá uma caixa de zoom como também uma caixa de redimensionamento. Nota: para conhecer as principais propriedades de um formulário, utilize o comando GET FORM PROPERTIES. O parâmetro opcional tipo permite especificar um tipo de janela. Este parâmetro deve conter uma das seguintes constantes predefinidas do tema Abrir janela formulário): Constante Tipo Valor Form has full screen mode Mac Inteiro longo Modal form dialog box Inteiro longo 1 Movable form dialog box Inteiro longo 5 Palette form window Inteiro longo 1984 Plain form window Inteiro longo 8 Pop up form window Inteiro longo 32 Sheet form window Inteiro longo 33 Toolbar form window Inteiro longo 35 Notas: Os atributos da janela criada (caixa de redimensionamento, caixa fechar...) dependem das especificações de interface do sistema operativo para o tipo escolhido. Portanto é possível obter diferentes resultados dependendo da plataforma utilizada. As constantes Has toolbar button Mac OS e Has full screen mode Mac devem ser adicionados a uma das outras constantes de tipo. Para maior informação sobre os tipos de janelas, consulte a seção Tipos de Janelas. Note que apenas os tipos listados no tema Abrir janela formulário podem ser utilizados com o comando Open form window Quando passar a constante Toolbar form window, a janela é criada com a localização, o tamanho e as propriedades gráficas de uma barra de ferramentas, ou seja: A janela será mostrada sempre justo debaixo da barra de menus. O tamanho horizontal da janela será ajustada automaticamente para encher todo o espaço horizontal disponível no escritório (em OS X) ou dentro da janela principal de 4D (em Windows). O tamanho vertical da janela se baseia nas propriedades do formulário, como todos os outros tipos de janelas formulário. A janela não tem borde, não pode se mover e não pode mudar o tamanho de forma manual, e os parâmetros posh, posv e * se ignoram se estão presentes. Não é possível criar duas janelas da barra de ferramentas diferentes ao mesmo tempo. Se chamar Open form window com o tipo Toolbar form window enquanto já existe uma janela barra de ferramentas, é gerado um erro ("Não pode criar duas janelas formulário de tipo barra de ferramentas"). Barra de ferramentas e modo tela completa em OS X: se sua aplicação mostra ao mesmo tempo uma janela barra de ferramentas e uma janela estandarte que admitem o modo de tela completa (opção Has full screen mode Mac), as normas de interface requerem que se oculte a barra de ferramentas quando uma janela estandarte passe a modo tela completa. Para saber

15 se uma janela mudou ao modo tela completa, simplesmente prove se seu tamanho vertical é exatamente o mesmo que a altura da tela (consulte o comando HIDE TOOL BAR). O parâmetro opcional posh permite definir a posição horizontal da janela. Pode passar uma posição definida, expressada em pontos, a este parâmetro (consulte o comando Open window) ou uma das seguintes constantes predefinidas que ficam no tema Abrir janela formulário: Constante Tipo Valor Horizontally centered Inteiro longo On the left Inteiro longo On the right Inteiro longo O parâmetro opcional posv permite definir a posição vertical da janela. Pode passar uma posição definida, expressa em pontos, a este parâmetro (consulte o comando Open window) ou uma das seguintes constantes predefinidas do tema Abrir janela formulário: Constante Tipo Valor Vertically centered Inteiro longo At the top Inteiro longo At the bottom Inteiro longo Estes parâmetros levam em consideração a presença da barra de ferramentas, da barra de menus e também do tamanho atual da janela da aplicação (em Windows). Se passa o parâmetro opcional *, a posição e o tamanho atual da janela são memorizados ao fechar. Quando a janela é aberta novamente, sua posição e tamanho anterior são conservados. Neste caso, os parâmetros posv e PosH apenas são utilizados quando se abre a janela pela primeira vez. Exemplo 1 A seguinte instrução abre uma janela padrão ou uma caixa fechar e se ajusta automaticamente ao tamanho do formulário de "Entrada". Como o formulário foi definido como redimensionáveis, a janela tem uma caixa de redimensionamento e uma caixa de zoom: $winref :=Open form window([tabela1];"entrada") Exemplo 2 A instrução abre una palheta flutuante na parte superior esquerda da tela baseada em um formulário de projeto chamado "Ferramentas". Esta palheta utiliza a última posição em cada nova abertura: $winref :=Open form window("ferramentas";palette form window;on the left;at the top;*)

16 CREATE SUBRECORD CREATE SUBRECORD ( subtabela ) Parâmetro Tipo Descrição subtabela Subtabela Subtabela para a qual vai criar novo subregistro Nota de compatibilidade As subtabelas não são compatíveis a partir da versão 11 de 4D. Um mecanismo de compatibilidade garante o funcionamento deste comando em bancos compartilhados; entretanto, é recomendável substituir as subtabelas com tabelas relacionadas padrão. Descrição CREATE SUBRECORD cria um novo subregistro em subtabela e o converte no subregistro atual. O novo subregistro é guardado apenas quando o registro pai for guardado. O registro pai pode ser guardado com um comando como SAVE RECORD ou quando o usuário confirma o registro. Se não houver registro atual, CREATE SUBRECORD não tem efeito. Para adicionar um novo subregistro em um formulário de entrada de subregistros, utilize ADD SUBRECORD. Exemplo O seguinte exemplo é um método de objeto para um botão. Quando for executado (quando o usuário clicar no botão), cria novos subregistros para crianças na tabela [Pessoas]. O loop Repeat permite ao usuário adicionar crianças até que se clique no botão Cancelar. O formulário mostra as crianças em um subformulário, mas não permite a entrada direta de dados porque a opção Editável não foi desativada: Repeat ` É repetido até que o usuário clique em cancelar vcriança:=request("nome (cancelar quando terminar):") `Se o usuário clicar em Aceitar If(OK=1) ` Adição de um novo subregistro para uma criança CREATE SUBRECORD([Pessoas]Crianças) ` Atribuição do nome da criança ao subcampo [Pessoas]NomeCriança:=vCriança End if Until(OK=0)

17 Quick table Explicação dos valores para a coluna Estado : : já não está disponível na versão atual. Em breve: estamos pensando na eliminação da funcionalidade na próxima versão principal depois de 4D v14 Mais a frente: será eliminada em uma versão futura principal OS: depende de tecnologias OS oficialmente obsoletas (por exemplo: formato PICT). Estado é o mesmo que mais tarde, mas um sistema operativo poderia retirar o suporte antes que nós Funcionalidade Substituir com Estado Barra de ferramentas automática do modo Aplicação Open form window com Toolbar form window Opção de compatibilidade "Transações automáticas durante a entrada de dados" Dicionários ortográficos Cordial n/a Dicionários Hunspell (assim como o dicionário nativo sob Mac) Janelas em modo não compositing sob Mac Só o modo compositing está suportado "Option F/Alt F" Menu com elemento associado a ação estandarte "Voltar ao modo Desenho" OU OPCAO-MAIÚS CLIQUE DIREITO 4D Chart SVG/Web area/php Fontes Mac OS QuickDraw Nomes de fontes Altura Mac2Win Atribuição dinâmica das variáveis recebidas através de HTTP (opção de compatibilidade para as bases criadas antes da versão 13.4) Desenvolvedores de Plug-in: utilize o código Windows nativo Comando WEB GET VARIABLES (para recuperar variáveis). Comandos WEB GET BODY PART/WEB Get body part count (para recuperar arquivos enviados) Modo No Unicode (base pre-v11 convertida) Passar a Unicode Suporte de QuickTime (opção de compatibilidade utilizando SET DATABASE PARAMETER(QuickTimeSupport;1)) API QuickDraw Utilize os formatos nativos Novo plug-in SDK para os plug-ins de terceiras partes Subtabelas Utilize as tabelas N->1 XSLT Utilize o módulo libxslt PHP ou o comando PROCESS 4D TAGS Mac Resources (cicn, PICT) Utiliza a pasta "Resources" OS Por compatibilidade, ainda pode utilizar ele em bases convertidas. Já não suportamos comandos de acesso a escritura. PICT Formatos modernos OS

18 Previous documents This document concerns the 4D v14 product range. For reference, you can consult previous documents (PDF) describing deprecated features in prior product ranges, available here: Deprecated and Removed Features in 4D v13 - (Rev. 20 Feb 2012) Deprecated and Removed Features in 4D v12 - (Rev. 03 Jun 2010)