{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# LANGUAGE NamedFieldPuns #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}

-- Derived from AWS service descriptions, licensed under Apache 2.0.

-- |
-- Module      : Amazonka.QuickSight.Types.Template
-- Copyright   : (c) 2013-2023 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
module Amazonka.QuickSight.Types.Template where

import qualified Amazonka.Core as Core
import qualified Amazonka.Core.Lens.Internal as Lens
import qualified Amazonka.Data as Data
import qualified Amazonka.Prelude as Prelude
import Amazonka.QuickSight.Types.TemplateVersion

-- | A template object. A /template/ is an entity in Amazon QuickSight that
-- encapsulates the metadata required to create an analysis and that you
-- can use to create a dashboard. A template adds a layer of abstraction by
-- using placeholders to replace the dataset associated with an analysis.
-- You can use templates to create dashboards by replacing dataset
-- placeholders with datasets that follow the same schema that was used to
-- create the source analysis and template.
--
-- You can share templates across Amazon Web Services accounts by allowing
-- users in other Amazon Web Services accounts to create a template or a
-- dashboard from an existing template.
--
-- /See:/ 'newTemplate' smart constructor.
data Template = Template'
  { -- | The Amazon Resource Name (ARN) of the template.
    Template -> Maybe Text
arn :: Prelude.Maybe Prelude.Text,
    -- | Time when this was created.
    Template -> Maybe POSIX
createdTime :: Prelude.Maybe Data.POSIX,
    -- | Time when this was last updated.
    Template -> Maybe POSIX
lastUpdatedTime :: Prelude.Maybe Data.POSIX,
    -- | The display name of the template.
    Template -> Maybe Text
name :: Prelude.Maybe Prelude.Text,
    -- | The ID for the template. This is unique per Amazon Web Services Region
    -- for each Amazon Web Services account.
    Template -> Maybe Text
templateId :: Prelude.Maybe Prelude.Text,
    -- | A structure describing the versions of the template.
    Template -> Maybe TemplateVersion
version :: Prelude.Maybe TemplateVersion
  }
  deriving (Template -> Template -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: Template -> Template -> Bool
$c/= :: Template -> Template -> Bool
== :: Template -> Template -> Bool
$c== :: Template -> Template -> Bool
Prelude.Eq, ReadPrec [Template]
ReadPrec Template
Int -> ReadS Template
ReadS [Template]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [Template]
$creadListPrec :: ReadPrec [Template]
readPrec :: ReadPrec Template
$creadPrec :: ReadPrec Template
readList :: ReadS [Template]
$creadList :: ReadS [Template]
readsPrec :: Int -> ReadS Template
$creadsPrec :: Int -> ReadS Template
Prelude.Read, Int -> Template -> ShowS
[Template] -> ShowS
Template -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [Template] -> ShowS
$cshowList :: [Template] -> ShowS
show :: Template -> String
$cshow :: Template -> String
showsPrec :: Int -> Template -> ShowS
$cshowsPrec :: Int -> Template -> ShowS
Prelude.Show, forall x. Rep Template x -> Template
forall x. Template -> Rep Template x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep Template x -> Template
$cfrom :: forall x. Template -> Rep Template x
Prelude.Generic)

-- |
-- Create a value of 'Template' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'arn', 'template_arn' - The Amazon Resource Name (ARN) of the template.
--
-- 'createdTime', 'template_createdTime' - Time when this was created.
--
-- 'lastUpdatedTime', 'template_lastUpdatedTime' - Time when this was last updated.
--
-- 'name', 'template_name' - The display name of the template.
--
-- 'templateId', 'template_templateId' - The ID for the template. This is unique per Amazon Web Services Region
-- for each Amazon Web Services account.
--
-- 'version', 'template_version' - A structure describing the versions of the template.
newTemplate ::
  Template
newTemplate :: Template
newTemplate =
  Template'
    { $sel:arn:Template' :: Maybe Text
arn = forall a. Maybe a
Prelude.Nothing,
      $sel:createdTime:Template' :: Maybe POSIX
createdTime = forall a. Maybe a
Prelude.Nothing,
      $sel:lastUpdatedTime:Template' :: Maybe POSIX
lastUpdatedTime = forall a. Maybe a
Prelude.Nothing,
      $sel:name:Template' :: Maybe Text
name = forall a. Maybe a
Prelude.Nothing,
      $sel:templateId:Template' :: Maybe Text
templateId = forall a. Maybe a
Prelude.Nothing,
      $sel:version:Template' :: Maybe TemplateVersion
version = forall a. Maybe a
Prelude.Nothing
    }

-- | The Amazon Resource Name (ARN) of the template.
template_arn :: Lens.Lens' Template (Prelude.Maybe Prelude.Text)
template_arn :: Lens' Template (Maybe Text)
template_arn = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Template' {Maybe Text
arn :: Maybe Text
$sel:arn:Template' :: Template -> Maybe Text
arn} -> Maybe Text
arn) (\s :: Template
s@Template' {} Maybe Text
a -> Template
s {$sel:arn:Template' :: Maybe Text
arn = Maybe Text
a} :: Template)

-- | Time when this was created.
template_createdTime :: Lens.Lens' Template (Prelude.Maybe Prelude.UTCTime)
template_createdTime :: Lens' Template (Maybe UTCTime)
template_createdTime = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Template' {Maybe POSIX
createdTime :: Maybe POSIX
$sel:createdTime:Template' :: Template -> Maybe POSIX
createdTime} -> Maybe POSIX
createdTime) (\s :: Template
s@Template' {} Maybe POSIX
a -> Template
s {$sel:createdTime:Template' :: Maybe POSIX
createdTime = Maybe POSIX
a} :: Template) forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall (f :: * -> *) (g :: * -> *) s t a b.
(Functor f, Functor g) =>
AnIso s t a b -> Iso (f s) (g t) (f a) (g b)
Lens.mapping forall (a :: Format). Iso' (Time a) UTCTime
Data._Time

-- | Time when this was last updated.
template_lastUpdatedTime :: Lens.Lens' Template (Prelude.Maybe Prelude.UTCTime)
template_lastUpdatedTime :: Lens' Template (Maybe UTCTime)
template_lastUpdatedTime = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Template' {Maybe POSIX
lastUpdatedTime :: Maybe POSIX
$sel:lastUpdatedTime:Template' :: Template -> Maybe POSIX
lastUpdatedTime} -> Maybe POSIX
lastUpdatedTime) (\s :: Template
s@Template' {} Maybe POSIX
a -> Template
s {$sel:lastUpdatedTime:Template' :: Maybe POSIX
lastUpdatedTime = Maybe POSIX
a} :: Template) forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. forall (f :: * -> *) (g :: * -> *) s t a b.
(Functor f, Functor g) =>
AnIso s t a b -> Iso (f s) (g t) (f a) (g b)
Lens.mapping forall (a :: Format). Iso' (Time a) UTCTime
Data._Time

-- | The display name of the template.
template_name :: Lens.Lens' Template (Prelude.Maybe Prelude.Text)
template_name :: Lens' Template (Maybe Text)
template_name = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Template' {Maybe Text
name :: Maybe Text
$sel:name:Template' :: Template -> Maybe Text
name} -> Maybe Text
name) (\s :: Template
s@Template' {} Maybe Text
a -> Template
s {$sel:name:Template' :: Maybe Text
name = Maybe Text
a} :: Template)

-- | The ID for the template. This is unique per Amazon Web Services Region
-- for each Amazon Web Services account.
template_templateId :: Lens.Lens' Template (Prelude.Maybe Prelude.Text)
template_templateId :: Lens' Template (Maybe Text)
template_templateId = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Template' {Maybe Text
templateId :: Maybe Text
$sel:templateId:Template' :: Template -> Maybe Text
templateId} -> Maybe Text
templateId) (\s :: Template
s@Template' {} Maybe Text
a -> Template
s {$sel:templateId:Template' :: Maybe Text
templateId = Maybe Text
a} :: Template)

-- | A structure describing the versions of the template.
template_version :: Lens.Lens' Template (Prelude.Maybe TemplateVersion)
template_version :: Lens' Template (Maybe TemplateVersion)
template_version = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\Template' {Maybe TemplateVersion
version :: Maybe TemplateVersion
$sel:version:Template' :: Template -> Maybe TemplateVersion
version} -> Maybe TemplateVersion
version) (\s :: Template
s@Template' {} Maybe TemplateVersion
a -> Template
s {$sel:version:Template' :: Maybe TemplateVersion
version = Maybe TemplateVersion
a} :: Template)

instance Data.FromJSON Template where
  parseJSON :: Value -> Parser Template
parseJSON =
    forall a. String -> (Object -> Parser a) -> Value -> Parser a
Data.withObject
      String
"Template"
      ( \Object
x ->
          Maybe Text
-> Maybe POSIX
-> Maybe POSIX
-> Maybe Text
-> Maybe Text
-> Maybe TemplateVersion
-> Template
Template'
            forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"Arn")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"CreatedTime")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"LastUpdatedTime")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"Name")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"TemplateId")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser (Maybe a)
Data..:? Key
"Version")
      )

instance Prelude.Hashable Template where
  hashWithSalt :: Int -> Template -> Int
hashWithSalt Int
_salt Template' {Maybe Text
Maybe POSIX
Maybe TemplateVersion
version :: Maybe TemplateVersion
templateId :: Maybe Text
name :: Maybe Text
lastUpdatedTime :: Maybe POSIX
createdTime :: Maybe POSIX
arn :: Maybe Text
$sel:version:Template' :: Template -> Maybe TemplateVersion
$sel:templateId:Template' :: Template -> Maybe Text
$sel:name:Template' :: Template -> Maybe Text
$sel:lastUpdatedTime:Template' :: Template -> Maybe POSIX
$sel:createdTime:Template' :: Template -> Maybe POSIX
$sel:arn:Template' :: Template -> Maybe Text
..} =
    Int
_salt
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
arn
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe POSIX
createdTime
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe POSIX
lastUpdatedTime
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
name
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe Text
templateId
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe TemplateVersion
version

instance Prelude.NFData Template where
  rnf :: Template -> ()
rnf Template' {Maybe Text
Maybe POSIX
Maybe TemplateVersion
version :: Maybe TemplateVersion
templateId :: Maybe Text
name :: Maybe Text
lastUpdatedTime :: Maybe POSIX
createdTime :: Maybe POSIX
arn :: Maybe Text
$sel:version:Template' :: Template -> Maybe TemplateVersion
$sel:templateId:Template' :: Template -> Maybe Text
$sel:name:Template' :: Template -> Maybe Text
$sel:lastUpdatedTime:Template' :: Template -> Maybe POSIX
$sel:createdTime:Template' :: Template -> Maybe POSIX
$sel:arn:Template' :: Template -> Maybe Text
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
arn
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe POSIX
createdTime
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe POSIX
lastUpdatedTime
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
name
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe Text
templateId
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe TemplateVersion
version