Importer des associations (Utility Network)

Synthèse

Importe les associations depuis un fichier de valeurs séparées par des virgules (.csv) dans un réseau de distribution existant. Cet outil peut être utilisé avec l’outil Exporter des associations.

En savoir plus sur la procédure d’importation des associations

Utilisation

  • Les associations doivent figurer dans un seul fichier .csv.

  • Les entités répertoriées dans le fichier .csv doivent exister dans le réseau de distribution.

  • Les entités répertoriées dans le fichier .csv doivent avoir des règles compatibles.

  • Si une erreur se produit durant l’importation, par exemple, si une règle est manquante, l’ensemble du processus d’importation est annulé. Consultez les erreurs et examinez le fichier .csv avant de relancer le processus d’importation des associations.

  • Si une géodatabase d’entreprise est utilisée, le paramètre Réseau de distribution en entrée approprié doit provenir d’une connexion de base de données établie en tant que propriétaire du réseau de distribution de la base de données.

  • Les informations figurant dans le fichier .csv sont stockées au format suivant : ASSOCIATIONTYPE, FROMFEATURECLASS, FROMASSETGROUP, FROMASSETTYPE, FROMGLOBALID, FROMTERMINAL, TOFEATURECLASS, TOASSETGROUP, TOASSETTYPE, TOGLOBALID, TOTERMINAL, ISCONTENTVISIBLE, PERCENTALONG.

    Colonnes .csv

    ColonneDescriptionExemple

    ASSOCIATIONTYPE

    Le type d’association.

    • Connectivité jonction jonction
    • Connectivité de départ jonction-tronçon
    • Connectivité à mi-portée jonction-tronçon
    • Connectivité d’arrivée jonction-tronçon
    • Inclusion
    • Dépendance structurelle

    Inclusion

    FROMFEATURECLASS/TOFEATURECLASS

    Classe d’entités ou objet qui participe à l’association.

    ElectricDistributionDevice, ElectricDistributionAssembly, StructureJunction

    FROMASSETGROUP/TOASSETGROUP

    Le groupe de ressources de l'entité.

    Transformer, Fuse, Elbow

    FROMASSETTYPE/TOASSETTYPE

    Le type de ressources de l'entité.

    Streetlight, Attachment, Single-phase padmounted

    FROMGLOBALID/TOGLOBALID

    Identifiant global de l’entité.

    {16558C73-013C-4169-A095-7E9DCD57EB57}

    FROMTERMINAL/TOTERMINAL

    La borne qui participe à l’association. Applicable uniquement aux associations de connectivité jonction-jonction.

    Single Terminal, Load, Source

    ISCONTENTVISIBLE

    Un indicateur booléen signalant si le contenu est visible. Applicable uniquement aux associations de dépendance structurelle.

    False, True

    PERCENTALONG

    La valeur avec pourcentage pour les associations de connectivité à mi-portée jonction-tronçon entre un objet de jonction et un objet de tronçon.

    0,75

Paramètres

ÉtiquetteExplicationType de données
Réseau de distribution en entrée

Réseau de distribution dans lequel les associations sont importées.

Utility Network; Utility Network Layer
Type d’association

Spécifie le type d’association à importer.

  • TousTous les types d’associations sont importés.
  • Connectivité jonction-jonctionLe type d’association de connectivité jonction-jonction est importé.
  • InclusionLe type d’association de contenu est importé.
  • Pièce jointeLe type structural attachment association est importé.
  • Connectivité jonction-tronçon (à partir du côté du tronçon)Le type d’association de connectivité jonction-tronçon (à partir du côté du tronçon) est importé.
  • Connectivité jonction-tronçon (mi-portée)Le type d’association de connectivité jonction-tronçon (mi-portée) est importé.
  • Connectivité jonction-tronçon (vers le côté du tronçon)Le type d’association de connectivité jonction-tronçon (vers le côté du tronçon) est importé.
String
Fichier en entrée

Le fichier .csv à partir duquel les associations sont importées.

File

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution mis à jour

Réseau de distribution mis à jour.

Utility Network

arcpy.un.ImportAssociations(in_utility_network, association_type, csv_file)
NomExplicationType de données
in_utility_network

Réseau de distribution dans lequel les associations sont importées.

Utility Network; Utility Network Layer
association_type

Spécifie le type d’association à importer.

  • ALLTous les types d’associations sont importés.
  • JUNCTION_JUNCTION_CONNECTIVITYLe type d’association de connectivité jonction-jonction est importé.
  • CONTAINMENTLe type d’association de contenu est importé.
  • STRUCTURAL_ATTACHMENTLe type structural attachment association est importé.
  • JUNCTION_EDGE_FROM_CONNECTIVITYLe type d’association de connectivité jonction-tronçon (à partir du côté du tronçon) est importé.
  • JUNCTION_EDGE_MIDSPAN_CONNECTIVITYLe type d’association de connectivité jonction-tronçon (mi-portée) est importé.
  • JUNCTION_EDGE_TO_CONNECTIVITYLe type d’association de connectivité jonction-tronçon (vers le côté du tronçon) est importé.
String
csv_file

Le fichier .csv à partir duquel les associations sont importées.

File

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau de distribution mis à jour.

Utility Network

Exemple de code

Exemple d’utilisation de l’outil ImportAssociations (fenêtre Python)

Cet exemple de script importe tous les types d’associations dans un réseau de distribution intitulé GridNetwork

import arcpy
arcpy.ImportAssociations_un("GridNetwork", "ALL", "C:\\Temp\\AllAssociations.csv")
Exemple 2 d'utilisation de l'outil ImportAssociations (fenêtre Python)

Cet exemple de script importe les associations de connectivité jonction-jonction dans un réseau de distribution intitulé GridNetwork.

import arcpy
arcpy.ImportAssociations_un("GridNetwork", "JUNCTION_JUNCTION_CONNECTIVITY", 
                            "C:\\Temp\\JJconnectivity.csv")
Exemple 3 d'utilisation de l'outil ImportAssociations (fenêtre Python)

Cet exemple de script importe les associations d'inclusion dans un réseau de distribution intitulé GridNetwork.

import arcpy
arcpy.ImportAssociations_un("GridNetwork", "CONTAINMENT", 
                            "C:\\Temp\\Containment.csv")
Exemple 4 d'utilisation de l'outil ImportAssociations (fenêtre Python)

Cet exemple de script importe les associations de dépendances structurelles dans un réseau de distribution intitulé GridNetwork.

import arcpy
arcpy.ImportAssociations_un("GridNetwork", "STRUCTURAL_ATTACHMENT", 
                            "C:\\Temp\\StructuralAttachment.csv")

Environnements

Cas particuliers

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes