Definición
Crea un ObjectId desde un valor hexadecimal.
Compatibilidad
Este método está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Sintaxis
El campo hexadecimalString especifica una string que contiene un valor hexadecimal de 24 caracteres. Por ejemplo, "64c13ab08edf48a008793cac".
Ejemplos
Los siguientes ejemplos muestran cómo añadir un identificador de objeto a un documento usando ObjectId.createFromHexString() y cómo aparece el identificador de objeto en la salida al recuperarlo.
Crear una colección que contenga un documento con identificador de objeto
El siguiente ejemplo crea una colección llamada objectIdentifierValuesFromHex:
db.objectIdentifierValuesFromHex.insertOne( { _id: 0, objectIdentifierValue: ObjectId.createFromHexString( "64c13ab08edf48a008793cac" ) } )
El campo objectIdentifierValue contiene el object identifier creado a partir del string hexadecimal especificado en ObjectId.createFromHexString().
Recuperar documento de la colección con identificador de objeto
El siguiente ejemplo recupera el documento:
db.objectIdentifierValuesFromHex.findOne( { _id: 0 } )
Ejemplo de salida:
{ _id: 0, objectIdentifierValue: ObjectId("64c13ab08edf48a008793cac") }