Páginas configurações de Configuração do conversor personalizado

Artigo
09/26/2008

Se seu personalizado conversor documento requer um personalizado interface configuração, você pode criar e especificar um personalizado página .aspx para essa finalidade. Esta página poderia substituir a página Configurações configuração usar como padrão documento incluída no Microsoft Office do SharePoint Server 2007.

Dica

Se você precisar coletar informações adicionais a partir de administrador somente durante configuração, você pode especificar um personalizado controle .ascx para hospedar sobre a página Configurações configuração usar como padrão documento incluída no O Office SharePoint Server 2007.Essa abordagem permite que você use a página Configurações configuração usar como padrão documento conversor, em vez precisar desenvolver uma forma de substituição.Para obter mais informações, consulte Controles configurações adicionais do conversor.

Os administradores podem usar seu personalizado página para especificar as configurações configuração para cada tipo de conteúdo que usa o conversor. Essas configurações conversor CONTENT_TYPE-specific são passadas para o conversor documento quando o usuário seleciona para converter um documento do que tipo de conteúdo. A página Configurações configuração conversor usar como padrão que está incluída O Office SharePoint Server 2007 contém codificar que passa as configurações CONTENT_TYPE-specific conversor.

Para especificar um personalizado página Configurações configuração conversor, defina o elemento ConverterSettingsForContentType ConverterSettingsForContentType de definição conversor de documento com o nome arquivo da página .aspx você desejar usar. Este é um opcional elemento; Se você não for incluído-lo na sua definição conversor, nenhuma página configuração conversor está disponível para esse conversor.

Para obter mais informações sobre definição conversor de documento, consulte Documento converter definição de esquema.

O Office SharePoint Server 2007 passa as seguinte informações para a página Configurações configuração conversor quando um usuário navega para ele:

ctype representa o tipo de conteúdo identificação do tipo de conteúdo para os quais o usuário deseja configurar este conversor.
Converter representa o GUID do conversor o usuário deseja configurar.
OriginalSource representa a URL da página da qual o usuário navegar. Este parâmetro não é usado neste contexto e pode ser ignorado.

Por exemplo:

http://example-ts/_layouts/ConverterSettings.aspx?ctype=0x0101&Converter=6dfdc5b4%2D2a28%2D4a06%2Db0c6%2Dad3901e3a807&OriginalSource=http%3A%2F%2Fexample%2Dts%2FDocuments%2FForms%2FAllItems%2Easpx

A página você especificar deve conter codificar para fazer o seguinte:
1. Formate as configurações configuração reunidas pela página em um documento XML.
  
  Para o conversor para fornecer informações a configuração necessária para pós-processamento conversão documento, ele deve armazenar suas configurações configuração na tipo de conteúdo especificado de acordo com o seguinte esquema.
```
<rca:RCAuthoringProperties xmlns:rca="urn:sharePointPublishingRcaProperties">
  <rca:Converter rca:guid="6dfdc5b4-2a28-4a06-b0c6-ad3901e3a807">
    <rca:property rca:type="InheritParentSettings">True</rca:property>
    <rca:property rca:type="SelectedPageLayout">30</rca:property>
    <rca:property rca:type="SelectedPageField">f55c4d88-1f2e-4ad9-
      aaa8-819af4ee7ee8</rca:property>
    <rca:property rca:type="SelectedStylesField">a932ec3f-94c1-48b1-
      b6dc-41aaa6eb7e54</rca:property>
    <rca:property 
      rca:type="CreatePageWithSourceDocument">True</rca:property>
    <rca:property 
      rca:type="AllowChangeLocationConfig">True</rca:property>
    <rca:property rca:type="ConfiguredPageLocation"></rca:property>
    <rca:property rca:type="CreateSynchronously">True</rca:property>
    <rca:property 
      rca:type="AllowChangeProcessingConfig">True</rca:property>
    <rca:property rca:type="ConverterSpecificSettings"></rca:property>
  </rca:Converter>
</rca:RCAuthoringProperties>
```
  Na acima representam os elementos exemplo, o vários opções disponível na página Configurações configuração conversor de usar como padrão. O elemento ConverterSpecificSettings ConverterSpecificSettings representa as configurações configuração gravadas pelo controle de .ascx converter-specific, se houver uma. Para obter mais informações, consulte Controles configurações adicionais do conversor. Além disso, o elemento ConfiguredPageLocation ConfiguredPageLocation está vazio, especificando que O Office SharePoint Server 2007 deve usar o atual site.
2. Gravar essa configuração XML o apropriado definição tipo de conteúdo como um nó XMLDocument.
  
  De exemplo, a seguinte definição tipo de conteúdo a site, após ter construída o apropriado atualiza codificar documento XML, conforme mostrado anteriormente:
```
// Delete the previous instance of this document if it already exists.
myContentType.XmlDocuments.Delete(RcaPropertiesNamespaceUri);
myContentType.XmlDocuments.Add(this.myXmlDocument);
myContentType.Update();
```

Os dados configurações configuração podem ser qualquer XML bem formado que o conversor documento pode analisar. O Office SharePoint Server 2007 não analisa as informações próprio, mas simplesmente permite que você para armazenar esse XML dentro de definição tipo de conteúdo para que ele mais tarde pode ser passado para conversor de documento.

Esteja ciente que se você especificar uma página Configurações configuração conversor, você também deve especificar um personalizado página .aspx para interface de usuário para invocar esse conversor documento. A página usar como padrão para chamar conversões documento não transmitir quaisquer configurações configuração para os conversores selecionados. Para obter mais informações, consulte Páginas Configurações de conversão personalizados.

Hospedando um controle configurações converter personalizado

Para habilitar personalizado conversor configurações controles, a página que invoca o conversor documento deve conter codificar para fazer isso.

De exemplo, a seguinte codificar, colocado no OnLoad onload função da página, adiciona um personalizado controle as configurações conversor para a página, se um controle personalizado for especificada.

O seguinte exemplo requer dois membros na code-behind file:

Um membro nomeado customControl do tipo System.Web.UI.Control

Um membro nomeado customConverterControl de tipo System.Web.UI.WebControls.PlaceHolder, bem como um correspondente espaço reservado na página .aspx

if (!String.IsNullOrEmpty(myTransformer.ConverterSpecificSettingsUI))
{
  this.customControl = 
    LoadControl(myTransformer.ConverterSpecificSettingsUI);
  this.customConverterControl = this.customControl as 
    IDocumentConverterControl;
  if (this.customConverterControl != null)
  {
    this.converterSpecificControl.Controls.Add(this.customControl);
  }
}

Em seguida, a codificar aplica as configurações existentes do personalizado controle as configurações conversor.

// Set up the converter-specific control and retrieve the settings.
if (this.customConverterControl != null)
{
  this.customConverterControl.ContentType = this.CurrentContentType;
  this.customConverterControl.ConverterSettings = 
      this.effectiveRcaProperties.ConverterSpecificSettings; 
}

Finalmente, a seguinte exemplo de código, colocados no OnOK OnOK função da página, persistir o personalizado configurações conversor voltar para a definição site tipo de conteúdo. Observe que a codificar define o tipo de conteúdo para fornecer mais informações contexto o controle.

// Persist the converter-specific settings.
if (this.converterSpecificControl.Controls.Count > 0)
{
  if (this.customConverterControl != null)
  {
    this.customConverterControl.ContentType = this.CurrentContentType;
    this.myRcaProperties.ConverterSpecificSettings = 
      this.customConverterControl.ConverterSettings; 
// Store this string in the content type properties as converter specific settings.
  }
}

Requisitos de configuração conversor

É uma recomendação incluir codificar que determina se o conversor requer configuração e em caso afirmativo, para exibir o apropriado mensagem de erro. Este codificar pode variar bastante depending on a implementação da página.

Consulte também

Outros recursos

Visão geral sobre Conversores de documentos
Conversores de documentos
Implantação converter de documentos
Documento converter definição de esquema
Controles configurações adicionais do conversor
Páginas Configurações de conversão personalizados

Compartilhar via

Páginas configurações de Configuração do conversor personalizado

Hospedando um controle configurações converter personalizado

Requisitos de configuração conversor

Consulte também

Outros recursos

Recursos adicionais