Compartilhar via


Uso do manifesto de transferência

O Assistente de Publicação na Web e o Assistente de Ordenação de Impressão Online usam o manifesto de transferência para comunicar detalhes da transferência de dados entre o computador cliente e o site do servidor.

O objetivo do manifesto de transferência

O manifesto de transferência descreve os arquivos envolvidos na transferência, incluindo detalhes como a hierarquia de destino e os metadados do arquivo. O script do lado do servidor pode modificar o manifesto removendo arquivos inadequados da lista e adicionando informações sobre como e para onde os arquivos devem ser transferidos.

O manifesto é exposto como a propriedade window.external.Property("TransferManifest"), um documento DOM (Modelo de Objeto do Documento) XML. Para obter mais informações sobre o XML DOM, consulte IXMLDOMDocument/DOMDocument.

A organização de nível superior do manifesto de transferência é a seguinte:

<transfermanifest>
    <filelist/>
    <folderlist/>
    <uploadinfo/>
</transfermanifest>

A página HTML do lado do servidor pode usar os nós no manifesto para obter determinadas informações sobre os arquivos a serem copiados e, em seguida, modificar a interface do usuário do serviço de acordo. Por exemplo, um site de impressão de fotos pode usar as informações para exibir miniaturas das imagens escolhidas, enquanto um site de armazenamento pode usar as informações para garantir que haja espaço de armazenamento suficiente disponível para esse usuário. Para obter informações completas sobre os nós e atributos do manifesto de transferência, consulte Esquema do manifesto de transferência.

O esquema do manifesto de transferência é gravado como um modelo aberto para que elementos não especificamente definidos no esquema possam aparecer no manifesto de transferência. Portanto, um site de provedor pode adicionar elementos proprietários para seu próprio uso sem perturbar a validade do manifesto. O esquema também é definido para que a ordem dos elementos não seja restrita.

Observação

O manifesto é recriado sempre que um novo provedor é escolhido para que o provedor tenha a chance de armazenar informações do site do manifesto.

 

Esquema do manifesto de transferência