smapOne

Pomocí tohoto konektoru můžete načíst data týkající se vašich map z plattformu smapOne, aktualizovat zdroje dat nebo vytvářet úkoly pro uživatele.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název smapOne AG
URL https://www.smapone.com
Email support@smapone.com
Metadata konektoru
Vydavatel smapOne AG
Internetová stránka https://www.smapone.com
Zásady ochrany osobních údajů https://en.smapone.com/privacy-policy/
Kategorie Data; Produktivita

Vytvoření připojení

Konektor podporuje následující typy ověřování:

výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
Klíč rozhraní API smapOne securestring Klíč rozhraní API pro váš účet smapOne Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizace všech zdrojů dat v mapě

Zkontrolujte všechny odkazované zdroje dat pro aktualizaci. Pokud existují novější podverze odkazovaných zdrojů dat, odkazy byly aktualizovány a je publikována nová verze této mapy. Pokud nejsou k dispozici žádné aktualizace, nespustí se žádné publikování a vrátí se nejnovější verze.

Aktualizace zdroje dat

Aktualizujte zdroj dat. Sloupce musí být stejné. To znamená, že id sloupců se musí shodovat.

Odstranění datového záznamu

Odstraní konkrétní datový záznam dané verze mapy.

Odstranění datových záznamů verze mapy

Odstraní všechny datové záznamy do dané verze mapy. Mějte na paměti, že odstraníte všechny záznamy, pokud nenastavíte filtr stavu.

Přiřazení nebo odebrání úkolu

Přiřazení nebo odebrání úkolu uživateli

Vytvoření úlohy pro verzi mapy

Vytvoření úkolu – předem vyplněný datový záznam, který lze přiřadit uživateli

Získání datového záznamu

Vrátí konkrétní datový záznam dané verze mapy.

Získání hodnot zdroje dat

Vrátí hodnoty konkrétní verze zdroje dat.

Získání informací o uživateli

Tato operace vrátí informace o aktuálním uživateli. Například uživatelé e-mail a subscriptionId.

Získání konkrétní verze mapy

Získání metadat pro konkrétní verzi mapy smap

Získání podrobností o konkrétní mapě

Získání všech metadat pro konkrétní mapu

Získání podrobností o zdroji dat

Vrátí podrobnosti do daného zdroje dat.

Získání schématu pro záznam dat

Získání schématu JSON pro data této mapy smap

Získání sestav pro všechny datové záznamy všech verzí mapy

Vrátí sestavy pro všechny záznamy daného smapId. Vrátí se sestavy všech verzí mapy.

Získání sestav pro všechny datové záznamy z konkrétní verze mapy

Vrátí sestavy pro všechny záznamy konkrétní verze mapy. U všech nových záznamů se datum exportu aktualizuje automaticky. Pomocí parametru stavu můžete filtrovat nové záznamy.

Získání sestavy datového záznamu

Vrátí sestavu konkrétního datového záznamu dané verze mapy.

Získání souboru datového záznamu

Vrátí konkrétní soubor pro dané ID záznamu dané verze mapy.

Získání statistik o uživateli a předplatném

Tato operace poskytuje statistiky o vašem předplatném, jako je počet dat.

Získání všech datových záznamů pro verzi mapy

Vrátí všechny záznamy pro konkrétní verzi mapy pomocí daného smapId. U všech nových záznamů se datum exportu aktualizuje automaticky. Pomocí parametru stavu můžete filtrovat nové záznamy.

Získání všech datových záznamů pro všechny verze mapy

Vrátí všechny záznamy do daného smapId. Vrátí se datové záznamy všech verzí mapy. Mějte na paměti, že výsledky nemusí být vzájemně kompatibilní, protože schéma dat se mohlo mezi verzí mapy změnit.

Získání všech map

Vrátí všechny mapy vašeho předplatného. Vrácené entity lze použít k dotazování na dostupné verze mapy pomocí daného smapId nebo dotazování na datové záznamy mapy smap.

Získání všech metadat souboru pro datový záznam

Vrátí meta data pro všechny soubory tohoto datového záznamu.

Získání všech verzí mapy

Vrátí als verze, které patří k danému smapId. Vrácené entity lze použít k dotazování datových záznamů na danou verzi. Verze 0.0 je aktuálně upravená verze, ne publikovaná verze mapy.

Získání zdrojů dat

Vrátí seznam zdrojů dat dostupných ve vašem předplatném. Vrácené entity lze použít k dotazování na verze zdroje dat pomocí daného dataSourceId.

Aktualizace všech zdrojů dat v mapě

Zkontrolujte všechny odkazované zdroje dat pro aktualizaci. Pokud existují novější podverze odkazovaných zdrojů dat, odkazy byly aktualizovány a je publikována nová verze této mapy. Pokud nejsou k dispozici žádné aktualizace, nespustí se žádné publikování a vrátí se nejnovější verze.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

Verze návrháře aktualizací
updateEditVersion boolean

Pokud by se měla aktualizovat i aktuální verze návrháře

Návraty

Informace o Smap-Version

Aktualizace zdroje dat

Aktualizujte zdroj dat. Sloupce musí být stejné. To znamená, že id sloupců se musí shodovat.

Parametry

Name Klíč Vyžadováno Typ Description
DatasourceId
dataSourceId True string

ID zdroje dat

Version
dataSourceVersion True string

Číslo verze aktuální verze zdroje dat (např. 1.0)

values
values object

Návraty

Model verzí zdroje dat

Odstranění datového záznamu

Odstraní konkrétní datový záznam dané verze mapy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

ID záznamu
recordId True string

ID datového záznamu

Odstranění datových záznamů verze mapy

Odstraní všechny datové záznamy do dané verze mapy. Mějte na paměti, že odstraníte všechny záznamy, pokud nenastavíte filtr stavu.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

Stav záznamu
state string

filtrování záznamů pro nové, exportované nebo neúplné záznamy

Přiřazení nebo odebrání úkolu

Přiřazení nebo odebrání úkolu uživateli

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

ID záznamu
taskId True string

ID záznamu

akce
action string
userEmail
userEmail string

Návraty

Model rozhraní REST API pro datové záznamy

Vytvoření úlohy pro verzi mapy

Vytvoření úkolu – předem vyplněný datový záznam, který lze přiřadit uživateli

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

userEmail
userEmail string
title
title True string

Název úkolu

komentář
comment string

Komentář od autora úkolu

hasPriority
hasPriority boolean

Úkol má prioritu.

data
data True object

Návraty

Model rozhraní REST API pro datové záznamy

Získání datového záznamu

Vrátí konkrétní datový záznam dané verze mapy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

ID záznamu
recordId True string

ID datového záznamu

Formát
format string

Json, Xml

Označit jako exportované
markAsExported boolean

Označení záznamu jako exportovaného

Návraty

Model rozhraní REST API pro datové záznamy

Získání hodnot zdroje dat

Vrátí hodnoty konkrétní verze zdroje dat.

Parametry

Name Klíč Vyžadováno Typ Description
DatasourceId
dataSourceId True string

ID zdroje dat

Verze zdroje dat
dataSourceVersion True string

Číslo verze zdroje dat (např. 1.0)

Návraty

Name Cesta Typ Description
array of object
items
object

Získání informací o uživateli

Tato operace vrátí informace o aktuálním uživateli. Například uživatelé e-mail a subscriptionId.

Návraty

Informace pro uživatele

Získání konkrétní verze mapy

Získání metadat pro konkrétní verzi mapy smap

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

Návraty

Informace o Smap-Version

Získání podrobností o konkrétní mapě

Získání všech metadat pro konkrétní mapu

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

SmapId mapy, která se má vyžádat

Návraty

Základní informace o mapě

Body
SmapModel

Získání podrobností o zdroji dat

Vrátí podrobnosti do daného zdroje dat.

Parametry

Name Klíč Vyžadováno Typ Description
DatasourceId
dataSourceId True string

ID zdroje dat

Návraty

Zdrojový model

Získání schématu pro záznam dat

Získání schématu JSON pro data této mapy smap

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

Návraty

response
object

Získání sestav pro všechny datové záznamy všech verzí mapy

Vrátí sestavy pro všechny záznamy daného smapId. Vrátí se sestavy všech verzí mapy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

Označit jako exportované
markAsExported boolean

Označení datových záznamů všech požadovaných sestav jako exportovaných

Stav záznamu
state string

Filtrování záznamů pro jejich stav: nové, exportované nebo neúplné (úkol)

Návraty

response
binary

Získání sestav pro všechny datové záznamy z konkrétní verze mapy

Vrátí sestavy pro všechny záznamy konkrétní verze mapy. U všech nových záznamů se datum exportu aktualizuje automaticky. Pomocí parametru stavu můžete filtrovat nové záznamy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Verze mapy smap v hlavním nebo hlavním formátu.podverze

Označit jako exportované
markAsExported boolean

Označení datových záznamů všech požadovaných sestav jako exportovaných

Stav záznamu
state string

Filtrování záznamů pro nové, exportované nebo neúplné záznamy

Návraty

response
binary

Získání sestavy datového záznamu

Vrátí sestavu konkrétního datového záznamu dané verze mapy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

ID záznamu
recordId True string

ID datového záznamu

Formát
format True string

Pdf, Docx, Doc, Html, Xml, Txt (pro účely testování)

Označit jako exportované
markAsExported boolean

Označení záznamu jako exportovaného

Použít výchozí šablonu
useDefault boolean

Pokud se vygeneruje nová šablona true a nahraná šablona sestavy se bude ignorovat.

Návraty

response
binary

Získání souboru datového záznamu

Vrátí konkrétní soubor pro dané ID záznamu dané verze mapy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

ID záznamu
recordId True string

ID záznamu

ID souboru
fileId True string

ID souboru

Získání statistik o uživateli a předplatném

Tato operace poskytuje statistiky o vašem předplatném, jako je počet dat.

Návraty

Získání všech datových záznamů pro verzi mapy

Vrátí všechny záznamy pro konkrétní verzi mapy pomocí daného smapId. U všech nových záznamů se datum exportu aktualizuje automaticky. Pomocí parametru stavu můžete filtrovat nové záznamy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Verze mapy v hlavní verzi (např. 1) nebo major.podverze (např. 1.1)

Označit jako exportované
markAsExported boolean

Označit všechny požadované záznamy jako exportované

Formát
format string

Výstupní formát (.json oder .xml), výchozí formát je Json

Stav záznamu
state string

filtrování záznamů pro nové, exportované nebo neúplné záznamy

Návraty

Získání všech datových záznamů pro všechny verze mapy

Vrátí všechny záznamy do daného smapId. Vrátí se datové záznamy všech verzí mapy. Mějte na paměti, že výsledky nemusí být vzájemně kompatibilní, protože schéma dat se mohlo mezi verzí mapy změnit.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

Označit jako exportované
markAsExported boolean

Označit všechny požadované záznamy jako exportované

Formát
format True string

Výstupní formát (.json, .xml), Výchozí formát je JSON

Stav záznamu
state string

Filtrování záznamů pro jejich stav: nové, exportované nebo neúplné (úkol)

Návraty

Získání všech map

Vrátí všechny mapy vašeho předplatného. Vrácené entity lze použít k dotazování na dostupné verze mapy pomocí daného smapId nebo dotazování na datové záznamy mapy smap.

Návraty

Získání všech metadat souboru pro datový záznam

Vrátí meta data pro všechny soubory tohoto datového záznamu.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

smapVersion
version True string

Číslo verze mapy (např. 1.0)

ID záznamu
recordId True string

ID datového záznamu

Návraty

Získání všech verzí mapy

Vrátí als verze, které patří k danému smapId. Vrácené entity lze použít k dotazování datových záznamů na danou verzi. Verze 0.0 je aktuálně upravená verze, ne publikovaná verze mapy.

Parametry

Name Klíč Vyžadováno Typ Description
smapId
smapId True string

ID mapy

Návraty

Získání zdrojů dat

Vrátí seznam zdrojů dat dostupných ve vašem předplatném. Vrácené entity lze použít k dotazování na verze zdroje dat pomocí daného dataSourceId.

Návraty

Definice

UserInfoModel

Informace pro uživatele

Name Cesta Typ Description
accountIsActivated
accountIsActivated boolean

Označuje, jestli je účet aktivovaný. Pokud ne, uživatel ještě tento účet neověřil.

subscriptionId
subscriptionId string

ID předplatného uživatele

userName
userName string

Jméno uživatele

companyName
companyName string

Název společnosti zaregistrovaný pro předplatné

e-mail
email string

E-mailová adresa uživatele

originalMail
originalMail string

Pokud byl aktuální účet přístupný pomocí zosobnění, zobrazí se e-mailová adresa původního uživatele.

kontrakt
contract string

Typ kontraktu

roles
roles array of string

Seznam rolí, které se vztahují na uživatele

smapLimit
smapLimit integer

Maximální počet map, které může tento uživatel publikovat. Hodnota null znamená neomezenou.

vydavatel
publisher string

Text popisující vydavatele svým uživatelům.

odeslat k provedení
source string

Původ předplatného.

isInternal
isInternal boolean

Označuje, že tento účet je interně používán aplikací smapOne.

UserLimit
userLimit integer

Maximální počet uživatelů, které tvůrce může vytvořit

publishedSmaps
publishedSmaps integer

Počet publikovaných map tohoto účtu

availableFeatures
availableFeatures array of string

Seznam dostupných funkcí pro tento účet

nastavení
settings object

Vlastní nastavení uložená na tomto účtu. Výstup bude pouze v případě, že je parametr "embed" nastavený na požadavek.

jazyková verze
culture string

Aktuálně vybraná jazyková verze pro tento účet Jako dvoumístný kód jazykové verze, například "en".

AccountStatistics

Name Cesta Typ Description
identifikační číslo
id string
subscriptionType
subscriptionType string
subscriptionTypeChanged
subscriptionTypeChanged date-time
subscriptionTypeTitle
subscriptionTypeTitle string
subscriptionTypeValue
subscriptionTypeValue integer
isMasterSubscription
isMasterSubscription boolean
smapLimit
smapLimit integer
groupCount
groupCount integer
trialDurationInDays
trialDurationInDays integer
daysLeftForTrial
daysLeftForTrial integer
datum vytvoření
createdDate date-time
Počet uživatelů
userCount integer
UserLimit
userLimit integer
daysSinceCreation
daysSinceCreation integer
jazyková verze
culture string
langCode
langCode string
isInternal
isInternal boolean
verze systému
systemVersion string
doména
domain string
isChildSubscription
isChildSubscription boolean
isImpersonating
isImpersonating boolean
dataCount
dataCount integer
smapCount
smapCount integer
publishedSmapCount
publishedSmapCount integer
notPublishedSmapCount
notPublishedSmapCount integer
distributedSmapCount
distributedSmapCount integer
installedSmapsCount
installedSmapsCount integer
groupLicenseCount
groupLicenseCount integer
lastSmapId
lastSmapId string
previewSmapCount
previewSmapCount integer

DataSourceListModel

Zdrojový model

Name Cesta Typ Description
datum vytvoření
createdDate date-time

Datum vytvoření zdroje dat

latestVersion
latestVersion string

Nejnovější verze dostupná pro tento zdroj dat

typ
type string

Typ zdroje dat

ID zdroje dat
dataSourceId string

ID zdroje dat

název
name string

Název zdroje dat.

DataSourceVersionModel

Model verzí zdroje dat

Name Cesta Typ Description
definice
definition AbstractDataSourceDefinition

Definice této verze zdroje dat

datum vytvoření
createdDate date-time

Datum vytvoření této verze zdroje dat

verze
version string

Číslo verze této verze zdroje dat

ID zdroje dat
dataSourceId string

ID zdroje dat

název
name string

Název zdroje dat.

AbstractDataSourceDefinition

Definice této verze zdroje dat

Name Cesta Typ Description
title
title string
typ
type string
identifikační číslo
id string
ID zdroje dat
dataSourceId string

ID zdroje dat

DataSourceModel

Zdrojový model

Name Cesta Typ Description
ID zdroje dat
dataSourceId string

ID zdroje dat

typ
type string

Typ zdroje dat

název
name string

Název zdroje dat

datum vytvoření
createdDate date-time

Datum vytvoření zdroje dat

latestVersion
latestVersion string

Nejnovější verze dostupná pro tento zdroj dat

usedInSmaps
usedInSmaps array of DataSourceSmapModel

mapy, které používají tento zdroj dat

DataSourceSmapModel

Popisuje mapu smap.

Name Cesta Typ Description
smapName
smapName string

Název mapy

smapId
smapId string

ID mapy

SmapModel

Základní informace o mapě

Name Cesta Typ Description
groupLicenseCount
groupLicenseCount integer

Počet skupinových licencí

changeType
changeType string

Určuje, jaké změny byly provedeny v mapě smap v porovnání s poslední publikovanou verzí.

userLicenseCount
userLicenseCount integer

Počet uživatelských licencí

lastChanged
lastChanged date-time

Datum provedení poslední změny v mapě

isUpToDate
isUpToDate boolean

Označuje, že od posledního publikování se mapa smap nezměnila.

installationsCount
installationsCount integer

Počet instalací mapy smap

lastPublishedVersion
lastPublishedVersion SmapVersionModel

Informace o Smap-Version

totalDataCount
totalDataCount integer

Počet všech datových záznamů pro všechny verze mapy

totalOpenTasksCount
totalOpenTasksCount integer

Počet otevřených úkolů pro tuto mapu

tasksActivated
tasksActivated boolean

Označuje, že pro tuto mapu je aktivována možnost vytváření úkolů z datových záznamů.

isCompanyTemplate
isCompanyTemplate boolean

Označuje, jestli byla tato mapa zpřístupněna jako šablona společnosti.

název
name string

Název mapy

smapId
smapId string

ID mapy

logoId
logoId string

ID loga mapy

SmapVersionModel

Informace o Smap-Version

Name Cesta Typ Description
lastChanged
lastChanged date-time

Datum publikování této verze U verze 0.0 (upravit verze) se zobrazí, kdy byla v mapě provedena poslední změna.

lastRecordReceived
lastRecordReceived date-time

Datum přijetí posledního datového záznamu pro tuto verzi mapy smap

dataCount
dataCount integer

Počet datových záznamů pro tuto verzi mapy

smapVersionId
smapVersionId string

ID této verze mapy

verze
version string

Číslo verze této verze mapy smap

DataRecordApi

Model rozhraní REST API pro datové záznamy

Name Cesta Typ Description
verze schématu
schemaVersion integer

Verze formátu dat

identifikační číslo
id string

Identifikátor datového záznamu

typ záznamu
recordType string

Popisuje typ datového záznamu. Je to buď úkol, nebo vlastní datový záznam.

subscriptionId
subscriptionId string

Identifikátor předplatného, do kterého patří datový záznam a podle mapy.

smapId
smapId string

Identifikátor mapování datového záznamu patří.

smapVersionId
smapVersionId string

Identifikátor verze mapy, do které datový záznam patří.

verze
version string

Verze mapy čitelná pro člověka, do které záznam dat patří.

ID tokenu
tokenId string

Identifikátor tokenu smap, pomocí kterého byl vytvořen datový záznam.

userId
userId string

Identifikátor uživatele, který vytvořil datový záznam

userEmail
userEmail string

E-mailová adresa uživatele, který vytvořil datový záznam

userName
userName string

Jméno uživatele, který vytvořil datový záznam. Upozornění: Při vytvoření datového záznamu prostřednictvím anonymní licence má toto pole nečitelný jedinečný identifikátor.

sendDate
sendDate date-time

Časové razítko, kdy byl datový záznam dokončen uživatelem a zařazen do fronty pro odesílání na server v aplikaci smapOne.

clientCreatedDate
clientCreatedDate date-time

Časové razítko, kdy uživatel přeposlal datový záznam a stal se tak úkolem.

receivedDate
receivedDate date-time

Časové razítko, ve kterém server přijal datový záznam. Tato možnost se nastaví, když se samotný záznam přenese na server, ale přidružené soubory ještě nemusí. Toto časové razítko bude pozdější než sendDate, ale před dokončením.

completedDate
completedDate date-time

Časové razítko, ve kterém byl dokončený záznam dat samotný a všechny odkazované soubory zcela přeneseny a přijaty serverem.

deletedDate
deletedDate date-time

Časové razítko, ve kterém byl datový záznam odstraněn

lastExportDate
lastExportDate date-time

Časové razítko při posledním exportu datového záznamu

toCompleteOn
toCompleteOn date-time

Datum, kdy má být datový záznam publikován

title
title string

Název úkolu nebo datového záznamu

komentář
comment string

Jeden komentář k úkolu

data
data

Shromážděná data z mapy smap. Seznam párů klíč-hodnota, kde je klíč ID každého modulu mapy smap a hodnota je skutečná data z tohoto modulu.

SingleFileValue

Name Cesta Typ Description
ID souboru
fileId string
fileName
fileName string
časové razítko
timestamp date-time
kontrolní součet
checkSum string
typ obsahu
contentType string
size
size integer
meta
meta FileMetaData
adresa URL
url string

FileMetaData

Name Cesta Typ Description
audioDuration
audioDuration string

objekt

Toto je typ "object".

binární

Toto je základní datový typ Binary.