Putvalue

Deze Help-pagina is bedoeld voor CXone Studio. Deze informatie is ook beschikbaar voor Desktop Studio.

Slaat gegevens op in een NICE CXone-databasetabel om deze toegankelijk te maken voor andere scripts en contacten. Deze gegevens kunnen worden opgehaald met de GETvalue-actie.

Als er meerdere variabelen moeten worden geraadpleegd door andere scripts of contacten, is een database over het algemeen de beste oplossing.

Afhankelijkheden

  • Putvalue gebruikt een uniek gegevenstype dat alleen toegankelijk is via de geschikte Studio-acties:Getvalue, Remvalue, Getlist en Clearlist.
  • Wanneer de Persistent-eigenschap is ingesteld op False, worden alle publieke waarden die door een specifiek contact zijn toegevoegd, automatisch verwijderd wanneer het contact wordt vrijgegeven. Deze functie wordt vaak gebruikt wanneer een bovenliggend script informatie moet bijhouden over gespawnde onderliggende scripts. Elk onderliggend script zal Putvalue uitvoeren met de Name-eigenschap zoals "{MasterID}List" en een waarde van {ContactID}. Omdat de "{MasterID}List" openbaar is, kan het bovenliggende script van tijd tot tijd Getlist uitvoeren om te zien hoeveel onderliggende scripts momenteel worden uitgevoerd. Gezien de eigenschap Persistent=false, wordt de publieke waarde van het onderliggende script automatisch verwijderd wanneer het script wordt vrijgegeven. Er hoeft geen extra werk te worden verzet om een nauwkeurige telling van het aantal onderliggende scripts bij te houden.
  • Niet-persistente publieke variabelen kunnen worden gedeeld door andere scripts of contacten gedurende de levensduur van het script dat deze variabelen instelt. De variabelen worden automatisch opgeschoond na de vrijgave.
  • Persistent-variabelen moeten handmatig worden verwijderd door het uitvoeren van Getvalue (met de eigenschap Remove ingesteld op true), Remvalue of Clearlist. Het wordt niet aanbevolen om Putvalue te gebruiken voor grote hoeveelheden gegevens of voor gegevens die u gedurende lange tijd nodig hebt. Als u gegevens wilt opslaan, is het raadzaam om gebruik te maken van een DB-connector en verbinding te maken met een database die u beheert.

Ondersteunde scripttypen

Een vierkant waaruit een lijnvertakking komt die naar drie andere vierkanten gaat.

Generiek

E-mail Chat Telefoon Voicemail Werkitem SMS Digitaal

Gerelateerde acties

Deze actie is een van de acties die gegevens opslaan en ophalen uit een databasetabel om deze informatie toegankelijk te maken voor andere scripts. Het werkt als een lijst met velden of waarden. Gebruik deze acties voor het opslaan van een groot aantal waarden of van waarden die op een later moment nodig zijn voor andere scripts. De complete lijst van acties, inclusief deze actie, is: Putvalue, Getvalue, Remvalue, Getlist en Clearlist.

Deze acties maken gebruik van een uniek gegevenstype dat alleen toegankelijk is via deze Studio-acties. De gegevens zijn op geen enkele andere manier toegankelijk. Gebruikers kunnen deze database niet openen en gebruiken, ongeacht hun machtigingen.

De waarden blijven gedurende een beperkte tijd beschikbaar in een databasetabel, zoals ingesteld in de TTL hrs eigenschap uur van de Putvalue -actie. De standaardinstelling is 24 uur, maar u kunt een levensduur tussen 1 uur en 168 uur (zeven dagen) instellen. U kunt de actie Remvalue gebruiken om gegevens vóór het verstrijken van de TTL-tijd te verwijderen. Zo krijgt u volledige controle over de gegevens in uw scripts.

Opmerkingen:

  • Als er meerdere variabelen moeten worden geraadpleegd door andere scripts of contacten, is een database over het algemeen de beste oplossing.
  • Niet-persistente publieke variabelen kunnen worden gedeeld met andere scripts of contacten gedurende de levensduur van het script dat deze variabelen instelt. De variabelen worden automatisch opgeschoond na de vrijgave.

Invoereigenschappen

Deze eigenschappen definiëren gegevens die de actie gebruikt bij het uitvoeren.

Vertakking

Beschrijving

Voeg bijschrift toe

Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram.

Scope

Selecteer het niveau waarop de door deze actie verwerkte waarden zichtbaar zijn voor andere contacten. Alleen contacten die dezelfde scope hebben, krijgen toegang tot dezelfde gegevens. De opties zijn:

De Scope die u kiest, moet overeenkomen met de Scope die is ingesteld in alle andere lijstacties die u in het script gebruikt. De lijstacties zijn Putvalue, Getvalue, Remvalue, Getlist en Clearlist. Zelfs als de Name van de lijst dezelfde is, worden ze niet herkend als de Scope-instellingen verschillend zijn.

Name

Wordt gebruikt om waarde te identificeren. Dit kan een willekeurige naam of een willekeurig nummer zijn. Namen zijn niet hoofdlettergevoelig. Wanneer de waarde wordt opgehaald met Getvalue, moet Name hetzelfde zijn. Als de Name-eigenschap niet overeenkomt, wordt er geen match gevonden, ook al is de instelling Scope dezelfde.

Value

De waarde of de gegevens die moeten worden opgeslagen.

Method

Wanneer meerdere waarden onder dezelfde naam worden opgeslagen, worden ze in een lijst geplaatst. Kies een van de volgende methoden:

  • ReplaceAll: dit is de standaardwaarde die standaard wordt geselecteerd.
  • Append: voegt de nieuwe waarde toe aan het einde van de lijst. Als u Append gebruikt en er meer dan 1000 append-bewerkingen zijn binnen 24 uur, dan stopt het systeem met toevoegen totdat sommige append-bewerkingen zijn verwijderd (na 24 uur).
  • Insert: voegt de nieuwe waarde toe aan het begin van de lijst. Volgende aanroepen van Getvalue halen gegevens op vanaf het begin van de lijst.
Persistent

Selecteer True als u de gegevens die door een bepaald contact zijn opgeslagen, bewaard moeten blijven nadat het contact is vrijgegeven. De standaardinstelling is dat gegevens worden verwijderd wanneer het contact wordt vrijgegeven (False).

TTL (hrs)

Stel deze eigenschap in op de hoeveelheid tijd (in uren) dat de gegevens beschikbaar moeten blijven. Wanneer de TTL (levensduur) is bereikt, worden de gegevens gewist. De werkelijke tijd waarop de gegevens worden gewist, kan tot een uur na het verstrijken van de levensduur zijn. Dit komt doordat het proces voor controle van de levensduur eenmaal per uur, aan het begin van het uur, wordt uitgevoerd. Als de levensduur bijvoorbeeld om 10:03 uur verloopt, zal het controleproces pas weer om 11:00 uur worden uitgevoerd, zodat de gegevens tot 11:00 uur blijven bestaan.

De minimumwaarde voor deze eigenschap is één uur en het maximum is 168 uur (zeven dagen). De standaardwaarde is 24 uur. Als u een waarde buiten de toegestane limieten instelt, zal de actie de dichtstbijzijnde toegestane waarde gebruiken.

Resultaatvertakkingsvoorwaarden

Met Resultaatvertakkingsvoorwaarden kunt u vertakkingen maken in uw script om verschillende resultaten te behandelen wanneer de actie wordt uitgevoerd.

Voorwaarde

Beschrijving

Default

Het pad dat altijd wordt gevolgd, behalve als het script voldoet aan een voorwaarde die vereist dat het een van de andere vertakkingen volgt. Dit pad wordt ook gevolgd als de andere vertakkingen van de actie niet zijn gedefinieerd.