P08 - Integração Word Excel

INTEGRAÇÃO OFFICE WORD E EXCEL
MICROSIGA Software S/A

Av. Braz Leme, 1399/1631
02511-000 - São Paulo - Brasil
Telefone (011) 3981-7000
http://www.microsiga.com.br
Copyright © MICROSIGA Software S/A

Todos os direitos reservados e protegidos pela Lei de Direitos Autorais nº. 9.610 de 19/02/1.998.
Nenhuma parte deste documento pode ser reproduzida, publicada ou transmitida por impressão, fotocópia, microfilme, fita de
áudio, eletronicamente, mecanicamente, ou qualquer outro meio, ou armazenado em um sistema de informação recuperado, sem
a permissão prévia, por escrito do proprietário destes direitos.
Em função do contínuo desenvolvimento dos produtos da MICROSIGA Software S/A, este documento está sujeito a modificações
que serão atualizadas nas subseqüentes revisões de novas versões. Portanto, toda informação contida neste documento é de
natureza geral e nunca poderá ser utilizada em qualquer obrigação contratual.
Elaboração:
MICROSIGA Educação Corporativa
Apoio e Revisão:
Auditoria de Cursos MICROSIGA

Sumário
INTEGRAÇÃO OFFICE WORD E EXCEL ......................................................................................................1
INTRODUÇÃO ........................................................................................................................................5
VISÃO GERAL DO CURSO ......................................................................................................................5
Objetivos do Curso ..................................................... 5
Metodologia do Curso .................................................. 6
INSTALAÇÃO DA BIBLIOTECA DO PROTHEUS COM O OFFICE EXCEL ...........................................7

O que você irá aprender neste capítulo ...................................... 7
Rotinas Abordadas ..................................................... 7
Instalação da Biblioteca ApExcel80.xla ...................................... 8
Instrução de Uso das Funções ............................................ 10
Modo Interativo .................................................... 11
Modo Avançado ................................................... 11
O que você aprendeu neste capítulo ....................................... 12
Próximo Passo ....................................................... 12
FUNÇÕES DE INTEGRAÇÃO COM O OFFICE EXCEL ...................................................................................13

O que você irá aprender neste capítulo ..................................... 13
Rotinas Abordadas .................................................... 13
Funções Genéricas ................................................... 14
xFilial ........................................................... 14
Posicione ........................................................ 15
Somar .......................................................... 18
Contar .......................................................... 22
Siga ............................................................ 24
MsGetArray ...................................................... 26
Funções Financeiras .................................................. 27
SldBco .......................................................... 27
SldReceber ....................................................... 28
SldPagar ......................................................... 30
SldCliente ........................................................ 31
SldFornece ....................................................... 33
FinNatPrv ........................................................ 34
FinNatRea ....................................................... 36
FinNatOrc ....................................................... 37
RecMoeda ....................................................... 38
ConvMoeda ...................................................... 39
XMoeda ......................................................... 40
Funções CTB - Contabilidade Gerencial
SaldoConta............................................................................................................................41
SaldoCcus..............................................................................................................................43
SaldoItem..............................................................................................................................45
SaldoClass.............................................................................................................................47
MovConta..............................................................................................................................49
MovCusto..............................................................................................................................51
MovItem................................................................................................................................
53
CtsmConta.............................................................................................................................55
CtsmCusto.............................................................................................................................57
CtsmItem...............................................................................................................................59
CtsmClvl................................................................................................................................60

Próximo Passo ....................................................... 63
INTEGRAÇÃO COM O OFFICE WORD ......................................................................................................64

O que você irá aprender neste capítulo ..................................... 64
Rotinas Abordadas .................................................... 64
Identificação das Variáveis ............................................. 65
Elaboração de Documentos ............................................. 66
Emissão de Documentos ................................................ 68
Próximo Passo ....................................................... 69
Anotações:
INTRODUÇÃO
VISÃO GERAL DO CURSO
Este Curso foi elaborado para capacitar os usuários do ERP MICROSIGA, a se

familiarizarem com o sistema em sua forma padrão de operação na Integração com
Microsoft Office Word e Excel, e os meios de Extração de Informações do Protheus.
Objetivos do Curso
Ao término deste curso, o aluno deverá estar habilitado a:

• Realizar a Integração com o Microsoft Office Excel;
• Realizar a Integração com o Microsoft Office Word (Apenas com o Módulo de Gestão de Pesso-
al).
Anotações:
Metodologia do Curso
O curso de Integração com Office Word e Excel é ministrado com um Kit de

Treinamento composto por:
• Apostila:
Aborda as rotinas de Integração com o Office Word e Excel, conduzindo o aluno na sua
utilização, através de uma série de exercícios para prática e revisão da matéria. Os exercícios
devem ser executados, junto ao Sistema, exatamente da forma como estão apresentados, para
que o grau de aprendizado proposto seja obtido;
A cada capítulo, o aluno é posicionado sobre o conteúdo fornecido e os assuntos complemen-
tares que serão expostos.
• Manual Eletrônico:
Para verificar o Manual Eletrônico do Usuário de Integração com o Office Word e Excel,
posicione no Menu Principal do Módulo e tecle <F1> .
• Materiais de Apoio:
Pasta, Bloco de Anotações e Caneta.
O aluno deve acompanhar este curso nas instalações da MICROSIGA, Franquias ou em sua Empre-
sa, com o direcionamento de um instrutor que conduzirá as sessões de treinamento de modo que os
objetivos propostos sejam atingidos.
Anotações:
INSTALAÇÃO DA BIBLIOTECA DO
PROTHEUS COM O
OFFICE EXCEL
Na verdade não há uma instalação da Integração do Protheus com o Office.

Ao instalar o Protheus em qualquer computador além dos arquivos, para funciona-
mento do ERP também será instalada uma Biblioteca, ApExcel80.xla, que contém as
funções de Integração entre o Protheus e o Office Excel.
No caso da integração com o Office Word não existe sequer uma Biblioteca de Funções, basta que
se tenha acesso ao Módulo de Gestão de Pessoal, para se ter acesso a Integração
do Protheus com o Office Word.
Na maioria dos casos não é realizada a Instalação do Protheus em todas os
computadores de uma empresa, geralmente somente no servidor, portanto para que
cada um desses computadores faça uso da integração entre o Protheus e o Office
Excel, sem ter que instalar em todos computadores, é necessário instalar somente
a Biblioteca que contém as Funções de Integração.
O que você irá aprender neste capítulo
Neste capítulo veremos a Instalação e a Utilização da Biblioteca de Funções do

Protheus, para o Office Excel e as Instruções, para utilização das suas Funções.
Rotinas Abordadas
• Instalação da Biblioteca ApExcel80.xla;
Anotações:
• Instrução de Uso das Funções.
Anotações:
Instalação da Biblioteca ApExcel80.xla
Exercício 01 – Como instalar a Biblioteca de Funções do Protheus no Office

Excel:
1. Acesse o “Office Excel”;
2. Selecione as seguintes opções “Ferramentas” + “Suplementos”;
3. Clique na opção “Procurar”;
4. Selecione o arquivo “C:\AP8\DOT\ApExcel80.xla”;
Obs.:
Lembre-se o “Caminho”. sugerido acima é somente um exemplo, deve-se uti-

lizar o caminho de acordo com a “Instalação Realizada”.
5. Confirme a “Seleção”, clicando na opção “OK”;
6. Confira os dados e confirme a “Inclusão da Biblioteca”, clicando na opção “OK”;
Obs.:
• Note que foi inserida uma nova “Barra de Botões”, com três opções, os quais estudare-
mos a seguir.
Recálculo do Protheus – Esta opção tem a função de atualizar na

Planilha do Office Excel, os valores que são atualizados no Protheus, pois
Anotações:
por exemplo, enquanto está sendo gerado “Títulos a Pagar” e a “Receber”,
no Protheus a Planilha do Office Excel, pode muito bem estar estática, ou
seja, é necessário que seja clicado na opção acima mencionada, para que o
valor seja atualizado no Office Excel também, ou então que a Planilha seja
fechada e aberta novamente;
Altera os Links da Planilha – Esta opção ao ser clicada, atualiza os

vínculos com a Biblioteca ApExcel80.xla, caso ela tenha sido desatualizada
num processo de Cópia da Planilha ou da Biblioteca;
Informações sobre a Conexão com o Protheus – Ao ser clicada esta opção,

abre uma janela, com informações da conexão como: Environment, Empresa/
Filial, Tipo do Servidor, etc, usados no momento;
• Através desta opção também é possível gravar um Histórico com as

Últimas Funções utilizadas e o Resultado das mesmas, este Histórico pode
ser gravado em um Arquivo caso queira;
• Além das opções que acompanham a Biblioteca, há também as Funções que

foram anexadas as já existentes, mas em uma nova Categoria, a Definida
pelo Usuário, as quais veremos adiante.
Anotações:
Instrução de Uso das Funções
Antes de prosseguirmos com o curso é necessário que seja estabelecida a conexão

do Protheus com o Office Excel.
Para tanto basta acessar qualquer módulo do Protheus, a maioria deles segue este
padrão, selecionar as seguintes opções “Miscelânea” + “Planilha Excel” e clicar
na opção .
O Office Excel será aberto automaticamente, bastará começar a digitar as Funções ou abrir uma
Planilha existente.
Atenção, a Conexão somente funcionará se seguida as instruções citadas.
Além das Funções que a Biblioteca contém, é possível com o uso de uma função auxiliar, Fun-
ção SIGA, o uso de funções criadas no Protheus, respeitando algumas restrições:
• Não podem ser utilizadas Entrada de Dados;
• A Função deve obrigatoriamente retornar um Valor;
• É recomendável a utilização de Funções Pequenas, para evitar a perda da
conexão do Protheus com o Office Excel.
O Office Excel utiliza um padrão de Data, diferente do Protheus, por esse
motivo qualquer Função do Protheus utilizada no Office Excel, que utilize data
como Parâmetro ou retorne uma Data, deve obedecer as regras a seguir:
• Formatar a Célula como Data, para as Funções que retornem Data;
• Ao informar uma Data, como Parâmetro, fazê-lo no formato Texto.
Há funções que exigem Parâmetros Lógicos (Verdadeiro ou Falso), estes Parâmetros devem obede-
cer ao padrão de idioma do Office Excel, ou seja, se o Office Excel estiver no Idioma Português use
(Verdadeiro ou Falso), se Inglês use (True ou False).
Se ao inserir uma Função e o Office Excel retornar o erro #VALOR, ou a mensagem: As Funções
Anotações:
do SIGA Advanced, não constam na Lista de Funções definidas pelo usuário,
verifique os seguintes tópicos para solucionar:
• Tenha certeza de que o Office Excel foi iniciado a partir do Protheus;
• Verifique se foi instalada a Biblioteca de Integração;
• Verique se a Função está digitada corretamente.
Anotações:
Modo Interativo
Este procedimento é recomendado para usuários menos experientes, pois o Microsoft

Office Excel abre uma janela assistente para que sejam informados os Parâmetros,
facilitando o uso de referência a outras Células.
• No Office Excel, clique na Célula que deve receber o resultado da Função
Protheus e selecione as seguintes opções “Inserir” + “Função”, ou clique
na opção ;
• No Lado Esquerdo da janela são relacionadas as Categorias de Funções,
disponíveis;
• Selecione a Categoria de Funções– Definida pelo usuário;
• Na Caixa de Listagem – Nome da Função, selecione a Função, que será
utilizada;
• O sistema apresentará uma Janela Assistente, onde deverão ser informados os
Parâmetros da Função, conforme solicitado e definido pela sua Sintaxe;
• Informe os Parâmetros da Função e clique na opção “OK”, para finalizar.
Modo Avançado
Outra forma de se utilizar as funções do Protheus, é digitando a função, diretamente na célula.

Esta forma não conta com o assistente, portanto, o usuário deve conhecer a Sintaxe da Função
para digitar corretamente seus Parâmetros (Recomendado para usuários mais experientes).
Anotações:
O que você aprendeu neste capítulo
Neste capítulo, você aprendeu a Instalar a Biblioteca ApExcel80.xla, viu também

as suas opções e qual a Função de cada uma delas.
Aprendeu também que há dois modos de Utilização das Fórmulas.
Próximo Passo
Com a Instalação realizada e conhecendo como devem ser Utilizadas as Funções veremos o Fun-
cionamento e Exercitaremos cada uma delas.
Anotações:
FUNÇÕES DE INTEGRAÇÃO COM O
OFFICE EXCEL
Para termos Exemplos Genéricos, de fácil entendimento dos usuários, as Sintaxes, foram escritas de
uma Forma Genérica.
Como exemplo usamos a Sintaxe a seguir:
“=nomedafunção(ParC1; ParC2; ParD1; ParL1; ParN1)”, onde:
• O “Primeiro Parâmetro – ParC1”, se refere a um parâmetro do “Tipo – Caracter” e deve ser
digitado sempre entre aspas;
• O “Segundo Parâmetro – ParC2”, tem a mesma característica do primeiro, somente leva o
“Número Dois”, para diferenciar um do outro;
• O “Terceiro Parâmetro – ParD1”, se refere a uma “Data” e deve ser digitado sempre entre
aspas;
• O “Quarto Parâmetro – ParL1”, é do “Tipo – Lógico”, ou seja, “Verdadeiro ou Falso”;
• E o “Quinto Parâmetro – ParN1”, é do “Tipo – Numérico”.
Neste capítulo veremos e exercitaremos cada uma das Funções existente na Integração
do Protheus com o Office Excel.
Rotinas Abordadas
• Funções Genéricas;
• Funções Financeiras;
• Funções Contábeis.
Anotações:
Funções Genéricas
As Funções Genéricas, se caracterizam por poderem extrair dados de quaisquer
módulos.
Estas Funções, requerem muitas vezes, um conhecimento mínimo das Tabelas e Campos
do Protheus.
xFilial
Retorna o Código da Filial, que estamos Conectados atualmente.

Pode ser que retorne “ ”, caso o arquivo que estamos pesquisando seja Compartilhado.
Sintaxe:
xFilial(ParC1),
Onde:
• ParC1 – Alias do Arquivo;
Exercício 02 – Como utilizar a Função xFilial com a ajuda do Assistente de Funções:

1. Com o “Office Excel”, a partir do “Protheus”, já acessado;
2. Abra o “Arquivo – Exerpro.xls”;
3. Selecione a “Pasta – Genéricas”;
4. Selecione a “Célula – B3”;
5. Clique na opção ou no Menu “Inserir” + “Função”;
6. Selecione a “Categoria – Definida pelo Usuário”;
7. Selecione a “Função – xFilial” e confirme;
8. No “Campo – Alias”, informe “SA1” e confirme.
Dica:
Preferencialmente, utilize sempre “Letras Maiúsculas”.
Entendendo a Função:
xFilial(“SA1”),
Onde:
• “SA1” – É a “Tabela”, que desejamos pesquisar;
Obs.:
Este Exemplo, retornará a “Filial da Tabela – SA1”.
Anotações:
Posicione
Retorna o Conteúdo somente um Campo de um Registro, conforme parâmetros informa-

dos.
Sintaxe:
Posicione(ParC1; ParN1; ParC2; ParC3),
Onde:
• ParC1 – Alias do arquivo;
• ParN1 – Ordem Utilizada, baseado no Sindex;
• ParC2 – Chave de Pesquisa;
• ParC3 – Campo.
Exercício 03 – Como utilizar a Função Posicione com a ajuda do Assistente de Funções:

1. Selecione a “Célula – B7”;
2. Clique na opção ou no Menu “Inserir” + “Função”;
3. Selecione a “Categoria – Definida pelo Usuário”;
4. Selecione a “Função – Posicione”, confirme e informe os dados a seguir:
Alias: SA1
Ordem: 1
Chave: XFILIAL("SA1")&"000001"
Campo: "A1_NOME"
Obs.:
• Note que conforme você vai digitando no “Assistente”, automaticamente o “Assisten-

te”, vai colocando as “Aspas”, nos campos caracteres e na “Célula”, vai separando os
Parâmetros com “;”;
• Outro detalhe, é que antes mesmo de confirmar a “Função”, quando correta, o “Valor”,
já será exibido.
5. Confira os dados e confirme a “Digitação”.
Posicione(“SA1”;1;xFilial(“SA1”)&”000001”;“A1_NOME”),
Onde:
• “SA1” – Automaticamente é a “Tabela” que desejamos pesquisar;
Anotações:
• “1” – É o “Índice”, pelo qual desejamos pesquisar, nesta caso estamos
usando o índice “Filial + CódigoCliente”;
• xFilial(“SA1”)&”000001” – É um “Parâmetro Composto”, da função

“xFilial”, mais o “Código do Cliente”;
• “A1_NOME” – É o “Nome do Campo” que terá seu “Conteúdo” retornado.

Este exemplo, retorna o “Nome do Cliente” de “Código – 000001”, da “Filial
Ativa”, no momento.
Exercício 04 – Como utilizar a Função Posicione no Modo Avançado:

1. Selecione a “Célula – B11” e informe os dados a seguir:
“=Posicione(“SA1”;1;xFilial(“SA1”) & ”000002”;“A1_END”)”;
Posicione(“SA1”,1,xFilial(”SA1”) & ”000002”,“A1_END”),
Onde:
• “1” – É o “Índice”, pelo qual desejamos pesquisar, nesta caso estamos usando o índice
“Filial + CódigoCliente”;
• “01” – É a “Primeira Parte” do “Parâmetro”, que neste caso é o “Código da Filial” que
desejamos pesquisar;
• “&” – É uma maneira rápida de concatenar dois ou mais caracteres quaisquer;
• ”000002” – É a “Segunda Parte” do “Parâmetro Composto”, que neste caso é o “Código

do Cliente”;
• A1_END – É o “Nome do Campo”, que terá seu “Conteúdo”, retornado.
Obs.:
Este Exemplo, retorna o “Nome do Cliente” de “Código – 000002”, da “Filial – 01”,
Anotações:
exclusivamente.
Exercício 05 – Como utililizar a Função Posicione com Referência Relativa:

1. Na "Célula – B16”, informe “1”;
2. Na “Célula – C16”, informe “2”;
3. Na "Célula – D16”, informe os dados a seguir:
“=Posicione("SA2";1;TEXTO(B16;"00")&TEXTO(C16;"000000");"A2_NOME")”;
4. Copie o conteúdo das “Células – B16 e D16”, para a “Linha – 17”;
5. Altere o conteúdo da “Célula – C17”, para “3”;
Posicione("SA2";1;TEXTO(B16;"00")&TEXTO(C16;"000000");"A2_NOME")
Onde:
• “1” – É o “Índice”, pelo qual desejamos pesquisar, nesta caso estamos usando o índice
“Filial + CódigoFornecedor”;
• “TEXTO(B16;"00")” – Onde deveria ser digitada a “Filial”, usamos uma “Função – Tex-
to”, que converte o conteúdo da “Célula – B16”, em “Texto”, com “Dois Algarismos”;
• “&” – É uma maneira rápida de “Concatenar” dois ou mais caracteres quaisquer;
• “TEXTO(C16;"000000")” – Onde deveria ser digitado o “Código do Fornecedor”, usa-

mos uma “Função – Texto”, que converte o conteúdo da “Célula – C16”, em “Texto”, com
“Seis Algarismos”;
• “A2_NOME” – É o “Nome do Campo”, que será seu “Conteúdo”, retornado.
Obs.:
Este Exemplo, retorna o “Nome do Fornecedor”, cujo “Código e Filial”, foram digitados
nas “Células Vinculadas”.
Exercício 06 – Como exercitar a Função Posicione:
Anotações:
1. Usando as variações possíveis da “Função– Posicione”, obtenha a
“Descrição” e o “Débito de Outubro”, das contas sugeridas;
2. Sabendo-se que a “Tabela de Contas”, é a “SI1”;
3. Lembre-se de usar a “Função – xFilial”, pois, poderá haver a necessi-
dade de usar com qualquer “Filial”.
Anotações:
Somar
Retorna a Somatória de um Campo de uma Tabela, baseada nas condições informadas.

Sintaxe:
Somar(ParC1; ParC2; ParC3),
Onde:
• “ParC1” – Alias do arquivo;
• “ParC2” – Condição para soma;
• “ParC3” – Campo a ser somado.
Exercício 07 – Como utilizar a Função Somar no Modo Avançado:

1. Na "Célula – B31”, informe os dados a seguir:
“=Somar("SE1";"E1_CLIENTE=='000001'";"E1_VALOR")”;
2. Confira os dados e confirme a “Digitação”;
Somar("SE1";"E1_CLIENTE=='000001'";"E1_VALOR"),
Onde:
• "SE1" – É a “Tabela”, que desejamos pesquisar;
• "E1_CLIENTE=='000001'" – É o “Campo”, em que será aplicada a “Condição”, neste

caso “==” quer dizer, “Exatamente igual”;
• “‘000001’” – É a “Condição”, ou seja o “Código do Cliente”, que será pesquisado;
• "E1_VALOR" – É o “Nome do Campo”, que será calculado.
Obs.:
Anotações:
A Função, retornará a “Soma do Valor a Receber”, do “Cliente – 000001”.
Exercício 08 – Como utilizar a Função Somar Composta:

1. Na "Célula –B35”, informe os dados a seguir:
“=Somar("SE2";"E2_VALOR > 200 .AND. E2_TIPO <> 'FT'";"E2_VALOR")”;
2. Confira os dados e confirme a “Digitação”;
Somar("SE2";"E2_VALOR > 200 .AND. E2_TIPO <> 'FT'";"E2_VALOR"),
Onde:
• "SE2" – É a “Tabela”, que desejamos pesquisar;
• "E2_VALOR > 200" – É a “Primeira Condição”, que filtrará somente os “Valores Maiores
que 200”, do “Campo – E2_VALOR”;
• “.AND.” – É o “Operador” de “E”, originado do ADVPL, permite que sejam digitadas

mais de uma “Condição”;
• “E2_TIPO <> 'FT'" – É a “Segunda Condição”, filtrará somente os tipos diferentes de

“FT”, do “Campo – E2_TIPO”, e deve ser digitado entre ‘ ‘, pois, se trata de um “Texto”;
• "E2_VALOR" – É o “Nome do Campo”, a ser calculado.
Obs.:
• A Função, retornará a “Soma do Valor a Pagar dos Títulos”, que tenham “Valor Maior
que 200,00” e que sejam do “Tipo – FT”;
• Além do operador “AND”, também é possível usar o “OR”.
Exercício 09 – Como utilizar a Função Somar com Datas:

1. Na "Célula –B40”, informe:
“20/08/2001”, ou formate a célula como “Texto”;
2. Na "Célula –C40”, informe os dados a seguir:
Anotações:
“=Somar("SD2";"D2_EMISSAO>=CTOD('"&B40&"')";"D2_TOTAL")”;
Somar("SD2";"D2_EMISSAO>=CTOD('"&B40&"')";"D2_TOTAL"),
Onde:
• "SD2" – É a “Tabela”, que desejamos pesquisar;
• "D2_EMISSAO>=CTOD('"&B40&"')" – A “Condição”, filtrará todas as NFs

emitidas após a data vinculada na “Célula – B40”;
• A “Função – CTOD”, converte a “String da Célula em Data”, para o

Protheus;
• "D2_TOTAL" – É o “Nome do Campo”, a ser calculado.
Obs.:
Esta Função, retornará a “Soma do Campo – Total”, de todas a “NFs emitidas”, após “19/
08/2001”.
Exercício 10 – Como utilizar a Função Somar composta por Períodos:

1. Na “Célula – B45”, informe “1”;
2. Na “Célula – C45”, informe “29/06/2001”;
3. Na “Célula – D45”, informe “30/10/2001”
Anotações:
4. Na “Célula – E40”, informe os dados a seguir:
“=Somar("SF2";"F2_CLIENTE=='"&TEXTO(B45;"000000")&"' .and.
F2_EMISSAO>=CTOD('"&TEXTO(C45;"DD/MM/AA")&"').AND.
F2_EMISSAO<=CTOD('"&TEXTO(D45;"DD/MM/AA")&"')";"F2_VALFAT")”;
Somar("SF2";"F2_CLIENTE=='"&TEXTO(B45;"000000")&"'.and.F2_EMISSAO>=CTOD
('"&TEXTO(C45;"DD/MM/AA")&"').AND.F2_EMISSAO<=CTOD('"&TEXTO(D45;"DD/MM/
AA")&"')";"F2_VALFAT"),
Onde:
• “SF2” – É a “Tabela”, que desejamos pesquisar;
• “F2_CLIENTE=='"&TEXTO(B45;"000000")&"'” – A “Primeira Condição”, restringe o “Cli-

ente a ser Pesquisado”, transforma o conteúdo da “Célula – B45”, em “Texto”, preenchen-
do com o “Número de Caracteres”, necessários para realizar a “Pesquisa”;
• "F2_EMISSAO>=CTOD('"&TEXTO(C45;"DD/MM/AA")&"')" – A “Segunda Condição”,

indica a “Data Inicial”, para o “Filtro”, vinculada a “Célula – C45”;
• A Função “Texto”, converte a “Data da Célula”, em “Texto”, para então a “Função –

CTOD”, convertê-la em “Data”, para o Protheus;
• "F2_EMISSAO<=CTOD('"&TEXTO(D45;"DD/MM/AA")&"')" – Já a “Terceira Condição”,

indica a “Data Final”, para o “Filtro”, vinculada a “Célula – D45”;
• A Função “Texto”, converte a “Data da Célula”, em “Texto”, para então a “Função –

CTOD”, convertê-la em “Data”, para o Protheus;
• "F2_VALFAT" – É o “Nome do Campo”, a ser calculado.
Obs.:
A Função, retornará a “Soma do Campo – Valor Faturado”, de todas a “NFs emitidas”,

entre “29/06/2001 e 30/10/2001”, do “Cliente – 000001”.
Anotações:
Exercício 11 – Como exercitar a Função Somar:
1. Usando as variações possíveis da “Função Somar”, obtenha: a “Quanti-

dade Atual”, o “Saldo Atual em Valores” e o “Percentual de Contribui-
ção”, de cada um dos “Produtos” sugeridos;
2. Sabendo-se que a “Tabela de Saldos Físicos e Financeiros”, dos produ-
tos é a “SB2”;
3. Lembre-se que além do “Código do Produto”, ser uma das condições, há
também o “Armazém (Local)”, pois o mesmo produto pode ser encontrado
em mais de um armazém.
4. A “Contribuição”, se trata do “Percentual”, de cada produto em relação ao “To-
tal”.
Anotações:
Contar
Conta o Número de Registros, baseado nas condições determinadas.

Sintaxe:
Contar(ParC1; ParC2),
Onde:
• ParC1 – Alias do arquivo;
• ParC2 – Condição para a Contagem.
Exercício 12 – Como utilizar a Função Contar no Modo Avançado:

1. Na "Célula –B57”, informe os dados a seguir:
“=Contar("SA1";"!EOF()")”;
2. Confira os dados e confirme a "Digitação".
Contar("SA1";"!EOF()"),
Onde:
• “!EOF()” – Conta o “Número de Registros”, que contém toda a “Tabela”.
Obs.:
Esta Função, contará o “Número de Registros”, que contém a “Tabela – SA1”, ou seja, o
“Número de Clientes”, cadastrados.
Exercício 13 – Como utilizar a Função Contar com Referência Relativa:

1. Na “Célula – C62”, informe os dados a seguir:
“=Contar("SA1";"A1_EST=('"&B62&"')")”;
2. Copie a “Fórmula”, para a “Linha Seguinte”.
Contar("SA1";"A1_EST=('"&B62&"')"),
Anotações:
Onde:
• "A1_EST=('"&B62&"')" – Conta o “Número de Registros”, de acordo com o “Valor

Digitado”, na “Célula – B62”.
Obs.:
Esta Função, contará o “Número de Clientes”, no estado de “SP e MG”.
Exercício 14 – Como exercitar a Função Contar:

1. Usando as variações possíveis da “Função – Contar”, assim como, as “Variações”
das outras “Funções”, obtenha o “Número de Compras”, que realizaram cada um
dos “Clientes”, nas “Datas Sugeridas”;
2. Sabendo-se que a “Tabela de NFs”, é a “SF2”;
3. Lembre-se de usar a Função “CTOD” e o Operador “.AND.”.
Anotações:
Siga
Esta Função, permite que seja executada, a partir do Office Excel, qualquer
Função (Deve retornar valor) desenvolvida no IDE e atualizada no RPO.
Necessariamente esta Função requer pelo menos o primeiro Parâmetro, ou seja, o Nome da Fun-
ção.
Os demais variam conforme a Necessidade de Interação, que Poderá ou Não Haver, de acordo
com cada Função.
Sintaxe:
Siga(ParC1, Par1,),
Onde:
• “ParC1” – Nome da Função, precedido por “U_”. Obrigatório;
• “Par1” – Pode ser um Parâmetro Lógico, Numérico ou Caracter, dependendo da necessidade
da Função desenvolvida no IDE. Não obrigatório.
Exercício 15 – Como utilizar a Função Siga sem Parâmetros:

1. Na Célula “B75”, informe os dados a seguir:
“=Siga("U_STCLI")”;
Siga("U_1STCLI"),
Onde:
• “U_1STCLI” – É o “Nome da Função”, digitada no IDE.
Obs.:
Esta Função, retornará o “Código do Primeiro Cliente”, cadastrado.
Exercício 16 – Como utilizar a Função Siga com Parâmetros:

1. Na “Célula – D80”, informe os dados a seguir:
“=Siga("U_EXER15";B80;C80)”;
Anotações:
Siga("U_EXER15";B80;C80),
Onde:
• “U_EXER15” – É o “Nome da Função”, digitada no IDE, precedida do “U_” (User

Function);
• “B80” – É a “Célula”, que contém a “Primeira Variável”;
• “C80” – É a “Célula”, que contém a “Segunda Variável”.
Obs.:
Esta Função, retornará a “Soma dos Valores”, contidos nas “Células”.
Anotações:
MsGetArray
Esta Função, retornará o Resultado de um Array, desenvolvido na Ferramenta de

Desenvolvimento IDE.
Sintaxe:
Siga(ParC1; ParC2),
Onde:
• ParC1 – Referência da Célula Inicial;
• ParC2 – Nome da Função, que retorna o Array, inserido na Função – SIGA.
Exercício 17 – Como utilizar a Função MsGetArray:

1. Na “Célula – B85”, informe os dados a seguir:
“=MsGetArray(B85;Siga("U_MATRIZ1"))”;
Obs.:
Note que a partir da “Célula” digitada, foram acrescentados todos os códigos dos “Centros
de Custos”, existentes.
MsGetArray(B85;Siga("U_MATRIZ1"))
• “B85” – É a “Célula Inicial”, que deverá ser descarregado;
• “Siga("U_MATRIZ1")” – É o uso da “Função – SIGA”, executando a “Função –

U_MATRIZ1”, que retorna o “Array”.
Obs.:
Esta Função, retornará o “Resultado de um Array”, que contém todos os códigos de

“Centros de Custos”, a partir da “Célula – B85”.
Anotações:
Funções Financeiras
SldBco
Retorna o Saldo Bancário, baseado nos Parâmetros informados.

Sintaxe:
SldBco(ParC1; ParC2; ParC3; ParD1; ParN1),
Onde:
• ParC1 – Código do Banco;
• ParC2 – Agência Bancária;
• ParC3 – Conta Bancária;
• ParD1 – Data do Saldo;
• ParN1 – Moeda.
Exercício 18 – Como utilizar a Função SldBco Avançada:

1. No “Office Excel”, selecione a “Pasta – Financeiras”, do “Arquivo – ExerPro.xls”;
“=SldBco("341";"0754";"26456/8";AGORA();1)”;
SldBco("341";"0754";"26456/8";AGORA();1),
Onde:
• “341” – É o “Código do Banco”;
• “0754” – É o “Código da Agência”;
• “26456/8” – É o “Código da Conta”.
Obs.:
Esta Função, retornará o “Saldo da Conta”, especificada na “Data Atual” (Data do

Windows).
Anotações:
SldReceber
Retorna o Saldo a Receber em uma Data, ou até a Data e, pode ou não, considerar
o Valor já pago.
Sintaxe:
SldReceber(ParD1,ParN1,ParL1, ParL2),
Onde:
• ParD1 – Data do Movimento a Receber;
• ParN1 – Moeda;
• ParL1 – Se Verdadeiro, considera todo o saldo até a Data, se Falso, considera somente a
Data;
• ParL2 – Se Verdadeiro, desconsidera o Saldo Recebido, se Falso, considera o Saldo já Rece
bido.
Anotações:
Exercício 19 – Como utilizar a Função SldReceber Avançada:
“=SldReceber("08/10/01";1;VERDADEIRO;VERDADEIRO)”;
SldReceber("08/10/04";1;VERDADEIRO;VERDADEIRO),
Onde:
• “08/10/04” – É a “Data”, a ser pesquisado o “Movimento a Receber”;
• “1” – É a “Moeda”, em que se deseja saber o “Saldo”;
• “VERDADEIRO” – É o “Primeiro Parâmetro Lógico”, indica se retornará o “Saldo”,

somente “Na Data” (Falso), ou “Até a Data” (Verdadeiro);
• “VERDADEIRO” – É o “Segundo Parâmetro Lógico”, se “Verdadeiro”, considera os

“Valores Baixados”, se “Falso”, considera os “Valores a Receber”, sem verificar os “Bai-
xados”.
Obs.:
O Exemplo, retornará o “Saldo a Receber”, até a data “08/10/04”, menos o

“Saldo Recebido em Reais”, até a “Data”.
Exercício 20 – Como utilizar a Função SldReceber com a (Função SE) do

Office Excel:
1. Na “Célula – E12”, informe os dados a seguir:
“=SLDRECEBER(B12; C12; SE(D12="V"; VERDADEIRO; FALSO); VERDADEIRO)”;
SLDRECEBER(B12; C12; SE(D12="V"; VERDADEIRO; FALSO); VERDADEIRO),
Onde:
• “B12” – É a “Célula”, que contém a “Data”, a ser pesquisado o “Movimen-

to”;
Anotações:
FinNatPrv
Retorna o Saldo Previsto, de uma Natureza, dentro de um Período.

Sintaxe:
FinatPrv(ParC1; ParD1; ParD2; ParN1),
Onde:
• ParC1 – Natureza, a ser pesquisada;
• ParD1 – Data Inicial, para cálculo;
• ParD2 – Data Final, para cálculo;
• ParN2 – Data data a ser considerada (0 - data da digitação, 1 - data do
movimento).
Exercício 26 – Como utilizar a (Função FinNatPrv Avançada) com a Função

Agora do Office Excel:
1. Na "Célula – C39”, informe os dados a seguir:
“=FinNatPrv("000002";"31/12/00";AGORA()+B39;1;0)”;
FinNatPrv("000002";"31/12/00";AGORA()+B39;1),
Onde:
• “000002” – É o “Código da Natureza”, a ser pesquisada;
• “01/07/01” – É a “Data Inicial”, a ser considerada;
• “AGORA()+B39” – É a “Data Inicial” a ser considerada. A função “Agora”,

retornará a “Data Atual”, somada ao “Número de Dias”, contidos na “Célula
– B39”;
• “1” – É a “Moeda”
• “0” – É a data da “Movimentação”.
Obs.:
O Exemplo, retornará o “Saldo Previsto”, da “Natureza – 000002”, entre a
Anotações:
“Data Inicial” e a “Data Obtida”, através da “Função – Agora”, acrescido
do “Número de Dias”, contido na “Célula – B39”. A data a ser considerada
para filtro é a “Data de Digitação” do documento.
Anotações:
FinNatRea
Retorna o Saldo Realizado, de uma Natureza, dentro de um Período.

Sintaxe:
FinNatRea(ParC1; ParD1; ParD2; ParN1),
Onde:
• ParD1 – Data Inicial, para cálculo;
• ParD2 – Data Final de cálculo;
• ParN2 – Considera MovimentoBancário;
• ParC2 –Data data a ser considerada (DG - data da digitação, DT - data do
movimento).
Exercício 27 – Como utilizar a Função FinNatRea Avançada:

“=FinNatRea("000001";"01/07/01";"30/11/04";1;0;"DG")”;
FinNatRea("000001";"01/07/01";"30/11/04";1;0;"DG"),
Onde:
• “01/07/01” – É a “Data Inicial”, a ser considerada;
• “30/11/04” – É a “Data Final”, a ser considerada;
• “1” – É a “Moeda”
• “0” – Não considera movimentação bancária;
• “DG” – Considera a data de digitação dos títulos.
Obs.:
O Exemplo, retornará o “Saldo Realizado”, da “Natureza – 000001”, entre a

“Data Inicial” e a “Data Final”, não considerando a movimentação bancária
e tendo como parâmetro de datas a digitação.
Anotações:
FinNatOrc
Retorna o Saldo Orçado, de uma Natureza, em um determinado Mês.

Sintaxe:
FinNatOrc(ParC1; ParN1; ParN2),
Onde:
• ParN1 – Mês, a ser cálculado;
• ParN2 – Moeda.
Exercício 28 – Como utilizar a Função FinNatOrc Avançada:

“=FinNatOrc("000001";8;1)”;
FinNatOrc("000001";8;1),
Onde:
• “8” – É o “Mês”, a ser pesquisado;
• “1” – É a “Moeda”.
Obs.:
O Exemplo, retornará o “Valor Orçado”, da “Natureza – 000001”, no “Mês de

Agosto”.
Anotações:
RecMoeda
Retorna a Cotação da Moeda, de acordo com a Data.

Sintaxe:
RecMoeda(ParD1; ParN1),
Onde:
• ParD1 – Data, a ser pesquisada;
Exercício 29 – Como utilizar a Função RecMoeda Avançada:

“=RecMoeda("20/12/01";2)”;
RecMoeda("20/12/01";2),
Onde:
• “20/12/01” – É a “Data”, a ser pesquisada;
• “2” – É a “Moeda”, a ser pesquisada.
Obs.:
O Exemplo, retornará a “Cotação da Moeda – 2”, no dia “20/12/01”.
Anotações:
• “C12” – É a “Célula”, que contém a “Moeda”, em que se deseja saber o
“Saldo”;
• “SE(D12="V";VERDADEIRO;FALSO)” – A “Função – SE”, substitui o “Primeiro

Parâmetro”, esta “Função”, verificará se o parâmetro digitado na “Célula
– D12”, é igual a “V”, caso seja, retornará “VERDADEIRO”, caso seja “F”,
retornará “FALSO”;
• “VERDADEIRO” – É o “Segundo Parâmetro Lógico”, se “Verdadeiro”, considera os

“Valores Baixados”, se “Falso”, considera os “Valores a Receber”, sem verificar os “Bai-
xados”.
Obs.:
O Exemplo, retornará o “Saldo a Receber”, na data “20/08/04”, menos o

“Saldo Recebido em Reais até a Data”.
Exercício 21 – Como exercitar a Função SldReceber:

1. Usando os “Recursos”, já aprendidos de referência, “Função – SE”, retorne o “Saldo
a Receber”, baseado nos dados sugeridos;
2. Note que ao invés de ser “V”(Verdadeiro), como “Parâmetro”, use “T”(True).
Obs.:
Esta “Função”, deverá contemplar também a “Consistência dos Parâmetros”,

utilizados ou seja, só poderão ser aceitas como “Parâmetros”, as “Letras
– T e F”.
Anotações:
XMoeda
Retorna a Conversão de uma Moeda pela Outra.

Sintaxe:
XMoeda(ParN1; ParN2; ParN3; ParD1),
Onde:
• ParN1 – Valor a ser Convertido;
• ParN2 – Moeda de Partida;
• ParN3 – Moeda de Destino;
• ParD1 – Data da Conversão.
Exercício 31 – Como utilizar a Função XMoeda Avançada:

“=xMoeda(100;1;2;"20/12/04")”;
xMoeda(100;1;2;"20/12/04"),
Onde:
• “100” – É o “Valor”, a ser convertido;
• “1” – É a “Moeda”, na qual está sendo informado o “Valor”;
• “2” – É a “Moeda”, utilizada na “Conversão”;
• “20/12/04” – É a “Data”, utilizada para a “Conversão”.
Obs.:
O Exemplo, converterá o “Valor” de “100,00”, da “Moeda – 1”, para a “Moeda

– 2”, na “Taxa” do dia “20/12/04”.
Anotações:
Funções Contabilidade Gerencial (Ctb)
Saldo Conta
Retorna o Saldo de uma Conta Contábil (CT7) na data e moeda informadas.

Sintaxe:
SaldoConta(ParC1; ParD1; ParN1,ParC2,ParC3),
Onde:
• ParC1 – Código da Conta Contábil;
• ParD1 – Data na qual se deseja obter os saldos;
• ParN1 – Moeda na qual se deseja os saldos.
• ParC2 – Tipo de Saldo no qual se deseja os saldos.
Exercício 32 – Como utilizar a Função Saldo Conta:

1. No “Office Excel”, selecione a “Pasta – Ctb”, do “Arquivo – ExerPro.xls”;
“=SaldoConta(“31501001”,”30/11/04”,”01”,”1”,3)”;
SaldoConta(“31501001”,”30/11/04”,”01”,”1”,3)”,
Onde:
• “31501001” – É o “Código da Conta”;
• “30/11/04” – É a data”;
• “01” – É o “Código da Moeda”.
• “1” – Tipo de Saldo da Moeda”.
• 3 – Retorno DeseTipo de Saldo da Moeda”.
Anotações:
Obs.:
Esta Função, retornará o “Saldo da Conta”, especificada na “Data Atual”

(Data do Windows).
Obs.:
Retorno
Na passagem de parâmetros, indique qual o retorno desejado utilizando um dos números
abaixo:
1 - Saldo atual (com sinal)
2 - Débito na data (movimento)
3 - Crédito na Data (movimento)
4 - Saldo atual devedor
5 - Saldo atual credor
6 - Saldo anterior (com sinal)
7 - Saldo anterior devedor
8 - Saldo anterior credor
Anotações:
Saldo Centro Custo
Retorna o Saldo de uma Conta contábil + Centro de Custo (CT3) na data e moeda informadas.
Sintaxe:
SaldoCcus(ParC1; ParC2; ParD1 ;ParN1,ParC3,ParC4),
Onde:
• ParC2 – Código do Centro de Custo;
• ParD1 – Data na qual se deseja obter os saldos.
• ParC4 – Retorno Desejado.
Exercício 33– Como utilizar a Função Centro de Custo:

“=SaldoCCus(“11101002”,”12”,”30/09/2004”,”01”,”1”,1)”;
SaldoCcus(“11101002”,”12”,”30/09/2004”,”01”,”1”,1),
Onde:
• “11101002” – É o “Código da Conta Contábil”;
• “12” – É o “Código do Centro de custo”;
• “30/09/20004” – É o “Data do saldos”.
• “01” – É a “Moeda na qual se deseja obter os saldos”.
• “1” – Tipo da Moeda.
• 1 – Retorno Desejado.
Obs.:
Esta Função, retornará o “Saldo do Centro de custo”.
Anotações:
Obs.:
Retorno
abaixo:
Anotações:
Saldo Item
Retorna o Saldo de uma conta contábil + centro de custo + item contábil (CT4) na
data e moeda informadas.
Sintaxe:
SaldoItem(ParC1; ParC2; ParC3 ;ParD1; ParN1;ParC4;ParC5),
Onde:
• ParC3 – Código do Item Contábil;
• ParN1 – Moeda na qual se deseja obter os saldos
Exercício 34– Como utilizar a Função SaldoItem:

“=SaldoItem(“41101001”,“”,”1001”,”19/10/2004”,”01”,”1”,1)”;
SaldoItem(“41101001”,“”,”1001”,”19/10/2004”,”01”,”1”,1)
Onde:
• “” – É o “Código do Centro de custo”;
• “1001” – É o “Código do Item Contábil”;
• “19/10/20004” – É o “Data do saldos”.
• “01” – É a “Moeda na qual se deseja obter os saldos”.
Anotações:
Obs.:
Esta Função, retornará o “Saldo de uma conta contábil”.
Obs.:
Retorno
abaixo:
Anotações:
SaldoClass
Retorna o Saldo de uma Conta Contábil + Centro de Custo + Item Contábil + Classe
de Valor (CTI) na data e moeda informadas.
Sintaxe:
SaldoClass(ParC1; ParC2; ParC3 ;ParC4; ParD1; ParN1; ParC5;ParC6),
Onde:
• ParC4 – Código da Classe de Valor;
• ParD1 – Data na qual se deseja obter os saldos.
Exercício 35– Como utilizar a Função SaldoClass:

“=SaldoClass(“11301001”,”111”,”1001”,”clvl001”,”23/09/04”,”01”,”1”,1)”;
SldClass(“11301001”,”111”,”1001”,”clvl001”,”23/09/04”,”01”,”1”,1)
Onde:
• “1001” – É o “Código do Item Contábil”;
• “clvl001” – “Código da Classe de valor”;
• “23/09/04” – É a “Data na qual se deseja obter os saldos”;
Anotações:
Obs.:
Retorno
abaixo:
Anotações:
Movimento Conta
Retorna o Movimento da Conta Contábil (CT7) nas datas e moeda informadas.

Sintaxe:
MovConta(ParC1; ParD1; ParD2; ParN1;ParC2;ParC3),
Onde:
• ParD1 – Data inícial na qual se deseja obter o valor dos movimentos;
• ParD2 – Data final na qual se deseja obter o valor dos movimentos;
• ParN1 – Moeda na qual se deseja o valor dos movimentos;
• ParC2 – Tipo de Saldo no qual se deseja o valor dos movimentos;
• ParC3 – Retorno Desejado;
Exercício 36 – Como utilizar a Função MovConta:

“=MovConta(“31101001”,”31/12/2003”,”31/12/2004”,”01”,”1”,1)”;
MovConta(“31101001”,”31/12/2003”,”31/12/2004”,”01”,”1”,1)
Onde:
• “31/12/2003” – É a “Dt.inicial na qual se deseja obter o valor dos

movimen.”;
• “31/12/2004” – É a “Dt.final na qual se deseja obter o valor dos

movimen.”;
• “01” – É a “Moeda na qual se deseja o valor dos movimentos”.
• “1” – Tipo de saldo do valor dos movimentos”.
• 1 – Retorno desejado..
Anotações:
Obs.:
Retorno
abaixo:
1 - Movimento Devedor
2 - Movimento Credor
3 - Movimento do Mês
Anotações:
Movimento Custo
Retorna o Movimento de uma Conta Contábil + Centro de Custo (CT3) nas datas e moeda informa-
das.
Sintaxe:
MovCusto(ParC1; ParC2; ParD1; ParD2; ParN1),
Onde:
• ParN1 – Moeda na qual se deseja o valor dos movimentos.
Exercício 37 – Como utilizar a Função MovCusto:

“=MovCusto(“11101002”,”12”,”01/01/03”,”31/12/04”,”01”,”1”,1)”;
MovCusto(“11101002”,”12”,”01/01/03”,”31/12/04”,”01”,”1”,1)
Onde:
• “01/01/03” - É a “Dt.inicial na qual de deseja obter o valor dos

movimentos.”;
• “31/12/04” - É a “Dt.final na qual de deseja obter o valor dos movimen-

tos.”;
• “01” – É a “Moeda na qual se deseja o valor dos movimentos”.
• 1 – Retorno desejado..
Anotações:
Obs.:
Retorno
abaixo:
4 - Saldo Final do Periodo Informado
Anotações:
Movimento de Item
Retorna o Movimento de uma Conta Contábil + Centro de Custo + Item Contábil (CT4) nas datas e
moeda informadas.
Sintaxe:
MovItem(ParC1; ParC2; ParC3; ParD1; ParD2; ParN1;ParC4;ParC5),
Onde:
• ParC2 – Código do Centro de custo;
• ParN1 – Moeda na qual se deseja o valor dos movimentos.
Exercício 38 – Como utilizar a Função MovItem:

“=MovItem(“11301001”,”111”,”1001”,”31/12/03”,”31/12/04”,”01”,”1”,1)”;
MovItem(“11301001”,”111”,”1001”,”31/12/03”,”31/12/04”,”01”,”1”,1)
Onde:
• “31/12/03” – É a “Dt.inicial na qual se deseja obter o valor dos

movimentos;”;
• “31/12/04” – É a “Dt.final na qual se deseja obter o valor dos

movimentos;”;
• “01” – É a “Moeda na qual se deseja o valor dos movimentos.”;
Anotações:
• 1 – Retorno desejado.
Obs.:
Retorno
abaixo:
4 - Saldo Final do Periodo Informado
Anotações:
CTSMConta
Retorna o saldo de um grupo de contas contábeis na data e moeda informadas.

Sintaxe:
CtSmConta(ParC1; ParD1;ParN1,ParC2,ParC3),
Onde:
• ParC1 – Código das Contas Contábeis separadas por vírgula ou :
• ParN1 – Moeda na qual se deseja os saldos;
• ParC2 – Tipo de Saldo no qual se deseja;
Exercício 39 – Como utilizar a Função CtSmConta:

“=CtSmConta(“11101001:11101003”,”30/09/2004”,”01”,”1”,1)”;
MovCtSmConta(“11101001:11101003”,”30/09/2004”,”01”,”1”,1)
Onde:
• “11101001:11101003” – É o “Código das Contas Contábeis”;
• “30/09/04” – É a “Data na qual se deseja obter os saldos;”;
• “01” – É a “Moeda na qual se deseja os saldos.”.
• “1” – Tipo de Saldo.
Anotações:
Obs.:
Retorno
abaixo:
Anotações:
CTSMCusto
Retorna o saldo de um grupo de Centro de Custo na data e moeda informadas.

Sintaxe:
CtSmCusto(ParC1; ParD1;ParN1;ParC2;ParC3),
Onde:
• ParC1 – Código dos Centros de Custo separadas por vírgula ou:
Exercício 40– Como utilizar a Função CtSmCusto:

“=CtSmCusto(“111:113”,”20/09/2004”,”01”,”1”,1)”;
CtSmCusto(“111:113”,”20/09/2004”,”01”,”1”,1)
Onde:
• “111:113 ” – É o intervalo de “Código dos Centros de custo separadas por vírgula ou:”;
• “01” – É a “Moeda na qual se deseja os saldos.”;
Anotações:
Obs.:
Para indicar um intervalo de Centros de Custo utilize “:” e para indicar um novo Centro
de Custo utilize “,”.
Exemplo: “0001:0200,2000,3001”.
Serão considerados todos os centros de custo do intervalo “0001” a “0200” e somente os

centros de custo “2000” e “3001”.
Obs.:
Retorno
abaixo:
Anotações:
CTSMItem
Retorna o saldo de um grupo de itens contábeis na data e moeda informadas.

Sintaxe:
CtSmItem(ParC1; ParD1;ParN1;ParC2;ParC3),
Onde:
• ParC1 – Código dos itens contábeis separadas por vírgula ou:;
Exercício 41– Como utilizar a Função CtSmItem:

“=CtSmItem(“1001:1005”,”23/09/2004”,”01”,”1”,1)”;
CtSmItem(“1001:1005”,”23/09/2004”,”01”,”1”,1)
Onde:
• “1001” – É o intervalo de “Código dos itens contábeis separadas por vírgula”;
• “01” – É a “Moeda na qual se deseja os saldos”.
Anotações:
Obs.:
Esta Função, retornará o valor “CtSmItem”.
Obs.:
Para indicar um intervalo de itens contábeis utilize “:” e para indicar um novo item contábil
utilize “,”.
Exemplo: “ 0001:0200,2000,3001” - Serão consideradas todos os itens contábeis do intervalo

“0001” a “0200” e somente os itens contábeis “2000” e “3001”.
Obs.:
Retorno
abaixo:
Anotações:
CTSMCLVL
Retorna o saldo de um grupo de classes de valores na data e moeda informadas.

Sintaxe:
CtSmCLVL(ParC1;ParD1;ParN1;ParC2;ParC3),
Onde:
• ParC1 – Código das Classes de valores separadas por vírgula ou:;
Exercício 42– Como utilizar a Função CtSmConta:

“=CtSmCLVl(“clvl001:clvl002”,”23/09/2004”,”01”,”1”,1)”;
CtSmCIVI(“clvl001:clvl002”,”23/09/2004”,”01”,”1”,1)
Onde:
• “clvl001” – É o intervalo do “Cód.das Classes de valores separadas por vírgula ou:”;
• “23/09/2004” – É a “Data na qual se deseja obter os saldos;”
• “01” – É a “Moeda na qual se deseja os saldos.”
Anotações:
Obs.:
Para indicar um intervalo de Classes de valor utilize “:” e para indicar uma nova classe de
valor utilize “,”.
Exemplo: “ 001:0200,2000,3001” - Serão consideradas todas as classes de valor do intervalo

“0001” a “0200” e somente as classes de valor “2000” e “3001”.
Obs.:
Retorno
abaixo:
Anotações:
Neste capítulo, você aprendeu como instalar a biblioteca de integração do Protheus

com o Office Excel assim como o uso de cada uma das funções.
Próximo Passo
Veremos a seguir a integração com o Office Word.
Anotações:
INTEGRAÇÃO COM O
OFFICE WORD
A Integração entre o Protheus e o Office Word, acontece principalmente, no Módulo

de Gestão de Pessoal, embora seja possível também, a Integração com o Módulo de Documentos.
Através da Integração é possível extrair informações do Protheus, para Elaborar
Documentos e imprimí-los.
Esta ferramenta vem auxiliar na Elaboração de Documentos sem a necessidade de
intervenção de programação.
Neste capítulo veremos e como Identificar as Variáveis de uso da Integração, a

Elaboração de um Documento e a Emissão do mesmo.
Rotinas Abordadas
• Identificação das Variáveis;

• Elaboração de Documentos;
• Emissão de Documentos.
Anotações:
Identificação das Variáveis
A Integração do Protheus com o Office Word, se dá através de Variáveis inseridas

no texto digitado no Office Word.
Estas Variáveis assumem os Valores, conforme os Parâmetros especificados.
Há 173 Variáveis, que podem ser utilizadas na Elaboração de um Documento, elas
estão listadas em um Relatório do Protheus.
Exercício 43 – Como emitir o Relatório de Variáveis:

1. Acesse o Módulo “SIGAGPE – Gestão de Pessoal”;
2. Selecione as seguintes opções “Atualizações” + “Office Word”;
O sistema apresentará a janela “Integração com o Office Word”;
3. Clique na opção “Imp. Variáveis”;
Certifique-se que a impressão esteja “Em Disco”
4. Confira os dados e confirme a emissão do “Relatório de Variáveis”.
Anotações:
Elaboração de Documentos
A Elaboração de Documentos (Modelo), deverá ser realizada simplesmente através do Office

Word, já que a integração só será possível com o Documento pronto.
Nesta Elaboração, deverão serem inseridas as Variáveis necessárias, Salvar o
documento no formato “.Dot”, ou seja, como modelo do documento desejado.
A partir daí será possível a sua utilização, Integrando com o Office Word.
Exercício 44 – Como elaborar o Modelo do Office Word:

1. Abra o “Office Word”;
2. Abra o arquivo “c:\dot\ExerVt.dot”;
3. Posicione com o cursor em frente a linha de “Endereço”;
4. Selecione as seguintes opções “Inserir” + “Campo”;
5. Na caixa de texto “Códigos de Campos”, informe “DOCVARIABLE
GPE_ENDERECO”;
6. Confira os dados e confime a “Inclusão da Fórmula”;
7. Clique com o botão direito do mouse sobre o cursor e selecione
“Alternar Códigos de Campo”;
Dica:
Note que foi exibido a “Fórmula”, com a “Variável” digitada

8. Copie toda a “Fórmula” e cole em as demais linhas a serem completadas;
9. Selecione todas a “Linhas”, que foram “Copiadas” e exiba o “Conteúdo
das Fórmulas”;
10. Na linha do “Compl. End.”, substitua “Endereço”, por “Comp_ender”;
11. Na linha do “Bairro”, substitua “Endereço”, por “Bairro”;
12. Na linha do “Município”, substitua “Endereço”, por “Município”;
13. Na linha do “Estado”, substitua “Endereço”, por “Desc_estado”;
14. Salve o “Documento”.
Exercício 45 – Como criar Auto Textos:

1. Abra um “Novo Arquivo”;
2. Selecione as seguintes opções “Inserir” + “Campo”;
Anotações:
3. Na Caixa de Texto “Códigos de Campos”, informe “Docvariable
Gpe_Nome_Empresa”;
4. Confira os dados e confime a “Inclusão da Fórmula”;
5. Clique com o botão direito do mouse e selecione “Alternar Códigos de
Campo”;
6. Selecione todo o conteúdo do campo;
7. Pressione <Alt> + <F3>;
8. No campo “Atribua um Nome”, digite “NomeEmp”;
9. Feche o “Documento Atual”, sem salvá-lo;
10. Abra um “Novo Arquivo”;
11. Selecione as seguintes opções “Inserir” + “AutoTexto” + “Normal” +
“NomeEmp”
12. Clique com o botão direito do mouse e selecione “Alternar Códigos de
Campo”;
13. Complemente com o nome da função que deseja retornar. Neste caso
“Nome”.
Dica:
O arquivo deve necessáriamente ser gravado como “.dot” (Modelo do Office

Word), ser gravado em um diretório de nome curto (No máximo 8 caracteres)
no PC e não no Servidor.
Exercício 46 – Exercício proposto de integração com o Office Word:

1. Abra o arquivo “c:\dot\ExerPro.doc”
2. Usando as ferramentas já aprendidas, substitua todos os “Campos em
Negrito” por “Variáveis de Integração”.
3. Salve o documento no diretório “c:\dot\”, e lembre-se, deve ser um
modelo do Office Word.
Anotações:
Emissão de Documentos
Da mesma maneira que na Integração com o Office Excel, o Documento a ser emitido, deverá
necessariamente ser aberto, através do Protheus.
Uma vez aberto o Documento, o Office Word, enviará a impressão e encerrará
automaticamente.
Isto acontece por uma questão de segurança, tendo em vista que a maioria dos
documentos são Confidenciais.
Após a Abertura do Documento pelo Protheus, não será necessária nenhuma interven-
ção, pois todas as parametrizações como: Número de Cópias, Documento a ser
impresso e quais os Funcionários deverão ser Listados, será realizado através do
Protheus.
Exercício 47 – Como emitir o Documento Elaborado:

1. No Protheus, selecione as opções “Atualizações” + “Office Word”;
2. Clique na opção “Parâmetros” e informe os dados a seguir:
Filial De?: 01 (F3 Disponível)
Filial Até?: 99 (F3 Disponível)
C. Custos De?: <branco> (F3 Disponível)
C. Custos Até?: 999999999 (F3 Disponível)
Matrícula De?: 000001 (F3 Disponível)
Matrícula Até?: 000003 (F3 Disponível)
Admissão De?: 01/01/93
Admissão Até?: 31/12/01
Arquivo do Word?: <enter> C:\Dot\ExerPro.dot
3. Confira os dados e confirme os “Parâmetros”;
4. Clique na opção “Impr. Documentos”.
Obs.:
Note que o “Office Word”, abrirá automaticamente e enviará as impressões

necessárias.
Anotações:
Neste capítulo aprendemos sobre as Variáveis de Integração do Protheus com o

Office Word, aprendemos também a Criar Modelos e finalmente Imprimí-los, através
do Protheus.
Próximo Passo
Esperamos que você tenha conhecido e aprendido sobre os principais recursos da

Integração do Protheus com o Office.
Mantenha esta apostila como roteiro para seu trabalho diário, em conjunto com o
Manual do Usuário.
Se tiver alguma sugestão para melhoria do nosso material, utilize o nosso e-mail:
microsigaeducacao@microsiga.com.br.
Teremos satisfação em recebê-la e analisaremos a viabilidade de aplicá-la ao
nosso material.
Agora o próximo passo é:
Aplicar o conteúdo apresentado à rotina de trabalho de sua empresa!
Número de Registro:
8111702050940 - IOW
Anotações:

P08 - Integração Word Excel

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

P08 - Integração Word Excel

Enviado por

Direitos autorais:

Formatos disponíveis

INTEGRAÇÃO OFFICE WORD E EXCEL

MICROSIGA Software S/A

Copyright © MICROSIGA Software S/A

MICROSIGA Educação Corporativa

Auditoria de Cursos MICROSIGA

INSTALAÇÃO DA BIBLIOTECA DO PROTHEUS COM O OFFICE EXCEL ...........................................7

FUNÇÕES DE INTEGRAÇÃO COM O OFFICE EXCEL ...................................................................................13

O que você aprendeu neste capítulo ....................................... 63

INTEGRAÇÃO COM O OFFICE WORD ......................................................................................................64

VISÃO GERAL DO CURSO

Este Curso foi elaborado para capacitar os usuários do ERP MICROSIGA, a se

Ao término deste curso, o aluno deverá estar habilitado a:

O curso de Integração com Office Word e Excel é ministrado com um Kit de

Na verdade não há uma instalação da Integração do Protheus com o Office.

O que você irá aprender neste capítulo

Neste capítulo veremos a Instalação e a Utilização da Biblioteca de Funções do

• Instalação da Biblioteca ApExcel80.xla;

Exercício 01 – Como instalar a Biblioteca de Funções do Protheus no Office

Lembre-se o “Caminho”. sugerido acima é somente um exemplo, deve-se uti-

Recálculo do Protheus – Esta opção tem a função de atualizar na

Altera os Links da Planilha – Esta opção ao ser clicada, atualiza os

Informações sobre a Conexão com o Protheus – Ao ser clicada esta opção,

• Através desta opção também é possível gravar um Histórico com as

• Além das opções que acompanham a Biblioteca, há também as Funções que

Antes de prosseguirmos com o curso é necessário que seja estabelecida a conexão

Este procedimento é recomendado para usuários menos experientes, pois o Microsoft

Outra forma de se utilizar as funções do Protheus, é digitando a função, diretamente na célula.

Neste capítulo, você aprendeu a Instalar a Biblioteca ApExcel80.xla, viu também

O que você irá aprender neste capítulo

Retorna o Código da Filial, que estamos Conectados atualmente.

Exercício 02 – Como utilizar a Função xFilial com a ajuda do Assistente de Funções:

Preferencialmente, utilize sempre “Letras Maiúsculas”.

Retorna o Conteúdo somente um Campo de um Registro, conforme parâmetros informa-

Exercício 03 – Como utilizar a Função Posicione com a ajuda do Assistente de Funções:

• Note que conforme você vai digitando no “Assistente”, automaticamente o “Assisten-

• “SA1” – Automaticamente é a “Tabela” que desejamos pesquisar;

• xFilial(“SA1”)&”000001” – É um “Parâmetro Composto”, da função

• “A1_NOME” – É o “Nome do Campo” que terá seu “Conteúdo” retornado.

Exercício 04 – Como utilizar a Função Posicione no Modo Avançado:

Posicione(“SA1”,1,xFilial(”SA1”) & ”000002”,“A1_END”),

• “&” – É uma maneira rápida de concatenar dois ou mais caracteres quaisquer;

• ”000002” – É a “Segunda Parte” do “Parâmetro Composto”, que neste caso é o “Código

• A1_END – É o “Nome do Campo”, que terá seu “Conteúdo”, retornado.

Este Exemplo, retorna o “Nome do Cliente” de “Código – 000002”, da “Filial – 01”,

Exercício 05 – Como utililizar a Função Posicione com Referência Relativa:

• “SA2” – É a “Tabela”, que desejamos pesquisar;

• “&” – É uma maneira rápida de “Concatenar” dois ou mais caracteres quaisquer;

• “TEXTO(C16;"000000")” – Onde deveria ser digitado o “Código do Fornecedor”, usa-

• “A2_NOME” – É o “Nome do Campo”, que será seu “Conteúdo”, retornado.

Exercício 06 – Como exercitar a Função Posicione:

Retorna a Somatória de um Campo de uma Tabela, baseada nas condições informadas.

Exercício 07 – Como utilizar a Função Somar no Modo Avançado:

• "SE1" – É a “Tabela”, que desejamos pesquisar;

• "E1_CLIENTE=='000001'" – É o “Campo”, em que será aplicada a “Condição”, neste

• “‘000001’” – É a “Condição”, ou seja o “Código do Cliente”, que será pesquisado;

• "E1_VALOR" – É o “Nome do Campo”, que será calculado.

Exercício 08 – Como utilizar a Função Somar Composta:

Somar("SE2";"E2_VALOR > 200 .AND. E2_TIPO <> 'FT'";"E2_VALOR"),

• "SE2" – É a “Tabela”, que desejamos pesquisar;

• “.AND.” – É o “Operador” de “E”, originado do ADVPL, permite que sejam digitadas

• “E2_TIPO <> 'FT'" – É a “Segunda Condição”, filtrará somente os tipos diferentes de

• "E2_VALOR" – É o “Nome do Campo”, a ser calculado.

• Além do operador “AND”, também é possível usar o “OR”.

Exercício 09 – Como utilizar a Função Somar com Datas: