Descrição: | Realiza a conexão entre o Protheus SmartClient e a aplicação MS-Office (Word), para impressão de conteúdos que utilizam a funcionalidade de integração entre o Microsiga Protheus e o pacote Microsoft Office. |
Sintaxe: | OLE_CreateLink ( < cOLETypeLink >, < cOnError >, < lCabec > ) --> hOleLink |
Parâmetros: | cOLETypeLink (caracter): String que representa a conexão com MS Word. Utilize como padrão o valor TMsOleWord97. cOnError (caracter): uso interno lCabec (Lógico): Permite habilitar/desabilitar o suporte a campos variáveis (DocumentVar) no cabeçalho e rodapé do documento. |
Retorno: | hOleLink (numerico): Handle relativo a conexão entre o SmartClient e a aplicação MS-Office. O valor retornado será 0, caso a integração com o MS Word foi iniciada com sucesso, ou -1 caso qualquer erro tenha ocorrido. |
Sistemas Operacionais Suportados: | Windows |
Programa Fonte: | MsOle.prw |
Chamados relacionados: | TUUAER |
Observações
O parâmetro < lCabec > é necessário nos casos onde ocorre falha na integração por se utilizar algum campo variável (DocumentVar) no cabeçalho ou rodapé do documento. Falhas podem ocorrer em versões mais recentes do Word, como Microsoft Word 2007 e 2010. Entretanto sugerimos manter o valor verdadeiro (.T.) como padrão, para mantermos a compatibilidade com versões antigas da integração.
Caso o retorno da função seja o valor -1, será possível rastrear o problema através da gravação de um arquivo de log, e nele, encontrar a mensagem de erro que impede o correto funcionamento. Para que o arquivo de log seja gerado, siga os seguintes passos:
- Crie um arquivo com o nome mpword.ini e salve-o na mesma pasta do arquivo mpword.dll.
- Escreva o seguinte comando na primeira linha do arquivo: tracemode=on
- Salve e feche o arquivo.
- Execute novamente a integração;
- Será criado o arquivo de log na mesma pasta do arquivo mpword.dll, cujo nome estará no formato: mpword_[nome do computador]_[data]_[hora].log