Scénario : Utilisation des jumeaux numériques IoT
Pour configurer vos jumeaux numériques, vous pouvez utiliser les instances de jumeau numériques, les adaptateurs, les relations et les modèles.
Utilisez ces concepts pour utiliser les ressources de jumeau numérique.
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. Voir 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 jumeau numérique, un modèle et un adaptateur.
- Modèles de jumeau numérique : 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 jumeau numérique (DTMI) comme identificateur unique.
Par exemple :
dtmi:com:yourcompany:iot:example;1 - Adaptateurs de jumeau numérique : Traduisez les données vers des modèles de jumeau numérique pour les instantanés de données et, si configurés, saisissez les données historiques. Les données transmises à l'adaptateur jumeau numérique sont un objet JSON contenant les données et le mappage. Des adaptateurs jumeaux numériques sont nécessaires pour les données structurées.
- Format d'adaptateur par défaut : Si l'appareil peut être programmé pour envoyer des données dans le format avec lequel vous voulez travailler, créez un adaptateur jumeau numérique par défaut. Pour un exemple spécifique, voir Scénario : Envoi de données structurées dans un 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 avec lequel vous voulez travailler, créez un adaptateur jumeau numérique personnalisé. Pour un exemple spécifique, voir Scénario : Envoi de données structurées dans un format personnalisé à l'aide de HTTP.
- Relations avec les jumeaux numériques : Permet de connecter plusieurs instances de jumeau numérique. 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 de ses relations avec d'autres instances de jumeau numérique. Pour un exemple spécifique, voir Scénario : Interroger une relation de jumeau numérique.
Note
Selon l'interface que vous utilisez, les données utiles, les mappages d'adaptateur, les modèles de jumeau numérique, 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 que vous utilisez, les données utiles, les mappages d'adaptateur, les modèles de jumeau numérique, 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 les fichiers de modèle jumeau numérique et d'adaptateur jumeau numérique et utilise hyphenated-lowercase pour les commandes et les paramètres. Exemple : - API :
digitalTwinInstanceId - Interface de ligne de commande :
digital-twin-instance-id
Concepts des jumeaux numériques
Lorsque vous travaillez avec vos ressources de jumeau numérique, utilisez les concepts clés suivants :
- Fichiers JSON de référence 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 chargez un adaptateur à l'aide de l'interface de ligne de commande, vous pouvez utiliser des fichiers JSON pour spécifier le mappage de données. Voir Gestion de l'entrée et de la sortie de l'interface de ligne de commande et Utilisation d'un fichier JSON pour une entrée complexe.
- Exemples 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 de l'appareil pour reporter les données.
- Modèle jumeau numérique et options d'adaptateur : Créez un modèle jumeau numérique pour définir à l'aide des spécifications DTDL v3 et créez un adaptateur jumeau numérique pour normaliser les données de l'appareil en fonction du modèle jumeau numérique.
- Clé externe et authentification : Pour tester votre configuration IoT, utilisez une clé secrète de chambre forte avec authentification de base pour ingérer des données-échantillons. Lorsque vous envoyez des données à l'aide de l'instance de jumeau numérique, spécifiez le nom d'utilisateur de l'appareil comme
--external-keyet--auth-idcomme mot de passe de l'appareil.--auth-idpeut être une clé secrète de chambre forte ou un certificat mTLS. La clé secrète ou l'OCID du certificat peuvent être associés à l'instance de jumeau numérique lorsque vous créez l'instance de jumeau numérique ou mettez à jour l'instance de jumeau numérique. - Clé externe et certificat mTLS : Si vous utilisez un certificat mTLS au lieu de la clé secrète de la chambre forte, la clé externe doit être le nom commun du certificat. Pour trouver le nom commun du certificat, vous pouvez lister vos certificats et accéder aux détails du certificat.
- Relations : Les instances de lien Relations de jumeau numérique 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.