Exemplos de conector de aplicativo

Este artigo contém os seguintes tópicos:

Verificação de garantia Dell

O conector de verificação de garantia Dell permite se conectar ao suporte da Dell e recuperar informações de garantia de um ativo.

Siga estas etapas:

1. Na página Novo conector do aplicativo, forneça as seguintes informações:
   • Nome do conector do aplicativo: verificação de garantia da Dell
   • Descrição (opcional)
   • Tipo de conectividade: Na nuvem
   • URL base: https://api.dell.com/support/v2/assetinfo
   • Formato da API: XML
   • Autenticação: nenhuma
2. No painel Operação, clique em Nova operação e forneça as seguintes informações:
   1. Guia Propriedades básicas:
      • Nome da operação: obter os detalhes da garantia do ativo
      • Descrição (opcional)
      • URL: warranty/tags.xml
      • Método: GET

   2. Guia Parâmetros de entrada:

      Parâmetros do URL	Valor	Nome identificável do usuário
      svctags	C9CX7W1	Identificador do serviço
      apikey	d676cf6e1e0ceb8fd14e8cb69acd812d	Chave da API

   3. Guia Parâmetros de saída:

      1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

      2. Especifique os seguintes parâmetros:

         XPath	Parâmetro	Nome identificável do usuário
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]	a:CustomerNumber[1]	Nome do cliente
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]	a:MachineDescription[1]	Descrição da máquina
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[1]	a:EndDate[1]	Data de término da garantia 1
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[1]	a:ServiceLevelDescription[1]	Nome da garantia 1
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[2]	a:EndDate[1]	Data de término da garantia 2
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[2]	a:ServiceLevelDescription[1]	Nome da garantia 2
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[3]	a:EndDate[1]	Data de término da garantia 3
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[3]	a:ServiceLevelDescription[1]	Nome da garantia 3
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[4]	a:EndDate[1]	Data de término da garantia 4
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[4]	a:ServiceLevelDescription[1]	Nome da garantia 4

3. Salve e publique o conector. O conector de verificação de garantia da Dell foi criado e está pronto para uso.

Conector Rally 2.0

O Rally é uma plataforma para gerenciar seu ecossistema de desenvolvimento ágil. O Rally fornece APIs para gerenciar releases, iterações, histórias e defeitos. O conector Rally 2.0 permite automatizar a criação de releases e iterações no Rally a partir do aplicativo.

Siga estas etapas:

1. Na página Novo conector do aplicativo, forneça as seguintes informações:
   • Nome do conector do aplicativo: Rally 2.0 Connector
   • Descrição (opcional)
   • Versão da API: 2.0
   • Tipo de conectividade: Na nuvem
   • URL base: https://rally1.rallydev.com/slm/webservice/v2.0
   • Formato da API: JSON

   • Autenticação

     Arquivado	Valor
     Tipo de autenticação	Autenticação avançada
     URL de logon	https://rally1.rallydev.com/slm/webservice/v2.0/security/authorize
     Usa autenticação básica	Verdadeiro
     Nome de usuário	Seu nome de usuário do Rally (exemplo: SuperAdmin@dominio.com)
     Senha	Sua senha do Rally
     URL de logoff	https://rally1.rallydev.com/slm/webservice/v2.0/security/authorize
     Saída	Clique em Exibir o resultado do teste e selecionar parâmetros e insira os seguintes valores: Analisar sequência de caracteres: OperationResult.SecurityToken Nome para identificar: Token de segurança

2. No painel Operação, clique em Nova operação e forneça as seguintes informações:
   1. Crie uma iteração:
      
      1. Guia Propriedades básicas:
         • Nome da operação: Criar iteração
         • Descrição (opcional)
         • URL: iteração/criar
         • Método: POST

      2. Guia Parâmetros de entrada:

         Campos	Valor
         Parâmetros do URL	Parâmetro do URL: chave Valor: -- (deve estar vazio) Nome identificável do usuário: Token de segurança (o nome deve corresponder ao valor em Nome para identificar na saída da autenticação).
         Corpo	Dados brutos
         Carga	Copie e cole o seguinte código: Observação: altere a ID do projeto com o código existente. { "Iteration": { "Name": "{{Iteration Name:Iteration A}}", "Notes": "{{Iteration Notes:test}}", "PlannedVelocity": {{Iteration velocity:15}}, "Project": "https://rally1.rallydev.com/slm/webservice/v2.0/project/projectid", "StartDate": "{{Iteration Start Date:2014-09-23T06:00:00.000Z}}", "State": "Planning", "EndDate": "{{Iteration End Date:2014-10-29T06:59:59.000Z}}" } }

      3. Guia Parâmetros de saída:

         1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

         2. Selecione o seguinte parâmetro:

            Parâmetro	Nome identificável do usuário
            CreateResult.Object.ObjectID	ID da iteração

   2. Crie uma release: clique em Nova operação e especifique as seguintes informações:
      1. Guia Propriedades básicas:
         
         • Nome da operação: Criar release
         • Descrição (opcional)
         • URL: release/criar
         • Método: POST

          

      2. Guia Parâmetros de entrada:

         Campos	Valor
         Parâmetros do URL	Parâmetro do URL: chave Valor: -- (deve estar vazio) Nome identificável do usuário: Token de segurança (o nome deve corresponder ao valor em Nome para identificar na saída da autenticação).
         Corpo	Dados brutos
         Carga	Copie e cole o seguinte código: Observação: altere a ID do projeto com a ID de projeto existente. { "Release": { "Name": "{{Release name:Release B}}", "Notes": "{{Release Notes:test}}", "PlannedVelocity": {{Release planned velocity:30}}, "Project": "https://rally1.rallydev.com/slm/webservice/v2.0/project/projectid", "State": "Planning", "ReleaseDate": "2014-09-30T06:59:59.000Z", "ReleaseStartDate": "2014-09-23T07:00:00.000Z" } }

      3. Guia Parâmetros de saída:

         1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

         2. Especifique os seguintes parâmetros:

            Parâmetro	Nome identificável do usuário
            CreateResult.Object.ObjectID	ID da release

3. Salve e publique o conector. O Rally 2.0 Connector foi criado e está pronto para uso.

Conector do ServiceAide Process Automation

O Process Automation foi desenvolvido para acelerar o fornecimento de serviços de TI e ajudar a eliminar erros manuais. É possível eliminar os erros manuais por meio da automação e orquestração de processos entre silos organizacionais que utilizam sistemas diferentes. Esse conector aproveita suas APIs ReST e permite iniciar um fluxo de trabalho, buscando uma lista de formulários de solicitação, iniciando uma solicitação de fluxo de trabalho de automação e consultando o status de uma solicitação.

Siga estas etapas:

1. Na página Novo conector do aplicativo, forneça as seguintes informações:
   • Nome do conector do aplicativo: Conector do Process Automation
   • Descrição (opcional)
   • Versão da API: 4.2
   • Tipo de conectividade: Na nuvem
   • URL base: http://nomedohost:7000/node/rest (nomedohost é o nome do host em que o ITPAM está instalado.)
   • Formato da API: XML

   • Autenticação

     Arquivado	Valor
     Tipo de autenticação	Autenticação básica
     Nome de usuário	Seu nome de usuário do PAM
     Senha	Sua senha do PAM

2. No painel Operação, clique em Nova operação e forneça as seguintes informações:
   1. Iniciar um fluxo de trabalho:
      
      1. Guia Propriedades básicas:
         • Nome da operação: Iniciar fluxo de trabalho
         • Descrição (opcional)
         • URL: CA:00074_CA:00074:01/_ops/Start
         • Método: POST

      2. Guia Parâmetros de entrada:

         Campos	Valor
         Corpo	Dados brutos
         Carga	Copie e cole o seguinte código: <StartRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:StartRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" > <EntityID> <MdrElementID><context path execute workflow></MdrElementID> </EntityID> </StartRequest>

      3. Guia Parâmetros de saída:

         1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

         2. Selecione o seguinte parâmetro:

            Parâmetro	Nome identificável do usuário
            /usm-core:EntityID[1]/usm-core:MdrElementID[1]	ID da solicitação de início

   2. Obter formulários de solicitação: clique em Nova operação e especifique as seguintes informações:
      
      1. Guia Propriedades básicas:
         
         • Nome da operação: Obter formulários de solicitação
         • Descrição (opcional)
         • URL: CA:00074_CA:00074:01/_ops/QueryStartRequestForms
         • Método: POST

      2. Guia Parâmetros de entrada:

         Campos	Valor
         Corpo	Dados brutos
         Carga	Copie e cole o seguinte código: <QueryStartRequestFormsRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:QueryStartRequestFormsRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" ><Filter><LookUpPath>/mehni03</LookUpPath> <IsRecursive>true</IsRecursive></Filter></QueryStartRequestFormsRequest>

      3. Guia Parâmetros de saída:

         1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

         2. Selecione o seguinte parâmetro:

            Parâmetro	Nome identificável do usuário
            /QueryStartRequestFormsResponse[1]/StartRequestForm[1]/Description[1]	Descrição do formulário

   3. Enviar como solicitação: clique em Nova operação e especifique as seguintes informações:
      
      1. Guia Propriedades básicas:
         
         • Nome da operação: Enviar solicitação
         • Descrição (opcional)
         • URL: CA:00074_CA:00074:01/_ops/SubmitStartRequestForm
         • Método: POST

      2. Guia Parâmetros de entrada:

         Campos	Valor
         Corpo	Dados brutos
         Carga	Copie e cole o seguinte código: Observação: a carga baseia-se no formulário configurado para executar o fluxo de trabalho. <SubmitStartRequestFormRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:SubmitStartRequestFormRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" > <Name>CasaTestForm</Name> <Path>/mehni03</Path> <Arguments> <Argument> <Name>Var_0</Name> <Value>val0</Value></Argument><Argument> <Name>Var_1</Name> <Value>true</Value> </Argument> <Argument> <Name>Var_2</Name> <Value>val2</Value></Argument></Arguments></SubmitStartRequestFormRequest>

      3. Guia Parâmetros de saída:

         1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

         2. Selecione o seguinte parâmetro:

            Parâmetro	Nome identificável do usuário
            /pam-ops:SubmitStartRequestFormResponse[1]/StartRequestStatus[1]/Instance	ID da instância

   4. Obter o status da solicitação: clique em Nova operação e especifique as seguintes informações:
      
      1. Guia Propriedades básicas:
         
         • Nome da operação: Obter o status da solicitação
         • Descrição (opcional)
         • URL: CA:00074_CA:00074:01/_ops/QueryStartRequests
         • Método: POST

      2. Guia Parâmetros de entrada:

         Campos	Valor
         Corpo	Dados brutos
         Carga	Copie e cole o seguinte código: Observação: a ID do formulário (por exemplo: CasaTestForm_120) varia de acordo com a configuração do PAM. <QueryStartRequestsRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:QueryStartRequestsRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" > <Instance>{{INSTANCE:CasaTestForm_120}}</Instance> <IsArchived>false</IsArchived></QueryStartRequestsRequest>

      3. Guia Parâmetros de saída:

         1. Clique em Validar; a saída é gerada em uma caixa de diálogo.

         2. Selecione o seguinte parâmetro:

            Parâmetro	Nome identificável do usuário
            /pam-ops:QueryStartRequestsResponse[1]/StartRequestInstances[1]/StartRequestInstance[1]/State	Estado do processo

3. Salve e publique o conector. O conector do Process Automation foi criado e está pronto para uso.