Préparer et Soumettre des Listes d’Articles à STACK (TE)

Les Items peuvent être importés directement dans une bibliothèque personnalisée (Custom Library) à l'aide d'un fichier CSV ou XLSX. L'importation d'Items offre un moyen efficace de créer ou de mettre à jour plusieurs Items, coûts et structures de dossiers sans avoir à les saisir un à un.

Le processus d'importation valide le fichier avant d'apporter tout changement. Les erreurs peuvent être révisées et corrigées avant de terminer l'importation.

Le processus de préparation des données d'Items et de leur envoi à STACK pour importation comprend les étapes suivantes:

  1. Télécharger un gabarit d'importation d'Items (Item Import Template) à partir de cet article (voir Télécharger un gabarit d'importation d'Items).
  2. Saisir les données des Items dans le gabarit.
  3. Enregistrer le fichier au format CSV UTF-8.
  4. Soumettre une demande d'assistance pour faire importer vos Items.

Informations clés

  • Les Items ne peuvent être importés que dans une bibliothèque personnalisée (Custom Library).
  • Les bibliothèques fournies par STACK, y compris Quick Start, STACK, 1build et BNi, ne peuvent pas être modifiées.
  • Les fichiers CSV et XLSX sont tous deux acceptés pour l'importation.
  • Un gabarit d'importation d'Items peut être téléchargé à partir des paramètres de la bibliothèque (Library Settings).
  • Les fichiers sont validés avant l'importation. Les erreurs relevées doivent être corrigées avant de pouvoir terminer l'importation.
  • Les structures de dossiers peuvent être créées et gérées à partir du fichier d'importation.
  • Les éléments existants sont mis à jour lorsque le nom de l’élément et la structure des dossiers correspondent.
  • Les mises à jour peuvent avoir une incidence sur les projets actuels et futurs.
  • External ID a été renommé Item Number.

Planifier l'importation

Avant de préparer le fichier d'importation:

  • Remplissez tous les champs obligatoires.
  • Ne modifiez pas les en-têtes de colonnes.
  • N'incluez pas de lignes vides ou masquées.
  • Assurez-vous que les valeurs numériques respectent le format pris en charge.
  • Assurez-vous que les niveaux de dossier sont saisis dans l'ordre.
  • Assurez-vous que chaque type de coût (Cost Type) comporte le coût unitaire (Unit Cost) requis.
  • Si vous utilisez un fichier CSV, enregistrez-le au format CSV UTF-8.
  • Les fichiers XLSX peuvent être téléversés sans être convertis en CSV.

NOTE
Les modifications apportées aux Items existants peuvent se répercuter sur les projets actuels et futurs. Enregistrez des copies des rapports et Estimates pertinents avant l'importation, au besoin.


Télécharger un gabarit d'importation d'Items

Téléchargez un gabarit d'importation d'Items propre à un corps de métier à partir de cet article, remplissez-le, enregistrez-le au format CSV UTF-8, puis envoyez-le à STACK pour importation.

DownloadTemplates.gif

NOTE
Les gabarits propres à un corps de métier comprennent les colonnes couramment utilisées pour ce corps de métier. Tous les gabarits utilisent la même structure d'importation.

CONSEIL
Choisissez le gabarit qui correspond le mieux aux Items à importer.

NOTE
Les gabarits doivent être remplis et enregistrés au format CSV UTF-8 avant l'envoi.


Importer des Items dans une bibliothèque

Les Items peuvent être importés directement dans une bibliothèque personnalisée (Custom Library) à l'aide d'un fichier CSV ou XLSX rempli. STACK valide le fichier avant de terminer l'importation, ce qui permet de réviser et de corriger les erreurs avant l'ajout ou la mise à jour des Items et des structures de dossiers.

SelfImportItems.gif

  1. Ouvrez un projet.
  2. Cliquez sur LIBRARIES (Bibliothèques).
  3. Sélectionnez la bibliothèque personnalisée (Custom Library) dans laquelle les Items seront importés.
  4. Cliquez sur l'icône d'engrenage Settings (Paramètres).
  5. Ouvrez l'option d'importation d'Items.
  6. Téléversez le fichier CSV ou XLSX rempli.
  7. Passez en revue les résultats de la validation.
  8. Corrigez les erreurs relevées et téléversez de nouveau le fichier révisé, au besoin.
  9. Terminez l'importation.
  10. Une fois l'importation terminée, les Items et la structure de dossiers correspondante apparaissent dans la bibliothèque personnalisée sélectionnée.

Vérifier les erreurs d'importation

STACK valide le fichier avant d'importer tout Item. Les messages de validation signalent les valeurs manquantes, invalides ou non prises en charge dans le fichier d'importation.

  1. Passez en revue les erreurs de validation affichées.
  2. Ouvrez le fichier d'importation.
  3. Corrigez les champs signalés.
  4. Enregistrez le fichier mis à jour.
  5. Téléversez de nouveau le fichier.
  6. Répétez le processus jusqu'à ce que le fichier passe la validation.

NOTE
Aucun Item n'est importé tant que les erreurs de validation requises n'ont pas été corrigées.


Guide du gabarit d'importation d'Items

Ces tableaux décrivent les colonnes du gabarit d'importation d'Items et la façon de remplir chaque champ.

CONSEIL
Commencez par un petit groupe d'Items pour valider le format avant de soumettre une importation complète.

NOTE
Des limites de caractères s'appliquent lors de l'importation. Les valeurs qui dépassent ces limites provoqueront des erreurs.

Avant l'importation

  • Définissez la structure de dossiers et la convention de dénomination de la bibliothèque. Consultez le gabarit d'importation d'Items propre au corps de métier pour des exemples de convention de dénomination.
  • Assurez-vous que tous les champs obligatoires sont remplis
  • Ne modifiez pas les en-têtes de colonnes
  • N'incluez pas de lignes vides ou masquées
  • Vérifiez que le fichier est enregistré au format CSV UTF-8
  • Coverage Rate Purchase doit être un nombre positif
  • Coverage Rate Measured peut être négatif, mais ne peut pas être zéro

Champs de l'Item

Ces champs définissent les détails de l'Item saisis dans le gabarit d'importation d'Items.

Colonne Champ Description de la valeur acceptée Exemple
A ItemName Obligatoire, texte (150 caractères max.) Shingles (Metal)
B ItemDescription Facultatif, texte (500 caractères max.) 24 Gauge Aluminum
C PurchaseUnit Obligatoire, texte (50 caractères max.) Sq
D UnitOfMeasure Obligatoire. Utilisez l'une des valeurs suivantes: sq ft, lin ft, cu yd, m, sq m, cu m, each sq ft
E CoverageRatePurchase Obligatoire, numérique. La valeur par défaut est 1 si le champ est laissé vide 1
F CoverageRateMeasured Obligatoire, numérique 100
G FolderLevel1 Facultatif, texte (100 caractères max.) Roofing
H FolderLevel2 Facultatif, texte (100 caractères max.) Shingle
I FolderLevel3 Facultatif, texte (100 caractères max.) Shingle (Metal)
J FolderLevel4 Facultatif, texte (100 caractères max.) Aluminum
K FolderLevel5 Facultatif, texte (100 caractères max.) Premium

Détails de l'Item

Ces champs correspondent aux détails de l'Item dans STACK.

Voici comment l'Item apparaît dans STACK.

ItemDetails.png

Import File.png

Niveaux de dossier

  • Les niveaux de dossier sont facultatifs
  • Ils doivent être remplis dans l'ordre (aucun niveau ne peut être omis)
  • Les Items sont placés au niveau le plus profond indiqué

Exemple: Si FolderLevel4 est saisi, FolderLevel1 à 3 doivent également être saisis.

Ces champs déterminent la façon dont les Items sont organisés dans votre bibliothèque.

Voici comment la structure de dossiers apparaît dans STACK.

FolderLevels.png


Types de coût (Cost Types)

Ces champs définissent les types de coût, les coûts unitaires et les codes comptables (Accounting Code) de chaque Item.

Colonne Champ Description de la valeur acceptée Exemple
L CostType1 Obligatoire, texte (Equipment, Labor, Material, Subcontract ou personnalisé) Material
M UnitCost1 Obligatoire, numérique (peut être 0 si aucun coût ne s'applique) 10
N AccountingCode1 Facultatif, texte (250 caractères max.) 6409-07
O CostType2 Facultatif, texte Labor
P UnitCost2 Obligatoire si CostType2 est saisi, numérique 25
Q AccountingCode2 Facultatif, texte 5409-08
R CostType3 Facultatif, texte  
S UnitCost3 Obligatoire si CostType3 est saisi, numérique  
T AccountingCode3 Facultatif, texte  
U CostType4 Facultatif, texte  
V UnitCost4 Obligatoire si CostType4 est saisi, numérique  
W AccountingCode4 Facultatif, texte  
X CostType5 Facultatif, texte  
Y UnitCost5 Obligatoire si CostType5 est saisi, numérique  
Z AccountingCode5 Facultatif, texte  

Détails des types de coût

Ces champs correspondent aux détails des types de coût (Cost Type) dans STACK.

Voici comment les types de coût apparaissent dans STACK.

CostTypeDetails2.png

Règles des types de coût

  • Au moins un type de coût est requis
  • Jusqu'à cinq types de coût peuvent être ajoutés par Item
  • Chaque type de coût peut comporter un coût unitaire et un code comptable

Mettre à jour des Items existants

L'importation en bloc peut être utilisée pour mettre à jour des Items existants, y compris leurs détails, leurs coûts et leur emplacement dans la bibliothèque.

Les éléments existants sont mis en correspondance à l’aide de l’Export ID inclus dans le fichier exporté. Conservez ces valeurs inchangées afin que STACK puisse repérer et mettre à jour le bon Item.

Les informations suivantes peuvent être mises à jour:

  • Item Name
  • Item Description
  • Purchase Unit
  • Unit of Measure
  • Coverage Rates
  • Emplacement du dossier
  • Types de coût (Cost Types)
  • Coûts unitaires (Unit Costs)
  • Codes comptables (Accounting Codes)

Les modifications apportées aux champs de dossier déplacent l'Item existant vers le dossier indiqué sans le dissocier des Takeoffs, Assemblies, projets ou Estimates associés.

IMPORTANT
Ne modifiez ni ne supprimez le Item Name, l'Export ID ou l'Item ID lors de la mise à jour d'un Item exporté. Si l'une de ces valeurs est manquante ou modifiée, STACK pourrait créer un nouvel Item au lieu de mettre à jour l'Item existant.

NOTE
Les modifications apportées au coût unitaire (Unit Cost) ne mettent pas à jour les Estimates existants. Les coûts mis à jour s'appliquent aux nouveaux Estimates et aux rapports mis à jour.


Limites

  • Impossible de supprimer des Items
  • Impossible de modifier les notes d'un Item
  • Impossible d'ajouter ou de retirer des Items d'un Assembly

IMPORTANT
La suppression d'un Item est définitive. Les Items supprimés ne peuvent pas être restaurés et seront dissociés des takeoffs, assemblies et estimates existants.


Exporter des Items pour les mises à jour

Pour mettre à jour des Items plus efficacement:

  1. Exportez les Items d'une bibliothèque personnalisée (Custom Library)
  2. Modifiez le fichier CSV exporté
  3. Envoyez-le pour importation

IMPORTANT
Ne modifiez pas les colonnes Export ID ou Item ID. Ces valeurs servent à repérer les Items lors de l'importation. Si l'une d'elles est manquante ou modifiée, un nouvel Item sera créé au lieu de mettre à jour un Item existant.


Utiliser Google Sheets (facultatif)

Si Excel n'est pas disponible, le gabarit peut être rempli à l'aide de Google Sheets.

ImportGoogle2.png

  1. Téléchargez le gabarit d'importation d'Items
  2. Téléversez le fichier dans Google Drive
  3. Ouvrez le fichier avec Google Sheets
  4. Saisissez les données des Items en suivant les exigences du gabarit
  5. Cliquez sur Fichier → Télécharger → Valeurs séparées par des virgules (.csv, feuille actuelle)
  6. soumettez une demande d'assistance en y joignant votre fichier.

Articles connexes

Qu'est-ce qu'un élément
Créer, Modifier ou Supprimer des Éléments Personnalisés
Qu'est-ce qu'un Assemblage


Participez à la conversation sur cette fonctionnalité dans STACK Community.

Si vous avez besoin d'une assistance supplémentaire, Contactez-nous.

Cet article vous a-t-il été utile?
Utilisateurs qui ont trouvé cela utile : 0 sur 0

Commentaires

Vous devez vous connecter pour laisser un commentaire.