Delen via

ALVAO

Met Alvao kunt u acties automatiseren in Alvao Service Desk en Asset Management en integreren met andere toepassingen.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam ALVAO-ondersteuning
URL https://www.alvao.com/en/support-and-services
E-mailen support@alvao.com
Connectormetagegevens
Uitgever ALVAO
Webpagina https://www.alvao.com
Privacybeleid https://www.alvao.com/en/privacystatement
Categorieën Samenwerking;IT-bewerkingen

Met deze connector kunt u Power Automate, Power Apps of Azure Logic Apps gebruiken om acties in Alvao te automatiseren of Alvao te integreren met andere toepassingen. Met de connector kunt u automatiseringen starten die niet alleen zijn gekoppeld aan de werkstroom van tickets in de Service Desk, maar ook aan de levenscyclus van assets die zijn geregistreerd in Asset Management. Met connectoracties kunt u vervolgens de ticketwerkstroom verplaatsen of de levenscyclus van assets beheren.

Vereiste voorwaarden

U moet een ALVAO-klant (SaaS of On-premises) zijn met een versie van ALVAO ten minste 11.1 en rest API beschikbaar hebben via internet.

Referenties ophalen

  1. Maak een toepassingsaccount in Alvao WebAppUsers - Administration - .
  2. Stel ten minste de Name and Surnameoptie in User name en schakel de optie Application account - Other applicationsin.
  3. Stel een wachtwoord in voor dit account.
  4. Stel de juiste machtigingen in voor het account om te werken met tickets of assets.
  5. Gebruik het User name en Password van dit account om een verbinding met deze connector te maken.

Opmerking: U hebt ook de URL van uw Alvao REST API nodig die u kunt vinden in Alvao WebAppWeb services - - Administration - Settings.

Aan de slag met uw connector

Nadat u de verbinding hebt gemaakt, kunt u verschillende triggers of acties gebruiken.

Geef bijvoorbeeld toestemming om een map in SharePoint te lezen met behulp van een geautomatiseerde stroom op basis van de goedkeuring van een ticket in de Alvao Service Desk:

  1. Gebruik de When a ticket transitions to a status trigger en geef de naam van het proces en de status op waarin de stroom moet worden geactiveerd.
  2. Voeg vervolgens de Get Ticket actie toe en voer de invoer in die Ticket ID beschikbaar is via de trigger.
  3. Gebruik vervolgens bijvoorbeeld de e-mail van de aanvrager die u hebt ontvangen uit de actie en gebruik deze om de gebruiker in M365 te vinden en hem de juiste machtigingen toe te wijzen.

Andere acties kunnen u ook helpen met automatiseringen in Asset Management. Bijvoorbeeld acties voor het maken van een asset, het wijzigen van de waarden van de eigenschappen of het verplaatsen ervan in het register. Als u assets regelmatig wilt importeren uit een ander systeem, kunt u de actie Import objects from CSVgebruiken.

Bekende problemen en beperkingen

  • Alle triggers zijn alleen beschikbaar in ALVAO 11.2 of hoger.
  • Deze acties zijn alleen beschikbaar in ALVAO 11.2 of hoger:
    • Object maken
    • Object ophalen
    • Objecten ophalen
    • Objecteigenschappen bijwerken
    • Objecten verplaatsen
    • Gebruikers ophalen
    • Objecten importeren uit CSV
  • Voor sommige acties is een entiteits-id vereist als invoer, die in Alvao moet bestaan. Deze id's worden meestal gevonden in de Alvao WebApp aan het einde van de URL op hun detailpagina's of bewerken.

Veelvoorkomende fouten en oplossingen

  • 403 Verboden - Controleer of het gebruikte toepassingsaccount alle benodigde machtigingen heeft om de actie uit te voeren. Controleer ook de referenties die in de verbinding worden gebruikt.
  • 404 Niet gevonden: controleer of alle invoerparameters juist zijn en of de REST API-URL juist is in de verbinding. Controleer of de actie beschikbaar is in uw versie van ALVAO.

Veelgestelde vragen

Aangepaste velden

De connector biedt ook ondersteuning voor het lezen en schrijven van aangepaste velden van/naar ticket. Aangepaste velden kunnen niet worden beschreven in de definitie van de algemene connector, dus u moet de volgende technieken gebruiken om ze te verwerken.

Als u een waarde van het aangepaste veld van een ticket wilt lezen, gebruikt u expressies in de Get ticket actie. Als u bijvoorbeeld de waarde van het veld TicketCategory wilt lezen, gebruikt u de expressie:

outputs('Get_request')?['body/customItems/TicketCategory/value']

Als u een waarde wilt schrijven in het aangepaste veld van een ticket, gebruikt u de Update ticket actie met een aangepaste JSON-specificatie. Gebruik bijvoorbeeld deze specificatie in het Custom Items veld TicketCategory om de waarde 'fout bewaken' te schrijven:

{
  "TicketCategory": {
    "@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
    "name": "TicketCategory",
    "value": "monitor failure"
  }
}

Opmerking: het teken '@' wordt verdubbeld vanwege ontsnapping.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
Host touw Geef de host-URL van uw ALVAO REST API op Klopt
Gebruikersnaam touw De gebruikersnaam voor het ALVAO-toepassingsaccount Klopt
Wachtwoord beveiligde string Het wachtwoord voor het ALVAO-toepassingsaccount Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Gebruikers ophalen

Retourneert gebruikers en hun eigenschappen op basis van OData-parameters.
Object maken

Hiermee maakt u een nieuw object op basis van de opgegeven sjabloon onder het opgegeven object.
Object ophalen

Retourneert het object met de bijbehorende eigenschappen.
Object verplaatsen

Hiermee verplaatst u een object naar een opgegeven bestemming.
Objecteigenschappen bijwerken

Hiermee worden objecteigenschappen bijgewerkt.
Objecten importeren uit CSV

Hiermee importeert u objecten in CSV-indeling. Vergelijkbare functionaliteit als het hulpprogramma ImportUtil.
Objecten ophalen

Retourneert objecten met de bijbehorende eigenschappen op basis van OData-parameters.
Record maken in ticketlogboek

Hiermee maakt u een record in het ticketlogboek.
Ticket bijwerken

Hiermee worden ticketkolommen bijgewerkt. Stel alleen eigenschappen in die moeten worden gewijzigd. SlaId of slaName wijzigen als u slaId of slaName wilt wijzigen. Als u de aanvrager wilt wijzigen, stelt u alleen requester-id of alle gegevens in de aanvrager in (niet-geregistreerde gebruiker).
Ticket maken

Hiermee maakt u een nieuw ticket.
Ticket ophalen

Retourneert ticketeigenschappen.
Ticket toewijzen aan oplosser- of oplosserteam

Hiermee wordt een ticket toegewezen aan het team van oplosser of oplosser.
Ticket verplaatsen naar een andere service

Hiermee verplaatst u een ticket naar een andere service. Service-id of servicenaam is vereist.
Ticketstatus wijzigen

Wijzigt de status van het ticket. Het kan ook worden gebruikt voor het omzetten of opnieuw openen van het ticket. Status-id of statusnaam is vereist.

Gebruikers ophalen

Bewerkings-id:
GetUsers

Retourneert gebruikers en hun eigenschappen op basis van OData-parameters.

Parameters

Name Sleutel Vereist Type Description
Boven
 $top integer

Geef het aantal objecten op dat u wilt retourneren.
Zoeken
 $search string

Geef de zoekvoorwaarde voor volledige tekst op. OData $search.
Filter
 $filter string

Geef het filter op, bijvoorbeeld e-mail eq 'james.smith@contoso.com'. OData $filter.
Bestellen op
 $orderBy string

Geef de volgorde op. OData $orderBy.

Retouren

Body
Common.UsersApiResponse

Object maken

Bewerkings-id:
CreateObject

Hiermee maakt u een nieuw object op basis van de opgegeven sjabloon onder het opgegeven object.

Parameters

Name Sleutel Vereist Type Description
Template
 templateObjectId True integer

Selecteer de objectsjabloon of voer de id in (tblNode.intNodeId).
Bovenliggend object
 parentObjectId integer

Selecteer het bovenliggende object of voer de id (tblNode.intNodeId) in.

Retouren

Body
AM.Object

Object ophalen

Bewerkings-id:
GetObject

Retourneert het object met de bijbehorende eigenschappen.

Parameters

Name Sleutel Vereist Type Description
Object
 objectId True integer

Selecteer het object of voer de id in (tblNode.intNodeId).

Retouren

Body
AM.ObjectExpanded

Object verplaatsen

Bewerkings-id:
MoveObject

Hiermee verplaatst u een object naar een opgegeven bestemming.

Parameters

Name Sleutel Vereist Type Description
Object
 objectId True integer

Selecteer het object of voer de id in (tblNode.intNodeId).
Doelobject
 parentObjectId integer

Selecteer het doelobject of voer de id in (tblNode.intNodeId).

Objecteigenschappen bijwerken

Bewerkings-id:
UpdateObjectProperties

Hiermee worden objecteigenschappen bijgewerkt.

Parameters

Name Sleutel Vereist Type Description
Object
 objectId True integer

Selecteer het object of voer de id in (tblNode.intNodeId).
Naam
 name string

Selecteer de eigenschap van het object.
Waarde
 value string

Geef de waarde van de eigenschap op.

Objecten importeren uit CSV

Bewerkings-id:
ImportObjectsFromCsv

Hiermee importeert u objecten in CSV-indeling. Vergelijkbare functionaliteit als het hulpprogramma ImportUtil.

Parameters

Name Sleutel Vereist Type Description
CSV
 contentCsv True string

CSV-inhoud die moet worden geïmporteerd.
Objecttype
 objectTypeId integer

Het type geïmporteerde objecten.
Datum/tijd-notatie
 dateTimeFormat string

Datum/tijd-notatie in tekenreeksen (bijvoorbeeld dd/MM/jjjj).
Afscheider
 separator string

Het kolomscheidingsteken dat wordt gebruikt in het geïmporteerde CSV-bestand.
Fouten overslaan
 skipErrors boolean

Als deze optie is ingeschakeld, worden gegevens geïmporteerd, zelfs als er een fout optreedt in een van de vermeldingen.
Sleuteleigenschappen
 keyFields string

Sleutelvelden die worden gebruikt om bestaande objecten te identificeren en bij te werken (bijvoorbeeld serienummer, model).
Bovenliggend object
 createUnderObjectId integer

Bovenliggend object voor het maken van nieuwe objecten.
Verwijderde objecten bijwerken
 updateDiscardedObjects boolean

Indien ingeschakeld, worden verwijderde objecten ook gezocht naar en bijgewerkt bij het importeren.

Retouren

Body
AM.ImportCsvResponse

Objecten ophalen

Bewerkings-id:
GetObjects

Retourneert objecten met de bijbehorende eigenschappen op basis van OData-parameters.

Parameters

Name Sleutel Vereist Type Description
Boven
 $top integer

Geef het aantal objecten op dat u wilt retourneren.
Zoeken
 $search string

Geef de zoekvoorwaarde voor volledige tekst op. OData $search.
Filter
 $filter string

Geef het filter op, bijvoorbeeld naam eq 'Milk'. OData $filter.
Bestellen op
 $orderBy string

Geef de volgorde op. OData $orderBy.

Retouren

Body
AM.ObjectsExpandedApiResponse

Record maken in ticketlogboek

Bewerkings-id:
CreateRecordInTicketLog

Hiermee maakt u een record in het ticketlogboek.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
 ticketId True integer

Geef de id op van het ticket (tHdTicket.iHdTicketId).
Onderwerp
 subject True string

Onderwerp van de record.
HTML-inhoud
 contentHtml string

Inhoud van de record in Html.
Inhoud zonder opmaak
 contentPlain string

Inhoud van de record in tekst zonder opmaak.
Kind
 kind True string

Soort record.
Van naam
 from string

Naam van de afzender.
Via e-mail
 emailFrom string

E-mail van de afzender.
Tot
 emailTo string

Geadresseerden van het bericht, gescheiden door een puntkomma.
Kopiëren
 emailCc string

Geadresseerden van het bericht, gescheiden door een puntkomma.
Van persoons-id
 fromPersonId integer

Persoons-id van de auteur (tPerson.iPersonId).
Naar persoons-id
 toPersonId integer

Persoons-id van de ontvanger (tPerson.iPersonId).
Aanmaakdatum
 created string

De datum en tijd waarin de record moet worden gemaakt. Laat leeg voor huidige.
Weergeven aan aanvrager
 showToRequester boolean

Bepaal of de aanvrager de record moet zien.
Inhoudsbytes
 contentBytes string

Inhoud die is gecodeerd in Base64.
Inhoudstype
 contentType string

Inhoudstype, bijvoorbeeld afbeelding/png.
Inhoudsnaam
 name string

Naam van inhoud.

Retouren

Name Pad Type Description
Record-id
 id integer

Logboekrecord-id (tAct.iActId).
Onderwerp
 subject string

Onderwerp van logboekrecord.
HTML-inhoud
 contentHtml string

Logboekrecordinhoud in HTML.
Inhoud zonder opmaak
 contentPlain string

Logboekrecordinhoud in tekst zonder opmaak.
Aanmaakdatum
 created string

Logboekrecord gemaakt op.
Kind
 kind string

Soort logboekrecord.
Van naam
 from string

Naam van auteur van logboekrecord.
Via e-mail
 emailFrom string

E-mail van auteur van logboekrecord.
Tot
 emailTo string

E-mailberichten van ontvangers van logboekrecords.
Kopiëren
 emailCc string

E-mailberichten van ontvangers van logboekrecords.
Van persoons-id
 fromPersonId integer

Afzender-id van logboekrecord (tPerson.iPersonId).
Naar persoons-id
 toPersonId integer

Ontvanger-id van logboekrecord (tPerson.iPersonId).
Bericht-id
 messageId string

Logboekrecordbericht-id.
Bijlagen
 attachments array of object

Logboekrecordbijlagen.
Bijlagenaam
 attachments.name string

Naam van bijlage.
Bijlage-ID
 attachments.id integer

Bijlage-id (tDocument.iDocumentId).
Koppeling naar bijlage
 attachments.link string

Koppeling naar de bijlage.

Ticket bijwerken

Bewerkings-id:
UpdateTicket

Hiermee worden ticketkolommen bijgewerkt. Stel alleen eigenschappen in die moeten worden gewijzigd. SlaId of slaName wijzigen als u slaId of slaName wilt wijzigen. Als u de aanvrager wilt wijzigen, stelt u alleen requester-id of alle gegevens in de aanvrager in (niet-geregistreerde gebruiker).

Parameters

Name Sleutel Vereist Type Description
Ticket-id
 ticketId True integer

Geef de id op van het ticket (tHdTicket.iHdTicketId).
Naam
 name string

Ticketnaam.
Priority
 priority string

Ticketprioriteit.
Impact
 impact string

Impact van ticket.
Urgentie
 urgency string

Ticket urgentie.
SLA-id
 slaId integer

SLA-id van ticket (tSla.iSlaId).
SLA-naam
 slaName string

Sla-naam ticket.
Apparaatnummer
 deviceNumber string

Apparaatnummer ticket.
Gerelateerde organisatie
 relatedOrganization string

Naam van ticketgerelateerde organisatie.
Interne doeldatum
 internalTargetDate date-time

Interne doeldatum van ticket.
Intern doel
 internalTarget string

Intern doel van ticket.
Naam
 name string

Naam van aanvrager.
E-mail
 email string

E-mail aanvrager.
E-mail 2
 email2 string

Aanvrager e-mail 2.
Telefoon
 phone string

Aanvrager telefoon.
Telefoon 2
 phone2 string

Aanvrager telefoon 2.
Telefoon (mobiel)
 mobilePhone string

Aanvrager mobiele telefoon.
Afdeling
 department string

Aanvraagafdeling.
Kantoor
 office string

Aanvrager kantoor.
Werkpositie
 workPosition string

Werkpositie aanvrager.
Organisatie
 organization string

Aanvragerorganisatie.
Andere contactpersonen
 otherContacts string

De andere contactpersonen van de aanvrager.
Aangepaste items
 customItems object

Aangepaste items ticket (tHdTicketCust).

Ticket maken

Bewerkings-id:
CreateTicket

Hiermee maakt u een nieuw ticket.

Parameters

Name Sleutel Vereist Type Description
Service-ID
 serviceId True integer

Ticketservice-id (tHdSection.iHdSectionId).
Naam
 name True string

Ticketnaam.
Description
 descriptionHtml string

Beschrijving van ticket in HTML.
SLA-id
 slaId integer

SLA-id van ticket (tSla.iSlaId).
Priority
 priority string

Ticketprioriteit.
Impact
 impact string

Impact van ticket.
Urgentie
 urgency string

Ticket urgentie.
Apparaatnummer
 deviceNumber string

Apparaatnummer ticket.
Gerelateerde organisatie
 relatedOrganization string

Naam van ticketgerelateerde organisatie.
Aangevraagd voor persoons-id
 requestedForPersonId integer

Aangevraagd voor persoons-id (tPerson.iPersonId).
ID-kaart
 id integer

Aanvrager-id (tPerson.iPersonId).
Naam
 name string

Naam van aanvrager.
E-mail
 email string

E-mail van aanvrager.
E-mail 2
 email2 string

Aanvrager e-mail 2.
Telefoon
 phone string

Aanvrager telefoon.
Telefoon 2
 phone2 string

Aanvrager telefoon 2.
Mobiele telefoon
 mobilePhone string

Aanvrager mobiele telefoon.
Afdeling
 department string

Aanvraagafdeling.
Kantoor
 office string

Aanvrager kantoor.
Werkpositie
 workPosition string

Werkpositie aanvrager.
Organisatie
 organization string

Aanvragerorganisatie.
Andere contactpersonen
 otherContacts string

Aanvrager andere contactpersonen.
Objects
 objects array of integer

Koppelingen naar objecten.
Inhoudsbytes
 contentBytes string

Inhoud die is gecodeerd in Base64.
Inhoudstype
 contentType string

Inhoudstype, bijvoorbeeld afbeelding/png.
Inhoudsnaam
 name string

Naam van inhoud.
Aangepaste items
 customItems object

Aangepaste items ticket (tHdTicketCust).

Retouren

Body
SD.Ticket

Ticket ophalen

Bewerkings-id:
GetTicket

Retourneert ticketeigenschappen.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
 ticketId True integer

Geef de id op van het ticket (tHdTicket.iHdTicketId).

Retouren

Body
SD.Ticket

Ticket toewijzen aan oplosser- of oplosserteam

Bewerkings-id:
AssignTicketToSolverOrSolverTeam

Hiermee wordt een ticket toegewezen aan het team van oplosser of oplosser.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
 ticketId True integer

Geef de id op van het ticket (tHdTicket.iHdTicketId).
Oplosser-id
 solverId integer

Nieuwe oplosser-id (tPerson.iPersonId).
Team-id van Oplosser
 solverTeamId integer

Nieuwe team-id van oplosser (tRole.iPersonId).
Message
 messageForSolverHtml string

Bericht voor oplosser en/of voor oplosserteam in HTML.
Inhoudsbytes
 contentBytes string

Inhoud die is gecodeerd in Base64.
Inhoudstype
 contentType string

Inhoudstype, bijvoorbeeld afbeelding/png.
Inhoudsnaam
 name string

Naam van inhoud.

Retouren

response
string

Ticket verplaatsen naar een andere service

Bewerkings-id:
MoveTicketToAnotherService

Hiermee verplaatst u een ticket naar een andere service. Service-id of servicenaam is vereist.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
 ticketId True integer

Geef de id op van het ticket (tHdTicket.iHdTicketId).
Service-ID
 serviceId integer

Nieuwe service-id (tHdSection.iHdSectionId).
Servicenaam
 serviceName string

Nieuwe servicenaam.
Oplosser-id
 newSolverId integer

Nieuwe oplosser-id (tPerson.iPersonId).
Team-id van Oplosser
 newSolverTeamId integer

Nieuwe team-id van oplosser (tRole.iPersonId).
Comment
 commentHtml string

Opmerking in HTML.
Inhoudsbytes
 contentBytes string

Inhoud die is gecodeerd in Base64.
Inhoudstype
 contentType string

Inhoudstype, bijvoorbeeld afbeelding/png.
Inhoudsnaam
 name string

Naam van inhoud.

Retouren

response
string

Ticketstatus wijzigen

Bewerkings-id:
ChangeTicketState

Wijzigt de status van het ticket. Het kan ook worden gebruikt voor het omzetten of opnieuw openen van het ticket. Status-id of statusnaam is vereist.

Parameters

Name Sleutel Vereist Type Description
Ticket-id
 ticketId True integer

Geef de id op van het ticket (tHdTicket.iHdTicketId).
Status-id
 stateId integer

Nieuwe status-id (TicketState.id).
Statusnaam
 stateName string

Nieuwe statusnaam.
Comment
 commentHtml string

Opmerking in HTML.
Opmerking voor goedkeurders
 commentForApprovers string

Opmerking voor goedkeurders in HTML.
Opmerking voor aanvragers
 commentForRequesters string

Opmerking voor aanvragers in HTML.
Inhoudsbytes
 contentBytes string

Inhoud die is gecodeerd in Base64.
Inhoudstype
 contentType string

Inhoudstype, bijvoorbeeld afbeelding/png.
Inhoudsnaam
 name string

Naam van inhoud.

Retouren

response
string

Triggers

Wanneer de waarde van een ticketveld wordt gewijzigd

Deze bewerking wordt geactiveerd wanneer een bepaalde waarde van het ticketveld wordt gewijzigd.
Wanneer een object wordt gemaakt

Deze bewerking wordt geactiveerd wanneer een object van een bepaald type wordt gemaakt.
Wanneer een object wordt verplaatst

Deze bewerking wordt geactiveerd wanneer een object van een bepaald type wordt verplaatst naar een andere positie in de objectstructuur.
Wanneer een ticket overgaat naar een status

Deze bewerking wordt geactiveerd wanneer een ticket overgaat naar een bepaalde status.
Wanneer een waarde van een objecteigenschap wordt gewijzigd

Deze bewerking wordt geactiveerd wanneer een waarde van een bepaalde objecteigenschap wordt gewijzigd.

Wanneer de waarde van een ticketveld wordt gewijzigd

Bewerkings-id:
TicketFieldChanged

Deze bewerking wordt geactiveerd wanneer een bepaalde waarde van het ticketveld wordt gewijzigd.

Parameters

Name Sleutel Vereist Type Description
Veld
 fieldId True integer

Selecteer een ticketveld.
Proces
 process string

Voer de naam in van het proces waarvoor u deze stroom wilt activeren.
Dienst
 service string

Voer de naam in van de service waarvoor u deze stroom wilt activeren.

Retouren

Body
Webhook.UpdatedTicket

Wanneer een object wordt gemaakt

Bewerkings-id:
ObjectCreated

Deze bewerking wordt geactiveerd wanneer een object van een bepaald type wordt gemaakt.

Parameters

Name Sleutel Vereist Type Description
Kind
 kindId integer

Selecteer het type object waarvoor u deze stroom wilt activeren.
Bovenliggend object
 parentObjectId integer

Selecteer het bovenliggende object voor de substructuur waarvan u deze stroom wilt activeren.

Retouren

Name Pad Type Description
Object-ID
 objectId integer

Object-id (tblNode.intNodeId).

Wanneer een object wordt verplaatst

Bewerkings-id:
ObjectMoved

Deze bewerking wordt geactiveerd wanneer een object van een bepaald type wordt verplaatst naar een andere positie in de objectstructuur.

Parameters

Name Sleutel Vereist Type Description
Kind
 kindId integer

Selecteer het type object waarvoor u deze stroom wilt activeren.
Verplaatst van
 fromObjectId integer

Selecteer het bronobject voor de substructuur waarvan u deze stroom wilt activeren.
Verplaatst naar
 toObjectId integer

Selecteer het doelobject voor de substructuur waarvan u deze stroom wilt activeren.

Retouren

Name Pad Type Description
Object-ID
 objectId integer

Object-id (tblNode.intNodeId).
Oude bovenliggende object-id
 oldParentObjectId integer

Oude bovenliggende object-id (tblNode.intNodeId).

Wanneer een ticket overgaat naar een status

Bewerkings-id:
TicketTransitionsToStatus

Deze bewerking wordt geactiveerd wanneer een ticket overgaat naar een bepaalde status.

Parameters

Name Sleutel Vereist Type Description
Proces
 process True string

Voer de naam in van het proces waarvoor u deze stroom wilt activeren.
Ticketstatus
 status True string

Voer de naam van de ticketstatus in. Ticketovergang naar deze status activeert deze stroom.
Dienst
 service string

Voer de naam in van de service waarvoor u deze stroom wilt activeren.

Retouren

Body
Webhook.UpdatedTicket

Wanneer een waarde van een objecteigenschap wordt gewijzigd

Bewerkings-id:
ObjectPropertyChanged

Deze bewerking wordt geactiveerd wanneer een waarde van een bepaalde objecteigenschap wordt gewijzigd.

Parameters

Name Sleutel Vereist Type Description
Vastgoed
 propertyKindId integer

Selecteer de eigenschap van het object waarvoor u deze stroom wilt activeren.
Nieuwe waarde
 newValue string

Voer de nieuwe waarde in van de eigenschap waarvoor u deze stroom wilt activeren. Bijvoorbeeld PC123, 1.45, 14. 4. 2024.
Objecttype
 kindId integer

Selecteer het type object waarvoor u deze stroom wilt activeren.
Bovenliggend object
 parentObjectId integer

Selecteer het bovenliggende object voor de substructuur waarvan u deze stroom wilt activeren.

Retouren

Name Pad Type Description
Object-ID
 objectId integer

Object-id (tblNode.intNodeId).
Eigenschaps-id
 propertyId integer

Eigenschaps-id gewijzigd (tblProperty.intPropertyId).

Definities

SD. Kaartje

Name Pad Type Description
ID-kaart
 id integer

Ticket-id (tHdTicket.iHdTicketId).
Naam
 name string

Ticketnaam.
Berichttag
 messageTag string

Ticketberichttag.
SLA-id
 slaId integer

SLA-id (tSla.iSlaId).
SLA-naam
 slaName string

SLA-naam.
Priority
 priority string

Ticketprioriteit.
Impact
 impact string

Impact van ticket.
Urgentie
 urgency string

Ticket urgentie.
Apparaatnummer
 deviceNumber string

Apparaatnummer ticket.
Gerelateerde organisatie
 relatedOrganization string

Naam van ticketgerelateerde organisatie.
Interne doeldatum
 internalTargetDate date-time

Interne doeldatum van ticket.
Intern doel
 internalTarget string

Intern doel van ticket.
Aanvrager-id
 requesterId integer

Aanvrager-id (tPerson.iPersonId).
Naam van aanvrager
 requesterName string

Naam van aanvrager.
Aangevraagd voor id
 requestedForId integer

Aangevraagd voor id (tPerson.iPersonId).
Aangevraagd voor naam
 requestedForName string

Aangevraagd voor naam.
Oplosser-id
 solverId integer

Ticket oplosser-id (tPerson.iPersonId).
Naam oplosser
 solverName string

Naam van ticket oplosser.
Team-id van Oplosser
 solverTeamId integer

Team-id van ticketlosser (tRole.iRoleId).
Naam van oplosser-team
 solverTeamName string

Naam van ticketlosserteam.
Service-ID
 serviceId integer

Ticketservice-id (tHdSection.iHdSectionId).
Servicenaam
 serviceName string

Naam van ticketservice.
Procesnaam
 processName string

Serviceprocesnaam.
Status-id
 stateId integer

Status-id van ticket (TicketState.id).
Statusnaam
 stateName string

Naam van ticketstatus.
Aanmaakdatum
 createdDate date-time

De datum waarop het ticket is gemaakt.
Opgeloste datum
 resolvedDate date-time

Datum van ticketomzetting.
Gesloten datum
 closedDate date-time

De datum waarop het ticket is gesloten.
Eerste act-id
 initialActId integer

Eerste actie-id (tAct.iActId).
Datum verwijderd
 removedDate date-time

De datum waarop het ticket wordt verwijderd.
In goedkeuring
 inApproval boolean

Of het ticket in goedkeuringsproces is.
Vervaldag
 dueDate date-time

Einddatum van het ticket.
Objects
 objects array of object

Koppelingen naar objecten.
ID-kaart
 objects.objectId integer

Object-id (tblNode.intNodeId).
Aangepaste items
 customItems object

Aangepaste items ticket (tHdTicketCust).

Webhook.UpdatedTicket

Name Pad Type Description
Ticket-id
 requestId integer

Id van het ticket (tHdTicket.iHdTicketId).
Persoons-id
 personId integer

Id van de persoon die de wijziging heeft aangebracht (tPerson.iPersonId).

BEN. Object

Name Pad Type Description
ID-kaart
 id integer

Object-id (tblNode.intNodeId).
Naam
 name string

Objectnaam.
Path
 path string

Objectpad in de structuur.
Volledige naam
 fullName string

Objectnaam met pad in de structuur.
Soort id
 kindId integer

Objecttype-id (tblKind.intKindId).
Soort naam
 kindName string

Objecttypenaam.
Verborgen
 hidden boolean

Of het object verborgen is.
Bovenliggende object-id
 parentObjectId integer

Bovenliggende object-id (tblNode.intNodeId).

BEN. ObjectUitpanded

Name Pad Type Description
ID-kaart
 id integer

Object-id (tblNode.intNodeId).
Naam
 name string

Objectnaam.
Path
 path string

Objectpad in de structuur.
Volledige naam
 fullName string

Objectnaam met pad in de structuur.
Soort id
 kindId integer

Objecttype-id (tblKind.intKindId).
Soort naam
 kindName string

Objecttypenaam.
Verborgen
 hidden boolean

Of het object verborgen is.
Bovenliggende object-id
 parentObjectId integer

Bovenliggende object-id (tblNode.intNodeId).
Eigenschappen
 properties array of object

Eigenschappen van het object.
ID-kaart
 properties.id integer

Eigenschaps-id (tblProperty.intPropertyId).
Naam
 properties.name string

Naam van het pand.
Waarde
 properties.value string

Eigenschapswaarde.
Naamvolgorde
 properties.nameOrder integer

Volgorde van eigenschapsnaam.

BEN. ObjectsExpandedApiResponse

Name Pad Type Description
waarde
 value array of AM.ObjectExpanded

BEN. ImportCsvResponse

Name Pad Type Description
Totaal aantal records
 recordsTotalCount integer

Totaal aantal records in CSV.
Aantal verwerkte records
 recordsProcessedCount integer

Aantal verwerkte records.
Aantal overgeslagen records
 recordsSkippedCount integer

Aantal overgeslagen records.
Aantal mislukte records
 recordsFailedCount integer

Aantal mislukte records.
Aantal gemaakte objecten
 objectsCreatedCount integer

Aantal gemaakte objecten.
Aantal bijgewerkte objecten
 objectsUpdatedCount integer

Aantal bijgewerkte objecten.
Log
 log string

Importlogboek met gedetailleerde informatie.

Common.Person

Name Pad Type Description
Naam
 name string

Gebruikersnaam en achternaam.
E-mail
 email string

E-mail van gebruiker.
E-mail 2
 email2 string

Gebruikers-e-mail 2.
Telefoon werk
 phone string

Telefoon van het werk van de gebruiker.
Werktelefoon 2
 phone2 string

Gebruiker werktelefoon 2.
Mobiele telefoon
 mobilePhone string

Mobiele telefoon van de gebruiker.
Afdeling
 department string

Gebruikersafdeling.
Kantoor
 office string

Gebruikerskantoor.
Position
 workPosition string

Werkpositie van gebruiker.
Organisatie
 organization string

Gebruikersorganisatie.
Andere contactpersonen
 otherContacts string

Andere contactpersonen van de gebruiker.
Gebruikers-ID
 id integer

Gebruikers-id (tPerson.iPersonId).
Gebruikersnaam (voor oudere systemen)
 sAMAccountName string

Gebruikersnaam van gebruiker die ondersteuning biedt voor eerdere versies van Windows.
Gebruikersnaam
 login string

Gebruikersnaam van gebruiker.
Gecreëerd
 createdDate date-time

Door de gebruiker gemaakte datum.
Is systeem
 isSystem boolean

Of de gebruiker het Alvao-systeem is.
Is verborgen
 isHidden boolean

Of de gebruiker is verborgen in menu's.
Wordt gedeeld
 isShared boolean

Of de gebruiker een gedeeld account is.
Is uitgeschakeld
 isDisabled boolean

Of de gebruiker een uitgeschakeld account is.
Is gast
 isGuest boolean

Of de gebruiker de gastgebruiker is.
Is App
 isApp boolean

Of de gebruiker een toepassingsaccount is.
Removed
 removedDate date-time

Gebruiker heeft de datum verwijderd.
Manager-id
 managerId integer

Gebruikersbeheer-id (tPerson.iPersonId).
Vervangende id
 substituteId integer

Vervangende id van gebruiker (tPerson.iPersonId).
Persoonlijk nummer
 personalNumber string

Persoonlijk nummer van gebruiker.
Voorkeurstaal-id
 localeId integer

Voorkeurstaal-id van de gebruiker.
Tijdzone
 timezone string

Tijdzone van gebruiker.
Aangepaste items
 customItems object

Aangepaste gebruikersitems (tPersonCust).
AD-GUID
 adGuid string

AD-GUID van gebruiker.
Voornaam
 firstName string

Voornaam van gebruiker.
Achternaam
 lastName string

Achternaam van gebruiker.
SID
 sid string

Gebruikers-SID.
AD-pad
 adPath string

Ad-pad van gebruiker.
Azure-id
 azureAdObjectId string

Azure-id van gebruiker

Common.UsersApiResponse

Name Pad Type Description
waarde
 value array of Common.Person

touw

Dit is het basisgegevenstype 'tekenreeks'.