Índice:

Introdução:

          As Planilhas RM suportam o uso de Stored Procedure, ou Procedimento Armazenado. Neste documento estão descritos os passos para sua criação.

      Exemplo de Procedure a ser utilizada na Planilha RM

         Foi criada a procedure abaixo, como exemplo. Veja as funções que são executadas por ela:

CREATE PROCEDURE DBO.XATUALIZA_SALARIO (@PLN_Sheet1_$A1_S CHAR) AS
BEGIN
       /* VERIFICA SE A TABELA XSALARIO  JÁ EXISTE, E DROPA */
      IF EXISTS
            ( SELECT     TOP 1 1
            FROM  SYSOBJECTS
            WHERE SYSOBJECTS.XTYPE = 'U'
            AND         SYSOBJECTS.NAME = 'XSALARIO')
      BEGIN
            DROP TABLE XSALARIO
      END

      /* CRIAÇÃO DA TABELA XSALARIO */
      CREATE TABLE XSALARIO (
            CHAPA       VARCHAR(10),
            NOME        VARCHAR(100),
            SAL_ANTIGO  FLOAT,
            SAL_ATUAL   FLOAT
      )

                         /* DADOS PARA PREENCHER A TABELA XSALARIO */
                         INSERT INTO XSALARIO
                         SELECT      CHAPA, NOME, SALARIO AS SAL_ANTIGO, (SALARIO * 1.10) AS SAL_ATUAL
                         FROM  PFUNC
                         WHERE CODSITUACAO <> @PLN_Sheet1_$A1_S

      /* !!! LEMBRE-SE !!! */
      /* É NECESSÁRIO UTILIZAR UM COMPONENTE SQL NA PLANILHA RETORNANDO OS DADOS DA TABELA PREENCHIDA PELA PROCEDURE */

                         SELECT * FROM XSALARIO

END

Lembre-se que na criação de Stored Procedure, a nomenclatura para o parâmetro em SQL é "@" e Oracle é "I", de Inglês.

Exemplo:

          Após criar a Stored Procedure, temos que cadastrar no sistema RM a sentença SQL que retornará os dados desta Procedure. Para isso, cadastramos a Consulta

SQL com o Código 'Teste_Procedure'.

          Para realizar o cadastro, acesse o menu 'Gestão | Visões de Dados' e clique no botão Incluir (Ctrl + Ins). Veja a imagem a seguir:

Após a criação da Sentença SQL no sistema, vamos criar a planilha RM.

Acesse o menu 'Gestão > Planilha Net' e clique no botão Incluir (Ctrl + Ins). Em seguida, preencha os campos como ilustrado na imagem abaixo: 

 Após criar a planilha, clique duas vezes sobre ela e será apresentada a sua tela de edição.

 Agora, vamos associar a sentença SQL e a procedure na planilha. Selecione a célula da planilha que executará a Consulta SQL e/ou a Procedure.

Em seguida, acesse o menu 'Planilha | Visões de Dados | Associar Consulta SQL à Célula'. 

Selecione a Consulta SQL e a Stored Procedure criadas nos passos anteriores a serem associadas à Planilha RM. 

Em seguida, clique no botão 'OK'.

Ao observar a planilha será possível visualizar o resultado, como na figura a seguir:

Como mostrado na Procedure, temos a passagem de parâmetros que corresponde a Célula “A1” da planilha. Assim, ao alterar o valor dessa célula para  “A” (Ativos),  e Reexecutar a Consulta SQL, o resultado será atualizado.

Veja as imagens abaixo:

CREATE PROCEDURE DBO.XATUALIZA_SALARIO (@PLN_Sheet1_$A1_S CHAR) AS 

BEGIN 

       /* VERIFICA SE A TABELA XSALARIO  JÁ EXISTE, E DROPA */ 

      IF EXISTS

            ( SELECT     TOP 1 1 

            FROM  SYSOBJECTS 

            WHERE SYSOBJECTS.XTYPE = 'U'

            AND         SYSOBJECTS.NAME = 'XSALARIO')

      BEGIN 

            DROP TABLE XSALARIO

      END 

      /* CRIAÇÃO DA TABELA XSALARIO */ 

      CREATE TABLE XSALARIO (

            CHAPA       VARCHAR(10),

            NOME        VARCHAR(100),

            SAL_ANTIGO  FLOAT,

            SAL_ATUAL   FLOAT 

      )

      /* DADOS PARA PREENCHER A TABELA XSALARIO */ 

      INSERT INTO XSALARIO

      SELECT      CHAPA, NOME, SALARIO AS SAL_ANTIGO, (SALARIO * 1.10) AS SAL_ATUAL

      FROM  PFUNC

      WHERE CODSITUACAO <> @PLN_Sheet1_$A1_S

      /* !!! LEMBRE-SE !!! */ 

      /* É NECESSÁRIO UTILIZAR UM COMPONENTE SQL NA PLANILHA RETORNANDO OS DADOS DA TABELA PREENCHIDA PELA PROCEDURE */ 

      SELECT * FROM XSALARIO

END 

CREATE PROCEDURE DBO.XATUALIZA_SALARIO (@PLN_Sheet1_$A1_S CHAR) AS 

BEGIN 

       /* VERIFICA SE A TABELA XSALARIO  JÁ EXISTE, E DROPA */ 

      IF EXISTS

            ( SELECT     TOP 1 1 

            FROM  SYSOBJECTS 

            WHERE SYSOBJECTS.XTYPE = 'U'

            AND         SYSOBJECTS.NAME = 'XSALARIO')

      BEGIN 

            DROP TABLE XSALARIO

      END