Mettre à jour un sous-réseau (Outils Réseau de distribution)

Résumé

Met à jour les informations sur le sous-réseau dans la table Subnetworks (Sous-réseaux), la classe d’entités SubnetLine et les diagrammes système de sous-réseau pour les sous-réseaux spécifiés.

Pour la table Subnetworks (Sous-réseaux), cet outil change le statut des contrôleurs de sous-réseau associés pour qu’ils soient nettoyés (l’[attribut Is dirty (À valider)])(../../help/data/utility-network/update-subnetworks.md#E1F) est défini sur False (Faux). Si des échecs de validation de cohérence ou des erreurs de sous-réseau sont détectés pendant l’exécution de l’outil, le statut des contrôleurs de sous-réseau associés sera marqué comme non valide (l’attribut Is dirty est défini sur Invalid [Non valide]). Dans la classe d’entités SubnetLine, un enregistrement sera généré pour tout nouveau sous-réseau, les enregistrements des sous-réseaux supprimés seront effacés et la forme et les informations des sous-réseaux modifiés seront actualisées. Certains attributs seront créés ou mis à jour pour les entités de sous-réseau.

Si la mise à jour de la règle de sous-réseau pour un niveau est configuré de sorte à ne pas gérer l’attribut Is dirty (À valider), l’opération de mise à jour du sous-réseau peut être utilisée pour supprimer des lignes de la table Subnetworks (Sous-réseaux) lorsque l’attribut Is deleted est défini sur true (vrai).

En savoir plus sur la procédure de mise à jour des sous-réseaux

Utilisation

Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :
- Le réseau de distribution doit être inscrit en tant que branche versionnée.
- Le réseau de distribution en entrée doit provenir d’un service de réseau de distribution.
- L’opération de mise à niveau du sous-réseau peut être utilisée dans la version par défaut pour supprimer des lignes dans la table Subnetworks (Sous-réseaux) pour les niveaux où l’attribut Is dirty n’est pas géré.
- Si cet outil est exécuté sur la version par défaut, la géométrie, l’attribut de nom de sous-réseau et les champs propagés de la classe d’entités SubnetLine sont mis à jour sur place. Si cet outil est exécuté sur une version nommée, le comportement par défaut (sans événements) limite la mise à jour aux entités et aux objets modifiés dans la version. Le mode de mise à jour peut être modifié pour que les événements soient utilisés (avec événements). Cette option exécute le comportement de la géodatabase et peut être définie dans la configuration du sous-réseau pour la version par défaut et les versions nommées.
  
  En savoir plus sur le mode de mise à jour utilisé par l’outil Update Subnetwork (Mettre à jour un sous-réseau)
- Mettez à jour un sous-réseau un processus après l’autre. N’exécutez pas l’outil avec le paramètre All subnetworks in tier (Tous les sous-réseaux du niveau) sélectionné si vous exécutez plusieurs processus. Un incident pourrait survenir si deux processus tentaient de mettre à jour le même sous-réseau simultanément.
- Licence :
  
  Le compte de portail actif doit disposer d’une licence avec l’extension de type d’utilisateur ArcGIS Advanced Editing pour que cet outil puisse être utilisé dans un déploiement d’entreprise.
Cet outil est pris en charge pour une utilisation avec des réseaux de domaine traditionnels uniquement.
Cet outil crée ou met à jour les diagrammes de réseau pour les sous-réseaux actualisés si un modèle de diagramme a été spécifié lors de la configuration de la définition du sous-réseau.
Toute mise à jour doit être enregistrée avant d’exécuter l’outil.
La topologie du réseau doit être activée.
Il n’existe aucune zone à valider sectionnant les entités de sous-réseau.

Etiqueter	Explication	Type de données
Réseau de distribution en entrée	Réseau de distribution qui contient le sous-réseau.	Utility Network; Utility Network Layer
Réseau de domaine	Réseau de domaine contenant le sous-réseau.	String
Niveau	Niveau contenant le sous-réseau.	String
Tous les sous-réseaux du niveau	Détermine si tous les sous-réseaux figurant dans le niveau seront mise à jour. Pour mettre à jour un sous-ensemble de sous-réseaux dans le niveau, utilisez le paramètre Subnetwork Name (Nom de sous-réseau). Activé—Tous les sous-réseaux du niveau seront mis à jour. Cet option utilise un traitement asynchrone pour mettre à jour les sous-réseaux utilisant le système UtilityNetworkTools de service de géotraitement. Ce service est réservé aux tâches de géotraitement du réseau de distribution et bénéficie d’un paramètre de délai d’expiration plus long par défaut. Décoché—Seuls les sous-réseaux spécifiés dans le paramètre Subnetwork Name (Nom de sous-réseau) seront mis à jour. Il s’agit de l’option par défaut.	Boolean
Nom de sous-réseau (Facultatif)	Le nom du sous-réseau qui sera mis à jour à partir du niveau. Si le paramètre All subnetworks in tier (Tous les sous-réseaux du niveau) est sélectionné, ce paramètre est ignoré. Lorsque la table de sous-réseaux contient au moins 10 000 enregistrements pour un niveau, la liste de choix du paramètre n’est pas renseignée et un champ vierge est proposé pour le nom du sous-réseau.	String
Poursuite après échec (Facultatif)	Indique si le processus de mise à jour s’arrête en cas d’échec de la mise à jour d’un sous-réseau lors de la mise à jour de plusieurs sous-réseaux. Activé—Le processus de mise à jour ne s’arrête pas en cas de défaillance du sous-réseau. Il continue. Décoché—Le processus de mise à jour s’arrête en cas de défaillance du sous-réseau. Il s’agit de l’option par défaut.	Boolean
Interruptions conditionnelles (Facultatif)	Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. Une interruption conditionnelle utilise un attribut du réseau ou une catégorie de réseau, un opérateur et un type, ainsi qu’une valeur d’attribut. Par exemple, arrêtez un traçage lorsque l’attribut `Device Status` d’une entité est égal à la valeur spécifique de `Open`. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Si vous utilisez plusieurs attributs, vous pouvez utiliser le paramètre Combine using (Combiner en utilisant) pour définir une condition Et ou Ou. En savoir plus sur l’utilisation de plusieurs expressions conditionnelles Remarque : Ce paramètre est uniquement disponible pour Python. Colonnes de la table de valeurs : Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Filter by a specific type. Specific value—Filter by a specific value or network category. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Use this parameter to combine multiple condition barriers. And—Combine the condition barriers. Or—Use if either condition barrier is met.	Value Table
Interruptions de fonctions (Facultatif)	Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête. Remarque : Ce paramètre est uniquement disponible pour Python. Colonnes de la table de valeurs : Function—Filter by a function. Min—The minimum of the input values will be identified. Max—The maximum of the input values will be identified. Average—The average of the input values will be calculated. Count—The number of features will be identified. Add—The sum of the input values will be calculated. Subtract—The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	Value Table
Inclure les entités d’interruption (Facultatif)	Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. Activé—Les interruptions de capacité à être traversé sont incluses dans les résultats de traçage. Il s’agit de l’option par défaut. Décoché—Les interruptions de capacité à être traversé ne sont pas incluses dans les résultats de traçage.	Boolean
Appliquer la traversabilité à (Facultatif)	Spécifie le type de traversabilité qui sera appliqué. La portée de la capacité à être traversé détermine si la capacité à être traversé sera appliquée aux jonctions, tronçons, ou aux deux. Par exemple, si une interruption conditionnelle est définie pour arrêter le traçage lorsque `DEVICESTATUS` est défini sur Ouvert et que la portée de traversabilité est définie sur les tronçons uniquement, le traçage ne s’arrêtera pas même si un dispositif ouvert est détecté, car `DEVICESTATUS` s’applique uniquement aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux. Remarque : Ce paramètre est uniquement disponible pour Python. Jonctions et tronçons—La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. Jonctions uniquement—La capacité à être traversé s’applique uniquement aux jonctions. Tronçons uniquement—La capacité à être traversé s’applique uniquement aux tronçons.	String
Propagateurs (Facultatif)	Spécifie les attributs de réseau à propager, ainsi que la manière dont cette propagation doit être effectuée pendant un traçage dans un réseau de domaine traditionnel. Les attributs de classe propagés désignent les valeurs clés sur les contrôleurs de sous-réseau qui sont distribuées au reste des entités dans le sous-réseau. Par exemple, dans un modèle de distribution électrique, vous pouvez propager la valeur de phase. Remarque : Ce paramètre est uniquement disponible pour Python. Colonnes de la table de valeurs : Attribute—Filter by a network attribute. Substitution Attribute—The field that will be used for attribute substitution. Function—Filter by a function. Operator—Filter by an operator. Value—Filter by a specific value.	Value Table

Sortie dérivée

Etiqueter	Explication	Type de données
Réseau de distribution mis à jour	Réseau de distribution mis à jour.	Utility Network

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, all_subnetworks_in_tier, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})

Nom	Explication	Type de données
in_utility_network	Réseau de distribution qui contient le sous-réseau.	Utility Network; Utility Network Layer
domain_network	Réseau de domaine contenant le sous-réseau.	String
tier	Niveau contenant le sous-réseau.	String
all_subnetworks_in_tier	Détermine si tous les sous-réseaux figurant dans le niveau seront mise à jour. Pour mettre à jour un sous-ensemble de sous-réseaux dans le niveau, utilisez le paramètre `subnetwork_name`. `ALL_SUBNETWORKS_IN_TIER`—Tous les sous-réseaux du niveau seront mis à jour. Cet option utilise un traitement asynchrone pour mettre à jour les sous-réseaux utilisant le système UtilityNetworkTools de service de géotraitement. Ce service est réservé aux tâches de géotraitement du réseau de distribution et bénéficie d’un paramètre de délai d’expiration plus long par défaut. `SPECIFIC_SUBNETWORK`—Seuls les sous-réseaux spécifiés dans le paramètre `subnetwork_name` seront mis à jour. Il s’agit de l’option par défaut.	Boolean
subnetwork_name (Facultatif)	Le nom du sous-réseau qui sera mis à jour à partir du niveau. Lorsque le paramètre `all_subnetworks_in_tier` est défini sur `ALL_SUBNETWORKS_IN_TIER`, ce paramètre est ignoré.	String
continue_on_failure (Facultatif)	Indique si le processus de mise à jour s’arrête en cas d’échec de la mise à jour d’un sous-réseau lors de la mise à jour de plusieurs sous-réseaux. `CONTINUE_ON_FAILURE`—Le processus de mise à jour ne s’arrête pas en cas de défaillance du sous-réseau. Il continue. `STOP_ON_FAILURE`—Le processus de mise à jour s’arrête en cas de défaillance du sous-réseau. Il s’agit de l’option par défaut.	Boolean
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Facultatif)	Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. Une interruption conditionnelle utilise un attribut du réseau ou une catégorie de réseau, un opérateur et un type, ainsi qu’une valeur d’attribut. Par exemple, arrêtez un traçage lorsque l’attribut `Device Status` d’une entité est égal à la valeur spécifique de `Open`. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Si vous utilisez plusieurs attributs, vous pouvez utiliser le paramètre Combine using (Combiner en utilisant) pour définir une condition Et ou Ou. En savoir plus sur l’utilisation de plusieurs expressions conditionnelles Remarque : Ce paramètre est uniquement disponible pour Python. Colonnes de la table de valeurs : `Name`—Filter by network attribute name. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`—Filter by a specific type. `SPECIFIC_VALUE`—Filter by a specific value or network category. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Filter by a specific value. `Combine Using`—Use this parameter to combine multiple condition barriers. `AND`—Combine the condition barriers. `OR`—Use if either condition barrier is met.	Value Table
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Facultatif)	Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête. Remarque : Ce paramètre est uniquement disponible pour Python. Colonnes de la table de valeurs : `Function`—Filter by a function. `MIN`—The minimum of the input values will be identified. `MAX`—The maximum of the input values will be identified. `AVERAGE`—The average of the input values will be calculated. `COUNT`—The number of features will be identified. `ADD`—The sum of the input values will be calculated. `SUBTRACT`—The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. `Attribute`—Filter by a network attribute. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`—Filter by a specific value. `Use Local Values`—Boolean value to use local variables instead of a global variable.	Value Table
include_barriers (Facultatif)	Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. `INCLUDE_BARRIERS`—Les interruptions de capacité à être traversé sont incluses dans les résultats de traçage. Il s’agit de l’option par défaut. `EXCLUDE_BARRIERS`—Les interruptions de capacité à être traversé ne sont pas incluses dans les résultats de traçage.	Boolean
traversability_scope (Facultatif)	Spécifie le type de traversabilité qui sera appliqué. La portée de la capacité à être traversé détermine si la capacité à être traversé sera appliquée aux jonctions, tronçons, ou aux deux. Par exemple, si une interruption conditionnelle est définie pour arrêter le traçage lorsque `DEVICESTATUS` est défini sur Ouvert et que la portée de traversabilité est définie sur les tronçons uniquement, le traçage ne s’arrêtera pas même si un dispositif ouvert est détecté, car `DEVICESTATUS` s’applique uniquement aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux. `BOTH_JUNCTIONS_AND_EDGES`—La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. `JUNCTIONS_ONLY`—La capacité à être traversé s’applique uniquement aux jonctions. `EDGES_ONLY`—La capacité à être traversé s’applique uniquement aux tronçons.	String
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Facultatif)	Spécifie les attributs de réseau à propager, ainsi que la manière dont cette propagation doit être effectuée pendant un traçage dans un réseau de domaine traditionnel. Les attributs de classe propagés désignent les valeurs clés sur les contrôleurs de sous-réseau qui sont distribuées au reste des entités dans le sous-réseau. Par exemple, dans un modèle de distribution électrique, vous pouvez propager la valeur de phase. Remarque : Ce paramètre est uniquement disponible pour Python. Colonnes de la table de valeurs : `Attribute`—Filter by a network attribute. `Substitution Attribute`—The field that will be used for attribute substitution. `Function`—Filter by a function. `Operator`—Filter by an operator. `Value`—Filter by a specific value.	Value Table

Sortie dérivée

Nom	Explication	Type de données
out_utility_network	Réseau de distribution mis à jour.	Utility Network

Exemple de code

Exemple 1 d’utilisation d’UpdateSubnetwork (fenêtre Python)

Mettez à jour un sous-réseau spécifique nommé RMT004.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution",
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004",
                          "CONTINUE_ON_FAILURE")

Exemple 2 d’utilisation d’UpdateSubnetwork (fenêtre Python)

Mettez à jour tous les sous-réseaux figurant dans le niveau Medium Voltage.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution",
                          "Medium Voltage", "ALL_SUBNETWORKS_IN_TIER")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Mettre à jour un sous-réseau (Outils Réseau de distribution)

Résumé

Utilisation

Licence :

Paramètres

Remarque :

Remarque :

Remarque :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes