Gerenciamento de Serviços do Aranda (versão prévia)

Esse conector está disponível nos seguintes produtos e regiões:

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      – Regiões do Azure Governamental      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões do Power Apps , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Aranda Software
URL	https://arandasoft.com/
Email	soporte@arandasoft.com

Metadados do conector
Publicador	Aranda Software Corporation
Site	https://arandasoft.com/
Política de privacidade	https://arandasoft.com/politica-de-privacidad/
Categorias	Gestão de empresas; Colaboração

Aranda Service Management Suite (ASMS)

Aumente a produtividade da sua empresa e transforme a experiência dos usuários com o Aranda Service Management Suite, a solução multilocatário que permite gerenciar, integrar e automatizar processos e serviços de negócios. Crie, pesquise e atualize registros armazenados em qualquer workspace (projeto) do ASMS, incluindo incidentes, requisitos e alterações, entre outros.

Pré-requisitos

Tenha em mente os seguintes pré-requisitos para continuar:

• Uma assinatura e uma instância do Aranda Service Management Suite (ASMS). Comece aqui: https://arandasoft.com/
• Uma assinatura ativa do Microsoft Power Automate com recursos de conector Premium.

Obtendo credenciais

• Para executar a autenticação, use o token de integração. No link a seguir, você encontrará informações sobre como obter o token de integração

Introdução ao conector

1. Requer uma assinatura do ASMS (Aranda Service Management Suite).

2. Obter o token de integração

3. Obtenha a URL da Instância da API asms (ApiAsms) de Gerenciamento de Serviços do Aranda.

4. Estabeleça uma conexão com o conector do Aranda Service Management Suite.

5. Selecione uma das seguintes funções oferecidas pelo conector:

   

6. Para obter uma documentação detalhada em torno do conector, consulte https://docs.arandasoft.com/connectors

Você pode usar esse conector nos seguintes casos:

1. Crie, pesquise e atualize tíquetes, entre outras ações disponíveis.
2. Obter a rastreabilidade do tíquete.
3. Baixe anexos relacionados a um tíquete.
4. Pesquise artigos de KB (base de dados de conhecimento) no Aranda Service Management Suite.
5. Baixe anexos de artigos da base de dados de conhecimento (KB).
6. Criar, pesquisar e atualizar itens de configuração (CIs).
7. Ele permite que as organizações resolvam suas solicitações internas de suporte, gerenciando e simplificando o processo de resolução de problemas técnicos.
8. Permite o acompanhamento de comunicações entre solicitantes e agentes de suporte.
9. Ofereça respostas automatizadas para informar os solicitantes sobre o status de seu tíquete.

Resposta bem-sucedida

Code	Nome	Description
200	OKEY	A solicitação foi bem-sucedida
204	Sem conteúdo	Nenhum dado encontrado na solicitação

Erros e soluções comuns

Code	Nome	Description	Solução
400	SolicitaçãoInválida	CriteriaNeedsSomeArguments	Verifique se os parâmetros de pesquisa não estão vazios
400	SolicitaçãoInválida	InvalidAdditionalFieldId	Verifique se as IDs dos campos adicionais estão corretas
400	SolicitaçãoInválida	InvalidItemType	O tipo de caso está incorreto, altere a ID do tipo de caso
400	SolicitaçãoInválida	InvalidProjectId	A ID do projeto está incorreta, altere a ID do projeto à qual você associará o caso
400	SolicitaçãoInválida	InvalidStateId	Verificar o status adicionado ao criar ou atualizar um tíquete
400	SolicitaçãoInválida	InvalidUploadType	Erro ao anexar um arquivo, solicitar assistência de um Administrador do Sistema
400	SolicitaçãoInválida	RequestNeedsSomeArguments	Verifique os campos necessários do tíquete e adicione o valor correspondente destes no conector
400	SolicitaçãoInválida	SearchListIsRequired	Solicitar assistência de um Administrador do Sistema
400	SolicitaçãoInválida	Nome do parâmetro: {Parâmetro de nome}	Verifique se as propriedades mencionadas no erro não são nulas
400	SolicitaçãoInválida	É o nome do parâmetro nulo: {Parâmetro de nome}	Verifique se as propriedades mencionadas no erro não são nulas
400	SolicitaçãoInválida	ItemTypeIsRequired	Adicionar tipo de caso
400	SolicitaçãoInválida	ModelIdIsEmpty	Adicione o parâmetro modelId. É necessário.
400	SolicitaçãoInválida	StateIdIsEmpty	Adicione o parâmetro stateId. É necessário.
400	SolicitaçãoInválida	ServiceIdIsEmpty	Adicione o parâmetro serviceId. É necessário.
400	SolicitaçãoInválida	CategoryIdIsEmpty	Adicione o parâmetro categoryId. É necessário.
400	SolicitaçãoInválida	TypesListNeedsSomeArguments	Requer a adição do tipo de caso ao pesquisar tíquetes, solicitar assistência de um Administrador do Sistema
400	SolicitaçãoInválida	'{PARAMETER_NAME}' AdditionalFieldIsRequired	O campo adicional '{PARAMETER_NAME}' é obrigatório
400	SolicitaçãoInválida	ModelNotActive	O modelo associado ao caso não está ativo
400	SolicitaçãoInválida	FailedToCloseTaskPendingCloseTasksPredecessors	Se você tentar fechar o caso e o caso pai tiver tarefas pendentes para fechar
400	SolicitaçãoInválida	DuplicatedObject	O Ci já existe no banco de dados
400	SolicitaçãoInválida	Nome do parâmetro EmptyValue: {PARAMETER_NAME}	O parâmetro {PARAMETER_NAME} é necessário
400	SolicitaçãoInválida	Nome do parâmetro EmptyEnumeration: {PARAMETER_NAME}	O parâmetro {PARAMETER_NAME} é uma lista e é necessário
403	Proibido	DoNotHavePermissionForThisAction	Fale com o Administrador do Sistema para atribuir permissões

Code	Nome	Description	Solução
500	Erro Interno do Servidor		Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureExportExcel	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetAdditionalFields	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetCategoriesByService	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetChangeFSC	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetFields	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetFieldsList	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetFiles	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetLookupValues	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetMailTemplates	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetModelByCategory	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetOperators	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetReassignmentReasons	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureGetSimilarItems	Solicitar assistência de um Administrador do Sistema
500	Erro Interno do Servidor	FailureSearchQuickManagement	Solicitar assistência de um Administrador do Sistema

perguntas frequentes

1. Como recuperar as IDs dos atributos necessários para usar as diferentes ações no conector (por exemplo, projeto, serviço, categoria, grupo, especialista)?

   As IDs podem ser recuperadas de várias maneiras:

   • Usando o Aranda Query Manager, você pode criar um relatório que consulta a tabela ASMS (Aranda Service Management Suite), em que os dados necessários estão localizados. Se você precisar de diretrizes sobre os objetos de dados na solução, visite o link https://docs.arandasoft.com/docs/database.html a seguir e identifique a versão do banco de dados aranda correspondente à instalação do ASMS.
   • Se você estiver usando uma instalação local do ASMS, poderá consultar a tabela ASMS em que os dados necessários estão localizados por meio de um cliente SQL.
   • Por meio do Centro de Suporte do Aranda, criando uma solicitação de suporte por meio dos canais de contato indicados no suporte do site a seguir.

2. Qual é o tamanho máximo dos arquivos a serem anexados ao usar a ação "Adicionar Anexo"?

   O tamanho máximo depende da configuração específica da instância/instalação do ASMS. Pergunte ao administrador do ASMS.

3. Qual é o nível de acesso a dados exigido pela conta técnica cujo token é usado na configuração da conexão ASMS exigida pelo conector?

   O nível de acesso é o mesmo que a conta técnica usada no ASMS regularmente. Em outras palavras, com base nas funções e permissões do técnico correspondente no ASMS, os dados podem ser acessados com o conector.

4. A conta técnica cujo token será usado no conector deve ser Nomeada ou Simultânea?

   Como o conector pode acessar a instância do ASMS relacionada várias vezes por hora, é altamente recomendável que a conta seja um tipo Nomeado.

5. A criação ou modificação de casos usando o conector segue as mesmas regras de validação de dados presentes na interface do ASMS?

   Sim, ele segue as mesmas regras de validação. Por exemplo, ao criar um caso para um projeto, serviço e categoria específicos, se campos nativos e adicionais precisarem ser preenchidos, esses dados também serão necessários ao enviar o caso por meio do conector.

6. O conector pode ser usado para instâncias do ASMS em ambientes de nuvem e local?

   Sim, ele pode ser usado nas instalações de nuvem e local do ASMS. Em instalações locais, você deve considerar a conectividade entre o servidor ASMS e seu ambiente do Power Automate.

7. Tenho uma licença do Power Automate que só me permite usar conectores Standard. Posso usar o conector do ASMS?

   Não é possível, o conector do ASMS é do tipo Premium.

8. Quero criar fluxos no Power Automate que começam a partir de eventos no ASMS (por exemplo, quando um caso foi criado, quando um caso é atribuído a um grupo específico). É possível usar gatilhos que começam de eventos que ocorrem no ASMS?

   Sim, é possível. As seguintes etapas são recomendadas:

   • Inicialize um gatilho "Quando uma solicitação HTTP é recebida" e crie um esquema JSON do corpo da solicitação contendo a estrutura de dados que deverá ser recebida do ASMS. Depois que o gatilho for criado, você obterá uma URL HTTP POST (URL do WebHook) para usar em sua instância do ASMS. Não se esqueça de considerar o mecanismo de autenticação para acessar a URL do WebHook (por exemplo, Token).
   • Crie uma regra de negócios no ASMS para o conjunto de condições que, quando atendidas, devem iniciar o fluxo no Power Automate. Como uma ação dentro da regra, selecione "Invocar Webhook" e, na URL de destino da invocação, insira a URL do WebHook obtida anteriormente, os parâmetros a serem enviados e o corpo da solicitação (que deve corresponder ao Esquema JSON do Corpo da Solicitação). Para obter mais informações sobre como invocar um Webhook de uma regra no ASMS, visite o seguinte link: regra do Webhook
   • Teste a regra criada e valide se uma solicitação HTTP é enviada para a URL do WebHook e inicializa o fluxo no Power Automate.

9. Posso invocar pontos de extremidade da API REST do ASMS como ações de fluxos no Power Automate?

   Sim, é possível. Use a ação "HTTP" e preencha os dados necessários nele (URI, Método, Cabeçalhos, Corpo, entre outros).

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Host ASMS	cadeia	Host ASMS	Verdade
Token de autorização	secureString	Token de autorização	Verdade

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	100	60 segundos

Ações

Adicionar anexo ao caso	Anexe um arquivo a um registro de caso específico no ASMS.
Adicionar anotação ao caso	Adicione uma anotação a um registro de caso específico no ASMS.
Atualizar item de configuração	Atualizar CIs no CMDB do Aranda.
Baixar o anexo de maiúsculas e minúsculas	Baixe o anexo relacionado ao artigo.
Baixar o anexo do artigo	Baixe o anexo relacionado ao artigo.
Caso de atualização	Atualiza um registro para um caso ASMS.
Casos de pesquisa	Recupera uma lista de registros de casos do ASMS, dependendo dos critérios de pesquisa adicionados na consulta.
Criar caso	Crie um novo registro de caso no ASMS.
Criar item de configuração	Crie CIs no CMDB do Aranda.
Obter histórico de casos	Obtenha o histórico de casos, por padrão, as anotações não estão incluídas.
Obter item de configuração	Obter CI por nome e serial.
Obter maiúsculas/minúscula	Obtém um registro dos metadados de um caso ASMS.
Pesquisar artigos	Recupera uma lista de artigos com base nos critérios de pesquisa adicionados na consulta.
Pesquisar itens de configuração	Recupera uma lista de registros CIs do CMDB, dependendo dos critérios de pesquisa adicionados na consulta.

Adicionar anexo ao caso

Adicionar anotação ao caso

Atualizar item de configuração

Baixar o anexo de maiúsculas e minúsculas

Baixar o anexo do artigo

Caso de atualização

Casos de pesquisa

Criar caso

Criar item de configuração

Obter histórico de casos

Obter item de configuração

Obter maiúsculas/minúscula

Pesquisar artigos

Pesquisar itens de configuração

Definições

binário