Résumé
Importe les registres de téléphone portable des fournisseurs de réseau et associe ces registres à un site cellulaire et aux classes d’entités sectorielles tels que générés par l’outil Registres de site cellulaire vers classe d’entités sur la base des champs d'identifiants.
Utilisation
Les valeurs du paramètre Input Cell Site Points (Points du site cellulaire en entrée) doivent être générées à l’aide de l’outil Registres de site cellulaire vers classe d’entités.
Les paramètres Output Phone Record Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Record Sectors (Secteurs de registres téléphoniques en sortie) incluront uniquement les registres téléphoniques qui ont bien été liés au site cellulaire et secteurs en entrée sur la base des champs d’ID appariés. Les valeurs des paramètres Output Phone Record Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Record Sectors (Secteurs de registres téléphoniques en sortie) ne représentent pas l’emplacement réel du téléphone portable.
Les registres téléphoniques ou registres détaillés des appels sont transmis par les fournisseurs de réseau sans fil dans différents formats et styles. Il n’est pas inhabituel que ces données soient transmises dans un format non tabulaire ou sous forme de schéma. La valeur du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée) doit être une table dans laquelle les noms des colonnes apparaissent en haut.
La table transmise par le fournisseur de réseau sans fil peut contenir des registres détaillés des appels et des informations de site cellulaire dans une même ligne. Les tables structurées de cette façon doivent être séparées en deux tables. Utilisez la table contenant les informations relatives aux appels (identifiants, numéros de téléphone, dates, heure, durée d’appel et coordonnées) comme entrée pour cet outil.
Une entité est créée dans les classes d'entités en sortie pour chaque registre (appel ou événement de données) du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée)
Les champs suivants sont ajoutés aux classes d'entités en sortie :
- SUBSCRIBER : le numéro de téléphone de l’abonné du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Tous les caractères non numériques sont supprimés de la sortie.
- UNIQUEID : l’identifiant unique des antennes secteur cellulaires.
Les champs suivants sont ajoutés à la sortie lorsque le paramètre spécifié est utilisé :
- DESTPHONE : le numéro de téléphone appelé du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Ceci est ajouté à la sortie lorsque le paramètre Destination Phone Number Field (Champ du numéro de téléphone de destination) est utilisé. Tous les caractères non numériques sont supprimés de la sortie.
- STARTTIME : le champ Date et heure de début du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Ceci est ajouté à la sortie lorsque le paramètre Start Date and Time Field (Champ Date et heure de début) est utilisé.
- DURATION : la durée en secondes de l’appel téléphonique, du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Les valeurs de durée au format HH:MM:SS seront converties en secondes totales. Ceci est ajouté à la sortie lorsque le paramètre Duration Field (Champ Durée) est utilisé ou lorsque les paramètres Start Date and Time Field (Champ Date et heure de début) et End Date and Time Field (Champ Date et heure de fin) sont utilisés tous les deux.
- ENDTIME : le champ Date et heure de fin du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Ceci est ajouté à la sortie lorsque le paramètre End Date and Time Field (Champ Date et heure de fin) est utilisé ou lorsque les paramètres Start Date and Time Field (Champ Date et heure de début) et Duration (Durée) sont utilisés tous les deux.
La table fournie par le fournisseur de réseau sans fil peut inclure une table des informations de site cellulaire avec un champ d’ID unique pour définir tous les enregistrements uniques ou une combinaison de champs d’identifiants pour définir des enregistrements uniques dans la table. Par exemple, une table peut contenir des champs d’identifiant de site et d’identifiant de secteur pour définir de manière unique certains enregistrements, mais d’autres enregistrements de la table sont définis de manière unique avec des champs d’identifiant LAC (Location Area Code) et d’identifiant cellulaire.
- Lorsqu’un champ d’ID unique est fourni pour la table en entrée, définissez l’option ID Type (Type d’ID) sur Unique ID (ID unique) dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs d’ID de secteur cellulaire supplémentaires) et, dans le même paramètre, renseignez l’option Field (Champ) avec le champ représentant cet ID unique.
- Lorsque de nombreux champs d’ID sont fournis pour la table afin d’indiquer l’unicité, tous les champs d’ID doivent être ajoutés à la sortie. Pour chaque champ d’ID, choisissez la valeur de ID Type (Type d’ID) qui définit le type d’ID dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs d’ID de secteur cellulaire supplémentaires) et, dans le même paramètre, renseignez l’option Field (Champ) avec le champ associé contenant les informations d’ID. L’outil combine des champs d’ID et renseigne un champ d’ID unique dans les classes d’entités en sortie nommé UNIQUEID.
Les champs suivants seront ajoutés à la sortie s’ils sont spécifiés dans le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) :
- SITEID : identifiant unique d’un site cellulaire
- SECTORID : identifiant unique d’un secteur cellulaire
- SWITCHID : identifiant unique d’un commutateur réseau sans fil
- LACID : identifiant unique d’un code LAC (Location Area Code)
- CASCADEID : identifiant unique du secteur dans la cascade de réseau sans fil
- CELLID : identifiant unique du secteur dans un code LAC (Location Area Code)
Lorsque la table de registres téléphoniques en entrée contient des registres d’appel qui couvrent plusieurs secteurs cellulaires, les paramètres Cell Sector ID Fields (Champs ID de secteur cellulaire) et Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) doivent être renseignés. Le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) doit contenir les identifiants associés au secteur de départ, et le paramètre Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) doit contenir le secteur de fin ou tout autre secteur que le secteur de départ du registre d’appel.
Lorsque la table des registres téléphoniques en entrée contient des registres d'événements de données ou que le registre d'appel ne recense qu’un seul secteur, seul le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) doit être renseigné.
Le champ et les valeurs suivants sont générés lorsque le paramètre Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) est utilisé:
- IDTYPE : le champ indiquant si un registre d’appel correspond au secteur primaire ou à un secteur supplémentaire d’un registre d’appel.
- PRIMAIRE : la valeur attribuée lorsqu'un registre de téléphone portable est associé à un secteur au début d'un appel.
- SUPPLÉMENTAIRE : la valeur attribuée lorsqu'un registre de téléphone portable est associé à un secteur à la fin d’un appel ou à tout autre secteur que le secteur de départ au cours d’un appel.
Si l’outil détermine que le secteur associé à un registre de téléphone portable est le même au début et à la fin de l’appel, aucune entité distincte n’est créée pour le secteur cellulaire représentant la fin de l’appel.
- IDTYPE : le champ indiquant si un registre d’appel correspond au secteur primaire ou à un secteur supplémentaire d’un registre d’appel.
Les points d’appels en sortie estimés incluront tous les champs associés des paramètres Output Phone Records Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Records Site Sectors (Secteurs des sites de registres téléphoniques en sortie).
Les champs suivants sont également ajoutés au paramètre Output Estimated Call Points (Points d’appels estimés en sortie)
- PHONEX : les coordonnées X estimées de l’emplacement de l’appel telles que fournies par le fournisseur de réseau sans fil.
- PHONEY : les coordonnées Y estimées de l’emplacement de l’appel telles que fournies par le fournisseur de réseau sans fil.
Lorsque le registre du champ SUBSCRIBER est nul, il est ignoré et n’est pas importé dans les classes d’entités en sortie.
Lorsque les champs STARTTIME et DURATION contiennent des valeurs mais que le champ ENDTIME n’en contient pas, l’outil génère une valeur ENDTIME dans les classes d’entités en sortie.
Lorsque les champs STARTTIME et ENDTIME contiennent des valeurs mais que le champ DURATION n’en contient pas, l’outil génère une valeur DURATION dans les classes d’entités en sortie.
Syntaxe
CellPhoneRecordsToFeatureClass(in_table, in_site_features, in_sector_features, out_site_feature_class, out_sector_feature_class, id_fields, subscriber_field, {destination_field}, {additional_id_fields}, {start_time_field}, {duration_field}, {end_time_field}, {convert_utc}, {location_x_field}, {location_y_field}, {location_coordinate_system}, {out_call_points})| Paramètre | Explication | Type de données |
in_table | La table en entrée contenant les registres d’appel ou registres d’événements de données téléphoniques fournis par le fournisseur de réseau sans fil. | Table View |
in_site_features | La classe d'entités contenant les points des sites cellulaires générés par l’outil Registres de site cellulaire vers classe d’entités. | Feature Layer |
in_sector_features | La classe d'entités contenant les secteurs des sites cellulaires générés par l’outil Registres de site cellulaire vers classe d’entités. | Feature Layer |
out_site_feature_class | La classe d'entités ponctuelles contenant les points des sites de registres téléphoniques. Un point est généré par registre téléphonique associé aux points des sites cellulaires. | Feature Class |
out_sector_feature_class | La classe d'entités surfaciques contenant les secteurs de registres téléphoniques. Un polygone de secteur est généré par registre téléphonique associé aux secteurs des sites cellulaires. | Feature Class |
id_fields [id_fields,...] | Specifies the unique ID field type and the fields that will be added to the output feature. Utilisez le type Unique ID (ID unique) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d'autres valeurs ID Type (Type d’ID) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires.
ID Type options are as follows:
| Value Table |
subscriber_field | Le champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de l’abonné. | Field |
destination_field (Facultatif) | Le champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de la personne appelée. | Field |
additional_id_fields [additional_id_fields,...] (Facultatif) | Spécifie le type de champ d’ID unique supplémentaire et les champs qui seront ajoutés à l’entité en sortie. Utilisez le type Unique ID (ID unique) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d'autres valeurs ID Type (Type d’ID) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires.
ID Type options are as follows:
| Value Table |
start_time_field (Facultatif) | Le champ de la table en entrée contenant le champ de date et d’heure de début de l’appel téléphonique ou de l’événement de données. | Field |
duration_field (Facultatif) | Le champ de la table en entrée contenant la durée de l’appel téléphonique en secondes. | Field |
end_time_field (Facultatif) | Le champ de la table en entrée contenant la date et l’heure de fin de l’appel téléphonique ou de l’événement de données. | Field |
convert_utc (Facultatif) | Spécifie si les dates et heures de début et de fin des registres en entrée seront converties selon le fuseau horaire du système local ou seront conservées au format UTC.
| Boolean |
location_x_field (Facultatif) | Le champ de la table en entrée contenant les coordonnées X de l’emplacement estimé du téléphone, tel que fourni par le fournisseur du réseau sans fil. | Field |
location_y_field (Facultatif) | Le champ de la table en entrée contenant les coordonnées Y de l’emplacement estimé du téléphone, tel que fourni par le fournisseur du réseau sans fil. | Field |
location_coordinate_system (Facultatif) | Le système de coordonnées (coordonnées x,y) de l’emplacement estimé du téléphone. Le système de coordonnées par défaut est WGS84. | Coordinate System |
out_call_points (Facultatif) | La classe d’entités ponctuelles contenant les emplacements d’appels estimés tels que fournis par le fournisseur du réseau sans fil. | Feature Class |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction CellPhoneRecordsToFeatureClass en mode immédiat :
import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.CellPhoneRecordsToFeatureClass("CDR_Phone_1",
"Phone_1_Sites",
"Phone_1_Sectors",
"CDR_Phone_1_Sites_out",
"CDR_Phone_1_Sectors_out",
"SWITCH_ID BEGSWITCH;SITE_ID BEGSITE;SECTOR_ID BEGSECTOR",
"SUBSCRIBERID")Le script autonome suivant est un exemple d'utilisation de la fonction CellPhoneRecordsToFeatureClass dans un script :
# Name: CellPhoneRecordsToFeatureClass.py
# Description: Imports cell phone records then associates those records with a
# cell site and sector feature classes based on identifier fields.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Set local variables
in_table = "CDR_Phone_1"
in_sites = "Phone_1_Sites"
in_sectors = "Phone_1_Sectors"
out_cdr_sites = "CDR_Phone_1_Sites_out"
out_cdr_sectors = "CDR_Phone_1_Sectors_out"
# Set up Beginning of Phone IDs
# [ID Type, Field]
begin_switch_id = ["SWITCH_ID","BEGSWITCH"]
begin_site_id = ["SITE_ID","BEGSITE"]
begin_sector_id = ["SECTOR_ID","BEGSECTOR"]
begin_id_fields = [begin_switch_id, begin_site_id, begin_sector_id]
subscriber_field = "SUBSCRIBERID"
destination_field = "DESTNUM"
# Set up End of Phone Call IDs
# [ID Type, Field]
end_switch_id = ["SWITCH_ID","ENDSWITCH"]
end_site_id = ["SITE_ID","ENDSITE"]
end_sector_id = ["SECTOR_ID","ENDSECTOR"]
end_id_fields = [end_switch_id, end_site_id, end_sector_id]
# Input Table Contains information about the duration of the call
start_date_field = "DATETIME"
duration_field = "DURATION"
arcpy.ca.CellPhoneRecordsToFeatureClass(in_table,
in_sites,
in_sectors,
out_cdr_sites,
out_cdr_sectors,
begin_id_fields,
subscriber_field,
destination_field,
end_id_fields,
start_date_field,
duration_field)Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?