Méthode Application.MapEdit (Project)
Crée ou modifie un mappage d’importation/exportation.
Syntaxe
expression. MapEdit( _Name_, _Create_, _OverwriteExisting_, _NewName_, _DataCategory_, _CategoryEnabled_, _TableName_, _FieldName_, _ExternalFieldName_, _ExportFilter_, _ImportMethod_, _MergeKey_, _HeaderRow_, _AssignmentData_, _TextDelimiter_, _TextFileOrigin_, _UseHtmlTemplate_, _TemplateFile_, _IncludeImage_, _ImageFile_ )
expressionUne variable qui représente un objetApplication.
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| Name | Facultatif | String | Nom du mappage à créer, copier ou modifier. |
| Create | Facultatif | Boolean | True si Project doit créer un mappage. Si NewName n’est pas spécifié, le nom indiqué dans Name est attribué au nouveau mappage. Sinon, le nouveau mappage est une copie de celui spécifié dans Name et le nom indiqué dans NewName lui est attribué. La valeur par défaut est False. |
| OverwriteExisting | Facultatif | Boolean | True si un mappage existant doit être remplacé par un nouveau. La valeur par défaut est False. |
| Newname | Facultatif | String | Un nouveau nom pour la carte existante (Create a la valeur False) ou le nom de la nouvelle carte copiée à partir de la carte existante (Create a la valeur True). Si NewName n’est pas spécifié et que Create a la valeur False, le mappage spécifié par Name conserve son nom actuel. La valeur par défaut est une chaîne vide (""). |
| DataCategory | Facultatif | Long | Catégorie de données qui vont être modifiées par d’autres arguments. Obligatoire dans le cas où l’un des arguments suivants (CategoryEnabled, TableName, FieldName, ExternalFieldName, ExportFilter ou MergeKey) est spécifié. Il peut s’agir de l’une des constantes PjDataCategories suivantes : pjMapTasks, pjMapResources ou pjMapAssignments. |
| CategoryEnabled | Facultatif | Boolean | True si la carte importe et exporte la catégorie de données spécifiée avec DataCategory. Si Create a la valeur True et que NewName n’est pas spécifié, CategoryEnabled prend la valeur True. |
| TableName | Facultatif | String | Nom de la table externe ou de la feuille de calcul à partir de laquelle le mappage importe les données ou vers laquelle il exporte les données. Le type de table est déterminé par la valeur de DataCategory. Si Create est True et que NewName n’est pas spécifié, TableName est obligatoire. |
| FieldName | Facultatif | String | Nom du champ à ajouter au mappage. Ce champ correspond au champ externe spécifié par ExternalFieldName. Le type de champ est déterminé par la valeur de DataCategory. Si Create est True et que NewName n’est pas spécifié, FieldName est obligatoire. |
| ExternalFieldName | Facultatif | String | Nom du champ externe à ajouter au mappage. Le champ externe correspond au champ spécifié par FieldName. Si vous ne spécifiez pas ExternalFieldName, le nom spécifié par FieldName est également utilisé pour ExternalFieldName. |
| ExportFilter | Facultatif | String | Nom du filtre à utiliser lors de l’exportation des données. Le type du filtre est déterminé par la valeur de DataCategory. La valeur par défaut est « Toutes les tâches » lorsque DataCategory a la valeur pjMapTasks, « Toutes les ressources » lorsque DataCategory a la valeur pjMapResources, ExportFilter étant ignoré lorsque DataCategory a la valeur pjMapAssignments. |
| ImportMethod | Facultatif | Long | Méthode à utiliser lors de l’importation de données. Il peut s’agir de l’une des constantes PjImportMethods . La valeur par défaut est pjImportNew. |
| MergeKey | Facultatif | String | Nom du champ projet à utiliser comme clé lors de la fusion des données importées. Ce champ doit exister et avoir déjà été ajouté au mappage. Le type de champ est déterminé par la valeur de DataCategory. Si ImportMethod a la valeur pjImportMerge, MergeKey est requis. |
| HeaderRow | Facultatif | Boolean | True si une ligne d’en-tête de colonne doit être créée dans le fichier externe au cours d’une exportation et si elle existe dans le fichier externe au cours d’une importation. Si vous créez un mappage sans en-tête (HeaderRow a la valeur False) qui sera utilisé pour importer les mêmes données qu’il exporte, ExternalFieldName est obligatoire et doit être une valeur numérotée séquentiellement pour chaque champ exporté, en commençant par « 1 », pour indiquer sa position de colonne dans le fichier exporté. La valeur par défaut est True. |
| AssignmentData | Facultatif | Boolean | True si les lignes d’affectation doivent être incluses avec les ressources et les tâches exportées. Si l’argument a la valeur True, les ressources affectées s’affichent sous chaque tâche dans une table de tâches et les tâches affectées s’affichent sous chaque ressource dans une table de ressources. Les données exportées lorsque AssignmentData a la valeur True ne peuvent pas être importées par Project. La valeur par défaut est False. |
| TextDelimiter | Facultatif | String | Caractère à utiliser comme délimiteur de champ lors de l’importation des données à partir d’un fichier texte. La valeur par défaut est le caractère de tabulation. |
| TextFileOrigin | Facultatif | Long | Indique le jeu de caractères avec lequel le fichier texte a été créé. Il peut s’agir de l’une des constantes PjTextFileOrigin Suivantes : pjTextOriginWin, pjTextOriginDOS, pjTextOriginUnicode ou pjTextOriginMac. |
| UseHtmlTemplate | Facultatif | Boolean | True dans le cas où l’exportation vers un fichier HTML est basée sur un modèle HTML. |
| TemplateFile | Facultatif | String | Fichier modèle HTML à utiliser lors de l’exportation en HTML. Si UseHtmlTemplate a la valeur True et que le mappage spécifié par Name ne contient pas le nom d’un fichier modèle HTML, TemplateFile est obligatoire. |
| IncludeImage | Facultatif | Boolean | True si une référence à un fichier image doit être incluse lors de l’exportation en HTML. La valeur par défaut est False. |
| Imagefile | Facultatif | String | Nom du fichier image à inclure lors de l’exportation en HTML. |
Valeur renvoyée
Boolean
Exemple
L’exemple suivant montre comment créer un mappage simple qui permet l’exportation et l’importation des informations sur le Diagramme de Gantt par défaut.
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
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.