Dados do Campo Personalizado em XML

O Esquema de Intercâmbio de Dados XML do Microsoft Office Project 2007 (mspdi_pj12.xsd) altera a forma como algumas informações de campo personalizadas são representadas no XML. Este artigo descreve como o Office Project 2007 representa definições de campo personalizadas e valores de campo personalizados no formato XML.

Dados de campo personalizados

O projeto armazena informações sobre campos personalizados como um dos dois tipos:

• Definição de campo personalizado Uma definição de campo personalizada consiste em dados necessários para definir um campo personalizado local ou empresarial. Project para a Web campos personalizados locais são apresentados como campos personalizados da empresa. Esses dados incluem informações como o nome do campo personalizado, a ID do campo personalizado e o tipo de campo personalizado.

  Os elementos XML usados para armazenar definições de campo personalizadas são definidos no Esquema XML para a seção Elemento ExtendedAttributes do Esquema de Intercâmbio de Dados do Project XML.

• Valor de campo personalizado Um valor de campo personalizado são dados necessários para definir um valor específico para um campo personalizado e associá-lo a um projeto, tarefa, recurso ou atribuição. Por exemplo, você pode configurar o campo personalizado health enterprise para o valor Atrasado para uma determinada tarefa.

Este artigo inclui as seguintes seções:

• Definições de campo personalizadas no XML

• Valores de campo personalizados no XML

Definições de campo personalizadas no XML

O Project 2007 representa todas as definições de campo personalizados empresariais e locais na coleção de atributo estendido, que está contida no elemento ExtendedAttributes no arquivo de saída XML. Cada definição de campo personalizada é representada por um único elemento ExtendedAttribute e seus filhos.

O exemplo a seguir mostra a representação XML de uma coleção de atributos estendida que define dois campos personalizados. Text1 é um campo personalizado local, enquanto o Health é um campo personalizado da empresa que está pré-configurado no Projeto 2007.

<ExtendedAttributes>
    <ExtendedAttribute>
        <FieldID>188743731</FieldID>
        <FieldName>Text1</FieldName>
        <Alias>MyLocalCustomField</Alias>
        <SecondaryPID>255869028</SecondaryPID>
    </ExtendedAttribute>
    <ExtendedAttribute>
        <FieldID>188776449</FieldID>
        <FieldName>Health</FieldName>
        <CFType>7</CFType>
        <Guid>0000E8D9-65F1-4769-9BD2-819D38036FCC</Guid>
        <ElemType>20</ElemType>
        <MaxMultiValues>1</MaxMultiValues>
        <UserDef>1</UserDef>
        <SecondaryPID>255885314</SecondaryPID>
        <DefaultGuid>000079D2-4A43-41FC-B264-98D23FADD84B</DefaultGuid>
    </ExtendedAttribute>
</ExtendedAttributes>

Quando você salva um projeto como XML, todas as definições de campo personalizado locais são escritas na coleção de atributos estendidos. No entanto, você pode optar por incluir apenas os campos personalizados corporativos carregados atualmente na saída XML. A eleição para salvar apenas os itens globais corporativos atualmente carregados pode resultar em um arquivo XML menor e mais gerenciável.

Para obter mais informações sobre como salvar projetos como XML, confira Salvar e Abrir Projetos no Formato XML.

Valores de campo personalizados no XML

Quando você configura um valor específico para um campo personalizado no nível de projeto, tarefa, recurso ou atribuição, o Project 2007 grava informações sobre esse valor na seção resumo tarefa, tarefa, recurso ou atribuição da saída XML, respectivamente.

Para representar um valor de campo personalizado no XML, você deve atender aos seguintes três requisitos:

• Associe o valor de campo personalizado à entidade Project (projeto, tarefa, recurso ou atribuição) para a qual ele está configurado.

• Associe o valor de campo personalizado à definição de campo personalizada à qual ele pertence.

• Especifique o valor de campo personalizado.

As seções a seguir descrevem como o Project 2007 representa valores de campo personalizados no XML:

• Valores de campo personalizados da empresa

• Valores de campo personalizados locais

Valores de campo personalizados da empresa

No Projeto 2007, você pode configurar um número ilimitado de campos personalizados da empresa. Esse aprimoramento muda a forma como o Project 2007 armazena valores de campo personalizados corporativos no XML.

O exemplo a seguir mostra a saída XML relevante para uma tarefa que tem o campo personalizado health enterprise configurado para o valor da tabela de pesquisa Em Agendamento.

    <Task>
        ...
        <b408001>0000BB21-B2AE-410A-88B6-82C108903823</b408001>
        ...
    </Task>

Este XML atende aos três requisitos para armazenar um valor de campo personalizado no XML da seguinte maneira:

• O valor de campo personalizado é gravado na seção tarefa de resumo, tarefa, recurso ou atribuição da saída XML para a qual o valor está configurado. Isso associa o valor de campo personalizado à entidade de projeto correta, nesse caso, uma tarefa específica.

• A ID do campo personalizado é usada para vincular o valor de campo personalizado à definição de campo personalizado. A ID do campo personalizado é armazenada no elemento FieldID na definição de campo personalizado. Para o campo personalizado health enterprise, a ID do campo personalizado é 188776449.

  O nome do elemento XML que armazena o valor de campo personalizado, nesse caso, o elemento b408001, corresponde à representação hexadecimal da ID do campo personalizado. Para o campo personalizado health enterprise, o valor hexadecimal 0xb408001 é igual ao valor binário 188776449.

• O valor de campo personalizado é armazenado dentro do elemento b408001. Como o campo personalizado health enterprise é uma tabela de pesquisa, o valor de campo personalizado para On Schedule é o GUID desse valor de tabela de pesquisa, 0000BB21-B2AE-410A-88B6-82C108903823.

A Tabela 1 mostra os intervalos válidos de IDs de campo personalizadas para cada tipo de campo personalizado da empresa.

Tabela 1. IDs de campo personalizado da empresa

Como há 262.140 possíveis IDs de campo personalizado da empresa, há 262.140 nomes de elementoS XML possíveis para valores de campo personalizados. Para fins de desempenho, os elementos XML que o Project 2007 usa para armazenar valores de campo personalizados da empresa não são definidos no esquema principal de intercâmbio de dados XML do Project (mspdi_pj12.xsd). Em vez disso, esses elementos são definidos nos arquivos de esquema suplementar incluídos no download do SDK do Project 2007. Para obter um link para o download do SDK do Project 2007, confira Bem-vindo ao SDK do Microsoft Office Project 2007.

O esquema principal inclui anotações com a cadeia de caracteres pesquisável "##" para indicar o local ao qual o Project 2007 grava os elementos de valor de campo personalizado da empresa que não são definidos em mspdi_pj12.xsd.

Valores de campo personalizados locais

O Project 2007 representa valores de campo personalizados locais no XML de uma das duas maneiras. Os valores de campo personalizados locais de atribuição são gravados no XML no mesmo formato usado para valores de campo personalizados da empresa, enquanto os valores de campo personalizados locais de projeto, tarefa e recurso são gravados no XML no mesmo formato usado pelo Microsoft Office Project 2003.

As seções a seguir contêm informações mais detalhadas sobre como os valores de campo personalizados locais são representados no XML pelo Project 2007:

• Atribuir valores de campo personalizados locais no XML

• Valores de campo personalizados locais de projeto, tarefa e recurso no XML

Atribuir valores de campo personalizados locais no XML

O Project 2007 grava valores de campo personalizados locais de atribuição usando o mesmo formato que os valores de campo personalizados da empresa e atende aos três requisitos para armazenar um valor de campo personalizado no XML da mesma forma.

A Tabela 2 mostra o intervalo válido de IDs de campo personalizadas para campos personalizados locais de atribuição. O esquema de núcleo mspdi_pj12.xsd define os 200 elementos XML possíveis para atribuição de valores de campo personalizados locais.

Tabela 2. Atribuir IDs de campo personalizados locais

Valores de campo personalizados locais de projeto, tarefa e recurso no XML

O Project 2007 grava valores de campo personalizados locais de projeto, tarefa e recurso no formato mostrado no exemplo a seguir. Esse é o mesmo formato usado pelo Project 2003 para todos os valores de campo personalizados.

    <Task>
        ...
        <ExtendedAttribute>
          <FieldID>188743731</FieldID>
          <Value>This is the value of Text1</Value>
        </ExtendedAttribute>
        ...
    </Task>

Este XML atende aos três requisitos para armazenar um valor de campo personalizado no XML da seguinte maneira:

• O valor de campo personalizado é gravado na seção tarefa de resumo, tarefa, recurso ou atribuição da saída XML para a qual o valor está configurado. Isso associa o valor de campo personalizado à entidade de projeto correta, nesse caso, uma tarefa específica.

• A ID do campo personalizado é usada para vincular o valor de campo personalizado à definição de campo personalizado. A ID do campo personalizado é armazenada no elemento FieldID no XML que representa a definição de campo personalizada e o valor de campo personalizado.

• O valor de campo personalizado é armazenado dentro do elemento Value.

Consulte Também

Conceitos

Introdução aos Dados XML do Project

Elementos de Troca de Dados do Project