Метод Application.MapEdit (Project)

Статья
04/07/2023

Создает или изменяет карту импорта и экспорта.

Синтаксис

выражение. MapEdit( _Name_, _Create_, _OverwriteExisting_, _NewName_, _DataCategory_, _CategoryEnabled_, _TableName_, _FieldName_, _ExternalFieldName_, _ExportFilter_, _ImportMethod_, _MergeKey_, _HeaderRow_, _AssignmentData_, _TextDelimiter_, _TextFileOrigin_, _UseHtmlTemplate_, _TemplateFile_, _IncludeImage_, _ImageFile_ )

выражение: переменная, представляющая объект Application.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Name	Необязательно заполнять.	String	Имя карты для создания, копирования или изменения.
Создание	Необязательный	Логический	Значение true, если Project должен создать новую карту. Если newName не задано, новой карте присваивается имя, указанное с помощью имени. В противном случае новая карта является копией карты, указанной в поле Имя, и получает имя, указанное с помощью NewName. Значение по умолчанию — False.
OverwriteExisting	Необязательный	Логический	Значение true , если существующая карта должна быть перезаписана новой. Значение по умолчанию — False.
Newname	Необязательный	String	Новое имя для существующей карты (Create — False) или имя новой карты, скопированной из существующей карты (Create is True). Если параметр NewName не указан, а параметр Create имеет значение False, карта, указанная с помощью Имени, сохраняет свое текущее имя. Значение по умолчанию — пустая строка ("").
DataCategory	Необязательный	Long	Категория данных, которые будут изменены другими аргументами. Обязательный параметр, если указаны categoryEnabled, TableName, FieldName, ExternalFieldName, ExportFilter или MergeKey. Может быть одной из следующих констант PjDataCategories : pjMapTasks, pjMapResources или pjMapAssignments.
CategoryEnabled	Необязательный	Логический	Значение true , если карта импортирует и экспортирует категорию данных, указанную с помощью DataCategory. Если параметр Create имеет значение True , а NewName не задан, параметр CategoryEnabled имеет значение True.
TableName	Необязательный	String	Имя внешней таблицы или листа, из которые карта импортирует данные или экспортирует данные. Тип таблицы определяется значением DataCategory. Если значение Create имеет значение True , а NewName не указано, требуется значение TableName.
FieldName	Необязательный	String	Имя поля, добавляемого на карту. Поле сопоставляется с внешним полем, указанным в параметре ExternalFieldName. Тип поля определяется значением DataCategory. Если параметр Create имеет значение True , а NewName не задан, то fieldName является обязательным.
ExternalFieldName	Необязательный	String	Имя внешнего поля, добавляемого на карту. Внешнее поле сопоставляется с полем, указанным параметром FieldName. Если значение ExternalFieldName не указано, имя, указанное в параметре FieldName, также используется для ExternalFieldName.
ExportFilter	Необязательный	String	Имя фильтра, используемого при экспорте данных. Тип фильтра определяется значением DataCategory. Значение по умолчанию — "Все задачи", если DataCategory — pjMapTasks, "Все ресурсы", если DataCategory — pjMapResources, и ExportFilter игнорируется, если DataCategory — pjMapAssignments.
ImportMethod	Необязательный	Long	Метод, используемый при импорте данных. Может быть одной из констант PjImportMethods . Значение по умолчанию — pjImportNew.
MergeKey	Необязательный	String	Имя поля проекта, используемого в качестве ключа при слиянии импортированных данных. Поле должно существовать и уже добавлено на карту. Тип поля определяется значением DataCategory. Если параметр ImportMethod имеет значение pjImportMerge, требуется mergeKey.
HeaderRow	Необязательный	Логический	Значение true , если строка заголовка столбца должна быть создана во внешнем файле во время экспорта и существует ли она во внешнем файле во время импорта. При создании карты без заголовков (HeaderRow имеет значение False), которая будет использоваться для импорта экспортируемых данных, Значение ExternalFieldName является обязательным и должно быть последовательным нумерованным значением для каждого экспортированного поля, начиная с "1", чтобы указать положение столбца в экспортируемом файле. Значение по умолчанию — True.
AssignmentData	Необязательный	Логический	Значение true, если строки назначения должны быть включены в экспортированные ресурсы и задачи. Если задано значение True, назначенные ресурсы отображаются под каждой задачей в таблице задач, а назначенные задачи — под каждым ресурсом в таблице ресурсов. Данные, экспортированные при значении AssignmentData true , невозможно импортировать в Project. Значение по умолчанию — False.
TextDelimiter	Необязательный	String	Символ, используемый в качестве разделителя полей при импорте данных из текстового файла. Значение по умолчанию — символ табуляции.
TextFileOrigin	Необязательный	Long	Указывает набор символов, под которым был создан текстовый файл. Может быть одной из следующих констант PjTextFileOrigin : pjTextOriginWin, pjTextOriginDOS, pjTextOriginUnicode или pjTextOriginMac.
UseHtmlTemplate	Необязательный	Логический	Значение true , если экспорт в HTML-файл будет основан на шаблоне HTML.
TemplateFile	Необязательный	String	HTML-файл шаблона, используемый при экспорте в HTML. Если параметр UseHtmlTemplate имеет значение True , а карта, указанная в поле Имя, не содержит имя файла шаблона HTML, необходимо использовать TemplateFile.
IncludeImage	Необязательный	Логический	Значение true , если при экспорте в HTML следует включить ссылку на файл изображения. Значение по умолчанию — False.
ImageFile	Необязательный	String	Имя файла изображения, включаемого при экспорте в HTML.

Возвращаемое значение

Boolean

Пример

В следующем примере создается простая карта, которая позволяет экспортировать и импортировать сведения о диаграмме Ганта по умолчанию.

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

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.