Метод Application.MapEdit (Project)
Создает или изменяет карту импорта и экспорта.
Синтаксис
выражение. 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 и обратная связь.