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:

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

No painel Operação, clique em Nova operação e forneça as seguintes informações:

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
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

Guia Parâmetros de saída:

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

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

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:

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

No painel Operação, clique em Nova operação e forneça as seguintes informações:

Crie uma iteração:

Guia Propriedades básicas:
- Nome da operação: Criar iteração
- Descrição (opcional)
- URL: iteração/criar
- Método: POST

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}}"
}
}

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

Crie uma release: clique em Nova operação e especifique as seguintes informações:

Guia Propriedades básicas:
- Nome da operação: Criar release
- Descrição (opcional)
- URL: release/criar
- Método: POST

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"
}
}

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

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:

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

No painel Operação, clique em Nova operação e forneça as seguintes informações:

Iniciar um fluxo de trabalho:

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

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>

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

Obter formulários de solicitação: clique em Nova operação e especifique as seguintes informações:

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

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>

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

Enviar como solicitação: clique em Nova operação e especifique as seguintes informações:

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

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>

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

Obter o status da solicitação: clique em Nova operação e especifique as seguintes informações:

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

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>

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

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

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

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