Executando serviços do Info*Engine com o conector OData
O ThingWorx Navigate agora tem suporte para o conector OData executar tarefas do Info*Engine. Se as tarefas personalizadas usam tarefas do Info*Engine, use o conector OData para chamar as tarefas do Info*Engine.
Para obter as informações mais atualizadas sobre o suporte ao conector OData para o
Windchill, verifique
Platform Support Matrix for ThingWorx Navigate.
|
|
Nas próximas liberações do ThingWorx Navigate, o suporte para os conectores do Windchill, ptc-windchill-connector e ptc-windchill-swagger-connector, será desabilitado. A fim de fazer uma transição suave para uma liberação que não tem suporte para os conectores antigos do Windchill, execute suas tarefas do Info*Engine com o ptc-windchill-OData-connector agora, seguindo os passos deste tópico.
|
A fim de usar o conector OData para executar tarefas do Info*Engine, primeiramente, configure o ptc-windchill-OData-connector para se conectar aos serviços OData REST do domínio Windchill do Info*Engine. Em seguida, é possível usar serviços REST OData do Windchill para executar tarefas do Info*Engine.
|
|
• Ao configurar o ptc-windchill-OData-connector, todas as personalizações anteriores feitas no ptc-windchill-OData-connector predefinido precisam ser recriadas.
|
1. No ThingWorx Composer, faça uma busca por ptc-windchill-OData-connector e abra-o. A página General Information é aberta.
2. Clique em Configuration. A página Configuration é aberta.
A configuração depende do método de autenticação: logon único, autenticação do Windchill ou autenticação fixa.
Logon único
Se o logon único estiver configurado, siga estes passos:
1. Em Generic Connector Connection Settings, para Authentication Type, selecione SSO.
2. Em Authorization Server ID, insira o valor AuthorizationServerSettingsID fornecido em sso-settings.json, por exemplo, PingFed1.
3. Em Authorization Server Scopes Settings, clique em Add. A janela AuthorizationServerScopesSettings é aberta.
4. Em Scope, insira o escopo do Windchill registrado no PingFederate, como WINDCHILL.
5. Clique em Add.
6. Em CSRF Settings, insira estas informações:
◦ Relative URL For CSRF Get Request—/servlet/odata
◦ CSRF Token Name — CSRF_NONCE
7. Em HTTP Connector Connection Settings, insira estas informações:
◦ Base URL — O URL do Windchill. O URL deve terminar com /oauth. Use este formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/oauth
Esse formato especifica que a conexão usa o padrão OAuth e habilita solicitações de dados no provedor de recursos.
◦ Relative URL—/servlet/odata
Não é necessário inserir o nome do usuário e senha.
8. Clique em Save. O conector OData agora está configurado para funcionar em seu ambiente de logon único.
Agora, vá direto para a seção “Executando tarefas do Info*Engine”.
Autenticação do Windchill
Se a autenticação do Windchill estiver configurada, siga estes passos:
1. Em Generic Connector Connection Settings, para Authentication Type, selecione None.
2. Em CSRF Settings, insira estas informações:
◦ Relative URL For CSRF Get Request—/servlet/odata
◦ CSRF Token Name — CSRF_NONCE
3. Em HTTP Connector Connection Settings, insira estas informações:
◦ Base URL — O servidor Windchill que recebe a solicitação do Info*Engine do ODataConnector. Use este formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/sslClientAuth
◦ Relative URL—/servlet/odata
◦ Connection URL — /servlet/WindchillGW/wt.httpgw.HTTPServer/ping
Não é necessário inserir nome do usuário e senha.
4. Clique em Save.
Agora, vá direto para a seção “Executando tarefas do Info*Engine”.
Autenticação fixa
Se a autenticação fixa estiver configurada, siga os passos para configurar o conector OData:
1. Em Generic Connector Connection Settings, para Authentication Type, selecione Fixed.
2. Em CSRF Settings, insira estas informações:
◦ Relative URL For CSRF Get Request—/servlet/odata
◦ CSRF Token Name — CSRF_NONCE
3. Em HTTP Connector Connection Settings, insira estas informações:
◦ User name — O nome do usuário administrador do Windchill
◦ Password — A senha do administrador do Windchill
◦ Base URL — O servidor Windchill que recebe a solicitação do Info*Engine do ODataConnector. Use este formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]
◦ Relative URL—/servlet/odata
4. Clique em Save. O conector OData agora está configurado para funcionar em seu ambiente de autenticação fixa.
Continue com a seção “Executando tarefas do Info*Engine”.
Executando tarefas do Info*Engine
Agora, execute as tarefas do Info*Engine com o serviço:
1. Clique em Services. A página Services é aberta.
2. Para
RefreshEndpointCache, clique em
. A janela
Execute Service é aberta.
3. Clique em Execute. Você receberá a mensagem: Success. O serviço foi executado com êxito.
4. Clique em Done.
5. Para
InvokeIETask, clique em
.
6. Na janela Input, adicione as informações a seguir no formato JSON:
◦ Task — O arquivo XML da tarefa do Info*Engine. O arquivo está localizado aqui: <Instalação do Windchill>/<Windchill_Home>/tasks/.
| Certifique-se de habilitar a tarefa para execução. Para isto, verifique se a marcação a seguir aparece no topo do arquivo XML: <%@page language="java" access="http"%> |
◦ Params — (Opcional) Uma matriz JSON que contém pares de nome-valor a serem passados como parâmetro para a tarefa do Info*Engine.
Exemplo:
{
"Task": "wt/federation/delegates/windchill/QueryObjects.xml",
"Params": [
{ "Name": "type", "Value": "wt.part.WTPart" },
{ "Name": "where", "Value": "name=SOME_PART_NAME" }
]
}
7. Clique em Execute para iniciar a tarefa do Info*Engine. A saída do serviço está no formato JSON e contém as propriedades a seguir:
◦ @odata.context — O URL de contexto para payload.
◦ Value — Uma matriz JSON que contém objetos JSON com propriedades Groupname e Element.
8. Para executar outra tarefa do Info*Engine, repita os passos de 1 a 7.
| Os pontos finais do conector OData podem não funcionar como previsto no ThingWorx Navigate e, como resultado, você precisará fazer mudanças. Para obter detalhes e instruções sobre a configuração de serviços do OData em dados do Windchill, veja Windchill REST Services User’s Guide. |
