This code sample can be used to process a single document and send the processed data for human review.
For a comprehensive collection of code samples for the on-premises or any cloud edition of ABAP SDK for Google Cloud, see the code samples repository on GitHub.
Code sample
SAP BTP edition
" --------------------------------------------------------------------
" Copyright 2024 Google LLC -
" -
" Licensed under the Apache License, Version 2.0 (the "License"); -
" you may not use this file except in compliance with the License. -
" You may obtain a copy of the License at -
" https://www.apache.org/licenses/LICENSE-2.0 -
" Unless required by applicable law or agreed to in writing, -
" software distributed under the License is distributed on an -
" "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, -
" either express or implied. -
" See the License for the specific language governing permissions -
" and limitations under the License. -
" --------------------------------------------------------------------
CLASS zcl_cs_human_review DEFINITION
PUBLIC FINAL
CREATE PUBLIC.
PUBLIC SECTION.
INTERFACES if_oo_adt_classrun.
ENDCLASS.
CLASS zcl_cs_human_review IMPLEMENTATION.
METHOD if_oo_adt_classrun~main.
" Data Declarations
DATA lv_p_projects_id TYPE string.
DATA lv_p_locations_id TYPE string.
DATA lv_p_processors_id TYPE string.
DATA ls_input_proc TYPE /goog/cl_documentai_v1=>ty_084.
DATA ls_input TYPE /goog/cl_documentai_v1=>ty_092.
DATA lo_exception TYPE REF TO /goog/cx_sdk.
TRY.
DATA(lo_client) = NEW /goog/cl_documentai_v1( iv_key_name = 'DEMO_DOCAI' ).
" Developer to populate relevant parameters for the API call
lv_p_projects_id = lo_client->gv_project_id.
" Location ID of the Processor
lv_p_locations_id = 'LOCATION_ID'.
" Processor ID of the Processor
lv_p_processors_id = 'PROCESSOR_ID'.
" Developer to fetch the content and mime type of the file to be processed
" Content of the file in base-64 format
ls_input_proc-raw_document-content = 'CONTENT'.
" Mime type of the file
ls_input_proc-raw_document-mime_type = 'MIME_TYPE'.
" Call the API
lo_client->process_processors( EXPORTING iv_p_projects_id = lv_p_projects_id
iv_p_locations_id = lv_p_locations_id
iv_p_processors_id = lv_p_processors_id
is_input = ls_input_proc
IMPORTING es_output = DATA(ls_output_proc)
ev_ret_code = DATA(ev_ret_code)
ev_err_text = DATA(ev_err_text)
es_err_resp = DATA(es_err_resp) ).
IF /goog/cl_http_client=>is_success( ev_ret_code ).
" Pass the processed document to importing parameters to send for 'Human Review'
ls_input-inline_document = ls_output_proc-document.
" Call API method to send processed document for 'Human Review'
lo_client->review_document_human_revie( EXPORTING iv_p_projects_id = lv_p_projects_id
iv_p_locations_id = lv_p_locations_id
iv_p_processors_id = lv_p_processors_id
is_input = ls_input
IMPORTING es_output = DATA(ls_output)
ev_ret_code = DATA(lv_ret_code)
ev_err_text = DATA(lv_err_text)
es_err_resp = DATA(ls_err_resp) ).
IF /goog/cl_http_client=>is_success( lv_ret_code ).
out->write( | Success | ).
ELSE.
out->write( | Error occurred: { ev_err_text }| ).
ENDIF.
ELSE.
out->write( | Error occurred: { ev_err_text }| ).
ENDIF.
" Close HTTP Connection
lo_client->close( ).
CATCH /goog/cx_sdk INTO DATA(lo_exp).
ev_err_text = lo_exp->get_text( ).
out->write( | Error occurred: { ev_err_text }| ).
ENDTRY.
ENDMETHOD.
ENDCLASS.
On-premises or any cloud edition
**********************************************************************
* Copyright 2023 Google LLC *
* *
* Licensed under the Apache License, Version 2.0 (the "License"); *
* you may not use this file except in compliance with the License. *
* You may obtain a copy of the License at *
* https://www.apache.org/licenses/LICENSE-2.0 *
* Unless required by applicable law or agreed to in writing, *
* software distributed under the License is distributed on an *
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, *
* either express or implied. *
* See the License for the specific language governing permissions *
* and limitations under the License. *
**********************************************************************
REPORT zr_human_review.
DATA:
lt_bin_data TYPE STANDARD TABLE OF char1024,
ls_input_proc TYPE /goog/cl_documentai_v1=>ty_084,
ls_input TYPE /goog/cl_documentai_v1=>ty_092,
lv_p_projects_id TYPE string,
lv_p_locations_id TYPE string,
lv_p_processors_id TYPE string,
lv_file TYPE string,
lv_file_length TYPE i,
lv_xfile TYPE xstring,
lv_output TYPE string.
lv_file = 'BROWSED_FILE_PATH'. "File path of document to be processed
* Call function module to upload the file contents
CALL FUNCTION 'GUI_UPLOAD'
EXPORTING
filename = lv_file
filetype = 'BIN'
IMPORTING
filelength = lv_file_length
TABLES
data_tab = lt_bin_data.
* Call function module to convert file contents from 'BIN' to 'XSTRIG' format
CALL FUNCTION 'SCMS_BINARY_TO_XSTRING'
EXPORTING
input_length = lv_file_length
IMPORTING
buffer = lv_xfile
TABLES
binary_tab = lt_bin_data.
* Call function module to convert the file contents from 'XSTRING' to 'base-64 encoded' format
CALL FUNCTION 'SCMS_BASE64_ENCODE_STR'
EXPORTING
input = lv_xfile
IMPORTING
output = lv_output.
TRY.
* Open HTTP Connection
DATA(lo_client) = NEW /goog/cl_documentai_v1( iv_key_name = 'CLIENT_KEY' ).
* Populate relevant parameters
lv_p_projects_id = lo_client->gv_project_id.
lv_p_locations_id = 'LOCATION_ID'. "Location ID of the Processor
lv_p_processors_id = 'PROCESSOR_ID'. "Processor ID of the Processor
ls_input_proc-raw_document-content = lv_output. "File contents in base64-encoded format
ls_input_proc-raw_document-mime_type = 'MIME_TYPE'. "MIME Type of the file
* Call API method to process the document
CALL METHOD lo_client->process_processors
EXPORTING
iv_p_projects_id = lv_p_projects_id
iv_p_locations_id = lv_p_locations_id
iv_p_processors_id = lv_p_processors_id
is_input = ls_input_proc
IMPORTING
es_output = DATA(ls_output_proc)
ev_ret_code = DATA(lv_ret_code)
ev_err_text = DATA(lv_err_text)
es_err_resp = DATA(ls_err_resp).
IF /goog/cl_http_client=>is_success( lv_ret_code ).
* Pass the processed document to importing parameters to send for 'Human Review'
ls_input-inline_document = ls_output_proc-document.
* Call API method to send processed document for 'Human Review'
CALL METHOD lo_client->review_document_human_revie
EXPORTING
iv_p_projects_id = lv_p_projects_id
iv_p_locations_id = lv_p_locations_id
iv_p_processors_id = lv_p_processors_id
is_input = ls_input
IMPORTING
es_output = DATA(ls_output)
ev_ret_code = lv_ret_code
ev_err_text = lv_err_text
es_err_resp = ls_err_resp.
IF /goog/cl_http_client=>is_success( lv_ret_code ).
MESSAGE 'Success' TYPE 'S'.
ELSE.
MESSAGE lv_err_text TYPE 'E'.
ENDIF.
ELSE.
MESSAGE lv_err_text TYPE 'E'.
ENDIF.
* Close HTTP Connection
lo_client->close( ).
CATCH /goog/cx_sdk INTO DATA(lo_exception).
MESSAGE lo_exception->get_text( ) TYPE 'E'.
ENDTRY.