API de solicitação de ajuda remota
. Solicitação de ajuda remota A API fornece endpoints para criar, exibir e buscar listas de solicitações de serviço de TI e seus detalhes de um sistema de registro médico eletrônico (EMR). Uma solicitação de serviço DE TI está associada a um tipo de tarefa, como um incidente no ServiceNow instância.
Você só pode usar esta API quando Ajuda para prontuários médicos eletrônicos a aplicação (sn_ind_rmt_help) é instalada a partir do ServiceNow Store. Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.
Função necessária para acessar os endpoints desta API: sn_ind_rmt_help.requester.
Solicitação de ajuda remota - POST /remote_help_request/
Insere dados do sistema de registro médico eletrônico (EMR) no correspondente ServiceNow tabelas.
Você precisa especificar um ID de definição da solicitação além dos parâmetros da tarefa e dos dados adicionais do Sistema EMR persistente na tabela de dados de solicitação associada à tarefa. Dois tipos de dados são passados para este endpoint. O primeiro são os dados da solicitação, que o endpoint insere na tabela Dados da solicitação remota [sn_ind_rmt_help_request_data] e suas tabelas secundárias associadas. O segundo são os parâmetros de tarefa da solicitação de serviço DE TI, que o endpoint insere na tabela Parâmetro de solicitação remota [sn_ind_rmt_help_request_param]. Somente dados ou campos definidos em definições de solicitação são processados pelo endpoint. Para obter informações adicionais sobre este modelo de dados, consulte Modelo de dados de Ajuda do EMR .
Os registros são identificados usando o ID de definição da solicitação.
Formato de URL
URL com controle de versão: /api/sn_ind_rmt_help/
URL padrão: /api/sn_ind_rmt_help/remote_help_request/
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| req_defn_id | ID exclusivo da definição da solicitação. Tipo de dados: Cadeia de caracteres Coluna ID da tabela Definição de solicitação remota [sn_ind_rmt_help_request_defn]. |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
| Nome | Descrição |
|---|---|
| request_data | Obrigatório. Pares nome-valor dos dados de solicitação do Sistema EMR Para adicionar a tabela Dados da solicitação remota [sn_ind_rmt_help_request_data] e suas tabelas secundárias. Por exemplo: Nota: Passar somente parâmetros configurados em uma definição de solicitação no request_dataobjeto. Quaisquer outros parâmetros são ignorados. Para saber mais, consulte Configure definições de solicitação para sistemas EMR . Tipo de dados: Objeto |
| origem | Obrigatório. Nome do sistema EMR que invoca o endpoint conforme especificado em uma definição de solicitação. Por exemplo: Tipo de dados: Cadeia de caracteres |
| task_parameters | Obrigatório. Pares nome-valor que descrevem os parâmetros de tarefa da solicitação de serviço de TI. Cada elemento no objeto corresponde a uma coluna nas tabelas de tarefas correspondentes, como a tabela Incidente [incidente]. Por exemplo: Nota: Passar somente parâmetros configurados em uma definição de solicitação no task_parametersobjeto. Quaisquer outros parâmetros são ignorados. Para saber mais, consulte Configure definições de solicitação para sistemas EMR . Tipo de dados: Objeto |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
Parâmetros do corpo da resposta (JSON)
| Nome | Descrição |
|---|---|
| resultado | Objeto de resultado. Tipo de dados: Objeto
|
| result.code | Código de erro da aplicação quando result.statusretornado como falha . Tipo de dados: Cadeia de caracteres |
| resultado.erro | Mensagem de erro incluída se result.statusfalha. Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| ErroTranslatado | Mensagem de erro localizada opcional. Tipo de dados: Cadeia de caracteres |
| result.status | Status da resposta. Valores válidos:
Tipo de dados: Cadeia de caracteres |
| result.task_id | Sys_id da tarefa criada. Tipo de dados: Cadeia de caracteres |
| result.task_table | Nome da tabela de tarefas na qual a tarefa foi criada conforme definido na definição da solicitação. Tipo de dados: Cadeia de caracteres |
| resultado.aviso | Mensagem de aviso opcional. Pode ser incluído se result.status. sucesso . Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| WarningTraduzido | Mensagem de aviso localizada opcional. Tipo de dados: Cadeia de caracteres |
Solicitação de curl
Insira dados de um sistema Cerner EMR.
curl "https://instance.servicenow.com/api/sn_ind_rmt_help/v1/remote_help_request/sn_it_request"
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data "{
"source":"Cerner",
"task_parameters":{
"short_description":"Unable to load patient data",
"caller_id":"82d4ecb4db40e8100e28aa594b96195c",
"impact":"2",
"contact_type":"email"
},
"request_data":{
"application":"Powerchart",
"server":"CTXCHSITN453",
"environment":"CTX24",
"issue_type":"Helpdesk",
"millennium_username":"JOHN JASON",
"position":"Lab Tech",
"session_recording_id":"s5ds34dd96491b959a35010651896k",
"user_is_physician":"Yes",
"work_station":"PC354FLR3STATION7",
"additional_info":"MRN 222333"
}
}" \
--user "username":"password"
A saída a seguir mostra uma resposta bem-sucedida e uma resposta de erro.
// Successful response
{
"result": {
"task_id": "75b09061db2cac100e28aa594b9619fa",
"status": "success",
"task_table": "incident",
"warning": "Ignored invalid fields on table incident : test1",
"warningTranslated": "Ignored invalid fields on table incident : test1"
}
}
// Error response
{
"result": {
"status": "failure",
"code": "1001",
"error": "Invalid request definition: test_request1",
"errorTranslated": "Invalid request definition: test_request1"
}
}
Solicitação de ajuda remota - PUT /remote_help_request/
Atualiza um registro na tabela de dados de solicitação remota especificada para a tarefa.
Permite que você especifique um ID de definição de solicitação além da tarefa sys_id para atualizar uma solicitação remota que foi criada anteriormente.
Formato de URL
URL com controle de versão: /api/sn_ind_rmt_help//req_defn_id/task/
URL padrão: /api/sn_ind_rmt_help/remote_help_request/
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| req_defn_id | ID exclusivo da definição da solicitação. Tipo de dados: Cadeia de caracteres Coluna ID da tabela Definição de solicitação remota [sn_ind_rmt_help_request_defn]. |
| task_id | Sys_id da tarefa a ser atualizada. Este campo é fornecido pelo sistema EMR. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
| Nome | Descrição |
|---|---|
| request_data | Obrigatório. Pares nome-valor dos dados de solicitação do Sistema EMR Para atualizar a tabela Dados da solicitação remota [sn_ind_rmt_help_request_data] ou sua tabela secundária. Por exemplo: Nota: Passar somente parâmetros configurados em uma definição de solicitação no request_dataobjeto. Quaisquer outros parâmetros são ignorados. Para saber mais, consulte Configure definições de solicitação para sistemas EMR . Tipo de dados: Objeto |
| origem | Obrigatório. Nome do sistema EMR que invoca o endpoint conforme especificado em uma definição de solicitação. Por exemplo: Tipo de dados: Cadeia de caracteres |
| task_parameters | Obrigatório. Pares nome-valor que descrevem os parâmetros de tarefa da solicitação de serviço de TI. Cada elemento no objeto corresponde a uma coluna nas tabelas de tarefas correspondentes, como a tabela Incidente [incidente]. Por exemplo: Nota: Passar somente parâmetros configurados em uma definição de solicitação no task_parametersobjeto. Quaisquer outros parâmetros são ignorados. Para saber mais, consulte Configure definições de solicitação para sistemas EMR . Tipo de dados: Objeto |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
Parâmetros do corpo da resposta (JSON)
| Nome | Descrição |
|---|---|
| resultado | Objeto de resultado. Tipo de dados: Objeto
|
| result.code | Código de erro da aplicação quando result.statusretornado como falha . Tipo de dados: Cadeia de caracteres |
| resultado.erro | Mensagem de erro incluída se result.statusfalha. Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| ErroTranslatado | Mensagem de erro localizada opcional. Tipo de dados: Cadeia de caracteres |
| result.status | Status da resposta. Valores válidos:
Tipo de dados: Cadeia de caracteres |
| resultado.aviso | Mensagem de aviso opcional. Pode ser incluído se result.status. sucesso . Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| WarningTraduzido | Mensagem de aviso localizada opcional. Tipo de dados: Cadeia de caracteres |
Solicitação de curl
Atualize uma solicitação de serviço DE TI criada anteriormente em um Cerner EMR
curl "https://instance.servicenow.com/api/sn_ind_rmt_help/v1/remote_help_request/sn_it_request/task/207e57c1db60a410f50fdc5b4b96192e"
--request PUT \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data "{
"source":"Cerner",
"task_parameters":{
"impact":"1",
"contact_type":"phone"
},
"request_data":{
"additional_info" : "Please contact my office for more information."
}
}" \
--user "username":"password"
A saída a seguir mostra uma resposta bem-sucedida e uma resposta de erro.
// Successful response
{
"result": {
"status": "success"
}
}
// Error response
{
{
"result": {
"status": "failure",
"code": "1018",
"error": "Record with sys_id 207e57js1db60a410f50fdc5b4b96192e does not exist in table incident",
"errorTranslated": "Record with sys_id 207e57js1db60a410f50fdc5b4b96192e incident does not exist in table incident"
}
}
}
Solicitação de ajuda remota - OBTER /remote_help_request/
Busca uma lista de tarefas que correspondem ao ID especificado e ao filtro de consulta.
- Os campos de referência e tipo de escolha são sempre retornados como objetos JSON com o valor e display_value.
- Os campos de data/hora são retornados como cadeias de caracteres e sempre em UTC.
Formato de URL
URL com controle de versão: /api/sn_ind_rmt_help/
URL padrão: /api/sn_ind_rmt_help/remote_help_request/
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| req_defn_id | ID exclusivo da definição da solicitação a ser atualizada. Tipo de dados: Cadeia de caracteres Coluna ID da tabela Definição de solicitação remota [sn_ind_rmt_help_request_defn]. |
| Nome | Descrição |
|---|---|
| consulta | Obrigatório. Consulta codificada usado para filtrar o conjunto de resultados. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
Parâmetros do corpo da resposta (JSON)
| Nome | Descrição |
|---|---|
| resultado | Retornar resultados. Tipo de dados: Objeto
|
| result.code | Código de erro da aplicação quando result.statusretornado como falha . Tipo de dados: Cadeia de caracteres |
| resultado.erro | Mensagem de erro incluída se result.statusfalha. Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| ErroTranslatado | Mensagem de erro localizada opcional. Tipo de dados: Cadeia de caracteres |
| result.status | Status da resposta. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| task_list.result | Lista de tarefas. Tipo de dados: Matriz |
| resultado.aviso | Mensagem de aviso opcional. Pode ser incluído se result.status. sucesso . Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| WarningTraduzido | Mensagem de aviso localizada opcional. Tipo de dados: Cadeia de caracteres |
Solicitação de curl
Buscar dados de um Cerner EMR
curl "https://instance.servicenow.com/api/remote_help_request/v1/sn_it_request/?query=active=true" \
--header "Accept: application/json" \
--header "Content-Type: application/json"
{
"source":"Cerner",
} \
--user "username":"password"
A saída a seguir mostra uma resposta bem-sucedida e uma resposta de erro.
// Successful response
{
"result": {
"status": "success",
"task_list": [
{
"number": "INC0010096",
"short_description": "Unable to load data - 1",
"assigned_to": {
"value": "7a381da2dbfb5410f50fdc5b4b9619f2",
"display_value": "Abel Tuter (IT agent)"
},
"opened_at": "2020-11-16 18:37:57",
"closed_at": "",
"closed_by": {},
"state": {
"value": "2",
"display_value": "In Progress"
},
"priority": {
"value": "5",
"display_value": "5 - Planning"
},
"resolved_at": "",
"resolved_by": {},
"task_id": "207e57c1db60a410f50fdc5b4b96192e"
},
{
"number": "INC0010095",
"short_description": "Application freezes intermittently 3",
"assigned_to": {},
"opened_at": "2020-11-16 18:32:05",
"closed_at": "",
"closed_by": {},
"state": {
"value": "1",
"display_value": "New"
},
"priority": {
"value": "5",
"display_value": "5 - Planning"
},
"resolved_at": "",
"resolved_by": {},
"task_id": "561d1f8ddb20a410f50fdc5b4b9619da"
}
]
}
}
// Error response
{
"result": {
"status": "failure",
"code": "1019",
"error": "Invalid query in the request for table incident",
"errorTranslated": "Invalid query in the request for table incident"
}
Solicitação de ajuda remota - OBTER /remote_help_request//task/
Busca uma única tarefa conforme especificado em task_id.
- Os campos de referência e tipo de escolha são sempre retornados como objetos JSON com o valor e display_value.
- Os campos de data/hora são retornados como cadeias de caracteres e sempre em UTC.
- Somente comentários adicionais são compatíveis com campos de tipo de registro.
- Comentários adicionais são passados de volta como uma matriz JSON de objetos. Cada objeto representa um comentário com created_on, created_bye valuecampos. Os comentários mais recentes são enviados primeiro.
Formato de URL
URL com controle de versão: /api/sn_ind_rmt_help//remote_help_request//task/
URL padrão: /api/sn_ind_rmt_help/remote_help_request/
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| req_defn_id | ID exclusivo da definição da solicitação. Tipo de dados: Cadeia de caracteres Coluna ID da tabela Definição de solicitação remota [sn_ind_rmt_help_request_defn]. |
| task_id | Sys_id da tarefa a ser retornada. Este campo é fornecido pelo sistema EMR. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
Cabeçalhos
Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
Parâmetros do corpo da resposta (JSON)
| Nome | Descrição |
|---|---|
| resultado | Retornar resultados. Tipo de dados: Objeto
|
| result.code | Código de erro da aplicação quando result.statusretornado como falha . Tipo de dados: Cadeia de caracteres |
| resultado.erro | Mensagem de erro incluída se result.statusfalha. Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| ErroTranslatado | Mensagem de erro localizada opcional. Tipo de dados: Cadeia de caracteres |
| result.status | Status da resposta. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| task_parameters | Obrigatório. Pares nome-valor que descrevem os parâmetros de tarefa da solicitação de serviço de TI. Cada elemento no objeto corresponde a uma coluna nas tabelas de tarefas correspondentes, como a tabela Incidente [incidente]. Tipo de dados: Objeto |
| resultado.aviso | Mensagem de aviso opcional. Pode ser incluído se result.status. sucesso . Esta mensagem está somente em inglês. Tipo de dados: Cadeia de caracteres |
| WarningTraduzido | Mensagem de aviso localizada opcional. Tipo de dados: Cadeia de caracteres |
Solicitação de curl
Buscar dados de um Cerner EMR
curl "https://instance.servicenow.com/api/sn_ind_rmt_help/v1/remote_help_request/sn_it_request/task/207e57c1db60a410f50fdc5b4b96192e"\
--request GET \
--header "Accept: application/json"\
--user "username":"password"
A saída a seguir mostra uma resposta bem-sucedida e uma resposta de erro.
// Successful response
{
"result": {
"status": "success",
"task_parameters": {
"number": "INC0010096",
"short_description": "Unable to load data - 1",
"state": {
"value": "2",
"display_value": "In Progress"
},
"assigned_to": {
"value": "7a381da2dbfb5410f50fdc5b4b9619f2",
"display_value": "Abel Tuter (IT agent)"
},
"priority": {
"value": "5",
"display_value": "5 - Planning"
},
"caller_id": {
"value": "82d4ecb4db40e8100e28aa594b96195c",
"display_value": "Abel Tuter Requester"
},
"opened_at": "2020-11-16 18:37:57",
"closed_at": "",
"closed_by": {},
"description": "",
"impact": {
"value": "1",
"display_value": "1 - High"
},
"opened_by": {
"value": "82d4ecb4db40e8100e28aa594b96195c",
"display_value": "Abel Tuter Requester"
},
"close_code": {},
"close_notes": "",
"urgency": {
"value": "3",
"display_value": "3 - Low"
},
"category": {
"value": "inquiry",
"display_value": "Inquiry / Help"
},
"resolved_at": "",
"resolved_by": {},
"comments": [
{
"created_on": "2020-11-17 18:20:04",
"created_by": "Abel Tuter Requester",
"value": "You can reach me during office hours."
},
{
"created_on": "2020-11-16 18:40:14",
"created_by": "Abel Tuter Requester",
"value": "You can reach me during office hours."
},
{
"created_on": "2020-11-16 18:38:29",
"created_by": "Abel Tuter",
"value": "Hello there\rName of app please"
}],
"task_id": "207e57c1db60a410f50fdc5b4b96192e"
}
}
}
// Error response
{
"result": {
"status": "failure",
"code": "1001",
"error": "Invalid request definition: test_request2",
"errorTranslated": "Invalid request definition: test_request2"
}
}