La [Guía de referencia de la API de AWS SDK for JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) describe en detalle todas las operaciones de la API para la versión 3 (V3) de AWS SDK for JavaScript.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Amazon Transcribe Medical
En este ejemplo, se utilizan una serie de módulos de Node.js para crear, enumerar y eliminar trabajos de transcripción médica mediante los siguientes métodos de la clase de cliente de `TranscribeService`:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListTranscriptionJobsCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteTranscriptionJobCommand/)
Para obtener más información acerca de los usuarios de Amazon Transcribe, consulte la [Guía para desarrolladores de Amazon Transcribe](https://docs.aws.amazon.com//transcribe/latest/dg/what-is-transcribe.html).
## Tareas previas necesarias
Para configurar y ejecutar este ejemplo, primero debe completar estas tareas:
+ Configure el entorno del proyecto para ejecutar estos TypeScript ejemplos de Node e instale los módulos necesarios AWS SDK para JavaScript y de terceros. Siga las instrucciones de [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/README.md).
+ Cree un archivo de configuraciones compartidas con sus credenciales de usuario. Para obtener más información sobre cómo proporcionar un archivo de credenciales compartido, consulte [Archivos de configuración y credenciales compartidos](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) en la *Guía de referencia de herramientas AWS SDKs y herramientas*.
**importante**
En estos ejemplos se muestra cómo hacer un import/export cliente para ejecutar comandos y objetos de servicio mediante ECMAScript6 (ES6).
Requiere la versión 13.x o superior de Node.js. Para descargar e instalar la versión más reciente de Node.js, consulte [Descargas de Node.js](https://nodejs.org/en/download).
Si prefiere utilizar la sintaxis CommonJS, consulte [Sintaxis ES6/commonJS de JavaScript](sdk-example-javascript-syntax.md)
## Cómo iniciar un trabajo de transcripción de Amazon Transcribe Medical
En este ejemplo se muestra cómo iniciar un trabajo de transcripción de Amazon Transcribe Medical utilizando AWS SDK for JavaScript. Para obtener más información, consulte [startMedicalTranscriptionJob](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/StartMedicalTranscriptionJobCommand/).
Cree un directorio `libs` y un módulo Node.js con el nombre de archivo `transcribeClient.js`. Copie y pegue el siguiente código en él, para crear el objeto de cliente Amazon Transcribe. *REGION*Reemplácelo por su AWS región.
```
import { TranscribeClient } from "@aws-sdk/client-transcribe";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Transcribe service object.
const transcribeClient = new TranscribeClient({ region: REGION });
export { transcribeClient };
```
Puedes encontrar este código de ejemplo [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js).
Cree un módulo de Node.js con el nombre de archivo `transcribe-create-medical-job.js`. Asegúrese de configurar el SDK como se mostró anteriormente, incluida la instalación de los clientes y paquetes necesarios. Cree un objeto de parámetros especificando los parámetros necesarios. Inicie el trabajo médico con el comando `StartMedicalTranscriptionJobCommand`.
**nota**
*MEDICAL\$1JOB\$1NAME*Sustitúyalo por un nombre para el trabajo de transcripción médica. Para *OUTPUT\$1BUCKET\$1NAME* especificar el bucket de Amazon S3 en el que se guarda la salida. Para *JOB\$1TYPE* especificar los tipos de trabajo. Para *SOURCE\$1LOCATION* especificar la ubicación del archivo fuente. Para *SOURCE\$1FILE\$1LOCATION* especificar la ubicación del archivo multimedia de entrada.
```
// Import the required AWS SDK clients and commands for Node.js
import { StartMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // Required
OutputBucketName: "OUTPUT_BUCKET_NAME", // Required
Specialty: "PRIMARYCARE", // Required. Possible values are 'PRIMARYCARE'
Type: "JOB_TYPE", // Required. Possible values are 'CONVERSATION' and 'DICTATION'
LanguageCode: "LANGUAGE_CODE", // For example, 'en-US'
MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav'
Media: {
MediaFileUri: "SOURCE_FILE_LOCATION",
// The S3 object location of the input media file. The URI must be in the same region
// as the API endpoint that you are calling.For example,
// "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav"
},
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new StartMedicalTranscriptionJobCommand(params),
);
console.log("Success - put", data);
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.
```
node transcribe-create-medical-job.js
```
Este código de ejemplo se puede encontrar [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_create_medical_job.js).
## Obtener una lista de trabajos de Amazon Transcribe Medical
En este ejemplo, se muestra cómo obtener una lista de los trabajos de transcripción de Amazon Transcribe utilizando AWS SDK for JavaScript. Para obtener más información, consulte [ListTranscriptionMedicalJobsCommand](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/ListMedicalTranscriptionJobsCommand/).
Cree un directorio `libs` y un módulo Node.js con el nombre de archivo `transcribeClient.js`. Copie y pegue el siguiente código en él, para crear el objeto de cliente Amazon Transcribe. *REGION*Reemplácelo por su AWS región.
```
import { TranscribeClient } from "@aws-sdk/client-transcribe";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create an Amazon Transcribe service client object.
const transcribeClient = new TranscribeClient({ region: REGION });
export { transcribeClient };
```
Puedes encontrar este código de ejemplo [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js).
Cree un módulo de Node.js con el nombre de archivo `transcribe-list-medical-jobs.js`. Asegúrese de configurar el SDK como se mostró anteriormente, incluida la instalación de los clientes y paquetes necesarios. Cree un objeto de parámetros con los parámetros necesarios y obtenga una lista de los trabajos médicos utilizando el comando `ListMedicalTranscriptionJobsCommand`.
**nota**
*KEYWORD*Sustitúyalo por una palabra clave que deba contener el nombre de los trabajos devueltos.
```
// Import the required AWS SDK clients and commands for Node.js
import { ListMedicalTranscriptionJobsCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
JobNameContains: "KEYWORD", // Returns only transcription job names containing this string
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new ListMedicalTranscriptionJobsCommand(params),
);
console.log("Success", data.MedicalTranscriptionJobName);
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.
```
node transcribe-list-medical-jobs.js
```
Este código de ejemplo se puede encontrar [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_list_medical_jobs.js).
## Eliminar un trabajo de Amazon Transcribe Medical
En este ejemplo, se muestra cómo eliminar un trabajo de transcripción de Amazon Transcribe utilizando AWS SDK for JavaScript. Para obtener más información sobre los elementos opcionales, consulte [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteMedicalTranscriptionJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-transcribe/Class/DeleteMedicalTranscriptionJobCommand/).
Cree un directorio `libs` y un módulo Node.js con el nombre de archivo `transcribeClient.js`. Copie y pegue el siguiente código en él, para crear el objeto de cliente Amazon Transcribe. *REGION*Reemplácelo por su AWS región.
```
import { TranscribeClient } from "@aws-sdk/client-transcribe";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Transcribe service object.
const transcribeClient = new TranscribeClient({ region: REGION });
export { transcribeClient };
```
Puedes encontrar este código de ejemplo [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/libs/transcribeClient.js).
Cree un módulo de Node.js con el nombre de archivo `transcribe-delete-job.js`. Asegúrese de configurar el SDK como se mostró anteriormente, incluida la instalación de los clientes y paquetes necesarios. Cree un objeto de parámetros con los parámetros necesarios y elimine el trabajo médico utilizando el comando `DeleteMedicalJobCommand`.
**nota**
*JOB\$1NAME*Sustitúyalo por el nombre del trabajo que se va a eliminar.
```
// Import the required AWS SDK clients and commands for Node.js
import { DeleteMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // For example, 'medical_transciption_demo'
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new DeleteMedicalTranscriptionJobCommand(params),
);
console.log("Success - deleted");
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.
```
node transcribe-delete-medical-job.js
```
Este código de ejemplo se puede encontrar [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/transcribe/src/transcribe_delete_medical_job.js).