Método Application.MapEdit (Project)
Cria ou edita um mapa de importação/exportação.
Sintaxe
expression. MapEdit
( _Name_
, _Create_
, _OverwriteExisting_
, _NewName_
, _DataCategory_
, _CategoryEnabled_
, _TableName_
, _FieldName_
, _ExternalFieldName_
, _ExportFilter_
, _ImportMethod_
, _MergeKey_
, _HeaderRow_
, _AssignmentData_
, _TextDelimiter_
, _TextFileOrigin_
, _UseHtmlTemplate_
, _TemplateFile_
, _IncludeImage_
, _ImageFile_
)
expressão Uma variável que representa um Aplicativo objeto.
Parâmetros
Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
---|---|---|---|
Name | Opcional | String | O nome do mapa a ser editado, criado ou copiado. |
Create | Opcional | Boolean | True se Project deve criar um novo mapa. Se NewName não for especificado, o novo mapa receberá o nome especificado com o nome. Caso contrário, o novo mapa é uma cópia do mapa especificado com o nome e receberá o nome especificado em NewName. O valor padrão é False. |
OverwriteExisting | Opcional | Boolean | True se um mapa existente deve ser substituído por um novo. O valor padrão é False. |
Newname | Opcional | String | Um novo nome para o mapa existente (Criar é False) ou o nome do novo mapa copiado do mapa existente (Criar é True). Se não for especificado um NewName e Create for False, o mapa especificado com o nome manterá seu nome atual. O valor padrão é uma sequência vazia (""). |
DataCategory | Opcional | Longo | A categoria de dados que serão modificadas por outros argumentos. Obrigatório se qualquer um dos CategoryEnabled, TableName, FieldName, ExternalFieldName, ExportFilter ou MergeKey especificado. Pode ser uma das seguintes constantes PjDataCategories: pjMapTasks, pjMapResources ou pjMapAssignments. |
CategoryEnabled | Opcional | Boolean | True se o mapa importa e exporta a categoria de dados especificada com DataCategory. Se Create for True e NewName não for especificado, CategoryEnabled será definida como True. |
TableName | Opcional | String | O nome da tabela externa ou planilha que o mapa importa dados do ou exporta dados. O tipo de tabela é determinado pelo valor de DataCategory. Se Create for True e NewName não for especificado, TableName é necessário. |
FieldName | Opcional | String | O nome de um campo a ser adicionado ao mapa. O campo é mapeado para o campo externo especificado com ExternalFieldName. O tipo de campo é determinado pelo valor de DataCategory. Se Create for True e NewName não for especificado, FieldName é necessária. |
ExternalFieldName | Opcional | String | O nome do campo externo a ser adicionado ao mapa. O campo externo é mapeado para o campo especificado em FieldName. Se ExternalFieldName não for especificado, o nome especificado em FieldName também será usado para ExternalFieldName. |
ExportFilter | Opcional | String | O nome do filtro a ser usado na exportação de dados. O tipo de filtro é determinado pelo valor de DataCategory. O valor padrão é "Todas as tarefas" quando DataCategory é pjMapTasks, "Todos os recursos" quando DataCategory é pjMapResources e ExportFilter é ignorado quando DataCategory é pjMapAssignments. |
Importmethod | Opcional | Long | O método a ser usado ao importar dados. Pode ser uma das seguintes constantes PjImportMethods. O valor padrão é pjImportNew. |
MergeKey | Opcional | String | O nome do campo do projeto a ser usado como uma chave ao mesclar os dados importados. O campo deve existir e já foram adicionado para o mapa. O tipo de campo é determinado pelo valor de DataCategory. Se ImportMethod for pjImportMerge, MergeKey é necessária. |
Headerrow | Opcional | Boolean | True se uma linha de cabeçalho de coluna deve ser criada no arquivo externo durante uma exportação e se ele existir no arquivo externo durante uma importação. Se criar um mapa sem cabeçalho (HeaderRow é False) que será usado para importar os mesmos dados exportados, ExternalFieldName será necessário e deve ser um valor numerado sequencialmente para cada campo exportado, começando com "1", para indicar sua posição de coluna no arquivo exportado. O valor padrão é True. |
AssignmentData | Opcional | Boolean | True se linhas de atribuição devem ser incluídas com recursos e tarefas exportadas. Se True, atribuído recursos aparecem em cada tarefa em uma tabela de tarefas e tarefas atribuídas aparecem sob cada recurso em uma tabela de recursos. Dados exportados quando AssignmentData for verdadeira não podem ser importados por projeto. O valor padrão é False. |
TextDelimiter | Opcional | String | O caractere a ser usado como delimitador de campo durante a importação de dados de um arquivo de texto. O valor padrão é um caractere de tabulação. |
TextFileOrigin | Opcional | Long | Especifica o conjunto de caracteres com um arquivo de texto que foi criado. Pode ser uma das seguintes constantes PjTextFileOrigin: pjTextOriginWin, pjTextOriginDOS, pjTextOriginUnicode ou pjTextOriginMac. |
UseHtmlTemplate | Opcional | Boolean | True se uma exportação para um arquivo HTML será baseada em um modelo HTML. |
TemplateFile | Opcional | String | O arquivo de modelo HTML a ser usado ao exportar para HTML. Se UseHtmlTemplate for verdadeiro, e o mapa especificado com o nome não contém o nome de um arquivo de modelo HTML, TemplateFile é necessária. |
IncludeImage | Opcional | Boolean | True se uma referência para um arquivo de imagem deve ser incluída na exportação para HTML. O valor padrão é False. |
ImageFile | Opcional | String | O nome de um arquivo de imagem a ser incluído na exportação para HTML. |
Valor de retorno
Boolean
Exemplo
O exemplo a seguir cria um mapa simples que permite que as informações do gráfico de Gantt padrão sejam exportadas e importadas.
Sub MakeEntryTableMap()
MapEdit Name:="Fields in the Gantt Chart View", Create:=True, OverwriteExisting:=True, _
DataCategory:=pjMapTasks, CategoryEnabled:=True, TableName:="Task_Table", _
FieldName:="ID", ExternalFieldName:="ID"
MapEdit Name:="Fields in the Gantt Chart View", DataCategory:=pjMapTasks, _
FieldName:="Name", ExternalFieldName:="Tasks"
MapEdit Name:="Fields in the Gantt Chart View", DataCategory:=pjMapTasks, _
FieldName:="Duration"
MapEdit Name:="Fields in the Gantt Chart View", DataCategory:=pjMapTasks, _
FieldName:="Start", ExternalFieldName:="Start_Date"
MapEdit Name:="Fields in the Gantt Chart View", DataCategory:=pjMapTasks, _
FieldName:="Finish", ExternalFieldName:="Finish_Date"
MapEdit Name:="Fields in the Gantt Chart View", DataCategory:=pjMapTasks, _
FieldName:="Predecessors"
MapEdit Name:="Fields in the Gantt Chart View", DataCategory:=pjMapTasks, _
FieldName:="Resource Names", ExternalFieldName:="Resources"
End Sub
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.