|
FORUMS PROFESSIONNELS
WINDEV, WEBDEV et WINDEV Mobile |
| | | | | |
| Accueil → WINDEV 25 → WB - É possível via programação, colocar uma planilha do Excel em uma página web dinâmica? |
| WB - É possível via programação, colocar uma planilha do Excel em uma página web dinâmica? |
| Débuté par BOLLER, 28 nov. 2016 17:01 - Aucune réponse |
| |
| | | |
|
| |
Membre enregistré
3 659 messages
Popularité : +175 (223 votes) |
|
Posté le 28 novembre 2016 - 17:01 |
Prezados,
Sim, É possível via programação, colocar uma planilha do Excel em uma página web dinâmica!
Sendo assim o OFFICE tem uma API para JAVSCRIPT
https://dev.office.com/docs/add-ins/develop/understanding-the-javascript-api-for-office
Compreendendo a API JavaScript para Office
Este artigo fornece informações sobre a API JavaScript para o Office e como usá-lo. Para obter informações de referência, consulte JavaScript API para o Office . Para obter informações sobre como atualizar arquivos de projeto do Visual Studio para a versão mais atual da API JavaScript para o Office, consulte Atualize a versão do seu API JavaScript para o Office e arquivos de esquema de manifesto .
Referenciando a API JavaScript para biblioteca do Office no seu add-in
A API JavaScript para o Office biblioteca consiste em o arquivo Office.js e arquivos .js associados hospedeiras específicas de aplicativos, como o Excel-15.js e Outlook-15.js. O método mais simples de fazer referência a API está usando nossa CDN, adicionando o seguinte <script>ao da sua página <head>tag:
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/Office.js" type="text/javascript"></script>
Isto irá baixar e armazenar em cache a API JavaScript para arquivos do Office pela primeira vez o seu suplemento carrega para se certificar de que está usando a implementação mais up-to-date de Office.js e seus arquivos associados para a versão especificada.
Para mais detalhes em todo o Office.js CDN, incluindo a forma de versões e para trás compatibilidade é tratado, consulte Fazendo referência ao API JavaScript para biblioteca do Office a partir da sua rede de distribuição de conteúdo (CDN) .
Inicializar o seu add-in
Aplica-se a: Todos os tipos de add-in
Office.js fornece um evento de inicialização, que é disparado quando o API é totalmente carregado e pronto para começar a interagir com o usuário. Você pode usar o initialize manipulador de eventos para implementar cenários de inicialização add-in comuns, como avisar o usuário para selecionar algumas células no Excel, e, em seguida, inserir um gráfico inicializado com os valores selecionados. Você também pode usar o manipulador de eventos de inicialização para inicializar outra lógica personalizada para o seu suplemento, tais como ligações que estabelecem, solicitando padrão add-in valores de configurações, e assim por diante.
No mínimo, o evento initialize seria parecido com o exemplo a seguir:
Office.initialize = function () { };
Se você estiver usando estruturas adicionais de JavaScript que incluem seu próprio manipulador de inicialização ou testes, estes devem ser colocados dentro do evento Office.initialize. Por exemplo, de JQuery função seria referenciado como segue:
$(document).ready()
Office.initialize = function () {
// Office is ready
$(document).ready(function () {
// The document is ready
});
};
Todas as páginas dentro de um Office Add-ins são necessários para atribuir um manipulador de eventos para o evento initialize, Office.initialize . Se você não atribuir um manipulador de eventos, o suplemento pode gerar um erro quando é iniciado. Além disso, se um usuário tenta usar o suplemento com um cliente web Office Online, como o Excel online, PowerPoint on-line, ou o Outlook Web App, ele vai deixar de correr. Se você não precisa de nenhum código de inicialização, em seguida, o corpo da função que você atribui a Office.initialize pode estar vazio, como no primeiro exemplo acima.
Para mais detalhes sobre a seqüência de eventos quando um add-in é inicializado, consulte Carregando o ambiente DOM e tempo de execução .
Motivo de inicialização
Para Pane Captar e add-ins de conteúdo, Office.initialize fornece um adicional razão parâmetro. Este parâmetro pode ser usado para determinar a forma como um suplemento foi adicionado ao documento actual. Você pode usar isso para fornecer lógica diferente para quando um suplemento é inserido pela primeira vez versus quando ele já existia dentro do documento.
Office.initialize = function (reason) {
$(document).ready(function () {
switch (reason) {
case 'inserted': console.log('The add-in was just inserted.');
case 'documentOpened': console.log('The add-in is already part of the document.');
}
}
Para mais informações, consulte Office.initialize Evento e InitializationReason enumeração
objeto de contexto
Aplica-se a: Todos os tipos de add-in
Quando um add-in é inicializado, ele tem muitos objetos diferentes que podem interagir com no ambiente de tempo de execução. Contexto de tempo de execução do add-in é refletido no API pela Contexto objeto. O Contexto é o principal objeto que fornece acesso aos objetos mais importantes da API, como os Documentos e de caixa de correio objetos, que por sua vez fornecem acesso a documentos e conteúdo de caixa de correio.
Por exemplo, no painel de tarefas ou conteúdo add-ins, você pode usar o documento de propriedade do Contexto objeto para acessar as propriedades e métodos do documento objeto de interagir com o conteúdo de documentos do Word, planilhas do Excel, ou cronogramas de projetos. Da mesma forma, em suplementos do Outlook, você pode usar a caixa de correio de propriedade do Contexto objeto para acessar as propriedades e métodos da caixa de correio objeto para interagir com a mensagem, solicitação de reunião ou conteúdo nomeação.
O Contexto objeto também fornece acesso aos contentLanguage e displayLanguage propriedades que permitem determinar o local (idioma) usadas no documento ou item, ou pelo aplicativo host. E, o roamingSettings propriedade que permite que você acesse os membros das RoamingSettings objeto. Finalmente, o Contexto objeto fornece uma ui propriedade que permite que o add-in para iniciar diálogos pop-up.
objeto de documento
Aplica-se a: Conteúdo e painel de tarefas add-in tipos
Para interagir com os dados do documento em Excel, PowerPoint e Word, a API fornece o documento objeto. Você pode usar o documento membros do objeto para acessar os dados das seguintes maneiras:
Ler e escrever para seleções ativos na forma de texto, células contíguas (matrizes), ou tabelas.
de dados tabulares (matrizes ou tabelas).
Ligações (criados com a opção "Adicionar" métodos do ligações objeto).
partes XML personalizado (somente para Word).
Configurações ou add-in estado persistiu por add-in no documento.
Você também pode usar o documento objeto para interagir com dados em documentos do projeto. A funcionalidade específica do projeto da API está documentado nos membros ProjectDocument classe abstrata. Para mais informações sobre a criação do painel de tarefas add-ins para o projeto, consulte o painel de tarefas add-ins para o Project .
Todas estas formas de acesso a dados começam a partir de uma instância do resumo Documento objeto.
Você pode acessar uma instância do documento objeto quando o painel de tarefas ou conteúdo add-in é inicializado utilizando o documento de propriedade do Contexto objeto. O documento objeto define funções de acesso de dados comuns compartilhados entre documentos do Word e Excel, e também fornece acesso aos CustomXmlParts objeto para documentos do Word.
O documento objeto suporta quatro maneiras para desenvolvedores para acessar o conteúdo do documento:
Acesso à base de seleção acesso de ligação à base de acesso baseado em parte XML personalizada (somente Word)
acesso baseado em documento inteiro (PowerPoint e Word somente).
Para ajudar você a entender como selecção- e ligação à base de métodos de acesso a dados funciona, vamos primeiro explicar como as APIs de acesso a dados fornecem acesso a dados consistente em diferentes aplicações do Office.
Acesso a dados consistente em todos os aplicativos do Office
Aplica-se a: Conteúdo e painel de tarefas add-in tipos
Para criar extensões que perfeitamente trabalham em diferentes documentos do Office, a API JavaScript para o Office abstrai as particularidades de cada aplicação do Office através de tipos de dados comuns ea capacidade de coagir diferentes conteúdos de documentos em três tipos de dados comuns.
Tipos de dados comum
Em ambos o acesso aos dados com base na seleção e com base vinculativa, o conteúdo do documento são expostas através de tipos de dados que são comuns em todos os aplicativos do Office suportadas. No Office 2013, três tipos de dados principais são suportados:
Tipo de dados Descrição Hospedar suporte a aplicativos texto
Fornece uma representação de seqüência dos dados na seleção ou a ligação.
No Excel 2013, do Projeto 2013 e PowerPoint 2013 apenas texto simples é suportado. No Word 2013, são suportados três formatos de texto: texto simples, HTML e Office Open XML de texto (OOXML) .Quando é selecionado em uma célula no Excel, métodos baseados em seleção ler e escrever a todo o conteúdo da célula, mesmo se apenas uma parte do texto é selecionado na célula. Quando o texto é selecionado no Word e PowerPoint, métodos baseados em seleção ler e escrever apenas para a corrida de caracteres que são selected.Project 2013 e PowerPoint 2013 suportam apenas o acesso de dados baseada em seleção.
Matriz Fornece os dados sobre a selecção ou de ligação como um bidimensional matriz , que por sua JavaScript é implementada como uma matriz de arrays.For exemplo, duas linhas de corda valores em duas colunas seria , e uma única coluna de três linhas seria .[['a', 'b'], ['c', 'd']][['a'], ['b'], ['c']] acesso a dados Matrix é suportado apenas no Excel 2013 e Word 2013.
Mesa Fornece os dados sobre a selecção ou obrigatório como um TableData objeto. O TableData objeto expõe os dados através dos cabeçalhos e linhas propriedades. acesso a dados tabela é suportado apenas no Excel 2013 e Word 2013.
tipo de dados coerção
Os métodos de acesso a dados no documento e Binding objetos suportam especificando o tipo de dados desejado usando o coercionType parâmetro desses métodos, e correspondente CoercionType valores de enumeração. Independentemente da forma real da ligação, as diferentes aplicações do Office suportam os tipos de dados comuns, tentando coagir os dados para o tipo de dados solicitado. Por exemplo, se uma tabela do Word ou parágrafo é selecionado, o desenvolvedor pode especificar para lê-lo como texto simples, HTML, Office Open XML, ou uma tabela, ea implementação API lida com as necessárias transformações e dados conversões.
Dica Quando você deve usar a matriz contra coercionType mesa para acesso a dados? Se você precisa de seus dados tabulares para crescer dinamicamente quando as linhas e colunas são adicionados, e você deve trabalhar com cabeçalhos de tabela, você deve usar o tipo de dados tabela (especificando o coercionType parâmetro de um documento ou Encadernação método de acesso de dados objeto como "table"ou Office.CoercionType.Table ).
Adicionando linhas e colunas dentro da estrutura de dados é suportado em ambos os dados da tabela e de matriz, mas anexando linhas e colunas é suportada apenas para os dados da tabela. Se você não está pensando em adicionar linhas e colunas, e seus dados não requer funcionalidade de cabeçalho, então você deve usar o tipo de dados de matriz (especificando o coercionType parâmetro do método de acesso a dados como "matrix"ou Office.CoercionType.Matrix ), que fornece um modelo mais simples de interagir com os dados.
Se os dados não podem ser forçado para o tipo especificado, o AsyncResult.status propriedade no retorno de chamada retorna "failed", e você pode usar o AsyncResult.error propriedade para acessar um erro objeto com informações sobre por que a chamada de método falhou.
Trabalhando com seleções usando o objeto Document
O documento objeto expõe métodos que permitem ler e escrever para a seleção atual do usuário de uma forma "pegar e esquecer". Para isso, o documento objeto fornece os getSelectedDataAsync e setSelectedDataAsync métodos.
Para exemplos de código que demonstram como realizar tarefas com as seleções, consulte Ler e escrever dados para a seleção ativa em um documento ou planilha .
Trabalhando com ligações utilizando as ligações e vinculativa objetos
Acesso a dados de ligação à base permite que o painel de conteúdo e tarefa add-ins para acessar consistentemente uma determinada região de um documento ou folha de cálculo através de um identificador associado com uma ligação. O add-in primeiras necessidades para estabelecer a ligação chamando um dos métodos que associa uma parte do documento com um identificador único: addFromPromptAsync , addFromSelectionAsync ou addFromNamedItemAsync .
Após a ligação é estabelecida, o add-in pode usar o identificador fornecido para acessar os dados contidos na região associada do documento ou planilha. Criar ligações fornece o seguinte valor para o add-in:
Permite o acesso a estruturas de dados comum em aplicativos do Office suportadas, tais como: mesas, escalas, ou de texto (uma corrida contígua de caracteres).
Permite que as operações de leitura / gravação sem exigir que o usuário faça uma seleção.
Estabelece uma relação entre o add-in e os dados do documento. Ligações são persistentes no documento, e pode ser acessado em um momento posterior.
O estabelecimento de uma ligação também permite que você se inscrever para dados e eventos de alteração de seleção que são escopo para aquela região específica do documento ou planilha. Isto significa que o add-in só é notificado das alterações que acontecem dentro da região ligados ao invés de mudanças gerais em toda a todo o documento ou planilha.
A Ligações objeto expõe um getAllAsync método que dá acesso ao conjunto de todas as ligações estabelecidas no documento ou planilha. Um indivíduo ligação pode ser acessado pelo seu ID usando o Bindings.getBindingByIdAsync ou Office.select métodos. Você pode estabelecer novas ligações, bem como remover os já existentes, usando um dos seguintes métodos da Ligações objeto: addFromSelectionAsync , addFromPromptAsync , addFromNamedItemAsync ou releaseByIdAsync .
Existem três diferentes tipos de ligações que você especificar com o bindingType parâmetro quando você cria uma ligação com as addFromSelectionAsync , addFromPromptAsync ou addFromNamedItemAsync métodos:
tipo de ligação Descrição Hospedar suporte a aplicativos
ligação de texto Liga-se a uma região do documento que pode ser representado como texto. No Word, a maioria das seleções contíguas são válidos, enquanto no Excel apenas seleções de célula única pode ser alvo de um texto vinculativo. No Excel, apenas texto simples é suportado. No Word, três formatos são suportados: texto simples, HTML e Open XML para o Office.
vinculativo Matrix Se liga a uma região fixa de um documento que contém dados tabulares sem headers.Data em uma ligação é escrito ou lido como um bidimensional matriz de matriz , que em JavaScript é implementado como um array de arrays. Por exemplo, duas fileiras de cordas valores em duas colunas pode ser escrito ou lido como , e uma única coluna de três linhas podem ser escritos ou lidos como .[['a', 'b'], ['c', 'd']][['a'], ['b'], ['c']] No Excel, qualquer selecção de células contíguas pode ser usado para estabelecer uma ligação de matriz. No Word, apenas tabelas apoiar ligação matriz.
vinculativo tabela Liga-se a uma região de um documento que contém uma tabela com headers.Data numa ligação é escrito ou lido como uma tabela TableData objecto. O TableData objeto expõe os dados através dos cabeçalhos e linhas propriedades. Qualquer tabela Excel ou Word pode ser a base para uma tabela de ligação. Depois de estabelecer uma ligação de tabela, cada nova linha ou coluna um usuário adiciona a tabela é automaticamente incluído na ligação.
Depois de uma ligação é criada usando um dos três "adicionar" métodos da Ligações objeto, você pode trabalhar com os dados e propriedades de ligação usando os métodos do objeto correspondente: MatrixBinding , TableBinding ou TextBinding . Todos os três destes objetos herdam as getDataAsync e setDataAsync métodos da Binding objeto que permitem a você interagir com os dados vinculados.
Para exemplos de código que demonstram como realizar tarefas com as ligações, consulte Ligar a regiões em um documento ou planilha .
Trabalhando com partes XML personalizado usando o CustomXmlParts e objetos CustomXmlPart
Aplica-se a: Painel de tarefas add-ins para o Word
Os CustomXmlParts e CustomXmlPart objetos da API fornecer acesso a partes XML personalizados em documentos do Word, que permitem a manipulação orientada para o XML do conteúdo do documento. Para demonstrações de trabalhar com os CustomXmlParts e CustomXmlPart objetos, consulte a palavra-Add-in-trabalho-com-custom XML-peças- exemplo de código.
Trabalhando com o documento inteiro usando o método getFileAsync
Aplica-se a: painel de tarefas suplementos para o Word e PowerPoint
O Document.getFileAsync método e membros do Arquivo e fatia objetos para fornecer funcionalidade para obtenção de toda Palavra e arquivos de documentos do PowerPoint em fatias (pedaços) de até 4 MB de cada vez. Para mais informações, consulte Como: Obter todo o conteúdo do arquivo a partir de um documento em um add-in .
objeto Caixa de Correio
Aplica-se a: Outlook add-ins
Outlook add-ins usam principalmente um subconjunto da API exposta através da caixa de correio objeto. Para acessar os objetos e membros especificamente para uso em suplementos do Outlook, como o item objeto, você usa a caixa de correio de propriedade do Contexto objeto para acessar a caixa de correio objeto, como mostrado na seguinte linha de código.
// Access the Item object.
var item = Office.context.mailbox.item;
Além disso, o Outlook add-ins pode usar os seguintes objetos:
Escritório objeto: para inicialização.
Contexto objeto: para o acesso ao conteúdo e idioma de exibição Propriedades.
RoamingSettings objeto: para salvar Outlook add-in-específica configurações personalizadas para caixa postal do usuário onde o add-in está instalado.
Para obter informações sobre o uso de JavaScript no Outlook add-ins, consulte Outlook add-ins e Visão geral do Outlook add-ins arquitetura e características .
matriz de suporte API
Esta tabela resume o API e funções suportadas através add-in tipos (conteúdo, o painel de tarefas, e Outlook) e os aplicativos do Office que podem hospedar-los quando você especificar os aplicativos host Escritório seus apoios de add-in usando o 1.1 add-in de esquema de manifesto e características apoiada por v1.1 JavaScript API para o Office .
nome do host banco de dados livro Caixa de correio Apresentação Documento Projeto
Suportadas aplicações de host aplicativos de acesso à Web ExcelExcel on-line OutlookOutlook Web AppOWA para Dispositivos PowerPointPowerPoint on-line Palavra Projeto
Suportado add-in tipos Conteúdo Y Y Y
painel de tarefas Y Y Y Y
perspectiva Y
funcionalidades de API suportadas Read / Write Texto Y Y Y Y (somente leitura)
Read / Write Matrix Y Y
Read / Write Tabela Y Y
Read / Write HTML Y
Leia / WriteOffice Open XML Y
Leia tarefa, recurso, ver e propriedades de campo Y
Seleção mudou eventos Y Y
Obter documento inteiro Y Y
Bindingsand eventos de ligação Y (Apenas ligações completas e partialtable) Y Y
Leia Peças / WriteCustom Xml Y
Persistir add-in dados do estado (configurações) Y (por host add-in) Y (por documento) Y (por caixa de correio) Y (por documento) Y (por documento)
As configurações alteradas eventos Y Y Y Y
Obter vista modeand vista activa mudou eventos Y
Navegue até locationsin o documento Y Y Y
Ative regras contextuallyusing e RegEx Y
Leia propriedades do item Y
Leia o perfil do usuário Y
obter anexos Y
Obter token de identidade do usuário Y
Chamada Exchange Web Services Y
--
Adriano José Boller
______________________________________________
Consultor e Representante Oficial da
PcSoft no Brasil
+55 (41) 9949 1800
adrianoboller@gmail.com
skype: adrianoboller
http://wxinformatica.com.br/ |
| |
| |
| | | |
|
| | | | |
| | |
| | |
| |
|
|
|