Résumé
Ajoute une configuration de borne à un réseau de distribution existant.
Des entités équipées de bornes nécessitent des contraintes qui définissent la configuration valide de la connectivité interne du périphérique ou de l’objet de jonction. Cet outil permet d’ajouter une nouvelle configuration de bornes à un réseau de distribution qui peut, par la suite, être affectée à une classe au niveau du groupe de ressources ou du type de ressources au moyen de l’outil Set Terminal Configuration (Définir la configuration de bornes).
Utilisation
Les bornes sont configurées sur un périphérique ou un objet de jonction en affectant une configuration de borne. Une seule configuration de borne peut être attribuée à chacun des types de ressource prenant en charge les bornes.
Les bornes sur une entité possèdent un paramètre de direction. Elles peuvent être définies comme directionnelles (un seul sens de flux est autorisé) ou bidirectionnelles (les deux sens de flux sont autorisés).
Vous devez indiquer au minimum 2 bornes et au maximum 8 bornes. Le nom de la borne doit être une description pertinente, par exemple côté supérieur ou côté source.
Pour les entités dotées de trois ou quatre bornes, vous pouvez définir des configurations valides. Ceci est conçu pour gérer les dispositifs de commutation complexes pour lesquels vous devez contraindre les chemins de flux entre des paires de bornes. Par exemple, dans un dispositif à quatre bornes avec des bornes nommées A, B, C et D, vous pouvez autoriser le flux de A à B et C, mais pas de A à D.
La topologie du réseau doit être désactivée.
Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :
- Lors de son exécution, cet outil doit être connecté à la version par défaut.
- La valeur du paramètre Input Utility Network (Réseau de distribution en entrée) doit provenir d’une connexion à une base de données établie en tant que propriétaire du réseau de distribution de la base de données.
- Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique.
Syntaxe
arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})| Paramètre | Explication | Type de données |
in_utility_network | Réseau technique auquel la configuration des bornes sera ajoutée. | Utility Network; Utility Network Layer |
terminal_configuration_name | Nom de la configuration des bornes. | String |
traversability_model | Indique la direction de la configuration des bornes. Un modèle de traversabilité directionnel implique que le flux pour la borne concernée ne circule que dans un seul sens. Dans un modèle de traversabilité bidirectionnel, la borne autorise un flux dans les deux sens.
| String |
terminals_directional [[name, upstream],...] (Facultatif) | Nom et sens de circulation de chaque borne directionnelle. Vous devez spécifier entre deux et huit bornes. Le nom de chaque borne ne peut pas comporter plus de 32 caractères. Ce paramètre est requis si le paramètre traversability_model a pour valeur DIRECTIONAL.
| Value Table |
terminals_bidirectional [[name],...] (Facultatif) | Nom de chacune des bornes bidirectionnelles. Vous devez spécifier entre deux et huit bornes. Le nom de chaque borne ne peut pas comporter plus de 32 caractères. Ce paramètre est requis si le paramètre Directionality (Direction) a pour valeur Bidirectional (Bidirectionnel) (traversability_model = "BIDIRECTIONAL" dans Python). | Value Table |
valid_paths [[Name, [Value]],...] (Facultatif) | Nom(s) du ou des chemins valides de la configuration des bornes. En mode de traversabilité bidirectionnelle, ce paramètre est obligatoire si vous possédez deux bornes ou plus. Si vous utilisez la traversabilité directionnelle, une seule borne en amont permet de satisfaire une configuration valide. Les chemins valides doivent être définis de façon à indiquer le ou les chemins, au sein d’un périphérique ou d’un objet de jonction, qu’une ressource peut parcourir. Donnez un nom à chaque chemin valide et attribuez une valeur.
| Value Table |
default_path (Facultatif) | Chemin par défaut des configurations valides. Il sera attribué aux nouvelles entités dont le type de ressources possède cette configuration de borne. Si aucune configuration valide n’a été spécifiée, la configuration par défaut ALL est utilisée.
| String |
Sortie dérivée
| Nom | Explication | Type de données |
| out_utility_network | Réseau technique actualisé. | Utility Network |
Exemple de code
Ajoute une configuration de borne bidirectionnelle à trois bornes.
import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1',
'BIDIRECTIONAL', None, 'A;B;C',
'Top A-B;Bottom A-C', 'Top')Ajoute une configuration de borne directionnelle à trois bornes.
import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2',
'DIRECTIONAL', 'A true;B true;C false', None,
'Top A-B;Bottom A-C', 'Bottom')Ajoute une configuration de borne directionnelle à trois bornes. Les chemins valides sont indiqués à l’aide d’une collection de paires de bornes.
import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3',
'DIRECTIONAL', 'A true;B false;C false', None,
"AB A-B;ABAC 'A-B;A-C'", 'AB')Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?