{-# 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.WordCloudVisual
-- 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.WordCloudVisual 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.ColumnHierarchy
import Amazonka.QuickSight.Types.VisualCustomAction
import Amazonka.QuickSight.Types.VisualSubtitleLabelOptions
import Amazonka.QuickSight.Types.VisualTitleLabelOptions
import Amazonka.QuickSight.Types.WordCloudChartConfiguration

-- | A word cloud.
--
-- For more information, see
-- <https://docs.aws.amazon.com/quicksight/latest/user/word-cloud.html Using word clouds>
-- in the /Amazon QuickSight User Guide/.
--
-- /See:/ 'newWordCloudVisual' smart constructor.
data WordCloudVisual = WordCloudVisual'
  { -- | The list of custom actions that are configured for a visual.
    WordCloudVisual -> Maybe [VisualCustomAction]
actions :: Prelude.Maybe [VisualCustomAction],
    -- | The configuration settings of the visual.
    WordCloudVisual -> Maybe WordCloudChartConfiguration
chartConfiguration :: Prelude.Maybe WordCloudChartConfiguration,
    -- | The column hierarchy that is used during drill-downs and drill-ups.
    WordCloudVisual -> Maybe [ColumnHierarchy]
columnHierarchies :: Prelude.Maybe [ColumnHierarchy],
    -- | The subtitle that is displayed on the visual.
    WordCloudVisual -> Maybe VisualSubtitleLabelOptions
subtitle :: Prelude.Maybe VisualSubtitleLabelOptions,
    -- | The title that is displayed on the visual.
    WordCloudVisual -> Maybe VisualTitleLabelOptions
title :: Prelude.Maybe VisualTitleLabelOptions,
    -- | The unique identifier of a visual. This identifier must be unique within
    -- the context of a dashboard, template, or analysis. Two dashboards,
    -- analyses, or templates can have visuals with the same identifiers..
    WordCloudVisual -> Text
visualId :: Prelude.Text
  }
  deriving (WordCloudVisual -> WordCloudVisual -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: WordCloudVisual -> WordCloudVisual -> Bool
$c/= :: WordCloudVisual -> WordCloudVisual -> Bool
== :: WordCloudVisual -> WordCloudVisual -> Bool
$c== :: WordCloudVisual -> WordCloudVisual -> Bool
Prelude.Eq, Int -> WordCloudVisual -> ShowS
[WordCloudVisual] -> ShowS
WordCloudVisual -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [WordCloudVisual] -> ShowS
$cshowList :: [WordCloudVisual] -> ShowS
show :: WordCloudVisual -> String
$cshow :: WordCloudVisual -> String
showsPrec :: Int -> WordCloudVisual -> ShowS
$cshowsPrec :: Int -> WordCloudVisual -> ShowS
Prelude.Show, forall x. Rep WordCloudVisual x -> WordCloudVisual
forall x. WordCloudVisual -> Rep WordCloudVisual x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep WordCloudVisual x -> WordCloudVisual
$cfrom :: forall x. WordCloudVisual -> Rep WordCloudVisual x
Prelude.Generic)

-- |
-- Create a value of 'WordCloudVisual' 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:
--
-- 'actions', 'wordCloudVisual_actions' - The list of custom actions that are configured for a visual.
--
-- 'chartConfiguration', 'wordCloudVisual_chartConfiguration' - The configuration settings of the visual.
--
-- 'columnHierarchies', 'wordCloudVisual_columnHierarchies' - The column hierarchy that is used during drill-downs and drill-ups.
--
-- 'subtitle', 'wordCloudVisual_subtitle' - The subtitle that is displayed on the visual.
--
-- 'title', 'wordCloudVisual_title' - The title that is displayed on the visual.
--
-- 'visualId', 'wordCloudVisual_visualId' - The unique identifier of a visual. This identifier must be unique within
-- the context of a dashboard, template, or analysis. Two dashboards,
-- analyses, or templates can have visuals with the same identifiers..
newWordCloudVisual ::
  -- | 'visualId'
  Prelude.Text ->
  WordCloudVisual
newWordCloudVisual :: Text -> WordCloudVisual
newWordCloudVisual Text
pVisualId_ =
  WordCloudVisual'
    { $sel:actions:WordCloudVisual' :: Maybe [VisualCustomAction]
actions = forall a. Maybe a
Prelude.Nothing,
      $sel:chartConfiguration:WordCloudVisual' :: Maybe WordCloudChartConfiguration
chartConfiguration = forall a. Maybe a
Prelude.Nothing,
      $sel:columnHierarchies:WordCloudVisual' :: Maybe [ColumnHierarchy]
columnHierarchies = forall a. Maybe a
Prelude.Nothing,
      $sel:subtitle:WordCloudVisual' :: Maybe VisualSubtitleLabelOptions
subtitle = forall a. Maybe a
Prelude.Nothing,
      $sel:title:WordCloudVisual' :: Maybe VisualTitleLabelOptions
title = forall a. Maybe a
Prelude.Nothing,
      $sel:visualId:WordCloudVisual' :: Text
visualId = Text
pVisualId_
    }

-- | The list of custom actions that are configured for a visual.
wordCloudVisual_actions :: Lens.Lens' WordCloudVisual (Prelude.Maybe [VisualCustomAction])
wordCloudVisual_actions :: Lens' WordCloudVisual (Maybe [VisualCustomAction])
wordCloudVisual_actions = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\WordCloudVisual' {Maybe [VisualCustomAction]
actions :: Maybe [VisualCustomAction]
$sel:actions:WordCloudVisual' :: WordCloudVisual -> Maybe [VisualCustomAction]
actions} -> Maybe [VisualCustomAction]
actions) (\s :: WordCloudVisual
s@WordCloudVisual' {} Maybe [VisualCustomAction]
a -> WordCloudVisual
s {$sel:actions:WordCloudVisual' :: Maybe [VisualCustomAction]
actions = Maybe [VisualCustomAction]
a} :: WordCloudVisual) 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 s t a b. (Coercible s a, Coercible t b) => Iso s t a b
Lens.coerced

-- | The configuration settings of the visual.
wordCloudVisual_chartConfiguration :: Lens.Lens' WordCloudVisual (Prelude.Maybe WordCloudChartConfiguration)
wordCloudVisual_chartConfiguration :: Lens' WordCloudVisual (Maybe WordCloudChartConfiguration)
wordCloudVisual_chartConfiguration = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\WordCloudVisual' {Maybe WordCloudChartConfiguration
chartConfiguration :: Maybe WordCloudChartConfiguration
$sel:chartConfiguration:WordCloudVisual' :: WordCloudVisual -> Maybe WordCloudChartConfiguration
chartConfiguration} -> Maybe WordCloudChartConfiguration
chartConfiguration) (\s :: WordCloudVisual
s@WordCloudVisual' {} Maybe WordCloudChartConfiguration
a -> WordCloudVisual
s {$sel:chartConfiguration:WordCloudVisual' :: Maybe WordCloudChartConfiguration
chartConfiguration = Maybe WordCloudChartConfiguration
a} :: WordCloudVisual)

-- | The column hierarchy that is used during drill-downs and drill-ups.
wordCloudVisual_columnHierarchies :: Lens.Lens' WordCloudVisual (Prelude.Maybe [ColumnHierarchy])
wordCloudVisual_columnHierarchies :: Lens' WordCloudVisual (Maybe [ColumnHierarchy])
wordCloudVisual_columnHierarchies = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\WordCloudVisual' {Maybe [ColumnHierarchy]
columnHierarchies :: Maybe [ColumnHierarchy]
$sel:columnHierarchies:WordCloudVisual' :: WordCloudVisual -> Maybe [ColumnHierarchy]
columnHierarchies} -> Maybe [ColumnHierarchy]
columnHierarchies) (\s :: WordCloudVisual
s@WordCloudVisual' {} Maybe [ColumnHierarchy]
a -> WordCloudVisual
s {$sel:columnHierarchies:WordCloudVisual' :: Maybe [ColumnHierarchy]
columnHierarchies = Maybe [ColumnHierarchy]
a} :: WordCloudVisual) 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 s t a b. (Coercible s a, Coercible t b) => Iso s t a b
Lens.coerced

-- | The subtitle that is displayed on the visual.
wordCloudVisual_subtitle :: Lens.Lens' WordCloudVisual (Prelude.Maybe VisualSubtitleLabelOptions)
wordCloudVisual_subtitle :: Lens' WordCloudVisual (Maybe VisualSubtitleLabelOptions)
wordCloudVisual_subtitle = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\WordCloudVisual' {Maybe VisualSubtitleLabelOptions
subtitle :: Maybe VisualSubtitleLabelOptions
$sel:subtitle:WordCloudVisual' :: WordCloudVisual -> Maybe VisualSubtitleLabelOptions
subtitle} -> Maybe VisualSubtitleLabelOptions
subtitle) (\s :: WordCloudVisual
s@WordCloudVisual' {} Maybe VisualSubtitleLabelOptions
a -> WordCloudVisual
s {$sel:subtitle:WordCloudVisual' :: Maybe VisualSubtitleLabelOptions
subtitle = Maybe VisualSubtitleLabelOptions
a} :: WordCloudVisual)

-- | The title that is displayed on the visual.
wordCloudVisual_title :: Lens.Lens' WordCloudVisual (Prelude.Maybe VisualTitleLabelOptions)
wordCloudVisual_title :: Lens' WordCloudVisual (Maybe VisualTitleLabelOptions)
wordCloudVisual_title = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\WordCloudVisual' {Maybe VisualTitleLabelOptions
title :: Maybe VisualTitleLabelOptions
$sel:title:WordCloudVisual' :: WordCloudVisual -> Maybe VisualTitleLabelOptions
title} -> Maybe VisualTitleLabelOptions
title) (\s :: WordCloudVisual
s@WordCloudVisual' {} Maybe VisualTitleLabelOptions
a -> WordCloudVisual
s {$sel:title:WordCloudVisual' :: Maybe VisualTitleLabelOptions
title = Maybe VisualTitleLabelOptions
a} :: WordCloudVisual)

-- | The unique identifier of a visual. This identifier must be unique within
-- the context of a dashboard, template, or analysis. Two dashboards,
-- analyses, or templates can have visuals with the same identifiers..
wordCloudVisual_visualId :: Lens.Lens' WordCloudVisual Prelude.Text
wordCloudVisual_visualId :: Lens' WordCloudVisual Text
wordCloudVisual_visualId = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\WordCloudVisual' {Text
visualId :: Text
$sel:visualId:WordCloudVisual' :: WordCloudVisual -> Text
visualId} -> Text
visualId) (\s :: WordCloudVisual
s@WordCloudVisual' {} Text
a -> WordCloudVisual
s {$sel:visualId:WordCloudVisual' :: Text
visualId = Text
a} :: WordCloudVisual)

instance Data.FromJSON WordCloudVisual where
  parseJSON :: Value -> Parser WordCloudVisual
parseJSON =
    forall a. String -> (Object -> Parser a) -> Value -> Parser a
Data.withObject
      String
"WordCloudVisual"
      ( \Object
x ->
          Maybe [VisualCustomAction]
-> Maybe WordCloudChartConfiguration
-> Maybe [ColumnHierarchy]
-> Maybe VisualSubtitleLabelOptions
-> Maybe VisualTitleLabelOptions
-> Text
-> WordCloudVisual
WordCloudVisual'
            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
"Actions" forall a. Parser (Maybe a) -> a -> Parser a
Data..!= forall a. Monoid a => a
Prelude.mempty)
            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
"ChartConfiguration")
            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
"ColumnHierarchies"
                            forall a. Parser (Maybe a) -> a -> Parser a
Data..!= forall a. Monoid a => a
Prelude.mempty
                        )
            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
"Subtitle")
            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
"Title")
            forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x forall a. FromJSON a => Object -> Key -> Parser a
Data..: Key
"VisualId")
      )

instance Prelude.Hashable WordCloudVisual where
  hashWithSalt :: Int -> WordCloudVisual -> Int
hashWithSalt Int
_salt WordCloudVisual' {Maybe [ColumnHierarchy]
Maybe [VisualCustomAction]
Maybe VisualSubtitleLabelOptions
Maybe VisualTitleLabelOptions
Maybe WordCloudChartConfiguration
Text
visualId :: Text
title :: Maybe VisualTitleLabelOptions
subtitle :: Maybe VisualSubtitleLabelOptions
columnHierarchies :: Maybe [ColumnHierarchy]
chartConfiguration :: Maybe WordCloudChartConfiguration
actions :: Maybe [VisualCustomAction]
$sel:visualId:WordCloudVisual' :: WordCloudVisual -> Text
$sel:title:WordCloudVisual' :: WordCloudVisual -> Maybe VisualTitleLabelOptions
$sel:subtitle:WordCloudVisual' :: WordCloudVisual -> Maybe VisualSubtitleLabelOptions
$sel:columnHierarchies:WordCloudVisual' :: WordCloudVisual -> Maybe [ColumnHierarchy]
$sel:chartConfiguration:WordCloudVisual' :: WordCloudVisual -> Maybe WordCloudChartConfiguration
$sel:actions:WordCloudVisual' :: WordCloudVisual -> Maybe [VisualCustomAction]
..} =
    Int
_salt
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe [VisualCustomAction]
actions
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe WordCloudChartConfiguration
chartConfiguration
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe [ColumnHierarchy]
columnHierarchies
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe VisualSubtitleLabelOptions
subtitle
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Maybe VisualTitleLabelOptions
title
      forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Text
visualId

instance Prelude.NFData WordCloudVisual where
  rnf :: WordCloudVisual -> ()
rnf WordCloudVisual' {Maybe [ColumnHierarchy]
Maybe [VisualCustomAction]
Maybe VisualSubtitleLabelOptions
Maybe VisualTitleLabelOptions
Maybe WordCloudChartConfiguration
Text
visualId :: Text
title :: Maybe VisualTitleLabelOptions
subtitle :: Maybe VisualSubtitleLabelOptions
columnHierarchies :: Maybe [ColumnHierarchy]
chartConfiguration :: Maybe WordCloudChartConfiguration
actions :: Maybe [VisualCustomAction]
$sel:visualId:WordCloudVisual' :: WordCloudVisual -> Text
$sel:title:WordCloudVisual' :: WordCloudVisual -> Maybe VisualTitleLabelOptions
$sel:subtitle:WordCloudVisual' :: WordCloudVisual -> Maybe VisualSubtitleLabelOptions
$sel:columnHierarchies:WordCloudVisual' :: WordCloudVisual -> Maybe [ColumnHierarchy]
$sel:chartConfiguration:WordCloudVisual' :: WordCloudVisual -> Maybe WordCloudChartConfiguration
$sel:actions:WordCloudVisual' :: WordCloudVisual -> Maybe [VisualCustomAction]
..} =
    forall a. NFData a => a -> ()
Prelude.rnf Maybe [VisualCustomAction]
actions
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe WordCloudChartConfiguration
chartConfiguration
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe [ColumnHierarchy]
columnHierarchies
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe VisualSubtitleLabelOptions
subtitle
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Maybe VisualTitleLabelOptions
title
      seq :: forall a b. a -> b -> b
`Prelude.seq` forall a. NFData a => a -> ()
Prelude.rnf Text
visualId

instance Data.ToJSON WordCloudVisual where
  toJSON :: WordCloudVisual -> Value
toJSON WordCloudVisual' {Maybe [ColumnHierarchy]
Maybe [VisualCustomAction]
Maybe VisualSubtitleLabelOptions
Maybe VisualTitleLabelOptions
Maybe WordCloudChartConfiguration
Text
visualId :: Text
title :: Maybe VisualTitleLabelOptions
subtitle :: Maybe VisualSubtitleLabelOptions
columnHierarchies :: Maybe [ColumnHierarchy]
chartConfiguration :: Maybe WordCloudChartConfiguration
actions :: Maybe [VisualCustomAction]
$sel:visualId:WordCloudVisual' :: WordCloudVisual -> Text
$sel:title:WordCloudVisual' :: WordCloudVisual -> Maybe VisualTitleLabelOptions
$sel:subtitle:WordCloudVisual' :: WordCloudVisual -> Maybe VisualSubtitleLabelOptions
$sel:columnHierarchies:WordCloudVisual' :: WordCloudVisual -> Maybe [ColumnHierarchy]
$sel:chartConfiguration:WordCloudVisual' :: WordCloudVisual -> Maybe WordCloudChartConfiguration
$sel:actions:WordCloudVisual' :: WordCloudVisual -> Maybe [VisualCustomAction]
..} =
    [Pair] -> Value
Data.object
      ( forall a. [Maybe a] -> [a]
Prelude.catMaybes
          [ (Key
"Actions" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..=) forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe [VisualCustomAction]
actions,
            (Key
"ChartConfiguration" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..=)
              forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe WordCloudChartConfiguration
chartConfiguration,
            (Key
"ColumnHierarchies" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..=)
              forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe [ColumnHierarchy]
columnHierarchies,
            (Key
"Subtitle" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..=) forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe VisualSubtitleLabelOptions
subtitle,
            (Key
"Title" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..=) forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe VisualTitleLabelOptions
title,
            forall a. a -> Maybe a
Prelude.Just (Key
"VisualId" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..= Text
visualId)
          ]
      )