Scénario : utilisation de jumeaux numériques IoT
Pour configurer vos jumeaux numériques, vous pouvez utiliser les instances de jumeaux numériques, les adaptateurs, les relations et les modèles.
Utilisez ces concepts pour utiliser les ressources de jumeaux numériques.
Lorsque vous recevez des données non structurées, vous devez créer une instance de jumeau numérique. Aucun modèle et adaptateur de jumeau numérique n'est requis. Reportez-vous à Scénario : envoi de données non structurées à l'aide de HTTP.
Lorsque vous recevez des données structurées, vous devez créer une instance de jumeau numérique, un modèle et un adaptateur.
- Modèles de jumeaux numériques : un modèle de jumeau numérique définit la sémantique d'un jumeau numérique et est basé sur les spécifications DTDL v3. Un jumeau numérique utilise un identificateur de modèle de jumeau numérique (DTMI) comme identificateur unique.
Par exemple :
dtmi:com:yourcompany:iot:example;1 - Adaptateurs de jumeaux numériques : convertissez les données en modèles de jumeaux numériques pour les instantanés de données et, s'ils sont configurés, capture les données historiques. Les données transmises à l'adaptateur jumeau numérique sont un objet JSON contenant les données et le mapping. Des doubles adaptateurs numériques sont nécessaires pour les données structurées.
- Format d'adaptateur par défaut : si le périphérique peut être programmé pour envoyer des données dans le format que vous souhaitez utiliser, créez un adaptateur jumeau numérique par défaut. Pour obtenir un exemple spécifique, reportez-vous à Scénario : envoi de données structurées au format par défaut à l'aide de HTTP.
- Format d'adaptateur personnalisé : si l'appareil ne peut pas être programmé pour envoyer des données dans le format que vous souhaitez utiliser, créez un adaptateur jumeau numérique personnalisé. Pour obtenir un exemple spécifique, reportez-vous à Scénario : envoi de données structurées dans un format personnalisé à l'aide de HTTP.
- Relations de jumeaux numériques : connecte plusieurs instances de jumeaux numériques. Si une relation de jumeau numérique est liée à une instance de jumeau numérique, vous pouvez créer un graphique du jumeau numérique et ses relations avec d'autres instances de jumeau numérique. Pour obtenir un exemple spécifique, reportez-vous à Scénario : requête d'une relation de jumeau numérique.
Remarque
Selon l'interface utilisée, les données traitées, les mappings d'adaptateur, les modèles de jumeaux numériques, les attributs et les propriétés de vos fichiers utilisent une convention de casse différente. Par exemple, l'interface d'API utilise
Selon l'interface utilisée, les données traitées, les mappings d'adaptateur, les modèles de jumeaux numériques, les attributs et les propriétés de vos fichiers utilisent une convention de casse différente. Par exemple, l'interface d'API utilise
camelCase et l'interface de ligne de commande utilise un format hyphenated-lowercase. L'interface de ligne de commande peut accepter le format camelCase ou hyphenated-lowercase pour le modèle de jumeau numérique et les fichiers d'adaptateur de jumeau numérique, et utilise hyphenated-lowercase pour les commandes et les paramètres. Par exemple : - API :
digitalTwinInstanceId - CLI :
digital-twin-instance-id
Concepts relatifs aux jumeaux numériques
Lorsque vous utilisez vos ressources de jumeaux numériques, utilisez les concepts clés suivants :
- Référencer les fichiers JSON pour les spécifications et les adaptateurs de modèle de jumeau numérique : selon votre système d'exploitation, vous pouvez avoir une syntaxe légèrement différente avec des guillemets, des barres obliques ou l'emplacement du fichier par défaut. Lorsque vous téléchargez un adaptateur à l'aide de l'interface de ligne de commande, vous pouvez utiliser des fichiers JSON pour indiquer la mise en correspondance des données. Reportez-vous à Gestion des entrées et sorties de l'interface de ligne de commande et à Utilisation d'un fichier JSON pour les entrées complexes.
- Exemple de données : pour configurer et tester votre configuration, lorsque vous créez une instance de jumeau numérique si vous n'incluez pas de clé externe, elle est générée automatiquement. Utilisez cette clé externe comme nom d'utilisateur du périphérique pour publier des données.
- Options de modèle de jumeau numérique et d'adaptateur : créez un modèle de jumeau numérique pour définir à l'aide des spécifications DTDL v3 et créez un adaptateur de jumeau numérique pour normaliser les données de l'appareil afin de les adapter au modèle de jumeau numérique.
- Clé externe et authentification : pour tester votre configuration IoT, utilisez une clé secrète de coffre avec une authentification de base afin d'ingérer des données échantillon. Lorsque vous envoyez des données à l'aide de l'instance de jumeau numérique, indiquez le nom utilisateur de l'appareil en tant que mot de passe de l'appareil
--external-keyet--auth-id.--auth-idpeut être une clé secrète de coffre ou un certificat mTLS. La clé secrète ou l'OCID du certificat peut être associé à l'instance de jumeau numérique lorsque vous créez l'instance de jumeau numérique ou que vous mettez à jour l'instance de jumeau numérique. - Certificat mTLS et clé externe : si vous utilisez un certificat mTLS à la place de la clé secrète de coffre, la clé externe doit être le nom commun du certificat. Pour trouver le nom commun du certificat, vous pouvez répertorier vos certificats et accéder aux détails du certificat.
- Relations : les instances de lien Relations de jumeaux numériques sont généralement une source et une cible, ainsi qu'un chemin de contenu défini par les relations de votre modèle de jumeau numérique, par exemple,
servedBy.