Serviços web diretos
Um serviço web direto estará disponível para qualquer tabela no sistema se a lista de controle de acesso correta estiver configurada.
O formato compatível da mensagem de entrada é Documentos SOAP XML literais no estilo de documento (Documento/Literal). Para recuperar uma descrição WSDL direta do serviço web e um esquema XML, aponte para o URL relativo WSDL.do? WSDL <tablename> . Por exemplo, para recuperar o WSDL da tabela Incidente no sistema de demonstração on-line, use o seguinte URL: https://<instance name>.service-now.com/incident.do?WSDL .
Parâmetros de consulta estendidos
| Parâmetro | Descrição | Exemplo |
|---|---|---|
| __encoded_query | Especifique uma cadeia de caracteres de consulta codificada a ser usada na filtragem dos resultados retornados. O formato de cadeia de caracteres de consulta codificada é semelhante ao valor que pode ser especificado em um sysparm_query Parâmetro de URL. Consulte o exemplo de criação de consulta codificada nos exemplos do gerador de feed RSS. |
e-mail: o nome do usuário é o nome do usuário e o nome do usuário é o nome do usuário |
| __order_by | Instrua os resultados retornados a serem solicitados pelo campo especificado. | "order_by>" |
| __order_by_desc | Instrua os resultados retornados a serem ordenados pelo campo especificado, em ordem decrescente. | _order_by_desc>data_opened_order_by_desc> |
| __exclude_columns | Especifique uma lista de nomes de campos delimitados por vírgulas a serem excluídos do conjunto de resultados. | sys_created_by, caller_id, priority |
| __limit | Limite o número de registros retornados. | 100 |
| first_row | Instrua os resultados a serem compensados por este número de registros desde o início do conjunto. Quando usado com __last_row tem o efeito de consultar uma janela de resultados. Os resultados incluem o número da primeira linha. |
"first_row>250" |
| __last_row | Instrua os resultados a serem limitados por este número de registros desde o início do conjunto, ou o. __start_row valor quando especificado. Quando usado com first_row tem o efeito de consultar uma janela de resultados. Os resultados são menores do que o número da última linha e não incluem a última linha. |
500/__last_row> |
| __use_view | Especifique uma exibição de formulário por nome a ser usada para limitar e expandir os resultados retornados. Quando a exibição do formulário contém campos referenciados profundos, como caller_id.email este campo também será retornado no resultado. | soap_view> |
Namespace de serviços web diretos
Especificando um namespace exclusivo para cada tabela
. glide.wsdl.definition.use_unique_namespaceA propriedade garante que o WSDL de serviço web direto de cada tabela tenha um exclusivo targetNamespaceatributo. Esta propriedade é verdadeiro Por padrão, o que requer o WSDL do serviço web direto de uma tabela para usar um targetNamespacevalor de http://www.service-now.com/ <table name>. Quando falso (ou quando a propriedade não está presente), todas as tabelas usam o mesmo targetNamespacevalor de http://www.service-now.com . Como todas as tabelas também compartilham os mesmos nomes de operação, um cliente de serviço da Web tentando consumir mais de um ServiceNow o serviço web não seria capaz de diferenciar entre solicitações entre várias tabelas. Usando um exclusivo targetNamespaceo valor permite que os clientes de serviço da web diferenciem solicitações entre várias tabelas.
Por exemplo, o WSDL de serviço web direto para a tabela de incidentes usa isso targetNamepsacevalor:
<wsdl:definitions xmlns:soapenc= "http://schemas.xmlsoap.org/soap/encoding/"xmlns:wsdl = "http://schemas.xmlsoap.org/wsdl/"xmlns:http = "http://schemas.xmlsoap.org/wsdl/http/"xmlns:tns = "http://www.service-now.com/incident"xmlns:xsd = "http://www.w3.org/2001/XMLSchema"xmlns:mime = "http://schemas.xmlsoap.org/wsdl/mime/"xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"targetNamespace = "http://www.service-now.com/incident" ><wsdl:types><xsd:schema elementFormDefault = "unqualified"targetNamespace = "http://www.service-now.com/incident" >Definir requisitos de namespace
O esquema WSDL da ServiceNow por padrão declara um atributo de elementFormDefault="unqualified". Este atributo indica se elementos declarados localmente devem ou não ser qualificados pelo targetNamepsaceem um documento de instância. Se o valor deste atributo for não qualificado , os elementos declarados localmente não devem ser qualificados pelo targetNamepsace. Se o valor deste atributo for qualificado em seguida, os elementos declarados localmente devem ser qualificados pelo targetNamepsace.
No entanto, isso é incompatível com a maneira como os clientes gerados do WSDL (por exemplo, .NET, Axis2, webMethods) processam o esquema incorporado. Como resultado, ele remove o namespace do esquema, tornando a resposta do serviço da web não analisável.
Para superar esse problema de compatibilidade, uma propriedade booliana chamada glide.wsdl.schema.UnqualifiedElementFormDefaultintroduzido. Esta propriedade tem o valor de verdadeiro por padrão. Definindo-o como falso Permite que os clientes gerados a partir do WSDL analisem o valor de retorno da invocação do serviço web. Você pode modificar esta propriedade usando a página de propriedades de Serviços da Web em .
Permitir nomes de serviço duplicados
Por padrão, os nomes de serviço do WSDL gerado dinamicamente são exclusivos e têm o seguinte formato:
ServiceNow_<table name>Para permitir nomes de serviço duplicados, os administradores podem definir glide.wsdl.unique_service_namepropriedade para falso . Se ela não existir, crie a propriedade.