Skip to content

/AWS1/IF_CNH=>STARTMEDICSCRIBELISTENSESS()

About StartMedicalScribeListeningSession

Starts a new Medical Scribe listening session for real-time audio transcription

Method Signature

METHODS /AWS1/IF_CNH~STARTMEDICSCRIBELISTENSESS
  IMPORTING
    !IV_SESSIONID TYPE /AWS1/CNHSCRIBESESSIONID OPTIONAL
    !IV_DOMAINID TYPE /AWS1/CNHDOMAINID OPTIONAL
    !IV_SUBSCRIPTIONID TYPE /AWS1/CNHSUBSCRIPTIONID OPTIONAL
    !IV_LANGUAGECODE TYPE /AWS1/CNHMEDICALSCRIBELANGCODE OPTIONAL
    !IV_MEDIASAMPLERATEHERTZ TYPE /AWS1/CNHMEDSCRMEDIASMPRATEH00 OPTIONAL
    !IV_MEDIAENCODING TYPE /AWS1/CNHMEDICSCRIBEMEDIAENCOD OPTIONAL
    !IO_INPUTSTREAM TYPE REF TO /AWS1/IF_CNHMEDSCRINPUTSTRM_IS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_cnhstrtmedscrlstnse01
  RAISING
    /AWS1/CX_CNHACCESSDENIEDEX
    /AWS1/CX_CNHINTERNALSERVEREX
    /AWS1/CX_CNHRESOURCENOTFOUNDEX
    /AWS1/CX_CNHSERVICEQUOTAEXCDEX
    /AWS1/CX_CNHTHROTTLINGEX
    /AWS1/CX_CNHVLDTNEXCEPTION
    /AWS1/CX_CNHCLIENTEXC
    /AWS1/CX_CNHSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_sessionid TYPE /AWS1/CNHSCRIBESESSIONID /AWS1/CNHSCRIBESESSIONID

The Session identifier

iv_domainid TYPE /AWS1/CNHDOMAINID /AWS1/CNHDOMAINID

The Domain identifier

iv_subscriptionid TYPE /AWS1/CNHSUBSCRIPTIONID /AWS1/CNHSUBSCRIPTIONID

The Subscription identifier

iv_languagecode TYPE /AWS1/CNHMEDICALSCRIBELANGCODE /AWS1/CNHMEDICALSCRIBELANGCODE

The Language Code for the audio in the session

iv_mediasampleratehertz TYPE /AWS1/CNHMEDSCRMEDIASMPRATEH00 /AWS1/CNHMEDSCRMEDIASMPRATEH00

The sample rate of the input audio

iv_mediaencoding TYPE /AWS1/CNHMEDICSCRIBEMEDIAENCOD /AWS1/CNHMEDICSCRIBEMEDIAENCOD

The encoding for the input audio

Optional arguments:

io_inputstream TYPE REF TO /AWS1/IF_CNHMEDSCRINPUTSTRM_IS /AWS1/IF_CNHMEDSCRINPUTSTRM_IS

RETURNING

oo_output TYPE REF TO /aws1/cl_cnhstrtmedscrlstnse01 /AWS1/CL_CNHSTRTMEDSCRLSTNSE01

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->startmedicscribelistensess(
  io_inputstream = lo_stream
  iv_domainid = |string|
  iv_languagecode = |string|
  iv_mediaencoding = |string|
  iv_mediasampleratehertz = 123
  iv_sessionid = |string|
  iv_subscriptionid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_scribesessionid = lo_result->get_sessionid( ).
  lv_domainid = lo_result->get_domainid( ).
  lv_subscriptionid = lo_result->get_subscriptionid( ).
  lv_requestid = lo_result->get_requestid( ).
  lv_medicalscribelanguageco = lo_result->get_languagecode( ).
  lv_medicalscribemediasampl = lo_result->get_mediasampleratehertz( ).
  lv_medicalscribemediaencod = lo_result->get_mediaencoding( ).
  TRY.
    WHILE lo_result->get_responsestream( )->/aws1/if_rt_stream_reader~data_available( ) = ABAP_TRUE.
      lo_event = lo_result->get_responsestream( )->READ( ).
      IF lo_event->get_transcriptevent( ) IS NOT INITIAL.
        " process this kind of event
      ENDIF.
    ENDWHILE.
  CATCH /aws1/cx_cnhvldtnexception.
    " handle error in stream
  CATCH /aws1/cx_cnhinternalserverex.
    " handle error in stream
  ENDTRY.
ENDIF.