Patient Timeline - Create Job

Servicio:

Azure AI Services

Versión de la API:

2023-09-01-preview

Creación de un trabajo de escala de tiempo de pacientes
Crea un trabajo de escala de tiempo del paciente con el cuerpo de la solicitud especificado.

POST {endpoint}/health-insights/patient-timeline/jobs?api-version=2023-09-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus2.api.cognitive.microsoft.com).
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string
Repeatability-Request-ID		string	Identificador de cadena globalmente único y generado por el cliente para la solicitud.
Repeatability-First-Sent		string (date-time)	Especifica la fecha y hora en que se creó la solicitud por primera vez.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
patients	True	PatientRecord[]	La lista de pacientes, incluida su información clínica y sus datos.
configuration		PatientTimelineModelConfiguration	Configuración que afecta a la inferencia del modelo de escala de tiempo del paciente.

Respuestas

Nombre	Tipo	Description
202 Accepted		La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado. Encabezados Operation-Location: string Repeatability-Result: string Retry-After: integer
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Creates a Patient Timeline job with the given request body.

Solicitud de ejemplo

HTTP

POST {endpoint}/health-insights/patient-timeline/jobs?api-version=2023-09-01-preview

{
  "patients": []
}

Respuesta de muestra

status code:

202

Operation-Location: {endpoint}/health-insights/patient-timeline/jobs/{id}?api-version=2023-09-01-preview
Retry-After: 1

{
  "status": "notStarted",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ClinicalDocumentType	Tipo del documento clínico.
DocumentAdministrativeMetadata	Documentar metadatos administrativos
DocumentAuthor	Autor del documento
DocumentContent	Contenido del documento del paciente.
DocumentContentSourceType	Tipo del origen del contenido. En caso de que el tipo de origen sea "insertado", el contenido se asigna como una cadena (por ejemplo, texto). En caso de que el tipo de origen sea "referencia", el contenido se asigna como un URI.
DocumentType	Tipo del documento del paciente, como "nota" (documento de texto) o "fhirBundle" (documento JSON de FHIR).
Encounter	información de visita/encuentro
EncounterClass	Códigos de valores conocidos que se pueden usar para indicar la clase de encuentro (TODO://Based en el valor de FHIR set--http://....).
Fhir.R4.CodeableConcept	Concepto: referencia a una terminología o solo texto basado en CodeableConcept de FHIR
Fhir.R4.Coding	Una codificación es una representación de un concepto definido mediante un símbolo de un "sistema de código" definido. Basado en de codificación de FHIR
Fhir.R4.Extension	Base para todos los elementos Basado en el elemento FHIR
Fhir.R4.Identifier	Identificador destinado al cálculo basado en el identificador de FHIR
Fhir.R4.Meta	Metadatos sobre un recurso basado en meta de FHIR
Fhir.R4.Period	Un período de tiempo definido por una fecha de inicio y finalización y, opcionalmente, hora basada en el período de FHIR
Fhir.R4.Quantity	Cantidad medida o medible basada en la cantidad de FHIR
Fhir.R4.Range	Conjunto de cantidades ordenadas definidas por un límite bajo y alto basado en el intervalo de FHIR
Fhir.R4.Ratio	Relación de dos valores quantity: un numerador y un denominador basado en la relación de FHIR
Fhir.R4.Reference	Referencia de un recurso a otro basado en la referencia de FHIR
Fhir.R4.Resource	Resource es el antecesor de DomainResource del que se derivan la mayoría de los recursos. Agrupación, parámetros y recurso binario extendido directamente. Basado en [recurso de FHIR](https://www.hl7.org/fhir/r4/resource.html
Fhir.R4.SampledData	Una serie de medidas tomadas por un dispositivo basado en FHIR SampledData
OrderedProcedure	Información del procedimiento
PatientDocument	Un documento clínico relacionado con un paciente. El documento está aquí en el sentido amplio, no solo un documento de texto (nota).
PatientInfo	Información estructurada del paciente, incluyendo datos demográficos y información clínica estructurada conocida.
PatientInfoSex	El sexo del paciente.
PatientRecord	Un registro de pacientes, incluida su información clínica y sus datos.
PatientTimelineData	Cuerpo de la solicitud de escala de tiempo del paciente.
PatientTimelineModelConfiguration	Configuración que afecta a la inferencia del modelo de escala de tiempo del paciente.
SpecialtyType	Códigos de valores conocidos que se pueden usar para indicar el tipo de especialidad.
TimePeriod	Duración del tiempo durante el que se produce un evento

Azure.Core.Foundations.Error

Object

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Una representación en lenguaje natural del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Object

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

ClinicalDocumentType

Enumeración

Tipo del documento clínico.

Valor	Description
consultation
dischargeSummary
historyAndPhysical
laboratory
pathologyReport
procedure
progress
radiologyReport

DocumentAdministrativeMetadata

Object

Documentar metadatos administrativos

Nombre	Tipo	Description
encounterId	string	Referencia al encuentro asociado al documento.
orderedProcedures	OrderedProcedure[]	Lista de información de procedimiento asociada al documento.

DocumentAuthor

Object

Autor del documento

Nombre	Tipo	Description
fullName	string	Representación de texto del nombre completo
id	string	id. de autor

DocumentContent

Object

Contenido del documento del paciente.

Nombre	Tipo	Description
sourceType	DocumentContentSourceType	Tipo del origen del contenido. En caso de que el tipo de origen sea "insertado", el contenido se asigna como una cadena (por ejemplo, texto). En caso de que el tipo de origen sea "referencia", el contenido se asigna como un URI.
value	string	Contenido del documento, dado en línea (como una cadena) o como referencia (URI).

DocumentContentSourceType

Enumeración

Tipo del origen del contenido. En caso de que el tipo de origen sea "insertado", el contenido se asigna como una cadena (por ejemplo, texto). En caso de que el tipo de origen sea "referencia", el contenido se asigna como un URI.

Valor	Description
inline	El contenido se da como una cadena (por ejemplo, texto).
reference	El contenido se da como un URI.

DocumentType

Enumeración

Tipo del documento del paciente, como "nota" (documento de texto) o "fhirBundle" (documento JSON de FHIR).

Valor	Description
dicom
fhirBundle
genomicSequencing
note

Encounter

Object

información de visita/encuentro

Nombre	Tipo	Description
class	EncounterClass	Clase del encuentro.
id	string	Identificador de la visita.
period	TimePeriod	Período de tiempo de la visita. En caso de admisión, use timePeriod.start para indicar el tiempo de admisión y timePeriod.end para indicar el tiempo de descarga.

EncounterClass

Enumeración

Códigos de valores conocidos que se pueden usar para indicar la clase de encuentro (TODO://Based en el valor de FHIR set--http://....).

Valor	Description
ambulatory	El término cohorte generalmente implica que el paciente ha llegado a la ubicación y no está asignado a una cama. A veces se conoce como un encuentro externo.
emergency	Un encuentro de pacientes que tiene lugar en una ubicación dedicada de entrega del servicio sanitario donde el paciente recibe evaluación y tratamiento inmediatos, siempre que el paciente pueda ser dado de alta o responsabilidad por la atención del paciente se transfiere a otro lugar (por ejemplo, el paciente podría ser admitido como un paciente internado o transferido a otra instalación.
healthHome	Encuentro sanitario que tiene lugar en la residencia del paciente o en un destinatario
inpatient	Un paciente se encuentra donde un paciente es admitido por un hospital o un centro equivalente, asignado a una ubicación donde los pacientes generalmente permanecen al menos durante la noche y se proporcionan con sala, pensión y servicio de enfermería continua.
observation	Un encuentro en el que el paciente generalmente comenzará en diferentes encuentros, como uno en el departamento de emergencia, pero luego transición a este tipo de encuentro porque requieren un período significativo de tratamiento y supervisión para determinar si su condición garantiza o no una admisión o descarga inpatient.
virtual	Un encuentro de pacientes en el que el paciente no está presente físicamente para el encuentro, como en un encuentro de telehealth, llamada telefónica o comunicación electrónica.

Fhir.R4.CodeableConcept

Object

Concepto: referencia a una terminología o solo texto basado en CodeableConcept de FHIR

Nombre	Tipo	Description
coding	Fhir.R4.Coding[]	Código definido por un sistema de terminología
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
text	string	Representación de texto sin formato del concepto

Fhir.R4.Coding

Object

Una codificación es una representación de un concepto definido mediante un símbolo de un "sistema de código" definido. Basado en de codificación de FHIR

Nombre	Tipo	Description
code	string	Símbolo en la sintaxis definida por el sistema
display	string	Representación definida por el sistema
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
system	string	Identidad del sistema de terminología
version	string	Versión del sistema: si procede

Fhir.R4.Extension

Object

Base para todos los elementos Basado en el elemento FHIR

Nombre	Tipo	Description
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
url	string	Origen de la definición del código de extensión: un nombre lógico o una dirección URL.
valueBoolean	boolean	Valor como booleano
valueCodeableConcept	Fhir.R4.CodeableConcept	Valor como CodeableConcept
valueDateTime	string pattern: ([0-9]([0-9]([0-9][1-9]|[1-9]0)|[1-9]00)|[1-9]000)(-(0[1-9]|1[0-2])(-(0[1-9]|[1-2][0-9]|3[0-1])(T([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-9]{1,9})?)?)?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00)?)?)?	Valor como dateTime.
valueInteger	integer (int32)	Valor como entero
valuePeriod	Fhir.R4.Period	Valor como Punto.
valueQuantity	Fhir.R4.Quantity	Valor como cantidad
valueRange	Fhir.R4.Range	Valor como Intervalo.
valueRatio	Fhir.R4.Ratio	Valor como relación.
valueReference	Fhir.R4.Reference	Valor como referencia.
valueSampledData	Fhir.R4.SampledData	Valor como SampledData.
valueString	string	Valor como cadena
valueTime	string (time)	Valor como hora (hh:mm:ss)

Fhir.R4.Identifier

Object

Identificador destinado al cálculo basado en el identificador de FHIR

Nombre	Tipo	Description
assigner	Fhir.R4.Reference	Organización que emitió el identificador (puede ser simplemente texto)
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
period	Fhir.R4.Period	Período de tiempo en el que el identificador es o era válido para su uso
system	string	Espacio de nombres para el valor de identificador
type	Fhir.R4.CodeableConcept	Descripción del identificador
use	string	habitual | oficial | temp | secundario | old (Si se conoce)
value	string	Valor único

Fhir.R4.Meta

Object

Metadatos sobre un recurso basado en meta de FHIR

Nombre	Tipo	Description
lastUpdated	string pattern: ([0-9]([0-9]([0-9][1-9]|[1-9]0)|[1-9]00)|[1-9]000)-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])T([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-9]{1,9})?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))	Cuando el recurso cambió por última vez, por ejemplo, cuando cambió la versión.
profile	string[]	Lista de perfiles (referencias a recursos StructureDefinition ) a los que este recurso reclama que se ajuste. La dirección URL es una referencia a StructureDefinition.url.
security	Fhir.R4.Coding[]	Etiquetas de seguridad aplicadas a este recurso. Estas etiquetas conectan recursos específicos a la infraestructura y la directiva de seguridad generales.
source	string	URI que identifica el sistema de origen del recurso. Esto proporciona una cantidad mínima de información de provenencia que se puede usar para realizar un seguimiento o diferenciar el origen de información en el recurso. El origen puede identificar otro servidor de FHIR, documento, mensaje, base de datos, etc.
tag	Fhir.R4.Coding[]	Etiquetas aplicadas a este recurso. Las etiquetas están diseñadas para usarse para identificar y relacionar recursos con el proceso y el flujo de trabajo, y las aplicaciones no son necesarias para tener en cuenta las etiquetas al interpretar el significado de un recurso.
versionId	string	Identificador específico de la versión, tal como aparece en la parte de versión de la dirección URL. Este valor cambia cuando se crea, actualiza o elimina el recurso.

Fhir.R4.Period

Object

Un período de tiempo definido por una fecha de inicio y finalización y, opcionalmente, hora basada en el período de FHIR

Nombre	Tipo	Description
end	string pattern: ([0-9]([0-9]([0-9][1-9]|[1-9]0)|[1-9]00)|[1-9]000)(-(0[1-9]|1[0-2])(-(0[1-9]|[1-2][0-9]|3[0-1])(T([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-9]{1,9})?)?)?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00)?)?)?	Hora de finalización con límite inclusivo, si no está en curso
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
start	string pattern: ([0-9]([0-9]([0-9][1-9]|[1-9]0)|[1-9]00)|[1-9]000)(-(0[1-9]|1[0-2])(-(0[1-9]|[1-2][0-9]|3[0-1])(T([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)(\.[0-9]{1,9})?)?)?(Z|(\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00)?)?)?	Hora de inicio con límite inclusivo

Fhir.R4.Quantity

Object

Cantidad medida o medible basada en la cantidad de FHIR

Nombre	Tipo	Description
code	string	Forma codificada de la unidad
comparator	string	< | <= | >= | >: cómo comprender el valor
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
system	string	Sistema que define el formulario de unidad codificada
unit	string	Representación de unidad
value	number (double)	Valor numérico (con precisión implícita)

Fhir.R4.Range

Object

Conjunto de cantidades ordenadas definidas por un límite bajo y alto basado en el intervalo de FHIR

Nombre	Tipo	Description
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
high	Fhir.R4.Quantity	Límite alto
id	string	Identificador único para la referencia entre elementos
low	Fhir.R4.Quantity	Límite bajo

Fhir.R4.Ratio

Object

Relación de dos valores quantity: un numerador y un denominador basado en la relación de FHIR

Nombre	Tipo	Description
denominator	Fhir.R4.Quantity	Valor del denominador
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
numerator	Fhir.R4.Quantity	Valor del numerador

Fhir.R4.Reference

Object

Referencia de un recurso a otro basado en la referencia de FHIR

Nombre	Tipo	Description
display	string	Alternativa de texto para el recurso
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
id	string	Identificador único para la referencia entre elementos
identifier	Fhir.R4.Identifier	Referencia lógica, cuando no se conoce la referencia literal
reference	string	Referencia literal, Relativa, dirección URL interna o absoluta
type	string	Escriba la referencia hace referencia a (por ejemplo, "Paciente")

Fhir.R4.Resource

Object

Resource es el antecesor de DomainResource del que se derivan la mayoría de los recursos. Agrupación, parámetros y recurso binario extendido directamente. Basado en [recurso de FHIR](https://www.hl7.org/fhir/r4/resource.html

Nombre	Tipo	Description
id	string	Identificador de recurso
implicitRules	string	Conjunto de reglas en las que se creó este contenido
language	string	Idioma del contenido del recurso
meta	Fhir.R4.Meta	Metadatos sobre el recurso
resourceType	string	Tipo de recurso

Fhir.R4.SampledData

Object

Una serie de medidas tomadas por un dispositivo basado en FHIR SampledData

Nombre	Tipo	Description
data	string	Valores decimales con espacios o "E" | "U" | "L"
dimensions	integer (int32) minimum: 1	Número de puntos de ejemplo en cada momento
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones
factor	number (double)	Multiplique los datos antes de agregarlos al origen.
id	string	Identificador único para la referencia entre elementos
lowerLimit	number (double)	Límite inferior de detección
origin	Fhir.R4.Quantity	Valor cero y unidades
period	number (double)	Número de milisegundos entre muestras
upperLimit	number (double)	Límite superior de detección

OrderedProcedure

Object

Información del procedimiento

Nombre	Tipo	Description
code	Fhir.R4.CodeableConcept	Código de procedimiento
description	string	Descripción del procedimiento
extension	Fhir.R4.Extension[]	Contenido adicional definido por implementaciones

PatientDocument

Object

Un documento clínico relacionado con un paciente. El documento está aquí en el sentido amplio, no solo un documento de texto (nota).

Nombre	Tipo	Description
administrativeMetadata	DocumentAdministrativeMetadata	Metadatos administrativos del documento.
authors	DocumentAuthor[]	Autores de documentos
clinicalType	ClinicalDocumentType	Tipo del documento clínico.
content	DocumentContent	Contenido del documento del paciente.
createdDateTime	string (date-time)	La fecha y hora en que se creó el documento.
id	string minLength: 1	Identificador determinado para el documento. Debe ser único en todos los documentos para un solo paciente.
language	string	Representación ISO 639-1 de 2 letras del idioma del documento.
specialtyType	SpecialtyType	tipo de especialidad en el documento
type	DocumentType	Tipo del documento del paciente, como "nota" (documento de texto) o "fhirBundle" (documento JSON de FHIR).

PatientInfo

Object

Información estructurada del paciente, incluyendo datos demográficos y información clínica estructurada conocida.

Nombre	Tipo	Description
birthDate	string (date)	Fecha de nacimiento del paciente.
clinicalInfo	Fhir.R4.Resource[]	Información clínica conocida para el paciente, estructurado.
sex	PatientInfoSex	El sexo del paciente.

PatientInfoSex

Enumeración

El sexo del paciente.

Valor	Description
female
male
unspecified

PatientRecord

Object

Un registro de pacientes, incluida su información clínica y sus datos.

Nombre	Tipo	Description
encounters	Encounter[]	Encuentro/visitas de pacientes.
id	string minLength: 1	Identificador determinado para el paciente. Debe ser único en todos los pacientes en una sola solicitud.
info	PatientInfo	Información estructurada del paciente, incluyendo datos demográficos y información clínica estructurada conocida.
patientDocuments	PatientDocument[]	Datos clínicos no estructurados del paciente, dados como documentos.

PatientTimelineData

Object

Cuerpo de la solicitud de escala de tiempo del paciente.

Nombre	Tipo	Description
configuration	PatientTimelineModelConfiguration	Configuración que afecta a la inferencia del modelo de escala de tiempo del paciente.
patients	PatientRecord[]	La lista de pacientes, incluida su información clínica y sus datos.

PatientTimelineModelConfiguration

Object

Configuración que afecta a la inferencia del modelo de escala de tiempo del paciente.

Nombre	Tipo	Valor predeterminado	Description
includeEvidence	boolean	True	Indicación de si la salida del modelo debe incluir evidencia para las inferencias.
verbose	boolean	False	Indicación de si el modelo debe generar una salida detallada.

SpecialtyType

Enumeración

Códigos de valores conocidos que se pueden usar para indicar el tipo de especialidad.

Valor	Description
pathology	Patología
radiology	radiología

TimePeriod

Object

Duración del tiempo durante el que se produce un evento

Nombre	Tipo	Description
end	string (date-time)	Hora de finalización con límite inclusivo, si no está en curso
start	string (date-time)	Hora de inicio con límite inclusivo